- recognizing normalized paths
	- recognizing unnormalized / malformed paths
- OCCore
	- absence of parent items is now used as indication that a sub item of the absent parent item does not exist
	- [OCCore trackItemAtPath:trackingHandler:] now returns OCErrorUnnormalizedPath when passing unnormalized paths (containing f.ex. "//", "." or "..")
- new tests covering the new & improved functionality

- adds additional parameters to token request to ensure the retrieval of a refresh_token in case the OIDC provider isn't configured to this by default
- improve URL construction for absolute URLs (avoid leading double-slash)
- add new -[OCAuthenticationMethodOAuth2 retrieveEndpointInformationForConnection:] method to dynamically retrieve endpoints if needed (like for OIDC)

- add additional details to OCHTTPPipeline logging
- remove unused source code (OCWaitConditionPendingRequest)

- disabling background NSURLSession usage for apps running under iOS 13.1+ and having a FileProvider
- add auto-resume flag when downloading files

OCHTTPPipeline:
- add support for auto-resume of downloads

…erialization overhead

- updated `CONFIGURATION.md` to document the change
- OCAppIdentity: added appVersion and appBuildNumber properties
- UIDevice+ModelID: category allowing to retrieve the device's model identifier
- OCHTTPPipeline:
	- OCHTTPPipeline.userAgent builds, caches and returns the User-Agent
	- injects User-Agent into requests before sending them out
	- new OCClassSettingsIdentifierHTTP and OCHTTPPipelineSettingUserAgent
- OCDatabase: removed leftover debug message

- add ability to register classes for keys globally (use this sparingly)
- avoid unneeded deserializations when notifying observers of new values: if there's no observer for a key, there's no need to deserialize it

OCProcessManager:
- make property-like method sharedProcessManager an actual property

…lability across supported platforms

	- Adapt code to compile File Provider support code only on iOS and Mac Catalyst

…o develop

…at's used in startAuthenticationSession

	- added new OCAuthenticationBrowserSession class to allow plugging in alternative OAuth2 session providers
		- added OCAuthenticationBrowserSessionUIWebView as an implementation based on UIWebView, available right in the SDK as an option to work around issues in certain MDM software
	- added new OCClassSettings parameter "oa2-browser-session-class" to specify a class to use as alternative OAuth2 session providers
		- use "oc:authentication-oauth2.oa2-browser-session-class=string:UIWebView" as environment variable to use the OCAuthenticationBrowserSessionUIWebView class for OAuth2
	- added OC_FEATURE_AVAILABLE_AUTHENTICATION_SESSION availability macro

- add tvOS target and devices to ownCloudSDK target
	- fix dependencies and availability issues

…n-compatible APIs may be used (which silences a warning about this not being the case in a version of ownCloudApp with OCLicense*)

- SyncEngine: add preflight completion handler support
- LocalImport: make sure the placeholder completion handler is only called *after* the placeholder item is also in the database (fixes owncloud/enterprise#3642)
- CreateFolder: make sure the placeholder completion handler is only called *after* the placeholder item is also in the database (for future-proofing / consistency)

- OCItem: add -syncActivityDescription to provide a description of the OCItem sync activity contents

- adding .latestVersionOfLocalItem convenience attribute that retrieves (and caches) the latest version of an item

OCSyncActionUpload:
- use .latestVersionOfLocalItem instead of .localItem to fix an issue where a file was added offline, then updated offline, so that the activeSyncRecords of the OCItem got inconsistent:
	- upload file -> item has activeSyncRecord A
	- update file -> item has activeSyncRecords A, B
	- A: actually upload file -> item has no activeSyncRecords
	- B: actually update file -> item has activeSyncRecords A, spinning forever
- fix related issue that preflight could add a placeholder item to the database more than once, by only adding the placeholder as a new item if it has no databaseID yet

- OCConnection
	- new method to retrieve the path for a private link
- OCError
	- two new error codes indicating private link formatting or resolution errors
- OCCore
	- new method to retrieve the OCItem for a private link
	- make trackItem method more robust when targeting directories with non-OCPath-conforming paths (missing a trailing "/")
- OCItem+OCXMLObjectCreation
	- add support for extracting resolved private link paths
- Unit Tests
	- 4 new unit tests for the new OCConnection and OCCore methods

- expose background change scan activity via OCActivityIdentifierPendingServerScanJobsSummary activity identifier

- new OCBookmarkUserInfoKey type for OCBookmark.userInfo keys
- new OCBookmarkUserInfoKeyStatusInfo key holding the status.php contents of the last valid & non-maintenance connection to a server
- replace left-over usage of NSUUID* with OCBookmarkUUID in OCBookmarkManager

OCConnection:
- update OCBookmark.userInfo[OCBookmarkUserInfoKeyStatusInfo] on every successful connect

…red via ClassSettings/MDM

- add "email" to scope
- make scope configurable via ClassSettings
- document `oidc-scope` in CONFIGURATION.md

	- NSError category to simplify detecting NSErrors representing a network error/network failure
- OCConnection:
	- new OCConnection.authSignals that authentication methods can use to schedule their requests - allows the core to define conditions for these
- OCAuthenticationMethodOAuth2:
	- change token refresh to wait for network availability before sending token requests
	- taking advantage of new OCConnection.authSignals
	- fixing an unnecessary scheduling loop when no network connection is available and the token needs to be refreshed
- OCCore:
	- add new ready state (OCCoreStateReady) that is reached after setting up the infrastructure but before contacting the server
	- work around compiler bug in -[OCCore stopQuery:] that could crash the app
- OCCore+ConnectionStatus:
	- add new network available signal (OCConnectionSignalIDNetworkAvailable)
	- (re)starts background update checks and item task list scheduling when the connection is coming online
- OCCoreServerStatusSignalProvider:
	- allow providing the exact error when reporting that the connection was refused
	- uses the localizedDescription of the error as .shortDescription, if available
- OCCore+ItemList:
	- faster duplicate scheduled task detection
	- ensure OCQuerys are updated promptly even if there's already an item list task for the same path, resulting in queueing
	- fix bug that could permanently halt the item list task scheduling queue when offline
	- re-attempt update of item list tasks that failed and were put back in "new" state
	- ensure thread-safe use of _itemListTasksByPath
	- fix bug that led to deletion of scheduled background scans when offline
	- ensure scheduled background scans only take place when network is available (utilizing new OCConnectionSignalIDNetworkAvailable)
	- detect and avoid duplicate scheduling of jobs
- OCCoreItemListTask:
	- add new updateIfNew method to update only those sets whose state is "new"
	- add support for injecting required signal options depending on whether a PROPFIND is scheduled for a query or background scan

…che results, fetch new results in the event of a duplicate request, to ensure result consistency

…sync action until the metadata of an item changes or the item becomes unavailable

- OCEvent: new wakeup event (OCEventTypeWakeupSyncRecord) for use in wait conditions to wake up the Sync Engine
- OCCore+SyncEngine: new convenience method to create and send a wakeup event
- OCSyncActionDownload: improved handling of error 412
	- triggers a rescan of the enclosing directory to get up-to-date metadata to base future download retries on
	- adds a metadata refresh wait condition to pause the download until the metadata is up-to-date again
	- checks for versions of the item to download newer than the archived version the download was scheduled with - and updates itself if necessary
	- uses timeouts and a retry counter to avoid infinite retries in environments with frequent updates
	- provide an improved error message to the user if the error can't be resolved internally

…nd -[OCCore _pollForSharesWithScope:item:completionHandler:]

… enums

- OCConnection: provide better error message for HTTP status code 403 (DAV error message + fallback message)

…starting the core, ensuring that OAuth2 token refresh is carried out if the OCCore is started with an expired OAuth2 token

	- descheduling now uses the latest version of the local item to remove its ID and download status (fixing a possible status corruption issue)
	- descheduling now replaces the latest version of the local item with a newer remote version if one exists
	- correct handling of items removed, changed, moved and renamed between initiating the download and starting it (better error 412 handling)
- OCSyncActionUpload:
	- now uses LocalID-based -latestVersionOfLocalItem instead of path-based -retrieveLatestVersionOfItem:withError:
- OCWaitConditionMetaDataRefresh
	- add support for detecting path and name changes
	- fix OCCore retain cycle in tracking block
- OCCore: fix possible retain cycle in -trackItem: (occurred when timed extremely badly)

…return a "Wait" state (ensuring important context info in OCWaitConditionSyncIssue is stored/preserved), fixing finding (3) in ownloud/ios-app#632

…method

	- introduce concept of OCClaimLockTypes to express intent and more fine-grained control of *how* to hold onto a file
- OCCore
	- -registerUsageOfItem:completionHandler: changes:
		- attempt to retrieve the latest version of an item from the cache before updating .lastUsed
		- do not update item.lastUsed date unless the lastUsed date is older than 5 seconds to reduce load on the Sync Engine
- OCCore+ItemUpdates
	- implement support for different OCClaimLockTypes
	- take advantage of now available in-place updates via download
	- more readable/clearer log messages when local copies get removed due to newer copies on the server
- OCSyncActionDownload
	- add support for in-place updates of a file by downloading a newer version
	- preserve, not overwrite claims stored in item.fileClaim
- OCCore+SyncEngine
	- add new method -[OCCore retrieveLatestVersionForLocalIDOfItem:error:] to synchronously retrieve an item by local ID
- OCSyncActionUpdate
	- switch to using -[OCCore retrieveLatestVersionForLocalIDOfItem:error:]

…o simplifying code

- OCSyncActionUpload: remove redundant code (same operation performed by prepareToReplace: a few lines down)
- OCSyncActionDownload: add additional debug output and fetch latest version of item by localID rather than path

…emUpdates to a proper policy: OCItemPolicyProcessorVersionUpdates

- update unit tests for new OCClaimLockType API
- update demo-cert-new.cer and CertificateTests.m to make the certificate unit tests pass again
- note: unit tests couldn't all be run at this time as demo.owncloud.org seems to only return internal server errors at the time of testing

…sageQueue.md

- make OCMessageQueue.enqueue synchronous

	- add support for OCMessageAutoResolver to allow automatic message resolution
		- OCCore+MessageAutoresolver provides support for auto-resolving past auth errors
		- update MessageQueue.md with updated thoughts
	- fix lockingProcess validation bug
- OCProcessManager
	- add log tags and debug output for process-ping-pong
	- bugfix: the directory where process state tracking files were placed was not created
	- bugfix: OCProcessPing wasn't sending out a ping notification
- OCKeyValueStore: add missing IPC updateNotification handling
- Add "timestamp" support
	- OCHTTPResponse.date now contains the date a response was received
	- OCHTTPPipelineTaskMetrics.responseStartDate stores the date a response started to be received
	- OCHTTPPipelineTask: use OCHTTPPipelineTaskMetrics.responseStartDate if available to accurately determine OCHTTPResponse.date
	- OCHTTPPipeline: add response.date to debug output for responses
	- NSError+OCError: add support for an "NSError.errorDate"; provide macros and methods to easily add errorDate information to NSErrors; formally clean up OCError*Key types
	- OCConnection: use OCHTTPResponse.date where possible to provide errorDates for NSErrors
	- OCAuthenticationMethod: provide NSError.errorDate wherever possible

…lt scopes

…defunct)

- OCProcessManager
	- fix ping/pong mechanism to detect if another process is still running
	- fix creation of directory for process tracking files

…requested by the auth method, for ocis-oidc compatibility

…bscribe from pongs

…ts properly retained

- OCCore+SyncEngine: add detection of missing and defunct remote cores (in other processes) that could previously lead to sync records not getting processed as one process expected another process to process the record, while it wasn't really clear the other process was even listening for the event at this point
- OCProcessManager: remove redundant code

…ctive process core registrations are re-added if one was erroneously removed previously

	- new template mechanism for sync issues
	- provides metadata to allow f.ex. issue grouping and user notification actions
	- global registration and lookup
- OCSyncIssue
	- add methods to add autoChoiceErrors to choices generated from templates
- OCSyncAction
	- make .identifier a class-level property
	- add APIs to support OCSyncIssueTemplate
		- actionIssueTemplates: action-specific issue templates
		- issueTemplates: combines auto-generated issue templates and action-specific issue templates
	- migrated -_addIssueForCancellationAndDeschedulingToContext:title:description:impact: from OCCore to OCSyncAction, utilizing auto-generated issue templates
	- OCSYNCACTION_REGISTER_ISSUETEMPLATES macro to register issue templates at SDK load time
- OCSyncActionCopyMove
	- split up into OCSyncActionCopy and OCSyncActionMove to have unique classes for both action identifiers
- all OCSyncActions: switch creation of OCSyncIssues to using templates
- OCMessage
	- new properties for categories and threads
- OCMessageQueue
	- new method to retrieve message by UUID

- OCSyncActionUpload: add missing identifier values
- OCMessage
	- added .removed property to allow keeping messages around until they can be removed from storage
	- added presentation* properties to support the delivery of end notifications
- OCMessageQueue
	- added support for end notifications
	- added new method to manually present a message through a presenter
	- added OCMessageRemovedNotification notification that's broadcasted on all running processes whenever a message is removed from the queue
	- added tracking of active presentations
- OCMessagePresenter
	- new OCMessagePresentationResult result for the completion of a presentation to indicate requirements for calls to -endPresentationOfMessage:
	- refactor and add -endPresentationOfMessage: method
- OCWaitConditionIssue: removed old issue handling code (which was already commented out)
- code cleanup

	- better handling of situations where there's more than one NSThread object for a thread
	- new method to determine if a runloop thread is the current thread
- OCDatabase
	- added additional logging
	- fixed crash in event queuing if an insert fails
- OCSQLiteDB
	- use OCRunLoopThread.isCurrentThread to determine if the current thread is the SQLite thread

… _cachedAuthenticationSecret if updates happen in quick succession

…ote auth secret change notifications and clarify method names

- OCAuthenticationMethodOAuth2: add additional logging around authentication data updates following token refreshes
- OCBookmarkManager:
	- add support for IPC list change notifications
	- add new -updateBookmark: method to allow clients to signal updates of bookmarks to the bookmark manager (triggers notifications and saving)

…is changed on another process (via IPC notification)

…resigning active status for improved security (free local copy in memory) and consistency (IPC notifications might not be delivered while app is in background)

…ger.updateBookmark with additional safeguarding instead

	- OCFileIDUniquePrefix is a new type representing the unique fileID prefix of an item on the server. Background is that OC 10 FileIDs are composed of an 8-digit (%08ld) number and the server's ID (apparently identical across files). That number is unique for every file and also used as the number component in OC10 private links. By using a prefix here, it's possible to support both OC10-style fileID prefixes as well as future full-length fileIDs for searching for items.
and FileIDUnique.
- NSURL+OCPrivateLink
	- extracts private link FileIDs from private link URLs
	- extracts and converts private link FileIDs to a OCFileIDUniquePrefix, which can be used to retrieve an item from the cache
- OCCore+Sharing
	- support for local retrieval/lookup of the item for a private link using the OCFileIDUniquePrefix returned for the private link
	- additional debug logging
- OCConnection+Sharing: added PROPFIND to determine type (file / folder) of resolved resource
- OCCoreItemListTask: added additional debug logging
- OCDatabase: new -retrieveCacheItemForFileIDUniquePrefix:includingRemoved:completionHandler: method to retrieve an item from the cache using an OCFileIDUniquePrefix

…alid JSON

…ion data is changed

- OCCore: listen for bookmark-authdata-chnaged notifications (both local & IPC) and reattempt authentication or connection if a change occurs

…ortFileNamed:…] and [OCCore reportLocalModificationOfItem:…], allowing to specify a custom NSDate as last modified date to use during upload

…ad based on UUIDs rather than the NSThread pointer

- OCSQLiteDB: use OCRunLoopThread.isCurrentThread for OCSQLiteDB.isOnSQLiteThread
- OCDatabase: add additional error logging

… property to indicate when authentication has last failed using the current .authenticationData

	- OCAuthenticationMethodBasicAuth: add support for .authenticationDataKnownInvalidDate
	- OCAuthenticationMethodOAuth2: adopt .authenticationDataKnownInvalidDate property to avoid unnecessary token refreshes
	- OCCore: throttle connection attempts to at most once every three seconds if invalid authentication data is to be expected
- OCCore+ConnectionStatus: add new OCCoreConnectionStatusSignalConnecting and OCCoreConnectionStatusConnecting
	- OCCoreConnectionStatusConnecting indicates the OCCore is in the process of connecting
	- improved status change debug log messages
- NSError+OCDAVError: avoid "(null)" in error descriptions

…ously in the cache but are targeted directly by an OCQuery regardless could be returned with a nil .parentLocalID

- OCCore+Sharing: move "else" into its own line

…s into OCDAVErrorNotFound error code

- OCLogger:
	- support for "force" logging, that is, to log a message even if its logLevel would normally exclude it from logging
	- new logging methods, keeping "old" methods for compatibility with existing app sources
	- major macro consolidation / cleanup of existing macros
	- addition of new parametrized forced logging macros
	- addition of new OCLoggingEnabled() macro
- OCHTTPPipeline
	- HTTP requests and responses are now force-logged if HTTP request/response logging is enabled

- OCHTTPRequest: new .avoidCellular property controlling whether a request should not be sent over cellular (utilizing NSURLRequest.allowsCellularAccess)
- OCConnection: new OCConnectionOptionAllowCellularKey option for up- and downloads to control cellular usage for these
- OCCore: new OCCoreOptionAllowCellular option for up- and downloads to control cellular usage for these, to be passed to the import/localModification/download methods via the dictionary passed to the options parameter

	- OCCellularSwitch
		- represents features, areas and/or categories of transfer types
		- provides localizedName for rich representation
		- transparently stores/retrieves settings in/from user defaults
		- supports providing a maximum transfer size for each switch
	- OCCellularManager
		- provides convenient access to switches and helps determine if a transfer of a certain size is allowed for a switch
		- adds master switch to turns off all switches and/or set a maximum transfer size for all switches
	- OCItemPolicyProcessorAvailableOffline
		- adds support for new OCCellularSwitchIdentifierAvailableOffline cellular switch

…p-/download's usage of cellular data conditional on the status of a particular cellular switch at the time of scheduling

- OCItemPolicyProcessorAvailableOffline: adopt OCCoreOptionDependsOnCellularSwitch
- OCSyncActionDownload + OCSyncActionUpload: add support for OCCoreOptionDependsOnCellularSwitch and default to OCCellularSwitchIdentifierMaster if none is provided, fall back on OCCoreOptionAllowCellular instead if it is provided and no OCCoreOptionDependsOnCellularSwitch is provided
- OCHTTPRequest: add additional logging to indicate when a request has been set to avoid cellular transfer

…sAllowedFor:transferSize: (falls back to master switch in that case)

- OCCore:
	- new sync action categories for wifi-only and wifi-and-cellular uploads and downloads respectively
	- adapted concurrency budgets based on new wifi-only and wifi-and-cellular categories to ensure at least one cellular up- and download can run respectively

…i-lined log messages into single lines (on by default)

- OCHTTP: add new option `http.prefixed-http-logging` that prefixes each line of the different parts of a HTTP request with `[info]`, `[head]` or `[body]` (on by default)
- adjust tests to use extended request/response composition methods

	- remove `http.prefixed-http-logging` option and control that behaviour via `log.log-single-lined` instead
	- log `[header]` instead of `[head]` to allow for easier human "parsing"
- OCLogger
	- add new `log.log-maximum-message-size` option to limit the size of a log message to a maximum size (off by default)
	- OCLogWriter
		- new OCLogLineFlags: provide additional contextual information so writers can better present multi-line log messages saved as single line log messages
		- replace the separator with box drawing characters to visually group split multi line log messages

…ompletionHandler parameter

- fix typo in code comment

…o remove UIWebView from standard versions

- add documentation to doc/CONFIGURATION.md on how to re-enable UIWebView support via preprocessor flags

…e in OCItem as UInt64 bitfield

	- NSString+TUSMetadata: conversion from dictionary to Upload-Metadata - and back
	- OCTUSHeader: new class to simplify parsing, building and conversion of TUS-related headers
	- OCTUSJob: new class to manage the current status of a TUS upload
	- OCTUSJobSegment: new class to abstract away file segmentation details for TUS uploads
- OCConnection:
	- add new OCConnectionDelegate method to inject/modify TUS capabilities / settings
	- add new OCConnectionOptionTemporarySegmentFolderURLKey option key to provide a temporary folder to store file segments in when performing uploads via TUS
	- add code to upload files via TUS where available
- OCSyncActionUpload: add OCConnectionOptionTemporarySegmentFolderURLKey option to ensure persistence of temporary segment files
- OCEvent:
	- add OCTUSHeader, OCTUSJob and OCTUSJobSegment to .safeClasses
	- modernize initWithCoder
- OCHTTP:
	- add OCHTTPStaticHeaderFields type and switch OCHTTPResponse over
	- add OCHTTPMethodPATCH method

	- add support for TUS capabilities information provided via the capabilities endpoint
- OCConnection
	- apply OCCapabilities.tusMaxChunkSize to TUS uploads if available
- OCTUSHeader
	- clarify .maximumSize is the maximum file size and add new .maximumChunkSize to supply a maximum chunk size
	- add new OCTUSCapabilityKey and OCTUSCapability types as needed by OCCapabilities

- add new logging format option
- implement new json and json-composed formats
- update documentation and available Xcode env vars

- stricter MIMEType checks for content to print as text (previously also matched some xml document formats)

- move upload code to OCConnection+Upload (Upload category)
- extend TUS support with:
	- support for creation-with-upload
	- (currently disabled) differentiation between "small" and "large" files (OCConnection.tusSmallFileThreshold) where small files (below the threshold) are uploaded with creation-with-upload, while files above the threshold are uploaded with creation + PATCH
	- improved log messages showing upload progress by including file size in addition to upload offset