zero_ruby

gem 'zero_ruby'

# app/zero/mutations/post_update.rb
module Mutations
  class PostUpdate < ApplicationMutation
    argument :id, ID, required: true
    argument :post_input, Types::PostInput, required: true

    def execute(id:, post_input:)
      post = current_user.posts.find(id)
      post.update!(**post_input)
    end
  end
end

# app/zero/app_schema.rb
# The mutation names should match the names used in your Zero client:
#   mutators.posts.update({ id: "...", post_input: { title: "..." } })
#   -> maps to "posts.update"
class ZeroSchema < ZeroRuby::Schema
  mutation "posts.update", handler: Mutations::PostUpdate
end

# app/controllers/zero_controller.rb
class ZeroController < ApplicationController
  # Skip CSRF for API endpoint
  # skip_before_action :verify_authenticity_token

  def push
    if request.get?
      # GET requests return TypeScript type definitions
      render plain: ZeroSchema.to_typescript, content_type: "text/plain; charset=utf-8"
    else
      # POST requests process mutations
      body = JSON.parse(request.body.read)

      # Build context hash with whatever your mutations need.
      # Access in mutations via ctx[:current_user]
      context = {
        current_user: current_user,
      }

      result = ZeroSchema.execute(body, context: context)
      render json: result
    end
  rescue JSON::ParserError => e
    render json: {
      kind: "PushFailed",
      origin: "server",
      reason: "parse",
      message: "Invalid JSON: #{e.message}",
      mutationIDs: []
    }, status: :bad_request
  end
end

# config/routes.rb
match '/zero/push', to: 'zero#push', via: [:get, :post]

# app/zero/types/base_input_object.rb
module Types
  class BaseInputObject < ZeroRuby::InputObject
    # Add shared behavior across all input objects here
  end
end

# app/zero/mutations/application_mutation.rb
class ApplicationMutation < ZeroRuby::Mutation
  def current_user
    ctx[:current_user]
  end
end

# app/zero/types/post_input.rb
module Types
  class PostInput < Types::BaseInputObject
    argument :title, String, required: true,
      validates: { length: { minimum: 1, maximum: 200 } }
    argument :body, String, required: false
    argument :published, Boolean, required: false, default: false
  end
end

# config/initializers/zero_ruby.rb
ZeroRuby.configure do |config|
  # Storage backend (:active_record is the only built-in option)
  config.lmid_store = :active_record

  # Retry attempts for transient errors
  config.max_retry_attempts = 3

  # Push protocol version (reject requests with different version)
  config.supported_push_version = 1
end

argument :name, String, required: true,
  validates: {
    length: { minimum: 1, maximum: 100 },
    format: { with: /\A[a-z]+\z/i, message: "only letters allowed" },
    allow_blank: false
  }

argument :age, Integer, required: true,
  validates: {
    numericality: { greater_than: 0, less_than: 150 }
  }

argument :status, String, required: true,
  validates: {
    inclusion: { in: %w[draft published archived] }
  }

argument :username, String, required: true,
  validates: {
    exclusion: { in: %w[admin root system], message: "is reserved" }
  }

argument :email, String, required: true,
  validates: {
    allow_null: false,
    allow_blank: false
  }