Add data sharing engine

Basic engine to perform `data_sharing` with a fediverse server.

It includes all the basic building blocks (APIs + code to fetch
content from fediverse servers authenticating as a proper actor).

Shared content results in the queuing of an (empty) ActiveJob.
FASP need to implement these jobs to do something meaningful.

The debug provider has been extended to use this to subscribe to
content and (so far) fetch new content when it arrives.

Author: oneiros

.github/workflows/fasp_data_sharing.yml

@@ -0,0 +1,67 @@
+name: CI - fasp_data_sharing
+
+on:
+  pull_request:
+    paths:
+      - "fasp_data_sharing/**"
+  push:
+    branches: [ main ]
+    paths:
+      - "fasp_data_sharing/**"
+
+defaults:
+  run:
+    working-directory: ./fasp_data_sharing
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ruby-3.3.6
+          bundler-cache: true
+
+      - name: Lint code for consistent style
+        run: bin/rubocop -f github
+
+  test:
+    runs-on: ubuntu-latest
+
+    # services:
+    #  redis:
+    #    image: redis
+    #    ports:
+    #      - 6379:6379
+    #    options: --health-cmd "redis-cli ping" --health-interval 10s --health-timeout 5s --health-retries 5
+    steps:
+      - name: Install packages
+        run: sudo apt-get update && sudo apt-get install --no-install-recommends -y google-chrome-stable curl libjemalloc2 libvips sqlite3
+
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ruby-3.3.6
+          bundler-cache: true
+
+      - name: Run tests
+        env:
+          RAILS_ENV: test
+          # REDIS_URL: redis://localhost:6379/0
+        run: bin/rails db:test:prepare test
+
+      - name: Keep screenshots from failed system tests
+        uses: actions/upload-artifact@v4
+        if: failure()
+        with:
+          name: screenshots
+          path: ${{ github.workspace }}/tmp/screenshots
+          if-no-files-found: ignore
+

README.md

@@ -0,0 +1,29 @@
+# Ruby FASP SDK 
+
+A set of rails engines and a sample debug provider to facilitate
+development of Fediverse Auxiliary Service Providers (FASP).
+
+## Contents
+
+* [`fasp_base`](fasp_base/)
+  A rails engine with the basics of provider-server interactions
+  (registration, provider info, API authentication). Includes a simple
+  server-rendered HTML frontend, but could be used headless as well.
+* [`fasp_data_sharing`](fasp_data_sharing/)
+  A rails engine implementing most of the `data_sharing` discovery
+  capability. Can be dropped into any FASP, which will only need to
+  trigger subscriptions/backfill requests and implement background jobs
+  to handle the URIs it receives. Also includes code to perform an
+  "authorized fetch" of fediverse resources.
+* [`debug`](debug/)
+  A sample debug provider that utilizes both engines above to provide
+  the `debug` capability and experiment with `data_sharing`.
+
+## Contributing
+
+See https://github.com/mastodon/.github/blob/main/CONTRIBUTING.md
+
+## License
+
+The code in this repository is available as open source under the terms
+of the [MIT License](https://opensource.org/licenses/MIT).

debug_fasp/Gemfile

@@ -36,6 +36,7 @@ gem "bootsnap", require: false
 gem "thruster", require: false
 
 gem "fasp_base", path: "../fasp_base"
+gem "fasp_data_sharing", path: "../fasp_data_sharing"
 
 group :development, :test do
   # See https://guides.rubyonrails.org/debugging_rails_applications.html#debugging-with-the-debug-gem

debug_fasp/Gemfile.lock

@@ -8,6 +8,13 @@ PATH
       openssl
       rails (>= 8.0.0)
 
+PATH
+  remote: ../fasp_data_sharing
+  specs:
+    fasp_data_sharing (0.1.0)
+      fasp_base
+      rails (>= 8.0.0)
+
 GEM
   remote: https://rubygems.org/
   specs:
@@ -115,7 +122,6 @@ GEM
       irb (~> 1.10)
       reline (>= 0.3.8)
     drb (2.2.1)
-    ed25519 (1.3.0)
     erubi (1.13.0)
     et-orbi (1.2.11)
       tzinfo
@@ -143,11 +149,11 @@ GEM
       activesupport (>= 5.0.0)
     json (2.9.0)
     language_server-protocol (3.17.0.3)
-    linzer (0.6.1)
-      ed25519 (~> 1.3, >= 1.3.0)
+    linzer (0.6.2)
       openssl (~> 3.0, >= 3.0.0)
       rack (>= 2.2, < 4.0)
       starry (~> 0.2)
+      stringio (~> 3.1, >= 3.1.2)
       uri (~> 1.0, >= 1.0.2)
     logger (1.6.2)
     loofah (2.23.1)
@@ -313,12 +319,12 @@ GEM
     tailwindcss-rails (3.0.0)
       railties (>= 7.0.0)
       tailwindcss-ruby
-    tailwindcss-ruby (3.4.15)
-    tailwindcss-ruby (3.4.15-aarch64-linux)
-    tailwindcss-ruby (3.4.15-arm-linux)
-    tailwindcss-ruby (3.4.15-arm64-darwin)
-    tailwindcss-ruby (3.4.15-x86_64-darwin)
-    tailwindcss-ruby (3.4.15-x86_64-linux)
+    tailwindcss-ruby (3.4.16)
+    tailwindcss-ruby (3.4.16-aarch64-linux)
+    tailwindcss-ruby (3.4.16-arm-linux)
+    tailwindcss-ruby (3.4.16-arm64-darwin)
+    tailwindcss-ruby (3.4.16-x86_64-darwin)
+    tailwindcss-ruby (3.4.16-x86_64-linux)
     thor (1.3.2)
     thruster (0.1.9)
     thruster (0.1.9-aarch64-linux)
@@ -375,6 +381,7 @@ DEPENDENCIES
   capybara
   debug
   fasp_base!
+  fasp_data_sharing!
   importmap-rails
   jbuilder
   propshaft

debug_fasp/app/controllers/accounts_controller.rb

@@ -0,0 +1,2 @@
+class AccountsController < ApplicationController
+end

debug_fasp/app/controllers/contents_controller.rb

@@ -0,0 +1,2 @@
+class ContentsController < ApplicationController
+end

debug_fasp/app/controllers/subscriptions_controller.rb

@@ -0,0 +1,18 @@
+class SubscriptionsController < ApplicationController
+  def index
+    @subscriptions = FaspDataSharing::Subscription.all
+  end
+
+  def create
+    FaspDataSharing::Subscription.subscribe_to_content(current_user.servers.first)
+
+    redirect_to subscriptions_path, notice: t(".success")
+  end
+
+  def destroy
+    subscription = FaspDataSharing::Subscription.where(fasp_base_server_id: current_user.server_ids).find(params[:id])
+    subscription.destroy
+
+    redirect_to subscriptions_path, notice: t(".success")
+  end
+end

debug_fasp/app/helpers/accounts_helper.rb

@@ -0,0 +1,2 @@
+module AccountsHelper
+end

debug_fasp/app/helpers/contents_helper.rb

@@ -0,0 +1,2 @@
+module ContentsHelper
+end

debug_fasp/app/helpers/subscriptions_helper.rb

@@ -0,0 +1,2 @@
+module SubscriptionsHelper
+end