trmnl_preview 0.15.0 → 0.16.0

data/lib/trmnlp/user_data_assembler.rb

@@ -4,15 +4,20 @@ require 'active_support'
 require 'active_support/time'
 require 'json'
 
+require_relative 'merged_plugin_locals'
+require_relative 'transform_state'
+
 module TRMNLP
   class UserDataAssembler
     DEFAULT_DEVICE_WIDTH = 800
     DEFAULT_DEVICE_HEIGHT = 480
 
-    def initialize(config:, paths:, transform_pipeline:)
+    def initialize(config:, paths:, transform_pipeline:, oauth_session: nil)
       @config = config
       @paths = paths
       @transform_pipeline = transform_pipeline
+      @oauth_session = oauth_session
+      @transform_state = TransformState.new(paths:)
     end
 
     # Assembles the merged data hash. The trmnl namespace is built first,
@@ -21,41 +26,61 @@ module TRMNLP
     # (overrides included) is re-applied after the transform so it
     # survives even when the transform doesn't pass it through.
     def call(device: {})
-      namespace = base_trmnl_data(device:)
-      merged = assemble(namespace)
-      result = transform_pipeline.call(transform_input(merged))
-      result['trmnl'] = merged['trmnl']
+      merged = assemble(base_trmnl_data(device:), source_data)
+      runs_transform = config.plugin.transforms_on_render? && transform_pipeline.configured?
+      result = runs_transform ? transform_pipeline.call(transform_input(merged)) : merged.except('trmnl')
+      # The markup renders the state this run's transform kept, as on TRMNL.
+      result['trmnl'] = merged['trmnl'].merge('state' => transform_state.read)
       result
     end
 
+    def transform_webhook_post(merge_variables)
+      transform_pipeline.call(transform_input(assemble(base_trmnl_data(device: {}), merge_variables)))
+    end
+
+    # What a polling url, its headers and its body render with on TRMNL.
+    def polling_variables = assemble(base_trmnl_data(device: {}), {}).slice('trmnl')
+
     def device_from_params(params)
-      { 'width' => params[:width]&.to_i, 'height' => params[:height]&.to_i,
-        'model' => params[:model], 'bit_depth' => params[:bit_depth]&.to_i }.compact
+      { 'width' => params[:width]&.to_i, 'height' => params[:height]&.to_i, 'model' => params[:model],
+        'bit_depth' => params[:bit_depth]&.to_i, 'orientation' => params[:orientation] }.compact
     end
 
     private
 
-    attr_reader :config, :paths, :transform_pipeline
+    attr_reader :config, :paths, :transform_pipeline, :transform_state, :oauth_session
 
-    def assemble(namespace)
-      data = namespace.dup
-      merge_source_data!(data)
-      data.deep_merge!(config.project.user_data_overrides)
-      data
+    # The trmnl namespace wins over a trmnl key in the fetched data, as on TRMNL; only .trmnlp.yml overrides it.
+    def assemble(namespace, source)
+      source.merge(namespace).deep_merge(config.project.user_data_overrides)
     end
 
-    # The hosted service exposes only user/device/plugin_settings to the
+    # The hosted service exposes only user/device/plugin_settings/state to the
     # transform; the system namespace is added afterward. Mirror that slice
     # so transforms behave the same locally as in production.
     def transform_input(merged)
-      merged.merge('trmnl' => merged['trmnl'].slice('user', 'device', 'plugin_settings'))
+      trmnl = merged['trmnl'].slice('user', 'device', 'plugin_settings', 'state')
+      trmnl['previous_merge_variables'] = previous_merge_variables
+      oauth = oauth_for_transform
+      trmnl['oauth'] = oauth unless oauth.empty?
+      merged.merge('trmnl' => trmnl)
     end
 
-    def merge_source_data!(data)
+    # The connected account's token, so a transform can make its own authenticated calls.
+    def oauth_for_transform = (oauth_session&.liquid_variables || {}).transform_keys { it.delete_prefix('oauth_') }
+
+    # What the last run stored for the markup: a webhook's stored data, otherwise the last transform output.
+    def previous_merge_variables = config.plugin.webhook? ? source_data : transform_pipeline.previous_output
+
+    def source_data
       if config.plugin.static?
-        data.merge!(config.plugin.static_data)
+        config.plugin.static_data
+      elsif config.plugin.plugin_merge?
+        MergedPluginLocals.new(config:, paths:).call
       elsif paths.user_data.exist?
-        data.merge!(JSON.parse(paths.user_data.read))
+        JSON.parse(paths.user_data.read)
+      else
+        {}
       end
     end
 
@@ -68,7 +93,8 @@ module TRMNLP
         'user' => user_namespace,
         'device' => device_namespace(device),
         'system' => { 'timestamp_utc' => Time.now.utc.to_i },
-        'plugin_settings' => plugin_settings_namespace
+        'plugin_settings' => plugin_settings_namespace,
+        'state' => transform_state.read
       }
     end
 
@@ -89,21 +115,33 @@ module TRMNLP
         'height' => device['height'] || DEFAULT_DEVICE_HEIGHT,
         'width' => device['width'] || DEFAULT_DEVICE_WIDTH,
         'model' => device['model'] || 'og_plus', 'bit_depth' => device['bit_depth'] || 2,
-        'firmware_version' => '1.6.3', 'refresh_interval_seconds' => 900,
+        'orientation' => device['orientation'] || 'landscape',
+        'firmware_version' => '1.8.17', 'refresh_interval_seconds' => 900,
         'sleep_mode_enabled' => false, 'sleep_start_time' => 1320, 'sleep_end_time' => 480
       }
     end
 
     def plugin_settings_namespace
       {
-        'instance_name' => 'instance_name',
+        'instance_name' => config.plugin.settings['name'],
         'refresh_interval_minutes' => config.plugin.refresh_interval,
         'strategy' => config.plugin.strategy,
         'dark_mode' => config.plugin.dark_mode,
-        'polling_headers' => config.plugin.polling_headers_encoded,
-        'polling_url' => config.plugin.polling_url_text,
-        'custom_fields_values' => config.project.custom_fields
-      }
+        'no_screen_padding' => config.plugin.no_screen_padding
+      }.merge(custom_fields_setting, polling_url_setting, data_fetched_setting)
+    end
+
+    def custom_fields_setting
+      values = config.plugin.custom_fields_values
+      values.empty? ? {} : { 'custom_fields_values' => values }
+    end
+
+    # The polling url can carry the author's API key, so TRMNL exposes it only to a polling plugin.
+    def polling_url_setting = config.plugin.polling? ? { 'polling_url' => config.plugin.polling_url_text } : {}
+
+    def data_fetched_setting
+      fetched = !config.plugin.static? && paths.user_data.exist?
+      fetched ? { 'data_fetched_utc' => paths.user_data.mtime.to_i } : {}
     end
   end
 end

data/lib/trmnlp/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module TRMNLP
-  VERSION = '0.15.0'
+  VERSION = '0.16.0'
 end

data/lib/trmnlp/watcher.rb

@@ -67,7 +67,8 @@ module TRMNLP
     # NOTE: transform.* changes don't trigger a re-poll — the transform
     # runs inside user_data on every render against the cached polled
     # response (or static_data), so editing the transform updates the
-    # preview without re-fetching the API.
+    # preview without re-fetching the API. A webhook plugin's transform
+    # runs only when a post arrives, as on TRMNL.
     def notify(changes)
       data = user_data_assembler.call
       return unless @view_change_callback

data/lib/trmnlp/webhook_payload.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+require 'active_support/core_ext/hash/deep_merge'
+require 'json'
+
+module TRMNLP
+  # A webhook post as TRMNL takes it: merge_variables inside an object, merged into the
+  # stored data under merge_strategy, which the body or the query string may carry.
+  class WebhookPayload
+    MERGE_STRATEGIES = [nil, 'replace', 'deep_merge', 'stream'].freeze
+    STORED_SIZE_LIMIT_BYTES = 5 * 1024
+
+    def initialize(body, params = {})
+      @params = params.to_h.merge(body.is_a?(Hash) ? body : {})
+    end
+
+    def rejection
+      strategy = params['merge_strategy']
+      return "Invalid merge_strategy: '#{strategy}'" unless MERGE_STRATEGIES.include?(strategy)
+
+      case merge_variables
+      when Hash then nil
+      when nil, Array then 'Must be nested inside a merge_variables payload object'
+      when String then "Received string: '#{merge_variables}', expecting object"
+      else 'Expected an object payload'
+      end
+    end
+
+    def merge_variables
+      return @merge_variables if defined?(@merge_variables)
+
+      value = params['merge_variables']
+      @merge_variables = value.is_a?(String) ? (parsed_object(value) || value) : value
+    end
+
+    # A serverless webhook merges its transform output in place of the posted merge_variables.
+    def merged_into(stored, incoming = merge_variables)
+      case merge_strategy
+      when 'deep_merge' then stored.deep_merge(incoming)
+      when 'stream' then streamed_into(stored, incoming)
+      else incoming
+      end
+    end
+
+    # TRMNL refuses a post past its plan's limit; trmnlp cannot know the plan, so it only warns.
+    def size_warning(merged)
+      size = JSON.generate(merged).bytesize
+      "#{size} bytes stored; TRMNL rejects more than 5 kB (10 kB with TRMNL+)" if size > STORED_SIZE_LIMIT_BYTES
+    end
+
+    private
+
+    attr_reader :params
+
+    def merge_strategy = params['deep_merge'].to_s == 'true' ? 'deep_merge' : params['merge_strategy']
+
+    def parsed_object(text)
+      parsed = JSON.parse(text)
+      parsed if parsed.is_a?(Hash)
+    rescue JSON::ParserError
+      nil
+    end
+
+    def streamed_into(stored, incoming)
+      limit = params['stream_limit'].to_i
+      incoming.to_h do |key, value|
+        next [key, value] unless stored[key].is_a?(Array) && value.is_a?(Array)
+
+        combined = stored[key] + value
+        [key, limit.positive? ? combined.last(limit) : combined]
+      end
+    end
+  end
+end

data/lib/trmnlp/webhook_receiver.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+require 'json'
+
+require_relative 'reporter'
+require_relative 'webhook_payload'
+
+module TRMNLP
+  # Takes a webhook post the way TRMNL does: a serverless plugin transforms the post once, as it
+  # arrives, and the result is merged into the stored data. Answers TRMNL's status and JSON body.
+  class WebhookReceiver
+    MAX_SERVERLESS_INCOMING_BYTES = 1024 * 1024
+
+    def initialize(paths:, transform_pipeline:, user_data_assembler:, reporter: Reporter.new)
+      @paths = paths
+      @transform_pipeline = transform_pipeline
+      @user_data_assembler = user_data_assembler
+      @reporter = reporter
+    end
+
+    def call(body, params = {})
+      payload = WebhookPayload.new(JSON.parse(body), params)
+      return reject(payload, payload.rejection) if payload.rejection
+      return store(payload, payload.merge_variables) unless transform_pipeline.configured?
+
+      transform_and_store(payload)
+    rescue JSON::ParserError => e
+      report_warning(e.message)
+      [400, { message: e.message }]
+    end
+
+    private
+
+    attr_reader :paths, :transform_pipeline, :user_data_assembler, :reporter
+
+    def transform_and_store(payload)
+      oversized = serverless_size_rejection(payload)
+      return reject(payload, oversized) if oversized
+
+      transformed = user_data_assembler.transform_webhook_post(payload.merge_variables)
+      # TRMNL answers before its transform runs, so a failure keeps the stored data and never reaches the poster.
+      if transform_pipeline.error
+        report_warning("Transform failed: #{transform_pipeline.error}")
+      else
+        store(payload, transformed)
+      end
+      [200, { message: nil, merge_variables: payload.merge_variables, processing: 'serverless' }]
+    end
+
+    def serverless_size_rejection(payload)
+      size = JSON.generate(payload.merge_variables).bytesize
+      "Large payload received (#{size} bytes), should be less than 1mb." if size > MAX_SERVERLESS_INCOMING_BYTES
+    end
+
+    def store(payload, incoming)
+      merged = payload.merged_into(stored_data, incoming)
+      payload.size_warning(merged)&.then { report_warning(it) }
+      paths.user_data.dirname.mkpath
+      paths.user_data.write(JSON.generate(merged))
+      [200, { message: nil, merge_variables: merged }]
+    end
+
+    def reject(payload, message)
+      report_warning(message)
+      posted = payload.merge_variables.nil? ? [] : payload.merge_variables
+      [422, { message:, merge_variables: stored_data.empty? ? posted : stored_data }]
+    end
+
+    def stored_data
+      stored = paths.user_data.exist? ? JSON.parse(paths.user_data.read) : {}
+      stored.is_a?(Hash) ? stored : {}
+    rescue JSON::ParserError
+      {}
+    end
+
+    def report_warning(message) = reporter.info(reporter.yellow("webhook warning: #{message}"))
+  end
+end

data/lib/trmnlp.rb

@@ -4,7 +4,7 @@ module TRMNLP; end
 require 'oj'
 require 'trmnl/liquid'
 Oj.mimic_JSON
-TRMNL::Liquid::RailsHelpers = Module.new unless defined?(TRMNL::Liquid::RailsHelpers)
+require_relative 'trmnlp/rails_helpers'
 require_relative 'trmnlp/errors'
 require_relative 'trmnlp/oauth'
 require_relative 'trmnlp/config'

data/trmnl_preview.gemspec

@@ -48,6 +48,7 @@ Gem::Specification.new do |spec|
   # HTML rendering
   spec.add_dependency 'activesupport', '~> 8.0'
   spec.add_dependency 'crass', '~> 1.0'
+  spec.add_dependency 'csv', '~> 3.3'
   spec.add_dependency 'nokogiri', '~> 1.18'
   spec.add_dependency 'trmnl-liquid', '~> 0.8.2'
 

data/web/public/index.js

@@ -23,7 +23,8 @@ trmnlp.connectLiveRender = function () {
 // trmnl.device values the picked model and palette decide.
 trmnlp.deviceParams = function (state) {
   const bitDepth = Math.ceil(Math.log2(state.palette?.grays || 2));
-  return new URLSearchParams({ width: state.width, height: state.height, model: state.model.name, bit_depth: bitDepth });
+  const orientation = state.isPortrait ? 'portrait' : 'landscape';
+  return new URLSearchParams({ width: state.width, height: state.height, model: state.model.name, bit_depth: bitDepth, orientation });
 };
 
 trmnlp.fetchPreview = function (pickerState) {
@@ -31,6 +32,7 @@ trmnlp.fetchPreview = function (pickerState) {
   const screenClasses = (state?.screenClasses || []).join(" ");
   const encodedScreenClasses = encodeURIComponent(screenClasses);
   let src = `/render/${trmnlp.view}.${trmnlp.formatSelect.value}?screen_classes=${encodedScreenClasses}`;
+  if (trmnlp.themeSelect.value) src += `&theme=${encodeURIComponent(trmnlp.themeSelect.value)}`;
 
   // Pass the device for both HTML and PNG renders so trmnl.device.{width,height,model,bit_depth}
   // in the Liquid context tracks the picker model selection.
@@ -38,9 +40,8 @@ trmnlp.fetchPreview = function (pickerState) {
     src += `&${trmnlp.deviceParams(state)}`;
   }
 
-  // PNG-only: dark mode + color depth from palette
+  // PNG-only: color depth from palette
   if (trmnlp.formatSelect.value === 'png' && state) {
-    const isDarkMode = state.isDarkMode ? 1 : 0;
     const grays = state.palette.grays || 2;
     const colorDepth = Math.ceil(Math.log2(grays));
     src += `&color_depth=${colorDepth}`;
@@ -214,9 +215,13 @@ trmnlp.addSelectFieldRow = function (container, key, selectedValue, options) {
   const row = document.createElement('div');
   row.className = 'custom-field-row';
 
-  const optionsHtml = options.map(opt => {
-    const selected = String(opt) === String(selectedValue) ? 'selected' : '';
-    return `<option value="${trmnlp.escapeHtml(String(opt))}" ${selected}>${trmnlp.escapeHtml(String(opt))}</option>`;
+  // Saved as TRMNL saves them: "New York" as new_york, { Label: value } as its value.
+  const choices = options.map(opt => (opt && typeof opt === 'object')
+    ? [String(Object.keys(opt)[0]), String(Object.values(opt)[0])]
+    : [String(opt), String(opt).toLowerCase().replaceAll(' ', '_')]);
+  const optionsHtml = choices.map(([label, value]) => {
+    const selected = [label, value].includes(String(selectedValue)) ? 'selected' : '';
+    return `<option value="${trmnlp.escapeHtml(value)}" ${selected}>${trmnlp.escapeHtml(label)}</option>`;
   }).join('');
 
   row.innerHTML = `
@@ -261,6 +266,7 @@ document.addEventListener("DOMContentLoaded", async function () {
   trmnlp.view = document.querySelector("meta[name='trmnl-view']").content;
   trmnlp.iframe = document.querySelector("iframe");
   trmnlp.formatSelect = document.querySelector(".select-format");
+  trmnlp.themeSelect = document.querySelector("[data-theme-select]");
   trmnlp.userData = document.getElementById("user-data");
   trmnlp.spinner = document.querySelector(".spinner");
   trmnlp.isLiveReloadEnabled =
@@ -278,6 +284,12 @@ document.addEventListener("DOMContentLoaded", async function () {
     trmnlp.fetchPreview();
   });
 
+  trmnlp.themeSelect.value = localStorage.getItem("trmnlp-theme") || "";
+  trmnlp.themeSelect.addEventListener("change", () => {
+    localStorage.setItem("trmnlp-theme", trmnlp.themeSelect.value);
+    trmnlp.fetchPreview();
+  });
+
   trmnlp.iframe.addEventListener("load", () => {
     trmnlp.spinner.style.display = "none";
   });

data/web/views/index.erb

@@ -46,6 +46,13 @@
                     <span data-dark-mode-text>Light Mode</span>
                 </button>
 
+                <select data-theme-select>
+                    <option value="">Default theme</option>
+                    <% TRMNLP::FrameworkVersion::THEMES.each do |id, name| %>
+                    <option value="<%= id %>"><%= name %></option>
+                    <% end %>
+                </select>
+
                 <!-- Optional: Reset button -->
                 <button class="btn" type="button" data-reset-button>Reset</button>
             </form>

data/web/views/render_html.erb

@@ -1,7 +1,43 @@
 <!DOCTYPE html>
 <html>
   <head>
+    <script>
+      const [andXMorePrefix, andXMoreSuffix] = <%= @and_x_more.to_json %>;
+      window.I18n = { andXMore: (count) => `${andXMorePrefix} ${count} ${andXMoreSuffix}` };
+
+      // Copied from TRMNL's plugin_rendering.js: the PNG capture waits for TRMNL_HIGHCHARTS_DONE.
+      document.addEventListener("DOMContentLoaded", () => {
+        if (!window.Highcharts) {
+          window.TRMNL_HIGHCHARTS_DONE = true;
+          return;
+        }
+
+        let counter = 0;
+        const settle = () => {
+          const allReady = Highcharts.charts.every(c => c && c.renderer && c.renderer.boxWrapper);
+          if (!allReady && counter <= 50) return false; // 5 second timeout
+
+          // A chart drawn before the title bar clamped its slot falls back to a 400px height.
+          Highcharts.charts.forEach(c => {
+            if (!c || !c.renderTo) return;
+            const w = c.renderTo.offsetWidth;
+            const h = c.renderTo.offsetHeight;
+            if (h && Math.round(c.chartHeight) !== Math.round(h)) c.setSize(w, h, false);
+          });
+          window.TRMNL_HIGHCHARTS_DONE = true;
+          return true;
+        };
+
+        if (settle()) return;
+
+        const interval = setInterval(() => {
+          counter++;
+          if (settle()) clearInterval(interval);
+        }, 100);
+      });
+    </script>
     <link rel="stylesheet" href="<%= @framework.css_url %>" />
+    <% if @theme_css_url %><link rel="stylesheet" href="<%= @theme_css_url %>" /><% end %>
     <script src="<%= @framework.js_url %>"></script>
     <meta name="trmnl-framework-version" content="<%= @framework.number %>" />
     <meta name="trmnl-framework-pinned" content="<%= @framework.pinned? %>" />

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: trmnl_preview
 version: !ruby/object:Gem::Version
-  version: 0.15.0
+  version: 0.16.0
 platform: ruby
 authors:
 - Rockwell Schrock
@@ -79,6 +79,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: csv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.3'
 - !ruby/object:Gem::Dependency
   name: nokogiri
   requirement: !ruby/object:Gem::Requirement
@@ -302,11 +316,42 @@ files:
 - README.md
 - bin/rake
 - bin/trmnlp
+- db/data/and_x_more.yml
 - db/data/form_fields.yml
 - db/data/framework_versions.yml
+- db/data/locales/cs.yml
+- db/data/locales/da.yml
+- db/data/locales/de-AT.yml
+- db/data/locales/de.yml
+- db/data/locales/en-AU.yml
+- db/data/locales/en-GB.yml
+- db/data/locales/en.yml
+- db/data/locales/es-ES.yml
+- db/data/locales/fr.yml
+- db/data/locales/he.yml
+- db/data/locales/hu.yml
+- db/data/locales/id.yml
+- db/data/locales/is.yml
+- db/data/locales/it.yml
+- db/data/locales/ja.yml
+- db/data/locales/ko.yml
+- db/data/locales/lt.yml
+- db/data/locales/nl.yml
+- db/data/locales/no.yml
+- db/data/locales/pl.yml
+- db/data/locales/pt-BR.yml
+- db/data/locales/raw.yml
+- db/data/locales/ro.yml
+- db/data/locales/ru.yml
+- db/data/locales/sk.yml
+- db/data/locales/sv.yml
+- db/data/locales/uk.yml
+- db/data/locales/zh-CN.yml
+- db/data/locales/zh-HK.yml
 - lib/trmnlp.rb
 - lib/trmnlp/api_client.rb
 - lib/trmnlp/app.rb
+- lib/trmnlp/async_callback.rb
 - lib/trmnlp/browser_pool.rb
 - lib/trmnlp/cli.rb
 - lib/trmnlp/commands.rb
@@ -342,6 +387,7 @@ files:
 - lib/trmnlp/lint/checks/layouts_have_content.rb
 - lib/trmnlp/lint/checks/limited_inline_styles.rb
 - lib/trmnlp/lint/checks/no_async_functions.rb
+- lib/trmnlp/lint/checks/no_custom_filters.rb
 - lib/trmnlp/lint/checks/no_opacity.rb
 - lib/trmnlp/lint/checks/no_size_classes.rb
 - lib/trmnlp/lint/checks/recipe_overview_length.rb
@@ -350,6 +396,7 @@ files:
 - lib/trmnlp/lint/checks/waits_for_dom_load.rb
 - lib/trmnlp/lint/diagnostic.rb
 - lib/trmnlp/lint/source.rb
+- lib/trmnlp/merged_plugin_locals.rb
 - lib/trmnlp/oauth.rb
 - lib/trmnlp/oauth/client.rb
 - lib/trmnlp/oauth/pkce.rb
@@ -357,22 +404,28 @@ files:
 - lib/trmnlp/oauth/session.rb
 - lib/trmnlp/oauth/token_bundle.rb
 - lib/trmnlp/oauth/token_store.rb
+- lib/trmnlp/outbound_request.rb
 - lib/trmnlp/paths.rb
 - lib/trmnlp/poller.rb
+- lib/trmnlp/rails_helpers.rb
 - lib/trmnlp/renderer.rb
 - lib/trmnlp/reporter.rb
 - lib/trmnlp/screen.rb
 - lib/trmnlp/screen_generator.rb
 - lib/trmnlp/screenshot.rb
+- lib/trmnlp/select_field_choices.rb
 - lib/trmnlp/transform_backend/http.rb
 - lib/trmnlp/transform_backend/subprocess.rb
 - lib/trmnlp/transform_backend/which.rb
 - lib/trmnlp/transform_backend/wrapper.rb
 - lib/trmnlp/transform_client.rb
 - lib/trmnlp/transform_pipeline.rb
+- lib/trmnlp/transform_state.rb
 - lib/trmnlp/user_data_assembler.rb
 - lib/trmnlp/version.rb
 - lib/trmnlp/watcher.rb
+- lib/trmnlp/webhook_payload.rb
+- lib/trmnlp/webhook_receiver.rb
 - templates/init/.github/workflows/trmnl.yml
 - templates/init/.gitignore
 - templates/init/.trmnlp.yml