Contents

# frozen_string_literal: true

class Bridgetown::Site
  module SSR
    def self.included(base)
      base.extend ClassMethods
    end

    module ClassMethods
      # Establish an SSR pipeline for a persistent backend process
      def start_ssr!(loaders_manager: nil, &)
        if Bridgetown::Current.site
          raise Bridgetown::Errors::FatalException, "Bridgetown SSR already started! " \
                                                    "Check your Rack app for threading issues"
        end

        site = new(Bridgetown::Current.preloaded_configuration, loaders_manager:)
        site.enable_ssr
        site.ssr_setup(&)

        site
      end
    end

    def ssr?
      @ssr_enabled == true
    end

    def enable_ssr
      Bridgetown.logger.info "SSR:", "enabled."
      config.fast_refresh = false # SSR mode and Fast Refresh mode are mututally exclusive
      @ssr_enabled = true
    end

    def ssr_setup(&block)
      Bridgetown::Hooks.trigger :site, :pre_read, self
      ssr_first_read
      Bridgetown::Hooks.trigger :site, :post_read, self

      block&.call(self) # provide additional setup hook

      return if Bridgetown.env.production?

      Bridgetown::Watcher.watch(self, config, &block)
    end

    def ssr_first_read
      Bridgetown::Hooks.trigger :site, :pre_read, self
      defaults_reader.tap do |d|
        d.path_defaults.clear
        d.read
      end
      reader.read_layouts
      collections.data.tap do |coll|
        coll.read
        self.data = coll.merge_data_resources
      end

      # This part is handled via a hook so it is supported by the SSR "soft reset"
      Bridgetown::Hooks.register_one :site, :post_read, reloadable: false, priority: :high do
        reader.read_directories
        reader.sort_files!
        reader.read_collections
      end
    end

    def disable_ssr
      Bridgetown.logger.info "SSR:", "now disabled."
      @ssr_enabled = false
    end
  end
end

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
bridgetown-core-2.0.0.beta3	lib/bridgetown-core/concerns/site/ssr.rb