action_merge 0.1.0

data/app/assets/builds/action_merge/network-adapter.d.ts

@@ -0,0 +1,18 @@
+import { Consumer, Subscription } from '@rails/actioncable';
+import { NetworkAdapter, PeerId, PeerMetadata, Message } from '@automerge/automerge-repo/slim';
+declare class ActionCableNetworkAdapter extends NetworkAdapter {
+    #private;
+    channelName: string;
+    consumer: Consumer;
+    subscription?: Subscription;
+    syncableType: string;
+    syncableId: any;
+    constructor(channelName: string, syncableType: string, syncableId: any, serverUrl?: string);
+    connect(peerId: PeerId, peerMetadata?: PeerMetadata): void;
+    disconnect(): void;
+    send(message: Message): void;
+    whenReady(): Promise<void>;
+    isReady(): boolean;
+}
+export default ActionCableNetworkAdapter;
+//# sourceMappingURL=network-adapter.d.ts.map

data/app/assets/builds/action_merge/network-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-adapter.d.ts","sourceRoot":"","sources":["../../../javascript/action_merge/network-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,QAAQ,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAQ,MAAM,gCAAgC,CAAA;AAGpG,cAAM,yBAA0B,SAAQ,cAAc;;IACrD,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,QAAQ,CAAA;IAElB,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,GAAG,CAAA;gBACH,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,MAAM;IAS1F,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,YAAY;IAyEnD,UAAU;IAeV,IAAI,CAAC,OAAO,EAAE,OAAO;IAmBrB,SAAS;IAWT,OAAO;CAGP;AAED,eAAe,yBAAyB,CAAA"}

data/app/assets/builds/action_merge/syncable.d.ts

@@ -0,0 +1,7 @@
+declare global {
+    interface Window {
+        Syncable?: any;
+    }
+}
+export {};
+//# sourceMappingURL=syncable.d.ts.map

data/app/assets/builds/action_merge/syncable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncable.d.ts","sourceRoot":"","sources":["../../../javascript/action_merge/syncable.ts"],"names":[],"mappings":"AAIA,OAAO,CAAC,MAAM,CAAC;IACd,UAAU,MAAM;QAAG,QAAQ,CAAC,EAAE,GAAG,CAAA;KAAE;CACnC"}

data/app/assets/config/action_merge_manifest.js

@@ -0,0 +1 @@
+//= link_directory ../stylesheets/action_merge .css

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

@@ -0,0 +1,15 @@
+/*
+ * This is a manifest file that'll be compiled into application.css, which will include all the files
+ * listed below.
+ *
+ * Any CSS and SCSS file within this directory, lib/assets/stylesheets, vendor/assets/stylesheets,
+ * or any plugin's vendor/assets/stylesheets directory can be referenced here using a relative path.
+ *
+ * You're free to add application-wide styles to this file and they'll appear at the bottom of the
+ * compiled file so the styles you add here take precedence over styles defined in any other CSS/SCSS
+ * files in this directory. Styles in this file should be added after the last require_* statement.
+ * It is generally better to create a new file per style scope.
+ *
+ *= require_tree .
+ *= require_self
+ */

data/app/channels/action_merge/sync_channel.rb

@@ -0,0 +1,36 @@
+require "active_support/all"
+
+module ActionMerge
+  class SyncChannel < ActionCable::Channel::Base
+    cattr_accessor :peers
+    @@peers ||= {}
+  
+    def subscribed
+      @model = ActiveSupport::Inflector.constantize(params[:syncable_type]).find(params[:syncable_id])
+      
+      reject unless @model.authorize_sync(self)
+            
+      @peer = ActionMerge::Peer.new(params[:id], storageId: params.dig(:metadata, :storageId), isEphemeral: params.dig(:metadata, :isEphemeral), model: @model) 
+      
+      @@peers[@peer.to_gid_param] = @peer
+            
+      stream_for @peer
+    end
+    
+    def perform_action(data)
+      data.deep_symbolize_keys!
+      if data.dig(:targetId).presence
+        self.class.broadcast_to(@@peers[data[:targetId]], data)
+      else
+        @@peers.each do |id, peer|
+          self.class.broadcast_to(peer, data) unless id == @peer&.to_gid_param
+        end
+      end
+    end
+      
+    def unsubscribed
+      @@peers[@peer&.to_gid_param] = nil
+      @peer = nil
+    end
+  end
+end

data/app/channels/application_cable/channel.rb

@@ -0,0 +1,4 @@
+module ApplicationCable
+  class Channel < ActionCable::Channel::Base
+  end
+end

data/app/channels/application_cable/connection.rb

@@ -0,0 +1,4 @@
+module ApplicationCable
+  class Connection < ActionCable::Connection::Base
+  end
+end

data/app/controllers/action_merge/application_controller.rb

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

data/app/helpers/action_merge/application_helper.rb

@@ -0,0 +1,4 @@
+module ActionMerge
+  module ApplicationHelper
+  end
+end

data/app/javascript/action_merge/application.ts

@@ -0,0 +1,5 @@
+import "./syncable.js"
+import { next as Am } from "@automerge/automerge"
+
+// @ts-ignore
+window.Am = Am

data/app/javascript/action_merge/network-adapter.ts

@@ -0,0 +1,144 @@
+import { createConsumer, Consumer, Subscription } from "@rails/actioncable"
+import { NetworkAdapter, PeerId, PeerMetadata, Message, cbor } from "@automerge/automerge-repo/slim"
+import omit from "lodash.omit"
+
+class ActionCableNetworkAdapter extends NetworkAdapter {
+	channelName: string
+	consumer: Consumer
+	#isReady: boolean
+	subscription?: Subscription
+	syncableType: string
+	syncableId: any
+	constructor(channelName: string, syncableType: string, syncableId: any, serverUrl?: string) {
+		super()
+		this.channelName = channelName
+		this.syncableType = syncableType
+		this.syncableId = syncableId
+		this.consumer = createConsumer(serverUrl)
+		this.#isReady = false
+	}
+
+	connect(peerId: PeerId, peerMetadata?: PeerMetadata) {
+		this.peerId = peerId
+		this.peerMetadata = peerMetadata
+
+		this.subscription = this.consumer.subscriptions.create({ channel: this.channelName, id: this.peerId, metadata: this.peerMetadata || {}, syncable_id: this.syncableId, syncable_type: this.syncableType }, {
+			connected: () => {
+				this.#isReady = true
+				this.send({
+					// @ts-expect-error
+					senderId: this.peerId,
+					type: "arrive",
+					// @ts-expect-error
+					targetId: null
+				})
+			},
+  
+			disconnected: () => {
+				this.#isReady = false
+				this.emit("close")
+			},
+      
+			received: (message) => {      
+				// @ts-ignore
+				window.message = message
+				if (message.targetId != null && message.targetId !== this.peerId) {
+					if (message.senderId == this.peerId) {
+						return
+					}
+					throw new Error(
+						"ActionCableNetworkAdapter should never receive messages for a different peer."
+					)
+				}
+      
+				const { senderId, type } = message
+								      
+				switch (type) {
+					case "arrive":
+						{
+							const { peerMetadata } = message
+							this.send({
+								type: "welcome",
+								// @ts-expect-error
+								senderId: this.peerId,
+								peerMetadata: this.peerMetadata,
+								targetId: senderId,
+							})
+							this.emit("peer-candidate", { peerId: senderId, peerMetadata })
+						}
+						break
+					case "welcome":
+						{
+							const { peerMetadata } = message
+							this.emit("peer-candidate", { peerId: senderId, peerMetadata })
+						}
+						break
+					case "leave":
+						this.emit("peer-disconnected", { peerId: senderId })
+					default:
+						if(message.data && Object.values(message.data).length > 0) {
+							// @ts-ignore
+							this.emit("message", {
+								...omit(message, "data"),
+								data: new Uint8Array(Object.values(message.data)),
+							})
+						} else {
+							this.emit("message", message)
+						}
+						break
+				}
+			},
+		})
+	}
+
+	disconnect() {
+		if (this.subscription) {
+			this.send({
+				type: "leave",
+				// @ts-expect-error
+				senderId: this.peerId,
+			})
+			// @ts-expect-error
+			this.emit("peer-disconnected", { peerId: this.peerId })
+			this.subscription.unsubscribe()
+			this.subscription = undefined
+		}
+	}
+  
+
+	send(message: Message) {
+		this.subscription?.send(message)
+		if (message.data) {
+			const data = message.data.buffer.slice(
+				message.data.byteOffset,
+				message.data.byteOffset + message.data.byteLength
+			)
+		
+			this.subscription?.send(
+				{
+					...message,
+					data,
+				}
+			)
+		} else {
+			this.subscription?.send(message)
+		}
+	}
+
+	whenReady() {
+		return new Promise<void>((resolve) => {
+			while (true) {
+				if (this.#isReady) {
+					break
+				}
+			}
+			resolve()
+		})
+	}
+  
+	isReady() {
+		return this.#isReady
+	}
+}
+
+export default ActionCableNetworkAdapter

data/app/javascript/action_merge/syncable.ts

@@ -0,0 +1,24 @@
+import { Repo, type RepoConfig } from "@automerge/automerge-repo";
+import ActionCableNetworkAdapter from "./network-adapter.js"
+import { IndexedDBStorageAdapter } from "@automerge/automerge-repo-storage-indexeddb"
+
+declare global {
+	interface Window { Syncable?: any }
+}
+
+type Syncable = { 
+	new (klass: string, id: any, channel?: string, obj?: RepoConfig): Repo 
+}
+
+const Syncable: Syncable = new Proxy(Repo, {
+	construct: (target, args) => {
+		const [ klass, id, channel = "ActionMerge::SyncChannel", obj = {} ] = args
+		return new target({
+		  network: [new ActionCableNetworkAdapter(channel, klass, id)],
+		  storage: new IndexedDBStorageAdapter(),
+		  ...obj
+		});
+	}
+}) as Syncable
+
+window.Syncable = Syncable

data/app/jobs/action_merge/application_job.rb

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

data/app/mailers/action_merge/application_mailer.rb

@@ -0,0 +1,6 @@
+module ActionMerge
+  class ApplicationMailer < ActionMailer::Base
+    default from: "from@example.com"
+    layout "mailer"
+  end
+end

data/app/models/action_merge/application_record.rb

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

data/app/models/action_merge/document/chunk.rb

@@ -0,0 +1,11 @@
+module ActionMerge
+	class Document::Chunk < ApplicationRecord
+  	belongs_to :action_merge_document
+  	
+  	def upsert(k,v)
+			c = chunks.find(k).presence || chunks.new(primary_key => k)
+			c.update!(v)
+			c.save
+  	end
+	end
+end

data/app/models/action_merge/document.rb

@@ -0,0 +1,6 @@
+module ActionMerge
+  class Document < ApplicationRecord
+    belongs_to :syncable, polymorphic: true
+    has_many :action_merge_document_chunks, as: :chunks, foreign_key: :document_id
+  end
+end

data/app/models/action_merge/peer.rb

@@ -0,0 +1,23 @@
+module ActionMerge
+	class Peer
+		attr_accessor :id, :isEphemeral, :storageId, :model
+	
+		def initialize(id, isEphemeral: nil, storageId: nil, model: nil)
+			@id = id
+			@isEphemeral = isEphemeral
+			@storageId = storageId
+			@model = model
+		end
+		
+		def metadata
+			{
+				isEphemeral:,
+				storageId:
+			}
+		end
+		
+		def to_gid_param
+			[[@model.class.name, @model.id], id]
+		end
+	end
+end

data/app/models/action_merge/storage_adapter.rb

@@ -0,0 +1,32 @@
+# @implements automerge.org/automerge-repo/interfaces/_automerge_automerge_repo.StorageAdapterInterface
+module ActionMerge
+	module StorageAdapter
+  	def load(key)
+			ActionMerge::Document::Chunk.find(key)
+  	end
+	
+  	def loadRange(key)
+			document_id, type = *key
+		
+			d = ActionMerge::Document.find(document_id)
+		
+			if type
+	  		d.chunks.where(type:)
+			else
+	  		d.chunks
+			end
+  	end
+  	
+  	def remove(key)
+			ActionMerge::Document::Chunk.destroy(key)
+  	end
+  	
+  	def removeRange(key)
+			loadRange(key).destroy_all
+  	end
+  	
+  	def save(key, value)
+			ActionMerge::Document::Chunk.upsert(key, value)
+  	end
+  end
+end

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

@@ -0,0 +1,14 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Action Merge</title>
+  <%= csrf_meta_tags %>
+  <%= csp_meta_tag %>
+
+  <%= stylesheet_link_tag "action_merge/application", media: "all" %>
+  <%= javascript_include_tag "action_merge/application", "data-turbo-track": "reload", type: "module" %>
+</head>
+<body>
+  <%= yield %>
+</body>
+</html>

data/config/routes.rb

@@ -0,0 +1,2 @@
+ActionMerge::Engine.routes.draw do
+end

data/db/migrate/20240910160133_create_action_merge_documents.rb

@@ -0,0 +1,19 @@
+class CreateActionMergeDocuments < ActiveRecord::Migration[7.1]
+  def change
+    create_table :action_merge_documents, primary_key: :id, id: false do |t|
+      t.string :id
+      t.string :syncable_type
+      t.integer :syncable_id
+
+      t.timestamps
+    end
+    
+    create_table :action_merge_document_chunks, primary_key: [:action_merge_document_id, :type, :hash], id: false do |t|
+      t.string :type
+      t.text :hash
+      t.belongs_to :action_merge_document
+      
+      t.timestamps
+    end
+  end
+end

data/lib/action_merge/assets.rb

@@ -0,0 +1,19 @@
+module ActionMerge
+	class Assets
+		def initialize(app)
+			@app = app
+		end
+	
+		def call(env)
+			path = env[Rack::PATH_INFO]
+			
+			if path.start_with? "/.well-known/action_merge/assets/"
+				env[Rack::PATH_INFO] = path.split("/").last
+				
+				Rack::Files.new(ActionMerge::Engine.root.join("app", "assets", "builds", "action_merge")).call(env)
+			else
+				@app.call(env)
+			end
+		end
+	end
+end

data/lib/action_merge/engine.rb

@@ -0,0 +1,16 @@
+module ActionMerge
+  class Engine < ::Rails::Engine
+    isolate_namespace ActionMerge
+    
+    initializer "action_merge.assets" do |app|
+      app.middleware.insert_after(
+        Rack::Sendfile,
+        ActionMerge::Assets
+      )
+    end
+    
+    initializer "action_merge.helpers" do
+      ActiveSupport.on_load(:action_view) { include ActionMerge::Helpers }
+    end
+  end
+end

data/lib/action_merge/helpers.rb

@@ -0,0 +1,7 @@
+module ActionMerge
+	module Helpers
+		def action_merge_javascript_tag
+			ActiveSupport::SafeBuffer.new '<script src="/.well-known/action_merge/assets/application.js" data-turbo-track="reload" type="module"></script>'
+		end
+	end
+end

data/lib/action_merge/syncable.rb

@@ -0,0 +1,19 @@
+module ActionMerge
+	module Syncable
+	  extend ActiveSupport::Concern
+	  
+	  included do
+			has_one :automerge_document, dependent: :destroy, as: :syncable
+	  end
+		
+		class_methods do
+			def to_authorize_sync(&block)
+				@@_to_authorize_sync = block
+			end
+		end		
+		
+		def authorize_sync(channel)
+			channel.instance_eval &@@_to_authorize_sync
+		end
+	end
+end

data/lib/action_merge.rb

@@ -0,0 +1,12 @@
+require "zeitwerk"
+loader = Zeitwerk::Loader.for_gem
+loader.setup
+
+module ActionMerge
+  def self.table_name_prefix
+    "action_merge_"
+  end
+end
+
+loader.eager_load
+

data/lib/tasks/action_merge_tasks.rake

@@ -0,0 +1,4 @@
+# desc "Explaining what the task does"
+# task :action_merge do
+#   # Task goes here
+# end

metadata

@@ -0,0 +1,104 @@
+--- !ruby/object:Gem::Specification
+name: action_merge
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Reese Armstrong
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2024-09-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '7.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '8.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '7.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '8.0'
+description: Build local-first and collaborative Rails applications with Automerge
+email:
+- me@reeseric.ci
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.md
+- README.md
+- Rakefile
+- app/assets/builds/action_merge/application.d.ts
+- app/assets/builds/action_merge/application.d.ts.map
+- app/assets/builds/action_merge/application.js
+- app/assets/builds/action_merge/application.js.map
+- app/assets/builds/action_merge/automerge.wasm
+- app/assets/builds/action_merge/network-adapter.d.ts
+- app/assets/builds/action_merge/network-adapter.d.ts.map
+- app/assets/builds/action_merge/syncable.d.ts
+- app/assets/builds/action_merge/syncable.d.ts.map
+- app/assets/config/action_merge_manifest.js
+- app/assets/stylesheets/action_merge/application.css
+- app/channels/action_merge/sync_channel.rb
+- app/channels/application_cable/channel.rb
+- app/channels/application_cable/connection.rb
+- app/controllers/action_merge/application_controller.rb
+- app/helpers/action_merge/application_helper.rb
+- app/javascript/action_merge/application.ts
+- app/javascript/action_merge/network-adapter.ts
+- app/javascript/action_merge/syncable.ts
+- app/jobs/action_merge/application_job.rb
+- app/mailers/action_merge/application_mailer.rb
+- app/models/action_merge/application_record.rb
+- app/models/action_merge/document.rb
+- app/models/action_merge/document/chunk.rb
+- app/models/action_merge/peer.rb
+- app/models/action_merge/storage_adapter.rb
+- app/views/layouts/action_merge/application.html.erb
+- config/routes.rb
+- db/migrate/20240910160133_create_action_merge_documents.rb
+- lib/action_merge.rb
+- lib/action_merge/assets.rb
+- lib/action_merge/engine.rb
+- lib/action_merge/helpers.rb
+- lib/action_merge/syncable.rb
+- lib/tasks/action_merge_tasks.rake
+homepage: https://codeberg.org/reesericci/action_merge
+licenses:
+- LGPL-3.0-or-later
+metadata:
+  homepage_uri: https://codeberg.org/reesericci/action_merge
+  source_code_uri: https://codeberg.org/reesericci/action_merge
+  changelog_uri: https://codeberg.org/reesericci/action_merge/releases
+post_install_message:
+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: 3.5.9
+signing_key:
+specification_version: 4
+summary: Build local-first and collaborative Rails applications
+test_files: []