fuik 0.5.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 1b6a7e1fbd1184f851bc0d1cd17013aaf4d84575e8e33ad6db6c16b7a428b3c2
+  data.tar.gz: 41ffd19e734216ca8b5503b461ffb600e9749de0610e27899c7b672922a25ae0
+SHA512:
+  metadata.gz: 2f232b48c331815d4aa07fe0796ba7cecddeab26a835950ac1e874c5a602de8a76ad73eedd0c58dfdd0f7f7d6850205989666434ef1e76f3f709cb7297e3c710
+  data.tar.gz: 229f5f61ec154a18e2213f3131150c3013430f1025457db1a91d84cfe4bab680c13cdb815152544b84ae32483bf6a3293c3d00a591b5f08da95258d42e330209

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright Rails Designer
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,165 @@
+# Fuik
+
+**A fish trap for webhooks**
+
+Fuik (Dutch for fish trap) is a Rails engine that catches and stores webhooks from any provider. View all events in the admin interface, then create event classes to add your business logic.
+
+
+**Sponsored By [Rails Designer](https://railsdesigner.com/)**
+
+<a href="https://railsdesigner.com/" target="_blank">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/Rails-Designer/fuik/HEAD/.github/logo-dark.svg">
+    <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/Rails-Designer/fuik/HEAD/.github/logo-light.svg">
+    <img alt="Rails Designer" src="https://raw.githubusercontent.com/Rails-Designer/fuik/HEAD/.github/logo-light.svg" width="240" style="max-width: 100%;">
+  </picture>
+</a>
+
+
+## Quick start
+
+```bash
+# Install
+bundle add fuik
+bin/rails generate fuik:install
+bin/rails db:migrate
+
+# Point your webhook to
+POST https://yourdomain.com/webhooks/stripe
+```
+
+That's it. Webhooks are captured and visible at `/webhooks`.
+
+
+## Installation
+
+Add to your Gemfile:
+```ruby
+gem "fuik"
+```
+
+Then run:
+```bash
+bundle install
+bin/rails generate fuik:install
+bin/rails db:migrate
+```
+
+The engine mounts at `/webhooks` automatically.
+
+
+## Usage
+
+### View events
+
+Visit `/webhooks` to see all received webhooks. Click any event to see the full payload, headers and status.
+
+<img alt="Fuik admin interface" src="https://raw.githubusercontent.com/Rails-Designer/fuik/HEAD/.github/docs/webhooks-index.jpg" style="max-width: 100%;">
+
+
+### Add business logic
+
+Generate event handlers when you're ready to automate:
+```bash
+bin/rails generate fuik:provider stripe checkout_session_completed customer_subscription_updated
+```
+
+This creates:
+- `app/webhooks/stripe/base.rb`
+- `app/webhooks/stripe/checkout_session_completed.rb`
+- `app/webhooks/stripe/customer_subscription_updated.rb`
+
+Each class is a thin wrapper around your business logic:
+```ruby
+module Stripe
+  class CheckoutSessionCompleted < Base
+    def process!
+      User.find_by(id: payload.dig("client_reference_id")).tap do |user|
+        user.activate_subscription!
+        user.send_welcome_email
+
+        # etc.
+      end
+
+      @webhook_event.processed!
+    end
+  end
+end
+```
+
+Implement `Base.verify!` to enable signature verification:
+```ruby
+module Stripe
+  class Base < Fuik::Event
+    def self.verify!(request)
+      secret = Rails.application.credentials.dig(:stripe, :signing_secret)
+      signature = request.headers["Stripe-Signature"]
+
+      Stripe::Webhook.construct_event(
+        request.raw_post,
+        signature,
+        secret
+      )
+    rescue Stripe::SignatureVerificationError => error
+      raise Fuik::InvalidSignature, error.message
+    end
+  end
+end
+```
+
+If `Provider::Base.verify!` exists, Fuik calls it automatically. Invalid signatures return 401 without storing the webhook.
+
+
+### Pre-packaged providers
+
+Fuik includes ready-to-use [templates for common providers](https://github.com/Rails-Desinger/fuik/tree/main/lib/generators/fuik/provider/templates).
+
+
+### Event type & ID lookup
+
+Fuik automatically extracts event types and IDs from common locations:
+
+**Event Type:**
+1. provider config (if exists);
+2. common headers (`X-Github-Event`, `X-Event-Type`, etc.);
+3. payload (`type`, `event`, `event_type`);
+4. falls back to `"unknown"`.
+
+**Event ID:**
+1. provider config (if exists);
+2. common headers (`X-GitHub-Delivery`, `X-Event-Id`, etc.);
+3. payload (`id`).
+4. falls back to MD5 hash of request body.
+
+
+#### Custom lookup via config
+
+Create `app/webhooks/provider_name/config.yml`:
+```yaml
+event_type:
+  source: header
+  key: X-Custom-Event
+
+event_id:
+  source: payload
+  key: custom_id
+```
+
+
+## Add your custom provider
+
+Have a provider template others could use? Add it to [lib/generators/fuik/provider/templates/your_provider/](https://github.com/Rails-Desinger/fuik/tree/main/lib/generators/fuik/provider/templates) and submit a PR!
+
+Include:
+- `base.rb.tt` with signature verification (if applicable);
+- event class templates with helpful TODO comments.
+
+
+## Contributing
+
+This project uses [Standard](https://github.com/testdouble/standard) for formatting Ruby code. Please make sure to run `rake` before submitting pull requests.
+
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new do |t|
+  t.libs << "test"
+
+  t.test_files = FileList["test/**/*_test.rb"]
+  t.verbose = true
+  t.warning = true
+end
+
+require "standard/rake"
+
+task default: %i[test standard]

data/app/assets/stylesheets/fuik/application.css

@@ -0,0 +1,100 @@
+@layer base, components;
+
+@layer base {
+  :root {
+    --color-text: oklch(30% 0.02 250);
+    --color-text-muted: oklch(55% 0.02 250);
+    --color-border: oklch(90% 0.01 250);
+    --color-bg-hover: oklch(97% 0.01 250);
+  }
+
+  * { box-sizing: border-box; }
+
+  body {
+    margin: 0;
+    padding: 2rem;
+    max-inline-size: 80rem;
+    margin-inline: auto;
+    font-family: system-ui, -apple-system, sans-serif;
+    line-height: 1.5;
+    color: var(--color-text);
+  }
+
+  h1 {
+    margin-block-end: 1rem;
+    font-size: 1.875rem;
+    font-weight: 700;
+    letter-spacing: -.025em;
+
+    a {
+      color: var(--color-text-muted);
+
+      &:hover { color: var(--color-text); }
+    }
+  }
+
+  a {
+    color: inherit;
+    text-decoration: none;
+
+    &:hover { text-decoration: underline; }
+  }
+
+  pre {
+    margin: 0;
+    padding-block: .5rem;
+    padding-inline: 1rem;
+    max-height: calc(20lh + 1rem);
+    font-size: .875rem;
+    background: var(--color-bg-hover);
+    border-radius: .5rem;
+    overflow-x: auto;
+  }
+
+  dl {
+    display: grid;
+    grid-template-columns: auto 1fr;
+    gap: 1rem 2rem;
+
+    dt {
+      font-weight: 600;
+      color: var(--color-text);
+    }
+
+    dd { margin: 0; }
+  }
+}
+
+@layer components {
+  article {
+    margin-block-end: 1rem;
+    padding-block: .5rem;
+    padding-inline: .75rem;
+    border: 1px solid var(--color-border);
+    border-radius: .5rem;
+
+    &:hover { background: var(--color-bg-hover); }
+
+    a {
+      display: grid;
+      grid-template-columns: repeat(4, 1fr);
+      gap: 1rem;
+
+      &:hover { text-decoration: none; }
+    }
+  }
+
+  .status {
+    display: flex;
+    align-items: center;
+    column-gap: .375rem;
+
+    &::before { content: "●"; }
+
+    &[data-status="pending"]::before { color: oklch(65% 0.15 75); }
+
+    &[data-status="processed"]::before { color: oklch(65% 0.15 150); }
+
+    &[data-status="failed"]::before { color: oklch(60% 0.2 25); }
+  }
+}

data/app/controllers/concerns/fuik/event_type.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module Fuik
+  module EventType
+    private
+
+    COMMON_EVENT_TYPE_HEADERS = [
+      "X-Github-Event",
+      "X-Event-Type",
+      "X-Webhook-Event"
+    ]
+
+    COMMON_EVENT_ID_HEADERS = [
+      "X-GitHub-Delivery",
+      "X-Event-Id",
+      "X-Webhook-Id"
+    ]
+
+    def event_type
+      from_config("event_type") || from_event_type_headers || from_payload_type || "unknown"
+    end
+
+    def event_id
+      from_config("event_id") || from_event_id_headers || payload["id"] || Digest::MD5.hexdigest(request.raw_post)
+    end
+
+    def from_config(key)
+      return unless config.present? && config[key].present?
+
+      case config[key]["source"]
+      when "header"
+        request.headers[config[key]["key"]]
+      when "payload"
+        payload[config[key]["key"]]
+      end
+    end
+
+    def from_event_type_headers
+      COMMON_EVENT_TYPE_HEADERS.lazy.map { |header| request.headers[header] }.find(&:present?)
+    end
+
+    def from_event_id_headers
+      COMMON_EVENT_ID_HEADERS.lazy.map { |header| request.headers[header] }.find(&:present?)
+    end
+
+    def from_payload_type
+      payload["type"] || payload["event"] || payload["event_type"]
+    end
+
+    def config
+      @config ||= begin
+        config_path = Rails.root.join("app/webhooks/#{params[:provider]}/config.yml")
+
+        File.exist?(config_path) ? YAML.load_file(config_path) : nil
+      end
+    end
+  end
+end

data/app/controllers/fuik/application_controller.rb

@@ -0,0 +1,4 @@
+module Fuik
+  class ApplicationController < ActionController::Base
+  end
+end

data/app/controllers/fuik/events_controller.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Fuik
+  class EventsController < Fuik::Engine.config.events_controller_parent.constantize
+    layout "fuik/application"
+
+    def index
+      @webhook_events = WebhookEvent.order(created_at: :desc)
+    end
+
+    def show
+      @webhook_event = WebhookEvent.find(params[:id])
+    end
+  end
+end

data/app/controllers/fuik/webhooks_controller.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+module Fuik
+  class WebhooksController < Fuik::Engine.config.webhooks_controller_parent.constantize
+    include EventType
+
+    skip_before_action :verify_authenticity_token
+
+    def create
+      verify_signature!
+
+      webhook_event = WebhookEvent.create!(
+        provider: params[:provider],
+        event_id: event_id,
+        event_type: event_type,
+        body: request.raw_post,
+        headers: headers
+      )
+
+      process!(webhook_event)
+
+      head :ok
+    rescue Fuik::InvalidSignature
+      head :unauthorized
+    rescue ActiveRecord::RecordNotUnique
+      head :ok
+    end
+
+    private
+
+    def verify_signature!
+      return unless should_verify?
+
+      base_class.verify!(request)
+    end
+
+    def headers
+      @headers ||= request.headers.env
+        .select { |key, _| key.start_with?("HTTP_") }
+        .transform_keys { |key| key.sub(/^HTTP_/, "").split("_").map(&:capitalize).join("-") }
+        .merge(request.content_type.present? ? {"Content-Type" => request.content_type} : {})
+    end
+
+    def payload
+      @payload ||= begin
+        return {} if request.raw_post.blank?
+
+        JSON.parse(request.raw_post)
+      rescue JSON::ParserError
+        {}
+      end
+    end
+
+    def process!(webhook_event)
+      event_class = event_class_for(webhook_event.provider, webhook_event.event_type)
+      return unless event_class
+
+      event_class.new(webhook_event).process!
+    end
+
+    def event_class_for(provider, event_type)
+      "#{provider.camelize}::#{event_type.tr("./:-", "_").camelize}".safe_constantize
+    end
+
+    def should_verify? = base_class&.respond_to?(:verify!)
+
+    def base_class
+      @base_class ||= "#{params[:provider].camelize}::Base".safe_constantize
+    end
+  end
+end

data/app/jobs/fuik/application_job.rb

@@ -0,0 +1,4 @@
+module Fuik
+  class ApplicationJob < ActiveJob::Base
+  end
+end

data/app/models/fuik/application_record.rb

@@ -0,0 +1,5 @@
+module Fuik
+  class ApplicationRecord < ActiveRecord::Base
+    self.abstract_class = true
+  end
+end

data/app/models/fuik/event.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Fuik
+  class Event
+    def initialize(webhook_event)
+      @webhook_event = webhook_event
+    end
+
+    def process!
+      raise NotImplementedError, "#{self.class} must implement #process!"
+    end
+
+    def payload
+      @webhook_event.payload
+    end
+  end
+end

data/app/models/fuik/webhook_event.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Fuik
+  class WebhookEvent < ApplicationRecord
+    self.table_name = "fuik_webhook_events"
+
+    enum :status, %w[pending processed failed].index_by(&:itself), default: "pending"
+
+    validates :provider, presence: true
+    validates :event_id, presence: true
+
+    def payload
+      @payload ||= JSON.parse(body)
+    rescue JSON::ParserError
+      {}
+    end
+
+    def processed!
+      update!(status: "processed")
+    end
+
+    def failed!(error)
+      update!(status: "failed", error: error.to_s)
+    end
+  end
+end

data/app/views/fuik/events/index.html.erb

@@ -0,0 +1,15 @@
+<h1>Webhooks</h1>
+
+<% @webhook_events.each do |event| %>
+  <article>
+    <%= link_to event_path(event) do %>
+      <span><%= event.provider %></span>
+
+      <code><%= event.event_type %></code>
+
+      <span class="status" data-status="<%= event.status %>"><%= event.status %></span>
+
+      <time><%= event.created_at.strftime("%Y-%m-%d %H:%M:%S") %></time>
+    <% end %>
+  </article>
+<% end %>

data/app/views/fuik/events/show.html.erb

@@ -0,0 +1,31 @@
+<h1>
+  <%= link_to "Webhooks", root_path %> / <%= @webhook_event.event_id %>
+</h1>
+
+<dl>
+  <dt>Provider</dt>
+  <dd><%= @webhook_event.provider %></dd>
+
+  <dt>Event ID</dt>
+  <dd><%= @webhook_event.event_id %></dd>
+
+  <dt>Type</dt>
+  <dd><%= @webhook_event.event_type %></dd>
+
+  <dt>Status</dt>
+  <dd class="status" data-status="<%= @webhook_event.status %>"><%= @webhook_event.status %></dd>
+
+  <dt>Created</dt>
+  <dd><%= @webhook_event.created_at.strftime("%Y-%m-%d %H:%M:%S") %></dd>
+
+  <dt>Payload</dt>
+  <dd><pre><%= JSON.pretty_generate(@webhook_event.payload) %></pre></dd>
+
+  <dt>Headers</dt>
+  <dd><pre><%= JSON.pretty_generate(@webhook_event.headers) %></pre></dd>
+
+  <% if @webhook_event.error.present? %>
+    <dt>Error</dt>
+    <dd><%= @webhook_event.error %></dd>
+  <% end %>
+</dl>

data/app/views/layouts/fuik/application.html.erb

@@ -0,0 +1,17 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Fuik Admin</title>
+  <%= csrf_meta_tags %>
+  <%= csp_meta_tag %>
+
+  <%= yield :head %>
+
+  <%= stylesheet_link_tag "fuik/application", media: "all" %>
+</head>
+<body>
+
+<%= yield %>
+
+</body>
+</html>

data/config/routes.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+Fuik::Engine.routes.draw do
+  root to: "events#index"
+  resources :events, only: %w[show]
+
+  post ":provider", to: "webhooks#create"
+end

data/db/migrate/20250101000000_create_webhook_events.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+class CreateWebhookEvents < ActiveRecord::Migration[7.0]
+  def change
+    create_table :fuik_webhook_events do |t|
+      t.string :provider, null: false
+      t.string :event_id, null: false
+      t.string :event_type, null: false
+      t.text :body, null: false
+      t.json :headers, default: {}, null: false
+      t.string :status, default: "pending", null: false
+      t.text :error, null: true
+
+      t.timestamps
+    end
+
+    add_index :fuik_webhook_events, [:provider, :event_id], unique: true
+    add_index :fuik_webhook_events, :status
+    add_index :fuik_webhook_events, :created_at
+    add_index :fuik_webhook_events, [:provider, :event_type]
+  end
+end

data/lib/fuik/engine.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Fuik
+  class Engine < ::Rails::Engine
+    isolate_namespace Fuik
+
+    config.webhooks_controller_parent = "ActionController::Base"
+    config.events_controller_parent = "ActionController::Base"
+  end
+end

data/lib/fuik/version.rb

@@ -0,0 +1,3 @@
+module Fuik
+  VERSION = "0.5.0"
+end

data/lib/fuik.rb

@@ -0,0 +1,6 @@
+require "fuik/version"
+require "fuik/engine"
+
+module Fuik
+  class InvalidSignature < StandardError; end
+end

data/lib/generators/fuik/install/install_generator.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Fuik
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path("../templates", __FILE__)
+
+      def create_migrations
+        rails_command "railties:install:migrations FROM=fuik", inline: true
+      end
+
+      def add_route
+        route 'mount Fuik::Engine => "/webhooks"'
+      end
+
+      def show_readme
+        readme "README" if behavior == :invoke
+      end
+    end
+  end
+end

data/lib/generators/fuik/install/templates/README

@@ -0,0 +1,24 @@
+===============================================================================
+
+Fuik has been installed! 🎣
+
+Next steps:
+
+  1. Run migrations:
+     rails db:migrate
+
+  2. Webhooks can be sent to:
+     POST /webhooks/:provider
+
+     Example: POST /webhooks/stripe
+
+  3. (Optional) Generate webhook class for a provider:
+     rails generate fuik:provider stripe checkout_session_completed
+
+     Or start from scratch:
+     rails generate fuik:provider custom_provider my_event
+
+  4. View received webhooks at:
+     GET /webhooks
+
+===============================================================================

data/lib/generators/fuik/provider/provider_generator.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Fuik
+  module Generators
+    class ProviderGenerator < Rails::Generators::NamedBase
+      source_root File.expand_path("../templates", __FILE__)
+      desc "Generate webhook provider base class and event classes"
+
+      argument :event_names, type: :array, default: []
+
+      def create_base_class
+        template "base.rb.tt", "app/webhooks/#{file_name}/base.rb"
+      end
+
+      def create_event_classes
+        event_names.each do |event_name|
+          @event_name = event_name
+
+          if packaged_event_exists?
+            copy_packaged_event
+          else
+            create_blank_event
+          end
+        end
+      end
+
+      private
+
+      def packaged_event_exists? = File.exist?(packaged_event_template_path)
+
+      def copy_packaged_event
+        template packaged_event_template_path, event_file_path
+      end
+
+      def create_blank_event
+        template "event.rb.tt", event_file_path
+      end
+
+      def packaged_event_template_path = File.join(self.class.source_root, "providers", file_name, "#{event_file_name}.rb.tt")
+
+      def event_file_path = Rails.join("app", "webhooks", file_name, "#{event_file_name}.rb")
+
+      def event_file_name = @event_name.underscore
+
+      def event_class_name = @event_name.camelize
+
+      def provider_module_name = file_name.camelize
+    end
+  end
+end

data/lib/generators/fuik/provider/templates/README

@@ -0,0 +1,23 @@
+===============================================================================
+
+Webhook endpoint:
+  POST /webhooks/<%= file_name %>
+
+Next steps:
+
+  1. Configure webhook in <%= provider_module_name %>:
+     Set webhook URL to: https://yourdomain.com/webhooks/<%= file_name %>
+
+  2. Implement (optional) signature verification in app/webhooks/<%= file_name %>/base.rb:
+
+  3. Implement event processing logic in:
+<% event_names.each do |event_name| %>
+     - app/webhooks/<%= file_name %>/<%= event_name.underscore %>.rb
+<% end %>
+
+View received webhooks at: /webhooks
+
+
+(🙏 share your created provider with others, by submitting a PR)
+
+===============================================================================

data/lib/generators/fuik/provider/templates/base.rb.tt

@@ -0,0 +1,8 @@
+module <%= provider_module_name %>
+  class Base < Fuik::Event
+    # def self.verify!(request)
+      # TODO: Implement signature verification
+      # raise Fuik::InvalidSignature # only raise when signature is invalid
+    # end
+  end
+end

data/lib/generators/fuik/provider/templates/event.rb.tt

@@ -0,0 +1,10 @@
+module <%= provider_module_name %>
+  class <%= event_class_name %> < Base
+    def process!
+      # TODO: Implement webhook processing logic
+      # `payload` contains the webhook data
+
+      @webhook_event.processed!
+    end
+  end
+end

data/lib/generators/fuik/provider/templates/github/base.rb.tt

@@ -0,0 +1,11 @@
+module <%= provider_module_name %>
+  class Base < Fuik::Event
+    def self.verify!(request)
+      secret = Rails.application.credentials.dig(:webhooks, :github, :secret)
+      signature = request.headers["X-Hub-Signature-256"]
+      expected_signature = "sha256=" + OpenSSL::HMAC.hexdigest("SHA256", secret, request.raw_post)
+
+      raise Fuik::InvalidSignature unless Rack::Utils.secure_compare(signature, expected_signature)
+    end
+  end
+end

data/lib/generators/fuik/provider/templates/github/installation_created.rb.tt

@@ -0,0 +1,12 @@
+module <%= provider_module_name %>
+  class InstallationCreated < Base
+    def process!
+      installation_id = payload.dig("installation", "id")
+      account = payload.dig("installation", "account", "login")
+
+      # TODO: Add business logic
+
+      @webhook_event.processed!
+    end
+  end
+end

data/lib/generators/fuik/provider/templates/github/push.rb.tt

@@ -0,0 +1,14 @@
+module <%= provider_module_name %>
+  class Push < Base
+    def process!
+      # This fires when a pull request is merged (default branch push)
+
+      repository = payload.dig("repository", "full_name")
+      ref = payload["ref"]
+
+      # TODO: Add business logic
+
+      @webhook_event.processed!
+    end
+  end
+end

data/lib/generators/fuik/provider/templates/github/star_created.rb.tt

@@ -0,0 +1,12 @@
+module <%= provider_module_name %>
+  class StarCreated < Base
+    def process!
+      repository = payload.dig("repository", "full_name")
+      stargazer = payload.dig("sender", "login")
+
+      # TODO: Add business logic
+
+      @webhook_event.processed!
+    end
+  end
+end

data/lib/generators/fuik/provider/templates/mailpace/base.rb.tt

@@ -0,0 +1,19 @@
+module <%= provider_module_name %>
+  class Base < Fuik::Event
+    def self.verify!(request)
+      public_key_base64 = Rails.application.credentials.dig(:webhooks, :mailpace, :public_key)
+      signature_base64 = request.headers["X-MailPace-Signature"]
+
+      verify_key = Ed25519::VerifyKey.new(Base64.strict_decode64(public_key_base64))
+      signature = Base64.strict_decode64(signature_base64)
+
+      raise Fuik::InvalidSignature unless verify_key.verify(signature, request.raw_post)
+    rescue Ed25519::VerifyError
+      raise Fuik::InvalidSignature
+    end
+
+    private
+
+    def email = payload["to"]
+  end
+end

data/lib/generators/fuik/provider/templates/mailpace/email_bounced.rb.tt

@@ -0,0 +1,11 @@
+module <%= provider_module_name %>
+  class EmailBounced < Base
+    def process!
+      bounce_type = payload["bounce_type"]
+
+      # TODO: Add business logic
+
+      @webhook_event.processed!
+    end
+  end
+end

data/lib/generators/fuik/provider/templates/mailpace/email_spam.rb.tt

@@ -0,0 +1,9 @@
+module <%= provider_module_name %>
+  class EmailSpam < Base
+    def process!
+      # TODO: Add business logic
+
+      @webhook_event.processed!
+    end
+  end
+end

data/lib/generators/fuik/provider/templates/stripe/base.rb.tt

@@ -0,0 +1,16 @@
+module <%= provider_module_name %>
+  class Base < Fuik::Event
+    def self.verify!(request)
+      secret = Rails.application.credentials.dig(:webhooks, :stripe, :secret)
+      signature = request.headers["Stripe-Signature"]
+
+      Stripe::Webhook.construct_event(
+        request.raw_post,
+        signature,
+        secret
+      )
+    rescue JSON::ParserError, Stripe::SignatureVerificationError => error
+      raise Fuik::InvalidSignature, error.message
+    end
+  end
+end

data/lib/generators/fuik/provider/templates/stripe/checkout_session_completed.rb.tt

@@ -0,0 +1,12 @@
+module <%= provider_module_name %>
+  class <%= event_class_name %> < Base
+    def process!
+      session_id = payload.dig("data", "object", "id")
+
+      # TODO: Add business logic
+      # session = Stripe::Checkout::Session.retrieve(session_id) # this assumes the Stripe gem is available
+
+      @webhook_event.processed!
+    end
+  end
+end

data/lib/generators/fuik/provider/templates/stripe/customer_subscription_deleted.rb.tt

@@ -0,0 +1,11 @@
+module <%= provider_module_name %>
+  class <%= event_class_name %> < Base
+    def process!
+      subscription_id = payload.dig("data", "object", "id")
+
+      # TODO: Add business logic
+
+      @webhook_event.processed!
+    end
+  end
+end

data/lib/generators/fuik/provider/templates/stripe/customer_subscription_updated.rb.tt

@@ -0,0 +1,11 @@
+module <%= provider_module_name %>
+  class <%= event_class_name %> < Base
+    def process!
+      subscription_id = payload.dig("data", "object", "id")
+
+      # TODO: Add business logic
+
+      @webhook_event.processed!
+    end
+  end
+end

metadata

@@ -0,0 +1,93 @@
+--- !ruby/object:Gem::Specification
+name: fuik
+version: !ruby/object:Gem::Version
+  version: 0.5.0
+platform: ruby
+authors:
+- Rails Designer
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 7.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 7.0.0
+description: TBD
+email:
+- devs@railsdesigner.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- MIT-LICENSE
+- README.md
+- Rakefile
+- app/assets/stylesheets/fuik/application.css
+- app/controllers/concerns/fuik/event_type.rb
+- app/controllers/fuik/application_controller.rb
+- app/controllers/fuik/events_controller.rb
+- app/controllers/fuik/webhooks_controller.rb
+- app/jobs/fuik/application_job.rb
+- app/models/fuik/application_record.rb
+- app/models/fuik/event.rb
+- app/models/fuik/webhook_event.rb
+- app/views/fuik/events/index.html.erb
+- app/views/fuik/events/show.html.erb
+- app/views/layouts/fuik/application.html.erb
+- config/routes.rb
+- db/migrate/20250101000000_create_webhook_events.rb
+- lib/fuik.rb
+- lib/fuik/engine.rb
+- lib/fuik/version.rb
+- lib/generators/fuik/install/install_generator.rb
+- lib/generators/fuik/install/templates/README
+- lib/generators/fuik/provider/provider_generator.rb
+- lib/generators/fuik/provider/templates/README
+- lib/generators/fuik/provider/templates/base.rb.tt
+- lib/generators/fuik/provider/templates/event.rb.tt
+- lib/generators/fuik/provider/templates/github/base.rb.tt
+- lib/generators/fuik/provider/templates/github/installation_created.rb.tt
+- lib/generators/fuik/provider/templates/github/push.rb.tt
+- lib/generators/fuik/provider/templates/github/star_created.rb.tt
+- lib/generators/fuik/provider/templates/mailpace/base.rb.tt
+- lib/generators/fuik/provider/templates/mailpace/email_bounced.rb.tt
+- lib/generators/fuik/provider/templates/mailpace/email_spam.rb.tt
+- lib/generators/fuik/provider/templates/stripe/base.rb.tt
+- lib/generators/fuik/provider/templates/stripe/checkout_session_completed.rb.tt
+- lib/generators/fuik/provider/templates/stripe/customer_subscription_deleted.rb.tt
+- lib/generators/fuik/provider/templates/stripe/customer_subscription_updated.rb.tt
+homepage: https://railsdesigner.com/fuik/
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://railsdesigner.com/fuik/
+  source_code_uri: https://github.com/Rails-Designer/fuik/
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.0
+specification_version: 4
+summary: TBD
+test_files: []