- GADriveItem: change type of identifier to OCFileID

- GAEducationClass: update from latest Open API yaml file
- OCConnection+Spaces: add new method to update the resources (special items) for a drive with a provided item

Author: felix-schwarz

ownCloudSDK/Connection/OCConnection+Spaces.m

@@ -19,8 +19,11 @@
 #import "OCConnection.h"
 #import "GADrive.h"
 #import "GADriveUpdate.h"
+#import "GADriveItem.h"
 #import "OCConnection+OData.h"
 #import "OCConnection+GraphAPI.h"
+#import "OCMacros.h"
+#import "NSError+OCError.h"
 
 @implementation OCConnection (Drives)
 
@@ -121,4 +124,59 @@ - (nullable NSProgress *)updateDrive:(OCDrive *)drive properties:(NSDictionary<O
 	}]);
 }
 
+- (NSProgress *)updateDrive:(OCDrive *)drive resourceFor:(OCDataItemPresentableResource)resource withItem:(nullable OCItem *)item completionHandler:(void(^)(NSError * _Nullable error, OCDrive * _Nullable drive))completionHandler
+{
+	// Compose drive item
+	GADriveItem *driveItem = [GADriveItem new];
+
+	// - set special folder name based on OCDataItemPresentableResource
+	driveItem.specialFolder = [GASpecialFolder new];
+	if ([resource isEqual:OCDataItemPresentableResourceCoverImage]) {
+		driveItem.specialFolder.name = GASpecialFolderNameImage;
+	} else if ([resource isEqual:OCDataItemPresentableResourceCoverDescription]) {
+		driveItem.specialFolder.name = GASpecialFolderNameReadme;
+	} else {
+		// Unknown/unsupported resource type -> return error
+		completionHandler(OCError(OCErrorInvalidParameter), nil);
+	}
+
+	// - set item identifier
+	if (item != nil)
+	{
+		// update/set item as driveItem
+		driveItem.identifier = item.fileID;
+	}
+	else
+	{
+		// remove item as driveItem
+		driveItem.identifier = (OCFileID)NSNull.null;
+	}
+
+	// Compose drive update
+	GADriveUpdate *driveUpdate = [GADriveUpdate new];
+	driveUpdate.special = @[ driveItem ];
+
+	// Encode & send drive update
+	NSURL *url = [[self URLForEndpoint:OCConnectionEndpointIDGraphDrives options:nil] URLByAppendingPathComponent:drive.identifier];
+
+	return ([self updateODataObject:driveUpdate atURL:url requireSignals:[NSSet setWithObject:OCConnectionSignalIDAuthenticationAvailable] parameters:nil responseEntityClass:GADrive.class completionHandler:^(NSError * _Nullable error, id  _Nullable response) {
+		OCDrive *ocDrive = nil;
+
+		if (error == nil)
+		{
+			// Convert GADrive to OCDrive
+			GADrive *gaDrive;
+
+			if ((gaDrive = OCTypedCast(response, GADrive)) != nil)
+			{
+				ocDrive = [OCDrive driveFromGADrive:gaDrive];
+			}
+		}
+
+		OCLogDebug(@"Drives response: drive=%@, error=%@", ocDrive, error);
+
+		completionHandler(error, ocDrive);
+	}]);
+}
+
 @end

ownCloudSDK/Connection/OCConnection.h

@@ -37,6 +37,7 @@
 #import "OCDrive.h"
 #import "OCAppProviderApp.h"
 #import "OCFeatureAvailability.h"
+#import "OCDataItemPresentable.h"
 
 @class OCBookmark;
 @class OCAuthenticationMethod;
@@ -367,6 +368,7 @@ typedef void(^OCConnectionDriveManagementCompletionHandler)(NSError * _Nullable
 
 #pragma mark - Change attributes
 - (nullable NSProgress *)updateDrive:(OCDrive *)drive properties:(NSDictionary<OCDriveProperty, id> *)updateProperties completionHandler:(OCConnectionDriveCompletionHandler)completionHandler;
+- (nullable NSProgress *)updateDrive:(OCDrive *)drive resourceFor:(OCDataItemPresentableResource)resource withItem:(nullable OCItem *)item completionHandler:(void(^)(NSError * _Nullable error, OCDrive * _Nullable drive))completionHandler; //!< Updates special items of a drive with the provided item.
 
 @end
 

ownCloudSDK/GraphAPI/GeneratedTypes/GADriveItem.h

@@ -1,11 +1,11 @@
 //
 // GADriveItem.h
 // Autogenerated / Managed by ocapigen
-// Copyright (C) 2024 ownCloud GmbH. All rights reserved.
+// Copyright (C) 2025 ownCloud GmbH. All rights reserved.
 //
 
 /*
- * Copyright (C) 2024, ownCloud GmbH.
+ * Copyright (C) 2025, ownCloud GmbH.
  *
  * This code is covered by the GNU Public License Version 3.
  *
@@ -43,8 +43,8 @@
 NS_ASSUME_NONNULL_BEGIN
 @interface GADriveItem : NSObject <GAGraphObject, NSSecureCoding>
 
-// occgen: type properties { "customPropertyTypes" : { "eTag" : "OCFileETag" }}
-@property(strong, nullable) NSString *identifier; //!< Read-only.
+// occgen: type properties { "customPropertyTypes" : { "eTag" : "OCFileETag", "identifier" : "OCFileID" }}
+@property(strong, nullable) OCFileID identifier; //!< Read-only.
 @property(strong, nullable) GAIdentitySet *createdBy; //!< Identity of the user, device, or application which created the item. Read-only.
 @property(strong, nullable) NSDate *createdDateTime; //!< [string:date-time] Date and time of item creation. Read-only. | pattern: ^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])[Tt]([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?([Zz]|[+-][0-9][0-9]:[0-9][0-9])$
 @property(strong, nullable) NSString *desc; //!< Provides a user-visible description of the item. Optional.

ownCloudSDK/GraphAPI/GeneratedTypes/GADriveItem.m

@@ -1,11 +1,11 @@
 //
 // GADriveItem.m
 // Autogenerated / Managed by ocapigen
-// Copyright (C) 2024 ownCloud GmbH. All rights reserved.
+// Copyright (C) 2025 ownCloud GmbH. All rights reserved.
 //
 
 /*
- * Copyright (C) 2024, ownCloud GmbH.
+ * Copyright (C) 2025, ownCloud GmbH.
  *
  * This code is covered by the GNU Public License Version 3.
  *

ownCloudSDK/GraphAPI/GeneratedTypes/GAEducationClass.h

@@ -1,11 +1,11 @@
 //
 // GAEducationClass.h
 // Autogenerated / Managed by ocapigen
-// Copyright (C) 2024 ownCloud GmbH. All rights reserved.
+// Copyright (C) 2025 ownCloud GmbH. All rights reserved.
 //
 
 /*
- * Copyright (C) 2024, ownCloud GmbH.
+ * Copyright (C) 2025, ownCloud GmbH.
  *
  * This code is covered by the GNU Public License Version 3.
  *
@@ -28,10 +28,10 @@ NS_ASSUME_NONNULL_BEGIN
 // occgen: type properties
 @property(strong, nullable) NSString *identifier; //!< Read-only.
 @property(strong, nullable) NSString *desc; //!< An optional description for the group. Returned by default.
-@property(strong) NSString *displayName; //!< The display name for the group. This property is required when a group is created and cannot be cleared during updates. Returned by default. Supports $search and $orderBy.
+@property(strong, nullable) NSString *displayName; //!< The display name for the group. This property is required when a group is created and cannot be cleared during updates. Returned by default. Supports $search and $orderBy.
 @property(strong, nullable) NSArray<GAUser *> *members; //!< Users and groups that are members of this group. HTTP Methods: GET (supported for all groups), Nullable. Supports $expand.
 // @property(strong, nullable) NSArray<NSString *> *[email protected]; //!< A list of member references to the members to be added. Up to 20 members can be added with a single request
-@property(strong) NSString *classification; //!< Classification of the group, i.e. "class" or "course"
+@property(strong, nullable) NSString *classification; //!< Classification of the group, i.e. "class" or "course"
 @property(strong, nullable) NSString *externalId; //!< An external unique ID for the class
 
 // occgen: type protected {"locked":true}

ownCloudSDK/GraphAPI/GeneratedTypes/GAEducationClass.m

@@ -1,11 +1,11 @@
 //
 // GAEducationClass.m
 // Autogenerated / Managed by ocapigen
-// Copyright (C) 2024 ownCloud GmbH. All rights reserved.
+// Copyright (C) 2025 ownCloud GmbH. All rights reserved.
 //
 
 /*
- * Copyright (C) 2024, ownCloud GmbH.
+ * Copyright (C) 2025, ownCloud GmbH.
  *
  * This code is covered by the GNU Public License Version 3.
  *
@@ -28,10 +28,10 @@ + (nullable instancetype)decodeGraphData:(GAGraphData)structure context:(nullabl
 
 	GA_MAP(identifier, "id", NSString, Nil);
 	GA_MAP(desc, "description", NSString, Nil);
-	GA_SET_REQ(displayName, NSString, Nil);
+	GA_SET(displayName, NSString, Nil);
 	GA_SET(members, GAUser, NSArray.class);
 // 	GA_SET([email protected], NSString, NSArray.class);
-	GA_SET_REQ(classification, NSString, Nil);
+	GA_SET(classification, NSString, Nil);
 	GA_SET(externalId, NSString, Nil);
 
 	return (instance);
@@ -43,10 +43,10 @@ - (nullable GAGraphStruct)encodeToGraphStructWithContext:(nullable GAGraphContex
 	GA_ENC_INIT
 	GA_ENC_ADD(_identifier, "id", NO);
 	GA_ENC_ADD(_desc, "description", NO);
-	GA_ENC_ADD(_displayName, "displayName", YES);
+	GA_ENC_ADD(_displayName, "displayName", NO);
 	GA_ENC_ADD(_members, "members", NO);
 // 	GA_ENC_ADD([email protected], "[email protected]", NO);
-	GA_ENC_ADD(_classification, "classification", YES);
+	GA_ENC_ADD(_classification, "classification", NO);
 	GA_ENC_ADD(_externalId, "externalId", NO);
 	GA_ENC_RETURN
 }