restate-sdk 0.9.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0fdc1d0db30055117693522a2f51fc194ed403a53b6069b2a69181c859b0e9f9
-  data.tar.gz: c39fde762f884f79335330428ba8e9d2bc07b86ba77b12d268db1cd727660cab
+  metadata.gz: 40a987e80017804da9524cecb061cb5dd798f63d78b7b9d5297eafd0f7a3f08c
+  data.tar.gz: 7911f4dc802ffc13b5065ee3d7c0447c04a0741dee2df87aa023b7dfd8196cee
 SHA512:
-  metadata.gz: 2f460e546e7fb00ca7b6319e55374a52a944c58fcd3b0f0f399a62342e12d420280934473d0360d73d26be7dfd525cec7c4bfa831e198d90cb088ff6855351a1
-  data.tar.gz: 14361197f0c9bf7b798637d4a4e617d8438fdc46c433670eca069de100772e2126f8a0a41b27f0a7a283227f452c056aef8fce6efdaf0d60e5b86ef88a4fd1eb
+  metadata.gz: 8ed57c28f1a19c800602f98d47f8956850fa72962b8a35f6fe80f1d9e27c28d16de8803d504e0000455d8bfdfe45e0e402e063ea330307f4ace1c13c19196316
+  data.tar.gz: e48404e2aa84ee83852b65015fd70330d6407ad3874da6f639af741e623133bb59007294cffdc526ec5b0c1bfe35b20dbe4d9557ae4c1e3f0a92df7c603f6ba8

data/Cargo.lock

@@ -31,16 +31,14 @@ checksum = "72b3254f16251a8381aa12e40e3c4d2f0199f8c6508fbecb9d91f575e0fbb8c6"
 
 [[package]]
 name = "bindgen"
-version = "0.69.5"
+version = "0.72.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "271383c67ccabffb7381723dea0672a673f292304fcb45c01cc648c7a8d58088"
+checksum = "993776b509cfb49c750f11b8f07a46fa23e0a1386ffc01fb1e7d343efc387895"
 dependencies = [
  "bitflags",
  "cexpr",
  "clang-sys",
  "itertools 0.12.1",
- "lazy_static",
- "lazycell",
  "proc-macro2",
  "quote",
  "regex",
@@ -278,12 +276,6 @@ version = "1.5.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "bbd2bcb4c963f2ddae06a2efc7e9f3591312473c50c6685e1f298068316e66fe"
 
-[[package]]
-name = "lazycell"
-version = "1.3.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "830d08ce1d1d941e6b30645f1a0eb5643013d835ce3779a5fc208261dbe10f55"
-
 [[package]]
 name = "libc"
 version = "0.2.183"
@@ -489,18 +481,18 @@ dependencies = [
 
 [[package]]
 name = "rb-sys"
-version = "0.9.124"
+version = "0.9.128"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c85c4188462601e2aa1469def389c17228566f82ea72f137ed096f21591bc489"
+checksum = "45ca28513560e56cfb79a62b1fce363c73af170a182024ce880c77ee9429920a"
 dependencies = [
  "rb-sys-build",
 ]
 
 [[package]]
 name = "rb-sys-build"
-version = "0.9.124"
+version = "0.9.128"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "568068db4102230882e6d4ae8de6632e224ca75fe5970f6e026a04e91ed635d3"
+checksum = "ce04b2c55eff3a21aaa623fcc655d94373238e72cac6b3e1a3641ff31649f99a"
 dependencies = [
  "bindgen",
  "lazy_static",
@@ -569,7 +561,7 @@ dependencies = [
 
 [[package]]
 name = "restate_internal"
-version = "0.9.0"
+version = "0.10.0"
 dependencies = [
  "magnus",
  "rb-sys",
@@ -593,9 +585,9 @@ dependencies = [
 
 [[package]]
 name = "rustc-hash"
-version = "1.1.0"
+version = "2.1.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "08d43f7aa6b08d49f382cde6a7982047c3426db949b1424bc4b7ec9ae12c6ce2"
+checksum = "94300abf3f1ae2e2b8ffb7b58043de3d399c73fa6f4b73826402a5c457614dbe"
 
 [[package]]
 name = "rustversion"

data/ext/restate_internal/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "restate_internal"
-version = "0.9.0"
+version = "0.10.0"
 edition = "2021"
 publish = false
 

data/lib/restate/client.rb

@@ -81,6 +81,33 @@ module Restate
       post_admin("/restate/invocations/#{invocation_id}/kill", nil)
     end
 
+    # ── Introspection queries ──
+
+    # Execute a SQL query against Restate's introspection API (DataFusion).
+    # The admin API exposes system tables (sys_invocation, sys_journal, state,
+    # etc.) that can be queried with standard SQL.
+    #
+    # @param sql [String] a SQL query string
+    # @return [Array<Hash>] rows returned by the query
+    #
+    # @example
+    #   client.execute_query("SELECT id, status FROM sys_invocation LIMIT 10")
+    def execute_query(sql) # rubocop:disable Metrics/AbcSize,Metrics/MethodLength
+      uri = URI("#{@admin_url}/query")
+      request = Net::HTTP::Post.new(uri)
+      request['Content-Type'] = 'application/json'
+      request['Accept'] = 'application/json'
+      @admin_headers.each { |k, v| request[k] = v }
+      request.body = JSON.generate({ query: sql })
+      response = Net::HTTP.start(uri.hostname, uri.port, # steep:ignore ArgumentTypeMismatch
+                                 use_ssl: uri.scheme == 'https',
+                                 open_timeout: 5,
+                                 read_timeout: 30) { |http| http.request(request) }
+      Kernel.raise "Restate query error: #{response.code} #{response.body}" unless response.is_a?(Net::HTTPSuccess)
+      body = response.body
+      body && !body.empty? ? (JSON.parse(body)['rows'] || []) : []
+    end
+
     private
 
     def resolve_name(service)

data/lib/restate/introspection.rb

@@ -0,0 +1,127 @@
+# typed: false
+# frozen_string_literal: true
+
+require 'active_record'
+
+module Restate
+  # Arel table references for Restate's SQL introspection tables.
+  #
+  # Restate exposes a DataFusion-powered SQL endpoint at +/query+ on the admin
+  # API. These tables let you build queries using Arel's composable, type-safe
+  # predicate API — the same one ActiveRecord uses under the hood.
+  #
+  # @example Query running invocations for a service
+  #   i = Restate::Sys::Invocation
+  #   query = i.project(i[:id], i[:status], i[:created_at])
+  #            .where(i[:target_service_name].eq("MyService"))
+  #            .where(i[:status].eq("running"))
+  #            .order(i[:created_at].desc)
+  #            .take(50)
+  #   Restate.query(query)
+  #
+  # @example Join invocations with their journal input
+  #   i = Restate::Sys::Invocation
+  #   j = Restate::Sys::Journal
+  #   query = i.project(i[:id], i[:target], i[:status], j[:entry_json])
+  #            .join(j, Arel::Nodes::OuterJoin)
+  #            .on(j[:id].eq(i[:id]).and(j[:index].eq(0)))
+  #            .where(i[:target_service_name].eq("CrawlPipeline"))
+  #            .order(i[:created_at].desc)
+  #            .take(20)
+  #   Restate.query(query)
+  #
+  # @example Query virtual object state
+  #   s = Restate::Sys::State
+  #   query = s.project(s[:service_name], s[:service_key], s[:key], s[:value_utf8])
+  #            .where(s[:service_name].eq("Counter"))
+  #   Restate.query(query)
+  module Sys
+    Invocation       = Arel::Table.new(:sys_invocation)
+    Journal          = Arel::Table.new(:sys_journal)
+    JournalEvents    = Arel::Table.new(:sys_journal_events)
+    Inbox            = Arel::Table.new(:sys_inbox)
+    KeyedStatus      = Arel::Table.new(:sys_keyed_service_status)
+    Service          = Arel::Table.new(:sys_service)
+    Deployment       = Arel::Table.new(:sys_deployment)
+    Idempotency      = Arel::Table.new(:sys_idempotency)
+    Promise          = Arel::Table.new(:sys_promise)
+    State            = Arel::Table.new(:state)
+  end
+
+  # Minimal quoting adapter for Arel's ToSql visitor. Emits ANSI SQL
+  # (double-quoted identifiers, single-quoted strings) which DataFusion expects.
+  # Allows Arel query generation without an ActiveRecord database connection.
+  #
+  # @!visibility private
+  class DataFusionQuoting
+    def quote_table_name(name)
+      "\"#{name}\""
+    end
+
+    def quote_column_name(name)
+      "\"#{name}\""
+    end
+
+    def quote(value)
+      case value
+      when String then "'#{value.gsub("'", "''")}'"
+      when nil then 'NULL'
+      when true then 'TRUE'
+      when false then 'FALSE'
+      else value.to_s
+      end
+    end
+
+    def schema_cache
+      self
+    end
+
+    def columns_hash(_table)
+      {}
+    end
+
+    def data_source_exists?(_table)
+      true
+    end
+  end
+
+  # Arel visitor that generates ANSI SQL compatible with DataFusion.
+  # Uses DataFusionQuoting for identifier/value quoting without requiring
+  # a live database connection.
+  #
+  # @!visibility private
+  class DataFusionVisitor < Arel::Visitors::ToSql
+    def initialize
+      super(DataFusionQuoting.new)
+    end
+  end
+
+  class << self
+    # Convert an Arel AST to a SQL string without requiring an AR connection.
+    # Uses a standalone visitor that emits ANSI SQL (DataFusion-compatible).
+    #
+    # @param arel [Arel::SelectManager] an Arel query
+    # @return [String] SQL string
+    def arel_to_sql(arel)
+      collector = Arel::Collectors::SQLString.new
+      DataFusionVisitor.new.accept(arel.ast, collector).value
+    end
+
+    # Execute an Arel query or raw SQL string against the Restate admin
+    # introspection API. Returns an array of row hashes.
+    #
+    # @param arel_or_sql [Arel::SelectManager, String] an Arel query or raw SQL
+    # @return [Array<Hash>] rows returned by Restate
+    #
+    # @example With Arel
+    #   i = Restate::Sys::Invocation
+    #   Restate.query(i.project(Arel.star).take(10))
+    #
+    # @example With raw SQL
+    #   Restate.query("SELECT id, status FROM sys_invocation LIMIT 10")
+    def query(arel_or_sql)
+      sql = arel_or_sql.respond_to?(:ast) ? arel_to_sql(arel_or_sql) : arel_or_sql.to_s
+      client.execute_query(sql)
+    end
+  end
+end

data/lib/restate/railtie.rb

@@ -0,0 +1,17 @@
+# typed: false
+# frozen_string_literal: true
+
+module Restate
+  # Rails integration for the Restate SDK. Automatically loads the
+  # introspection module which provides Arel-based query support for
+  # Restate's SQL introspection API (powered by DataFusion).
+  #
+  # When Rails is present, +Restate::Sys+ table constants become available
+  # for building type-safe, composable queries against system tables like
+  # +sys_invocation+, +sys_journal+, and +state+.
+  class Railtie < Rails::Railtie
+    initializer 'restate.introspection' do
+      require_relative 'introspection'
+    end
+  end
+end

data/lib/restate/version.rb

@@ -2,5 +2,5 @@
 # frozen_string_literal: true
 
 module Restate
-  VERSION = '0.9.0'
+  VERSION = '0.10.0'
 end

data/lib/restate.rb

@@ -18,6 +18,7 @@ require_relative 'restate/endpoint'
 require_relative 'restate/service_proxy'
 require_relative 'restate/config'
 require_relative 'restate/client'
+require_relative 'restate/railtie' if defined?(Rails::Railtie)
 
 # Restate Ruby SDK — build resilient applications with durable execution.
 #

data/sig/restate.rbs

@@ -8,6 +8,8 @@ module Restate
   def self.configure: () { (Config) -> void } -> void
   def self.config: () -> Config
   def self.client: () -> Client
+  def self.query: (untyped arel_or_sql) -> Array[Hash[String, untyped]]
+  def self.arel_to_sql: (untyped arel) -> String
 
   # ── Durable execution ──
 
@@ -118,6 +120,7 @@ module Restate
     def reject_awakeable: (String awakeable_id, String message, ?code: Integer) -> void
     def cancel_invocation: (String invocation_id) -> void
     def kill_invocation: (String invocation_id) -> void
+    def execute_query: (String sql) -> Array[Hash[String, untyped]]
 
     private
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: restate-sdk
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.10.0
 platform: ruby
 authors:
 - Restate Developers
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-23 00:00:00.000000000 Z
+date: 2026-05-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: async
@@ -63,6 +63,8 @@ files:
 - lib/restate/endpoint.rb
 - lib/restate/errors.rb
 - lib/restate/handler.rb
+- lib/restate/introspection.rb
+- lib/restate/railtie.rb
 - lib/restate/serde.rb
 - lib/restate/server.rb
 - lib/restate/server_context.rb