diya/velody
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Implement remote library metadata sync for iPhone

Browse Source
This commit is contained in:
diyaa
2026-05-29 08:54:09 +02:00
parent ebc187f4a1
commit 6e73c1878e
20 changed files with 1379 additions and 48 deletions
Download Patch File Download Diff File Expand all files Collapse all files
packages/apple/VelodyNetworking/Package.swift
+7
View File
@@ -21,5 +21,12 @@ let package = Package(
name: "VelodyNetworking",
dependencies: ["VelodyDomain"]
),
.testTarget(
name: "VelodyNetworkingTests",
dependencies: [
"VelodyDomain",
"VelodyNetworking",
]
),
]
)
packages/apple/VelodyNetworking/Sources/VelodyNetworking/RemoteLibraryDTOs.swift
+54
View File
@@ -0,0 +1,54 @@
import Foundation
import VelodyDomain
public struct RemoteTrackDTO: Codable, Hashable, Sendable {
public var trackId: String
public var title: String
public var artist: String
public var durationSeconds: Int
public var sha256: String
public var assetId: String
public var createdAt: String
public var updatedAt: String
public init(
trackId: String,
title: String,
artist: String,
durationSeconds: Int,
sha256: String,
assetId: String,
createdAt: String,
updatedAt: String
) {
self.trackId = trackId
self.title = title
self.artist = artist
self.durationSeconds = durationSeconds
self.sha256 = sha256
self.assetId = assetId
self.createdAt = createdAt
self.updatedAt = updatedAt
}
public var remoteTrack: RemoteTrack {
RemoteTrack(
trackId: trackId,
title: title,
artist: artist,
durationSeconds: durationSeconds,
sha256: sha256,
assetId: assetId,
createdAt: createdAt,
updatedAt: updatedAt
)
}
}
public struct RemoteLibraryResponseDTO: Codable, Hashable, Sendable {
public var tracks: [RemoteTrackDTO]
public init(tracks: [RemoteTrackDTO]) {
self.tracks = tracks
}
}
packages/apple/VelodyNetworking/Sources/VelodyNetworking/VelodyAPIClient.swift
+64 -3
View File
@@ -39,6 +39,10 @@ public protocol VelodyAPIClient: Sendable {
func fetchSyncBootstrap() async throws -> SyncBootstrapResponse
func fetchRemoteLibrary(
deviceId: String
) async throws -> RemoteLibraryResponseDTO
func prepareUpload(
_ payload: UploadPrepareRequest
) async throws -> UploadPrepareResponse
@@ -106,6 +110,19 @@ public struct URLSessionVelodyAPIClient: VelodyAPIClient {
)
}
public func fetchRemoteLibrary(
deviceId: String
) async throws -> RemoteLibraryResponseDTO {
try await sendRequest(
method: "GET",
pathComponents: ["api", "v1", "library", "tracks"],
queryItems: [
URLQueryItem(name: "deviceId", value: deviceId),
],
responseType: RemoteLibraryResponseDTO.self
)
}
public func prepareUpload(
_ payload: UploadPrepareRequest
) async throws -> UploadPrepareResponse {
@@ -139,6 +156,7 @@ public struct URLSessionVelodyAPIClient: VelodyAPIClient {
let request = try buildRequest(
method: "PUT",
pathComponents: ["api", "v1", "uploads", uploadId, "file"],
queryItems: [],
bodyData: nil,
contentType: mimeType
)
@@ -174,11 +192,13 @@ public struct URLSessionVelodyAPIClient: VelodyAPIClient {
private func sendRequest<Response: Decodable>(
method: String,
pathComponents: [String],
queryItems: [URLQueryItem] = [],
responseType: Response.Type
) async throws -> Response {
let request = try buildRequest(
method: method,
pathComponents: pathComponents,
queryItems: queryItems,
bodyData: nil
)
@@ -188,6 +208,7 @@ public struct URLSessionVelodyAPIClient: VelodyAPIClient {
private func sendRequest<Body: Encodable, Response: Decodable>(
method: String,
pathComponents: [String],
queryItems: [URLQueryItem] = [],
body: Body,
responseType: Response.Type
) async throws -> Response {
@@ -202,6 +223,7 @@ public struct URLSessionVelodyAPIClient: VelodyAPIClient {
let request = try buildRequest(
method: method,
pathComponents: pathComponents,
queryItems: queryItems,
bodyData: bodyData,
contentType: "application/json"
)
@@ -212,10 +234,14 @@ public struct URLSessionVelodyAPIClient: VelodyAPIClient {
private func buildRequest(
method: String,
pathComponents: [String],
queryItems: [URLQueryItem],
bodyData: Data?,
contentType: String? = nil
) throws -> URLRequest {
guard let url = endpointURL(pathComponents: pathComponents) else {
guard let url = endpointURL(
pathComponents: pathComponents,
queryItems: queryItems
) else {
throw VelodyAPIError.invalidServerURL(environment.baseURL.absoluteString)
}
@@ -284,10 +310,24 @@ public struct URLSessionVelodyAPIClient: VelodyAPIClient {
}
}
private func endpointURL(pathComponents: [String]) -> URL? {
pathComponents.reduce(environment.baseURL) { partialURL, component in
private func endpointURL(
pathComponents: [String],
queryItems: [URLQueryItem]
) -> URL? {
let baseURL = pathComponents.reduce(environment.baseURL) { partialURL, component in
partialURL.appendingPathComponent(component, isDirectory: false)
}
guard !queryItems.isEmpty else {
return baseURL
}
guard var components = URLComponents(url: baseURL, resolvingAgainstBaseURL: false) else {
return nil
}
components.queryItems = queryItems
return components.url
}
}
@@ -340,6 +380,27 @@ public struct StubVelodyAPIClient: VelodyAPIClient {
)
}
public func fetchRemoteLibrary(
deviceId: String
) async throws -> RemoteLibraryResponseDTO {
_ = deviceId
return RemoteLibraryResponseDTO(
tracks: [
RemoteTrackDTO(
trackId: UUID().uuidString,
title: "Velody Remote Placeholder",
artist: "Private Library",
durationSeconds: 245,
sha256: String(repeating: "a", count: 64),
assetId: UUID().uuidString,
createdAt: ISO8601DateFormatter().string(from: .now),
updatedAt: ISO8601DateFormatter().string(from: .now)
),
]
)
}
public func prepareUpload(
_ payload: UploadPrepareRequest
) async throws -> UploadPrepareResponse {
packages/apple/VelodyNetworking/Tests/VelodyNetworkingTests/RemoteLibraryDTOTests.swift
+54
View File
@@ -0,0 +1,54 @@
import Foundation
import XCTest
@testable import VelodyNetworking
final class RemoteLibraryDTOTests: XCTestCase {
func testRemoteTrackDTOMapsToRemoteTrack() {
let dto = RemoteTrackDTO(
trackId: "track-123",
title: "Remote Title",
artist: "Remote Artist",
durationSeconds: 245,
sha256: String(repeating: "a", count: 64),
assetId: "asset-456",
createdAt: "2026-05-29T08:00:00.000Z",
updatedAt: "2026-05-29T08:05:00.000Z"
)
let track = dto.remoteTrack
XCTAssertEqual(track.trackId, "track-123")
XCTAssertEqual(track.title, "Remote Title")
XCTAssertEqual(track.artist, "Remote Artist")
XCTAssertEqual(track.durationSeconds, 245)
XCTAssertEqual(track.sha256, String(repeating: "a", count: 64))
XCTAssertEqual(track.assetId, "asset-456")
}
func testRemoteLibraryResponseDTODecodesFromAPIResponse() throws {
let data = Data(
"""
{
"tracks": [
{
"trackId": "track-123",
"title": "Remote Title",
"artist": "Remote Artist",
"durationSeconds": 245,
"sha256": "\(String(repeating: "a", count: 64))",
"assetId": "asset-456",
"createdAt": "2026-05-29T08:00:00.000Z",
"updatedAt": "2026-05-29T08:05:00.000Z"
}
]
}
""".utf8
)
let decoded = try JSONDecoder().decode(RemoteLibraryResponseDTO.self, from: data)
XCTAssertEqual(decoded.tracks.count, 1)
XCTAssertEqual(decoded.tracks.first?.trackId, "track-123")
XCTAssertEqual(decoded.tracks.first?.durationSeconds, 245)
}
}