// Copyright © 2022 Rangeproof Pty Ltd. All rights reserved. import Combine public protocol CombineCompatible {} public extension Publisher { /// Provides a subject that shares a single subscription to the upstream publisher and replays at most /// `bufferSize` items emitted by that publisher /// - Parameter bufferSize: limits the number of items that can be replayed func shareReplay(_ bufferSize: Int) -> AnyPublisher { return multicast(subject: ReplaySubject(bufferSize)) .autoconnect() .eraseToAnyPublisher() } func sink(into subject: PassthroughSubject, includeCompletions: Bool = false) -> AnyCancellable { return sink( receiveCompletion: { completion in guard includeCompletions else { return } subject.send(completion: completion) }, receiveValue: { value in subject.send(value) } ) } func tryFlatMap( maxPublishers: Subscribers.Demand = .unlimited, _ transform: @escaping (Self.Output) throws -> P ) -> AnyPublisher where T == P.Output, P : Publisher, P.Failure == Error { return self .mapError { $0 } .flatMap(maxPublishers: maxPublishers) { output -> AnyPublisher in do { return try transform(output) .eraseToAnyPublisher() } catch { return Fail(error: error) .eraseToAnyPublisher() } } .eraseToAnyPublisher() } func subscribe( on scheduler: S, options: S.SchedulerOptions? = nil, using dependencies: Dependencies = Dependencies() ) -> AnyPublisher where S: Scheduler { guard !dependencies.forceSynchronous else { return self.eraseToAnyPublisher() } return self.subscribe(on: scheduler, options: options) .eraseToAnyPublisher() } func receive( on scheduler: S, options: S.SchedulerOptions? = nil, using dependencies: Dependencies = Dependencies() ) -> AnyPublisher where S: Scheduler { guard !dependencies.forceSynchronous else { return self.eraseToAnyPublisher() } return self.receive(on: scheduler, options: options) .eraseToAnyPublisher() } func manualRefreshFrom(_ refreshTrigger: some Publisher) -> AnyPublisher { return Publishers .CombineLatest(refreshTrigger.prepend(()).setFailureType(to: Failure.self), self) .map { _, value in value } .eraseToAnyPublisher() } func withPrevious() -> AnyPublisher<(previous: Output?, current: Output), Failure> { scan(Optional<(Output?, Output)>.none) { ($0?.1, $1) } .compactMap { $0 } .eraseToAnyPublisher() } func withPrevious(_ initialPreviousValue: Output) -> AnyPublisher<(previous: Output, current: Output), Failure> { scan((initialPreviousValue, initialPreviousValue)) { ($0.1, $1) }.eraseToAnyPublisher() } } // MARK: - Convenience public extension Publisher { func sink(into subject: PassthroughSubject?, includeCompletions: Bool = false) -> AnyCancellable { guard let targetSubject: PassthroughSubject = subject else { return AnyCancellable {} } return sink(into: targetSubject, includeCompletions: includeCompletions) } /// Automatically retains the subscription until it emits a 'completion' event func sinkUntilComplete( receiveCompletion: ((Subscribers.Completion) -> Void)? = nil, receiveValue: ((Output) -> Void)? = nil ) { var retainCycle: Cancellable? = nil retainCycle = self .sink( receiveCompletion: { result in receiveCompletion?(result) // Redundant but without reading 'retainCycle' it will warn that the variable // isn't used if retainCycle != nil { retainCycle = nil } }, receiveValue: (receiveValue ?? { _ in }) ) } } public extension AnyPublisher { /// Converts the publisher to output a Result instead of throwing an error, can be used to ensure a subscription never /// closes due to a failure func asResult() -> AnyPublisher, Never> { self .map { Result.success($0) } .catch { Just(Result.failure($0)).eraseToAnyPublisher() } .eraseToAnyPublisher() } } // MARK: - Data Decoding public extension Publisher where Output == Data, Failure == Error { func decoded( as type: R.Type, using dependencies: Dependencies = Dependencies() ) -> AnyPublisher { self .tryMap { data -> R in try data.decoded(as: type, using: dependencies) } .eraseToAnyPublisher() } } public extension Publisher where Output == (ResponseInfoType, Data?), Failure == Error { func decoded( as type: R.Type, using dependencies: Dependencies = Dependencies() ) -> AnyPublisher<(ResponseInfoType, R), Error> { self .tryMap { responseInfo, maybeData -> (ResponseInfoType, R) in guard let data: Data = maybeData else { throw HTTPError.parsingFailed } return (responseInfo, try data.decoded(as: type, using: dependencies)) } .eraseToAnyPublisher() } }