Merge branch '3.0-preview' into feature/add-inlinable-notations-to-encourage-generic-specialization

# Conflicts:
#	Sources/CoreDataRepository/CoreDataRepository+CRUD.swift
#	Sources/CoreDataRepository/NSManagedObject+Helpers.swift
#	Sources/CoreDataRepository/NSManagedObjectContext+Helpers.swift

Author: roanutil

Sources/CoreDataRepository/CoreDataRepository+CRUD.swift

@@ -104,7 +104,7 @@ extension CoreDataRepository {
         let readContext = context.childContext()
         return AsyncStream { continuation in
             let provider: ReadSubscription<Model>
-            switch Self.getObjectId(fromUrl: url, context: readContext) {
+            switch readContext.objectId(from: url) {
             case let .success(objectId):
                 provider = ReadSubscription<Model>(
                     objectId: objectId,
@@ -132,7 +132,7 @@ extension CoreDataRepository {
         let readContext = context.childContext()
         return AsyncThrowingStream { continuation in
             let provider: ReadThrowingSubscription<Model>
-            switch Self.getObjectId(fromUrl: url, context: readContext) {
+            switch readContext.objectId(from: url) {
             case let .success(objectId):
                 provider = ReadThrowingSubscription<Model>(
                     objectId: objectId,
@@ -151,15 +151,4 @@ extension CoreDataRepository {
             }
         }
     }
-
-    @usableFromInline
-    static func getObjectId(
-        fromUrl url: URL,
-        context: NSManagedObjectContext
-    ) -> Result<NSManagedObjectID, CoreDataError> {
-        guard let objectId = context.persistentStoreCoordinator?.managedObjectID(forURIRepresentation: url) else {
-            return Result.failure(.failedToGetObjectIdFromUrl(url))
-        }
-        return .success(objectId)
-    }
 }

Sources/CoreDataRepository/CoreDataRepository+Custom.swift

@@ -0,0 +1,27 @@
+// CoreDataRepository+Custom.swift
+// CoreDataRepository
+//
+//
+// MIT License
+//
+// Copyright © 2024 Andrew Roan
+
+import CoreData
+import Foundation
+
+extension CoreDataRepository {
+    /// Escape hatch method for performing arbitrary operations inside a 'scratchpad' `NSManagedObjectContext` where
+    /// changes will be discarded if not saved.
+    ///
+    /// The caller is responsible for saving the contexts and cleaning up if needed.
+    /// All this  method provides is the contexts and mapping `Error` into ``CoreDataError``.
+    public func custom<T>(
+        schedule: NSManagedObjectContext.ScheduledTaskType = .enqueued,
+        block: @escaping (
+            _ parentContext: NSManagedObjectContext,
+            _ scratchPadContext: NSManagedObjectContext
+        ) throws -> T
+    ) async -> Result<T, CoreDataError> {
+        await context.performInScratchPad(schedule: schedule) { [context] scratchPad in try block(context, scratchPad) }
+    }
+}

…ternal/NSManagedObject+CRUDHelpers.swift …Repository/NSManagedObject+Helpers.swiftSources/CoreDataRepository/Internal/NSManagedObject+CRUDHelpers.swift renamed to Sources/CoreDataRepository/NSManagedObject+Helpers.swift Sources/CoreDataRepository/Internal/NSManagedObject+CRUDHelpers.swift renamed to Sources/CoreDataRepository/NSManagedObject+Helpers.swift

@@ -1,4 +1,4 @@
-// NSManagedObject+CRUDHelpers.swift
+// NSManagedObject+Helpers.swift
 // CoreDataRepository
 //
 //
@@ -11,8 +11,8 @@ import Foundation
 
 extension NSManagedObject {
     /// Helper function to handle casting ``NSManagedObject`` to a sub-class.
-    @usableFromInline
-    func asManagedModel<T>() throws -> T where T: NSManagedObject {
+	@inlinable
+    public func asManagedModel<T>() throws -> T where T: NSManagedObject {
         guard let repoManaged = self as? T else {
             throw CoreDataError.fetchedObjectFailedToCastToExpectedType
         }

…NSManagedObjectContext+CRUDHelpers.swift …ory/NSManagedObjectContext+Helpers.swiftSources/CoreDataRepository/Internal/NSManagedObjectContext+CRUDHelpers.swift renamed to Sources/CoreDataRepository/NSManagedObjectContext+Helpers.swift Sources/CoreDataRepository/Internal/NSManagedObjectContext+CRUDHelpers.swift renamed to Sources/CoreDataRepository/NSManagedObjectContext+Helpers.swift

@@ -1,4 +1,4 @@
-// NSManagedObjectContext+CRUDHelpers.swift
+// NSManagedObjectContext+Helpers.swift
 // CoreDataRepository
 //
 //
@@ -11,17 +11,17 @@ import Foundation
 
 extension NSManagedObjectContext {
     /// Helper function for getting the ``NSManagedObjectID`` from an ``URL``
-    @usableFromInline
-    func objectId(from url: URL) -> Result<NSManagedObjectID, CoreDataError> {
+	@inlinable
+    public func objectId(from url: URL) -> Result<NSManagedObjectID, CoreDataError> {
         guard let objectId = persistentStoreCoordinator?.managedObjectID(forURIRepresentation: url) else {
             return .failure(CoreDataError.failedToGetObjectIdFromUrl(url))
         }
         return .success(objectId)
     }
 
     /// Helper function for checking that a managed object is not deleted in the store
-    @usableFromInline
-    func notDeletedObject(for id: NSManagedObjectID) throws -> NSManagedObject {
+	@inlinable
+    public func notDeletedObject(for id: NSManagedObjectID) throws -> NSManagedObject {
         let object: NSManagedObject = try existingObject(with: id)
         guard !object.isDeleted else {
             throw CoreDataError.fetchedObjectIsFlaggedAsDeleted