/// <summary>
    ///     Adds Umbraco NuCache dependencies
    /// </summary>
    public static IUmbracoBuilder AddNuCache(this IUmbracoBuilder builder)
    {
        // register the NuCache database data source
        builder.Services.TryAddSingleton <INuCacheContentRepository, NuCacheContentRepository>();
        builder.Services.TryAddSingleton <INuCacheContentService, NuCacheContentService>();
        builder.Services.TryAddSingleton <PublishedSnapshotServiceEventHandler>();

        // register the NuCache published snapshot service
        // must register default options, required in the service ctor
        builder.Services.TryAddTransient(factory => new PublishedSnapshotServiceOptions());
        builder.SetPublishedSnapshotService <PublishedSnapshotService>();
        builder.Services.TryAddSingleton <IPublishedSnapshotStatus, PublishedSnapshotStatus>();

        // replace this service since we want to improve the content/media
        // mapping lookups if we are using nucache.
        // TODO: Gotta wonder how much this does actually improve perf? It's a lot of weird code to make this happen so hope it's worth it
        builder.Services.AddUnique <IIdKeyMap>(factory =>
        {
            var idkSvc = new IdKeyMap(
                factory.GetRequiredService <ICoreScopeProvider>(),
                factory.GetRequiredService <IIdKeyMapRepository>());
            if (factory.GetRequiredService <IPublishedSnapshotService>() is PublishedSnapshotService
                publishedSnapshotService)
            {
                idkSvc.SetMapper(UmbracoObjectTypes.Document, id => publishedSnapshotService.GetDocumentUid(id), uid => publishedSnapshotService.GetDocumentId(uid));
                idkSvc.SetMapper(UmbracoObjectTypes.Media, id => publishedSnapshotService.GetMediaUid(id), uid => publishedSnapshotService.GetMediaId(uid));
            }

            return(idkSvc);
        });

        builder.AddNuCacheNotifications();

        builder.AddNotificationHandler <UmbracoApplicationStartingNotification, NuCacheStartupHandler>();
        builder.Services.AddSingleton <IContentCacheDataSerializerFactory>(s =>
        {
            IOptions <NuCacheSettings> options = s.GetRequiredService <IOptions <NuCacheSettings> >();
            switch (options.Value.NuCacheSerializerType)
            {
            case NuCacheSerializerType.JSON:
                return(new JsonContentNestedDataSerializerFactory());

            case NuCacheSerializerType.MessagePack:
                return(ActivatorUtilities.CreateInstance <MsgPackContentNestedDataSerializerFactory>(s));

            default:
                throw new IndexOutOfRangeException();
            }
        });

        builder.Services.AddSingleton <IPropertyCacheCompressionOptions>(s =>
        {
            IOptions <NuCacheSettings> options = s.GetRequiredService <IOptions <NuCacheSettings> >();

            if (options.Value.NuCacheSerializerType == NuCacheSerializerType.MessagePack &&
                options.Value.UnPublishedContentCompression)
            {
                return(new UnPublishedContentPropertyCacheCompressionOptions());
            }

            return(new NoopPropertyCacheCompressionOptions());
        });

        builder.Services.AddSingleton(s => new ContentDataSerializer(new DictionaryOfPropertyDataSerializer()));

        // add the NuCache health check (hidden from type finder)
        // TODO: no NuCache health check yet
        // composition.HealthChecks().Add<NuCacheIntegrityHealthCheck>();
        return(builder);
    }