A platform for community discussion. Free, open, simple.
# frozen_string_literal: true
# A JS bundle built by an external command and cached on disk, keyed by a digest
# of its inputs. Precompiled during `assets:precompile`; held by composition.
class PrecompiledBundle
attr_reader :dependency_globs
# The digest of the source most recently returned by `load_or_build`
attr_reader :loaded_digest
def initialize(dir:, filename_prefix:, dependency_globs:, &build)
@dir = dir
@filename_prefix = filename_prefix
@dependency_globs = dependency_globs
@build = build
end
def path(digest = self.digest)
Rails.root.join(@dir, "#{@filename_prefix}-#{digest}.js")
end
def precompiled?
File.exist?(path)
end
def load_or_build
@loaded_digest = digest
cache_path = path(@loaded_digest)
return File.read(cache_path) if File.exist?(cache_path)
with_lock do
return File.read(cache_path) if File.exist?(cache_path)
verify_node_modules!
source = @build.call
FileUtils.mkdir_p(File.dirname(cache_path))
Discourse::Utils.atomic_write_file(cache_path, source)
cleanup_old(cache_path)
source
end
end
private
def verify_node_modules!
installed = Rails.root.join("node_modules/.pnpm/lock.yaml")
lockfile = Rails.root.join("pnpm-lock.yaml")
# pnpm copies only the last document of the lockfile into node_modules
if File.exist?(installed) && File.read(installed) == File.read(lockfile).split(/^---\n/).last
return
end
raise <<~MSG.squish
Cannot build #{@filename_prefix}: node_modules is missing or out of date.
Run `pnpm install`.
MSG
end
def digest
digest = Digest::MD5.new
@dependency_globs.each do |pattern|
files = Dir.glob(pattern, base: Rails.root).sort
raise "No files matched #{pattern}" if files.empty?
files.each do |file|
digest.update(file)
digest.update(File.read(Rails.root.join(file)))
end
end
digest.hexdigest.to_i(16).to_s(36)
end
def with_lock(&block)
lock_path = Rails.root.join(@dir, "build.lock")
FileUtils.mkdir_p(File.dirname(lock_path))
File.open(lock_path, File::CREAT | File::RDWR) do |lock_file|
lock_file.flock(File::LOCK_EX)
yield
end
end
def cleanup_old(keep)
Dir
.glob(Rails.root.join(@dir, "#{@filename_prefix}-*.js"))
.each { |file| File.delete(file) unless file == keep.to_s }
end
end