product_tours 0.1.0

data/lib/product_tours/video_metadata.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'net/http'
+require 'uri'
+
+module ProductTours
+  class VideoMetadata
+    ENDPOINTS = {
+      'youtube' => 'https://www.youtube.com/oembed',
+      'vimeo' => 'https://vimeo.com/api/oembed.json',
+      'loom' => 'https://www.loom.com/v1/oembed'
+    }.freeze
+
+    def self.fetch(url)
+      new(url).fetch
+    end
+
+    def initialize(url)
+      @url = url.to_s
+    end
+
+    def fetch
+      resolved = VideoResolver.resolve(@url)
+      return {} unless resolved
+
+      metadata = resolved.metadata
+      endpoint = ENDPOINTS[resolved.provider]
+      return metadata unless endpoint
+
+      response = request(endpoint)
+      return metadata unless response.is_a?(Net::HTTPSuccess)
+
+      body = JSON.parse(response.body)
+      metadata.merge(
+        'provider_title' => body['title'].presence,
+        'thumbnail_url' => safe_https_url(body['thumbnail_url'])
+      ).compact
+    rescue JSON::ParserError, IOError, SocketError, SystemCallError, Timeout::Error, OpenSSL::SSL::SSLError
+      metadata || {}
+    end
+
+    private
+
+    def request(endpoint)
+      uri = URI(endpoint)
+      uri.query = URI.encode_www_form(url: @url, format: 'json')
+      Net::HTTP.start(uri.host, uri.port, use_ssl: true, open_timeout: 3, read_timeout: 4) do |http|
+        http.get(uri.request_uri, { 'User-Agent' => "product_tours/#{ProductTours::VERSION}" })
+      end
+    end
+
+    def safe_https_url(value)
+      uri = URI.parse(value.to_s)
+      uri.to_s if uri.is_a?(URI::HTTPS) && uri.host.present? && uri.userinfo.nil?
+    rescue URI::InvalidURIError
+      nil
+    end
+  end
+end

data/lib/product_tours/video_resolver.rb

@@ -0,0 +1,129 @@
+# frozen_string_literal: true
+
+require 'uri'
+
+module ProductTours
+  class VideoResolver
+    Result = Data.define(:kind, :provider, :provider_id, :url) do
+      def iframe? = kind == 'iframe'
+      def direct? = kind == 'direct'
+
+      def metadata
+        {
+          'provider' => provider,
+          'provider_id' => provider_id,
+          'embed_url' => iframe? ? url : nil
+        }.compact
+      end
+    end
+
+    YOUTUBE_HOSTS = %w[youtube.com www.youtube.com m.youtube.com youtu.be youtube-nocookie.com
+                       www.youtube-nocookie.com].freeze
+    VIMEO_HOSTS = %w[vimeo.com www.vimeo.com player.vimeo.com].freeze
+    LOOM_HOSTS = %w[loom.com www.loom.com].freeze
+    TELLA_HOSTS = %w[tella.tv www.tella.tv].freeze
+    VOOMLY_HOSTS = %w[share.voomly.com embed.voomly.com app.voomly.com voomly.com www.voomly.com].freeze
+
+    def self.resolve(url)
+      new(url).resolve
+    end
+
+    def initialize(url)
+      @url = url.to_s.strip
+    end
+
+    def resolve
+      uri = URI.parse(@url)
+      return unless uri.is_a?(URI::HTTPS) && uri.host.present? && uri.userinfo.nil?
+
+      case uri.host.downcase
+      when *YOUTUBE_HOSTS then youtube(uri)
+      when *VIMEO_HOSTS then vimeo(uri)
+      when *LOOM_HOSTS then loom(uri)
+      when *TELLA_HOSTS then tella(uri)
+      when *VOOMLY_HOSTS then voomly(uri)
+      else direct(uri)
+      end
+    rescue URI::InvalidURIError, ArgumentError
+      nil
+    end
+
+    private
+
+    def youtube(uri)
+      id = if uri.host.downcase == 'youtu.be'
+             segments(uri).first
+           elsif uri.path == '/watch'
+             query(uri)['v']
+           else
+             match = uri.path.match(%r{\A/(?:embed|shorts|live)/([A-Za-z0-9_-]+)})
+             match && match[1]
+           end
+      return unless id&.match?(/\A[A-Za-z0-9_-]{6,20}\z/)
+
+      Result.new(kind: 'iframe', provider: 'youtube', provider_id: id,
+                 url: "https://www.youtube-nocookie.com/embed/#{id}?rel=0&modestbranding=1")
+    end
+
+    def vimeo(uri)
+      parts = segments(uri)
+      parts.shift if parts.first == 'video'
+      id = parts.shift
+      return unless id&.match?(/\A\d+\z/)
+
+      privacy_hash = query(uri)['h'].presence || parts.first.to_s.presence
+      return if privacy_hash && !privacy_hash.match?(/\A[A-Za-z0-9]+\z/)
+
+      embed_url = "https://player.vimeo.com/video/#{id}"
+      embed_url += "?h=#{URI.encode_www_form_component(privacy_hash)}" if privacy_hash
+      Result.new(kind: 'iframe', provider: 'vimeo', provider_id: id, url: embed_url)
+    end
+
+    def loom(uri)
+      match = uri.path.match(%r{\A/(?:share|embed)/([A-Za-z0-9_-]{8,64})/?\z})
+      return unless match
+
+      id = match[1]
+      Result.new(kind: 'iframe', provider: 'loom', provider_id: id,
+                 url: "https://www.loom.com/embed/#{id}")
+    end
+
+    def tella(uri)
+      match = uri.path.match(%r{\A/video/([A-Za-z0-9_-]{3,100})(?:/(?:view|embed))?/?\z})
+      return unless match
+
+      id = match[1]
+      Result.new(kind: 'iframe', provider: 'tella', provider_id: id,
+                 url: "https://www.tella.tv/video/#{id}/embed")
+    end
+
+    def voomly(uri)
+      id = if uri.host.downcase == 'embed.voomly.com' && uri.path == '/embed/assets/embed.html'
+             query(uri)['videoId']
+           else
+             uri.path.match(%r{\A/(?:v|video)/([A-Za-z0-9_-]{6,160})/?\z})&.[](1)
+           end
+      return unless id&.match?(/\A[A-Za-z0-9_-]{6,160}\z/)
+
+      embed = 'https://embed.voomly.com/embed/assets/embed.html?' \
+              "videoId=#{URI.encode_www_form_component(id)}&videoRatio=1.777778&type=v"
+      Result.new(kind: 'iframe', provider: 'voomly', provider_id: id, url: embed)
+    end
+
+    def direct(uri)
+      return unless uri.path.match?(/\.(?:mp4|webm)\z/i)
+
+      Result.new(kind: 'direct', provider: 'direct', provider_id: nil, url: uri.to_s)
+    end
+
+    def segments(uri)
+      uri.path.split('/').reject(&:blank?)
+    end
+
+    def query(uri)
+      URI.decode_www_form(uri.query.to_s).to_h
+    rescue ArgumentError
+      {}
+    end
+  end
+end

data/lib/product_tours/widget.js

@@ -0,0 +1,359 @@
+/* product_tours widget: delegated modal tutorials, no framework or build step. */
+(function () {
+  "use strict";
+
+  if (window.__productToursLoaded) return;
+  window.__productToursLoaded = true;
+
+  var config = readConfig();
+  var overlay = null;
+  var dialog = null;
+  var closeButton = null;
+  var session = null;
+  var currentPost = null;
+  var history = [];
+  var lastFocused = null;
+  var savedOverflow = null;
+  var viewportHandler = null;
+
+  document.addEventListener("click", handleTrigger, true);
+  document.addEventListener("keydown", handleKeydown);
+  document.addEventListener("turbo:load", function () { config = readConfig() || config; });
+  document.addEventListener("turbo:before-render", function () { close(false); });
+
+  function readConfig() {
+    var node = document.querySelector("script[data-product-tours-config]");
+    if (!node) return null;
+    try { return JSON.parse(node.textContent); } catch (_error) { return null; }
+  }
+
+  function handleTrigger(event) {
+    var trigger = event.target && event.target.closest
+      ? event.target.closest("[data-product-tour]")
+      : null;
+    if (!trigger) return;
+
+    config = readConfig() || config;
+    if (!config || !config.endpoint) return;
+    event.preventDefault();
+    event.stopPropagation();
+    resolve(trigger.getAttribute("data-product-tour"), trigger);
+  }
+
+  function resolve(key, trigger) {
+    if (!key || overlay) return;
+    fetchPost(key, config.locale)
+      .then(function (post) { open(post, trigger); })
+      .catch(reportError);
+  }
+
+  function fetchPost(key, locale) {
+    var url = config.endpoint + "/post?" + params({ key: key, locale: locale, page_url: window.location.href });
+    return fetch(url, { headers: { Accept: "application/json" }, credentials: "same-origin" })
+      .then(function (response) {
+        if (!response.ok) throw new Error("Product tour " + JSON.stringify(key) + " could not be resolved (HTTP " + response.status + ")");
+        return response.json();
+      });
+  }
+
+  function reportError(error) {
+    if (window.console && console.error) console.error("product_tours:", error.message);
+  }
+
+  function open(post, trigger) {
+    if (overlay) return;
+    injectStyles();
+    lastFocused = trigger || document.activeElement;
+    history = [];
+
+    overlay = element("div", "pt-overlay");
+    overlay.id = "product-tours-overlay";
+    overlay.addEventListener("mousedown", function (event) {
+      if (event.target === overlay) close(true);
+    });
+    overlay.addEventListener("keydown", trapFocus);
+
+    dialog = element("div", "pt-dialog");
+    dialog.setAttribute("role", "dialog");
+    dialog.setAttribute("aria-modal", "true");
+    dialog.setAttribute("aria-labelledby", "product-tours-title");
+    dialog.setAttribute("aria-label", config.labels.dialog);
+    dialog.tabIndex = -1;
+    if (config.rtl) dialog.setAttribute("dir", "rtl");
+
+    overlay.appendChild(dialog);
+    document.body.appendChild(overlay);
+    lockScroll();
+    startViewportTracking();
+    renderPost(post, "modal");
+  }
+
+  function renderPost(post, source) {
+    if (!dialog) return;
+    var existing = dialog.querySelector(".pt-content");
+    if (existing) existing.remove();
+    currentPost = post;
+    session = { key: post.key, locale: post.locale, completed: false, viewed: false };
+
+    var content = element("div", "pt-content");
+    var head = element("div", "pt-head");
+    var title = element("h2", "pt-title", post.title);
+    title.id = "product-tours-title";
+    head.appendChild(title);
+
+    closeButton = element("button", "pt-close", "\u00d7");
+    closeButton.type = "button";
+    closeButton.setAttribute("aria-label", config.labels.close);
+    closeButton.addEventListener("click", function () { close(true); });
+    head.appendChild(closeButton);
+    content.appendChild(head);
+
+    if (post.video && post.video.url) content.appendChild(videoNode(post.video, post.title));
+
+    if (post.descriptionHtml) {
+      var description = element("div", "pt-description");
+      description.innerHTML = post.descriptionHtml;
+      content.appendChild(description);
+    }
+
+    var error = element("p", "pt-error");
+    error.setAttribute("role", "alert");
+    error.hidden = true;
+    content.appendChild(error);
+
+    var actions = element("div", "pt-actions");
+    if (history.length) {
+      var back = element("button", "pt-back", config.labels.back);
+      back.type = "button";
+      back.addEventListener("click", function () {
+        renderPost(history.pop(), "back");
+      });
+      actions.appendChild(back);
+    }
+
+    var action = element("button", "pt-primary", (post.action && post.action.label) || config.labels.done);
+    action.type = "button";
+    action.addEventListener("click", function () {
+      var nextKey = post.action && post.action.postKey;
+      if (nextKey) {
+        action.disabled = true;
+        action.setAttribute("aria-busy", "true");
+        fetchPost(nextKey, post.locale).then(function (nextPost) {
+          var repeated = currentPost && currentPost.key === nextPost.key;
+          repeated = repeated || history.some(function (visited) { return visited.key === nextPost.key; });
+          if (repeated) throw new Error("Product tour link would create a navigation cycle");
+          complete("linked_post");
+          history.push(post);
+          renderPost(nextPost, "linked_post");
+        }).catch(function (fetchError) {
+          reportError(fetchError);
+          error.textContent = config.labels.unavailable;
+          error.hidden = false;
+          action.disabled = false;
+          action.removeAttribute("aria-busy");
+        });
+        return;
+      }
+
+      complete("action");
+      var target = post.action && post.action.url;
+      close(false);
+      if (target) window.location.assign(target);
+    });
+    actions.appendChild(action);
+    content.appendChild(actions);
+    dialog.appendChild(content);
+
+    window.requestAnimationFrame(function () {
+      if (!overlay || !dialog.getClientRects().length) return;
+      closeButton.focus();
+      if (document.activeElement && overlay.contains(document.activeElement)) {
+        session.viewed = true;
+        sendSignal("viewed", source || "modal");
+      }
+    });
+  }
+
+  function videoNode(video, title) {
+    var frame = element("div", "pt-video");
+    if (video.kind === "iframe") {
+      var iframe = document.createElement("iframe");
+      iframe.src = video.url;
+      iframe.title = title || config.labels.video;
+      iframe.loading = "eager";
+      iframe.allow = "accelerometer; autoplay; clipboard-write; encrypted-media; fullscreen; gyroscope; picture-in-picture";
+      iframe.setAttribute("allowfullscreen", "");
+      iframe.referrerPolicy = "strict-origin-when-cross-origin";
+      frame.appendChild(iframe);
+    } else {
+      var player = document.createElement("video");
+      player.src = video.url;
+      player.controls = true;
+      player.playsInline = true;
+      player.preload = "metadata";
+      showFirstVideoFrame(player);
+      frame.appendChild(player);
+    }
+    return frame;
+  }
+
+  function showFirstVideoFrame(player) {
+    function seek() {
+      if (!Number.isFinite(player.duration) || player.duration <= 0 || player.currentTime > 0) return;
+      try { player.currentTime = Math.min(0.1, player.duration / 2); } catch (_error) {}
+    }
+    player.addEventListener("loadedmetadata", seek, { once: true });
+    if (player.readyState >= 1) seek();
+  }
+
+  function handleKeydown(event) {
+    if (event.key === "Escape" && overlay) close(true);
+  }
+
+  function trapFocus(event) {
+    if (event.key !== "Tab" || !overlay) return;
+    var focusable = overlay.querySelectorAll("button, a[href], video[controls], [tabindex]:not([tabindex='-1'])");
+    if (!focusable.length) return;
+    var first = focusable[0];
+    var last = focusable[focusable.length - 1];
+    if (event.shiftKey && document.activeElement === first) {
+      event.preventDefault();
+      last.focus();
+    } else if (!event.shiftKey && document.activeElement === last) {
+      event.preventDefault();
+      first.focus();
+    }
+  }
+
+  function close(reportDismissal) {
+    if (!overlay) return;
+    if (reportDismissal && session && session.viewed && !session.completed) sendSignal("dismissed", "modal");
+    stopViewportTracking();
+    overlay.remove();
+    overlay = null;
+    dialog = null;
+    closeButton = null;
+    session = null;
+    currentPost = null;
+    history = [];
+    unlockScroll();
+    if (lastFocused && lastFocused.focus) lastFocused.focus();
+    lastFocused = null;
+  }
+
+  function sendSignal(action, source) {
+    if (!session || !config) return;
+    var body = {
+      key: session.key,
+      locale: session.locale,
+      event_action: action,
+      source: source,
+      page_url: window.location.href
+    };
+    fetch(config.endpoint + "/signal", {
+      method: "POST",
+      credentials: "same-origin",
+      keepalive: true,
+      headers: { "Content-Type": "application/json", "X-CSRF-Token": csrfToken(), Accept: "application/json" },
+      body: JSON.stringify(body)
+    }).catch(function () {});
+  }
+
+  function complete(source) {
+    if (!session || session.completed) return;
+    session.completed = true;
+    sendSignal("completed", source);
+  }
+
+  function csrfToken() {
+    var meta = document.querySelector("meta[name='csrf-token']");
+    return meta ? meta.content : "";
+  }
+
+  function params(values) {
+    return Object.keys(values).map(function (key) {
+      return encodeURIComponent(key) + "=" + encodeURIComponent(values[key] || "");
+    }).join("&");
+  }
+
+  function element(tag, className, text) {
+    var node = document.createElement(tag);
+    node.className = className;
+    if (text !== undefined) node.textContent = text;
+    return node;
+  }
+
+  function lockScroll() {
+    if (savedOverflow === null) savedOverflow = document.documentElement.style.overflow;
+    document.documentElement.style.overflow = "hidden";
+  }
+
+  function unlockScroll() {
+    if (savedOverflow === null) return;
+    document.documentElement.style.overflow = savedOverflow;
+    savedOverflow = null;
+  }
+
+  function applyViewport() {
+    if (!overlay) return;
+    var viewport = window.visualViewport;
+    var dialog = overlay.querySelector(".pt-dialog");
+    if (viewport && window.matchMedia("(max-width: 480px)").matches) {
+      overlay.style.top = viewport.offsetTop + "px";
+      overlay.style.height = viewport.height + "px";
+      overlay.style.bottom = "auto";
+      if (dialog) dialog.style.height = viewport.height + "px";
+    } else {
+      overlay.style.top = "";
+      overlay.style.height = "";
+      overlay.style.bottom = "";
+      if (dialog) dialog.style.height = "";
+    }
+  }
+
+  function startViewportTracking() {
+    if (!window.visualViewport) return;
+    viewportHandler = applyViewport;
+    window.visualViewport.addEventListener("resize", viewportHandler);
+    window.visualViewport.addEventListener("scroll", viewportHandler);
+    applyViewport();
+  }
+
+  function stopViewportTracking() {
+    if (viewportHandler && window.visualViewport) {
+      window.visualViewport.removeEventListener("resize", viewportHandler);
+      window.visualViewport.removeEventListener("scroll", viewportHandler);
+    }
+    viewportHandler = null;
+  }
+
+  function injectStyles() {
+    var css = [
+      ".pt-overlay{position:fixed;inset:0;z-index:2147482000;background:rgba(0,0,0,.45);display:flex;align-items:center;justify-content:center;padding:16px}",
+      ".pt-overlay,.pt-overlay *{box-sizing:border-box}",
+      ".pt-dialog{width:100%;max-width:440px;max-height:92vh;overflow:auto;overscroll-behavior:contain;background:#fff;color:#1c2024;border-radius:14px;padding:20px;font:14px/1.5 system-ui,-apple-system,sans-serif;box-shadow:0 20px 60px rgba(0,0,0,.35);outline:none}",
+      ".pt-head{display:flex;align-items:flex-start;justify-content:space-between;gap:8px;margin:0 0 12px}",
+      ".pt-title{margin:0;font-size:17px;line-height:1.5;font-weight:700;overflow-wrap:anywhere}",
+      ".pt-close{border:0;background:none;font-size:22px;line-height:1;cursor:pointer;color:inherit;padding:2px 6px}",
+      ".pt-close:focus-visible,.pt-primary:focus-visible,.pt-back:focus-visible{outline:2px solid #2563eb;outline-offset:2px}",
+      ".pt-video{position:relative;width:100%;aspect-ratio:16/9;margin:0 0 12px;overflow:hidden;border-radius:10px;background:#000}",
+      ".pt-video iframe,.pt-video video{display:block;width:100%;height:100%;border:0;object-fit:contain}",
+      ".pt-description{color:inherit;overflow-wrap:anywhere}.pt-description>*:first-child{margin-top:0}.pt-description>*:last-child{margin-bottom:0}.pt-description a{color:#2563eb}",
+      ".pt-error{color:#dc2626;margin:0 0 12px}.pt-error[hidden]{display:none}",
+      ".pt-actions{display:flex;align-items:center;justify-content:flex-end;gap:8px;flex-wrap:wrap;margin-top:12px}",
+      ".pt-primary,.pt-back{padding:8px 14px;border-radius:8px;cursor:pointer;font:inherit}",
+      ".pt-primary{border:0;background:#2563eb;color:#fff;font-weight:600}.pt-primary:hover{background:#1d4ed8}.pt-primary:disabled{opacity:.6;cursor:default}",
+      ".pt-back{margin-inline-end:auto;border:1px solid #d1d5db;background:none;color:inherit}.pt-back:hover{background:rgba(37,99,235,.07)}",
+      "@media (prefers-color-scheme:dark){.pt-dialog{background:#1a1f26;color:#e6e8ea}.pt-back{border-color:#2a313a}.pt-description{color:#e6e8ea}}",
+      "@media (max-width:480px){.pt-overlay{padding:0;align-items:stretch;justify-content:stretch}.pt-dialog{left:0;right:0;top:0;bottom:0;width:100%;max-width:none;height:100vh;height:100dvh;max-height:100dvh;border-radius:0;margin:0}.pt-actions{padding-bottom:calc(0px + env(safe-area-inset-bottom))}.pt-primary,.pt-back{font-size:16px}}"
+    ].join("");
+    var existing = document.getElementById("product-tours-styles");
+    if (existing && existing.textContent === css) return;
+    if (existing) existing.remove();
+
+    var style = document.createElement("style");
+    style.id = "product-tours-styles";
+    style.textContent = css;
+    document.head.appendChild(style);
+  }
+})();

data/lib/product_tours/widget.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+require 'digest'
+require 'json'
+
+module ProductTours
+  module Widget
+    SOURCE = File.expand_path('widget.js', __dir__)
+    DASHBOARD_SOURCE = File.expand_path('dashboard.js', __dir__)
+    DASHBOARD_STYLESHEET_SOURCE = File.expand_path('dashboard.css', __dir__)
+    RTL_LANGUAGES = %w[ar arc ckb dv fa ha he ks ku ps sd ug ur yi].freeze
+
+    class << self
+      def javascript = @javascript ||= File.read(SOURCE)
+      def dashboard_javascript = @dashboard_javascript ||= File.read(DASHBOARD_SOURCE)
+      def dashboard_stylesheet = @dashboard_stylesheet ||= File.read(DASHBOARD_STYLESHEET_SOURCE)
+      def fingerprint = @fingerprint ||= Digest::MD5.hexdigest(javascript)
+      def dashboard_fingerprint = @dashboard_fingerprint ||= Digest::MD5.hexdigest(dashboard_javascript)
+      def dashboard_stylesheet_fingerprint = @dashboard_stylesheet_fingerprint ||= Digest::MD5.hexdigest(dashboard_stylesheet)
+
+      def snippet(locale:, nonce: nil)
+        nonce_attr = nonce ? %( nonce="#{ERB::Util.html_escape(nonce)}") : ''
+        source = "#{ProductTours.config.mount_path.to_s.chomp('/')}/widget.js?v=#{fingerprint}"
+        %(<script type="application/json" data-product-tours-config>#{config_json(locale:)}</script>) +
+          %(<script src="#{ERB::Util.html_escape(source)}" defer#{nonce_attr} data-product-tours-widget></script>)
+      end
+
+      def config_json(locale:)
+        {
+          endpoint: ProductTours.config.widget_endpoint,
+          locale: locale.to_s,
+          rtl: rtl?(locale),
+          labels: labels
+        }.to_json.gsub('</', '<\\/')
+      end
+
+      private
+
+      def labels
+        {
+          close: t(:close, 'Close'),
+          back: t(:back, 'Back'),
+          done: t(:done, 'Done'),
+          dialog: t(:dialog, 'Product tutorial'),
+          video: t(:video, 'Tutorial video'),
+          unavailable: t(:unavailable, 'This tutorial is unavailable.')
+        }
+      end
+
+      def t(key, default)
+        I18n.t(key, scope: :product_tours, default: default)
+      end
+
+      def rtl?(locale)
+        RTL_LANGUAGES.include?(locale.to_s.downcase.split(/[-_]/).first)
+      end
+    end
+  end
+end

data/lib/product_tours.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require 'product_tours/version'
+require 'product_tours/configuration'
+require 'product_tours/errors'
+require 'product_tours/video_resolver'
+require 'product_tours/video_metadata'
+require 'product_tours/content_security_policy'
+require 'product_tours/widget'
+require 'product_tours/seeds'
+require 'product_tours/engine'
+
+module ProductTours
+  class << self
+    def config
+      @config ||= Configuration.new
+    end
+
+    def configure
+      yield config
+    end
+
+    def enabled?(request)
+      !!config.enabled.call(request)
+    end
+
+    def admin?(request)
+      !!config.authorize_admin.call(request)
+    end
+
+    def locale(_request = nil)
+      I18n.locale.to_s.presence || I18n.default_locale.to_s
+    end
+  end
+end

data/lib/tasks/product_tours_tasks.rake

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+namespace :product_tours do
+  desc 'Create or refresh the multilingual product_tours demo posts'
+  task seed_demo: :environment do
+    posts = ProductTours::Seeds.load_all!
+    locales = ProductTours::Seeds::DEMO_LOCALES.join(', ')
+    puts "Seeded #{posts.size} product tour demo posts for #{locales}."
+    puts "\nCopy this into any ERB view to try them:\n\n"
+    puts ProductTours::Seeds.trigger_html
+  end
+end