@seamapi/nextlove-sdk-generator 1.4.1 → 1.5.0

package/src/lib/generate-swift-sdk/templates/readme.md.template.ts

@@ -0,0 +1,47 @@
+export default () => `# Seam API Swift SDK
+
+Official interface to the [Seam Connect API].
+
+[Seam Connect API]: https://docs.seam.co/
+
+## Description
+
+This SDK provides convenient access to the [Seam Connect API] for Swift applications.
+
+[Seam API endpoints]: https://docs.seam.co/latest/api-endpoints/overview
+
+## Installation
+
+### Swift Package Manager
+
+Add the following dependency to your \`Package.swift\` file:
+
+\`\`\`swift
+dependencies: [
+  .package(url: "https://github.com/seamapi/swift", .upToNextMajor(from: "0.0.1"))
+]
+\`\`\`
+
+
+## Usage
+
+_Refer to the [Seam Connect API documentation][Seam Connect API]._
+
+### Requirements
+
+- An API Key generated via the [Seam Dashboard].
+
+[Seam Dashboard]: https://dashboard.getseam.com
+
+### Example
+
+\`\`\`swift
+import SeamAPI
+
+let seam = SeamClient(apiKey: "YOUR_API_KEY")
+
+// List devices
+let devices = try await seam.devices.list()
+print(devices)
+\`\`\`
+`

package/src/lib/generate-swift-sdk/templates/seamclient.swift.template.ts

@@ -0,0 +1,87 @@
+import { camelCase } from "change-case"
+
+type SeamClientTemplateOptions = {
+  namespaceToRouteGroupClassName: Map<string, string>
+}
+
+export default ({
+  namespaceToRouteGroupClassName,
+}: SeamClientTemplateOptions) => `import Foundation
+#if canImport(FoundationNetworking)
+import FoundationNetworking
+#endif
+
+enum SeamClientError: Error {
+  case couldNotMakeRequest(request: URLRequest, error: Error)
+  case non2xxResponseData(response: URLResponse, errorType: String?, errorMessage: String?, requestID: String?)
+  case responseJSONDecodingError(error: DecodingError)
+  case unknown(error: Error)
+}
+
+class SeamClient {
+  var apiKey: String
+  var baseURL: URL
+  let decoder = JSONDecoder()
+  let urlSession = URLSession.init(configuration: .default)
+
+  ${Array.from(namespaceToRouteGroupClassName.entries())
+    .map(
+      ([namespace, route_group_class_name]) =>
+        `var ${camelCase(namespace)}: ${route_group_class_name}! = nil`
+    )
+    .join("\n  ")}
+
+  init(apiKey: String, baseURL: URL = URL(string: "https://connect.getseam.com")!) {
+    self.apiKey = apiKey
+    self.baseURL = baseURL
+
+    ${Array.from(namespaceToRouteGroupClassName.entries())
+      .map(
+        ([namespace, route_group_class_name]) =>
+          `self.${camelCase(
+            namespace
+          )} = ${route_group_class_name}(client: self)`
+      )
+      .join("\n    ")}
+  }
+
+  func request<ResponseSchema: Decodable>(method: String, path: String, responseSchema: ResponseSchema.Type, jsonBody: Data? = nil) async -> Result<ResponseSchema, SeamClientError> {
+    let url = self.baseURL.appendingPathComponent(path)
+    var request = URLRequest(url: url)
+    request.httpMethod = method
+    request.setValue("application/json", forHTTPHeaderField: "Content-Type")
+    request.setValue("Bearer \\(apiKey)", forHTTPHeaderField: "Authorization")
+
+    if let jsonBody = jsonBody {
+      request.httpBody = jsonBody
+    }
+
+    let requestResult: (Data, URLResponse)
+    do {
+      requestResult = try await self.urlSession.data(for: request)
+    } catch let error {
+      return .failure(.couldNotMakeRequest(request: request, error: error))
+    }
+    let (data, response) = requestResult
+
+    guard let httpResponse = response as? HTTPURLResponse,
+          (200...299).contains(httpResponse.statusCode) else {
+      // todo: better error
+      return .failure(.non2xxResponseData(
+        response: response,
+        errorType: nil,
+        errorMessage: nil,
+        requestID: nil
+      ))
+    }
+
+    do {
+      let decoded = try decoder.decode(ResponseSchema.self, from: data)
+      return .success(decoded)
+    } catch let error as DecodingError {
+      return .failure(.responseJSONDecodingError(error: error))
+    } catch let error {
+      return .failure(.unknown(error: error))
+    }
+  }
+}`

package/src/lib/types.ts

@@ -43,16 +43,21 @@ export type PrimitiveSchema =
       format?: "uuid" | "date-time" | "uri"
       nullable?: boolean
     }
-  | { type: "boolean"; enum?: boolean[] }
-  | { type: "integer"; enum?: number[] }
-  | { type: "number" }
+  | { type: "boolean"; enum?: boolean[]; nullable?: boolean }
+  | { type: "integer"; enum?: number[]; nullable?: boolean }
+  | { type: "number"; nullable?: boolean }
 
-export type ArraySchema = { type: "array"; items: PropertySchema }
+export type ArraySchema = {
+  type: "array"
+  items: PropertySchema
+  nullable?: boolean
+}
 
 export type ObjSchema = {
   type: "object"
   properties: Record<string, PropertySchema>
   required: string[]
+  nullable?: boolean
 }
 
 export type RefSchema = {