janus-ledger 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 142a0c0c0e6fc368f3ddda5cce6581842a7bb32c401d189319c8699089f0622a
+  data.tar.gz: 32a84c4fed548d0b65f7d402bcd92fda15ec2ba2d895b28e2630b699bed37bba
+SHA512:
+  metadata.gz: 0c8b2b32be9600cc9816019c3d2a5dd0e94f0b084e4255045ac2d895d17718d5ae9e901cb050cdb90ac44a78dbc41ca119f7fad4633ca6773a0a21519f71b3d8
+  data.tar.gz: 478722f651cb772c110cb64a41818d06f2299ccb4ea35e4c2dc2cfc5fc019ef8925e95e6d309b13c058d4fe8384b2224ae4138e9ed4c5cae416b084c5372f329

data/lib/janus/_generated/janus_pb.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: janus.proto
+
+require 'google/protobuf'
+
+
+descriptor_data = "\n\x0bjanus.proto\x12\x08janus.v1\"+\n\tTimestamp\x12\x0f\n\x07seconds\x18\x01 \x01(\x03\x12\r\n\x05nanos\x18\x02 \x01(\x05\"\x96\x02\n\x06\x45ntity\x12\n\n\x02id\x18\x01 \x01(\t\x12\x13\n\x0b\x65xternal_id\x18\x02 \x01(\t\x12\x0c\n\x04name\x18\x03 \x01(\t\x12\x18\n\x0b\x64\x65scription\x18\x04 \x01(\tH\x00\x88\x01\x01\x12\x30\n\x08metadata\x18\x05 \x03(\x0b\x32\x1e.janus.v1.Entity.MetadataEntry\x12\'\n\ncreated_at\x18\x06 \x01(\x0b\x32\x13.janus.v1.Timestamp\x12\'\n\nupdated_at\x18\x07 \x01(\x0b\x32\x13.janus.v1.Timestamp\x1a/\n\rMetadataEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42\x0e\n\x0c_description\"\xd2\x01\n\x13\x43reateEntityRequest\x12\x13\n\x0b\x65xternal_id\x18\x01 \x01(\t\x12\x0c\n\x04name\x18\x02 \x01(\t\x12\x18\n\x0b\x64\x65scription\x18\x03 \x01(\tH\x00\x88\x01\x01\x12=\n\x08metadata\x18\x04 \x03(\x0b\x32+.janus.v1.CreateEntityRequest.MetadataEntry\x1a/\n\rMetadataEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42\x0e\n\x0c_description\"8\n\x14\x43reateEntityResponse\x12 \n\x06\x65ntity\x18\x01 \x01(\x0b\x32\x10.janus.v1.Entity\"-\n\x10GetEntityRequest\x12\x19\n\x11\x65xternal_id_or_id\x18\x01 \x01(\t\"E\n\x11GetEntityResponse\x12%\n\x06\x65ntity\x18\x01 \x01(\x0b\x32\x10.janus.v1.EntityH\x00\x88\x01\x01\x42\t\n\x07_entity\"\x15\n\x13ListEntitiesRequest\":\n\x14ListEntitiesResponse\x12\"\n\x08\x65ntities\x18\x01 \x03(\x0b\x32\x10.janus.v1.Entity\"\xbf\x02\n\x04\x42ook\x12\n\n\x02id\x18\x01 \x01(\t\x12\x0c\n\x04name\x18\x03 \x01(\t\x12\x0c\n\x04type\x18\x04 \x01(\t\x12\x10\n\x08\x63urrency\x18\x05 \x01(\t\x12\x0f\n\x07\x62\x61lance\x18\x06 \x01(\x03\x12.\n\x08metadata\x18\x08 \x03(\x0b\x32\x1c.janus.v1.Book.MetadataEntry\x12\'\n\ncreated_at\x18\t \x01(\x0b\x32\x13.janus.v1.Timestamp\x12\'\n\nupdated_at\x18\n \x01(\x0b\x32\x13.janus.v1.Timestamp\x12\x11\n\tentity_id\x18\x0b \x01(\t\x12\x1a\n\x12\x65ntity_external_id\x18\x0c \x01(\t\x1a/\n\rMetadataEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01J\x04\x08\x02\x10\x03J\x04\x08\x07\x10\x08\"\xd7\x01\n\x11\x43reateBookRequest\x12\x0c\n\x04name\x18\x02 \x01(\t\x12\x0c\n\x04type\x18\x03 \x01(\t\x12\x10\n\x08\x63urrency\x18\x04 \x01(\t\x12;\n\x08metadata\x18\x06 \x03(\x0b\x32).janus.v1.CreateBookRequest.MetadataEntry\x12\x1a\n\x12\x65ntity_external_id\x18\x07 \x01(\t\x1a/\n\rMetadataEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01J\x04\x08\x01\x10\x02J\x04\x08\x05\x10\x06\"2\n\x12\x43reateBookResponse\x12\x1c\n\x04\x62ook\x18\x01 \x01(\x0b\x32\x0e.janus.v1.Book\"$\n\x0eGetBookRequest\x12\x12\n\ntype_or_id\x18\x01 \x01(\t\"=\n\x0fGetBookResponse\x12!\n\x04\x62ook\x18\x01 \x01(\x0b\x32\x0e.janus.v1.BookH\x00\x88\x01\x01\x42\x07\n\x05_book\"\x8b\x01\n\x10ListBooksRequest\x12\x11\n\x04type\x18\x01 \x01(\tH\x00\x88\x01\x01\x12\r\n\x05limit\x18\x03 \x01(\x05\x12\x0e\n\x06offset\x18\x04 \x01(\x05\x12\x1f\n\x12\x65ntity_external_id\x18\x05 \x01(\tH\x01\x88\x01\x01\x42\x07\n\x05_typeB\x15\n\x13_entity_external_idJ\x04\x08\x02\x10\x03\"2\n\x11ListBooksResponse\x12\x1d\n\x05\x62ooks\x18\x01 \x03(\x0b\x32\x0e.janus.v1.Book\"\xc7\x01\n\x0e\x42ookEntryInput\x12\x0c\n\x04\x62ook\x18\x01 \x01(\t\x12\x12\n\x05\x64\x65\x62it\x18\x02 \x01(\x03H\x00\x88\x01\x01\x12\x13\n\x06\x63redit\x18\x03 \x01(\x03H\x01\x88\x01\x01\x12\x38\n\x08metadata\x18\x04 \x03(\x0b\x32&.janus.v1.BookEntryInput.MetadataEntry\x1a/\n\rMetadataEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42\x08\n\x06_debitB\t\n\x07_credit\"\x9c\x02\n\x19\x43reateJournalEntryRequest\x12\x17\n\x0fidempotency_key\x18\x01 \x01(\t\x12\x1b\n\x0e\x65\x66\x66\x65\x63tive_date\x18\x04 \x01(\tH\x00\x88\x01\x01\x12.\n\x0c\x62ook_entries\x18\x05 \x03(\x0b\x32\x18.janus.v1.BookEntryInput\x12\x43\n\x08metadata\x18\x06 \x03(\x0b\x32\x31.janus.v1.CreateJournalEntryRequest.MetadataEntry\x1a/\n\rMetadataEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42\x11\n\x0f_effective_dateJ\x04\x08\x02\x10\x03J\x04\x08\x03\x10\x04J\x04\x08\x07\x10\x08\"\x89\x03\n\x0cJournalEntry\x12\n\n\x02id\x18\x01 \x01(\t\x12\x17\n\x0fidempotency_key\x18\x02 \x01(\t\x12\x16\n\x0e\x65\x66\x66\x65\x63tive_date\x18\x05 \x01(\t\x12\x36\n\x08metadata\x18\x07 \x03(\x0b\x32$.janus.v1.JournalEntry.MetadataEntry\x12\'\n\ncreated_at\x18\x08 \x01(\x0b\x32\x13.janus.v1.Timestamp\x12-\n\x0breversed_at\x18\n \x01(\x0b\x32\x13.janus.v1.TimestampH\x00\x88\x01\x01\x12\x18\n\x0breverses_id\x18\x0b \x01(\tH\x01\x88\x01\x01\x12)\n\x0c\x62ook_entries\x18\x0c \x03(\x0b\x32\x13.janus.v1.BookEntry\x1a/\n\rMetadataEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42\x0e\n\x0c_reversed_atB\x0e\n\x0c_reverses_idJ\x04\x08\x03\x10\x04J\x04\x08\x04\x10\x05J\x04\x08\x06\x10\x07J\x04\x08\t\x10\n\"\xa9\x01\n\tBookEntry\x12\n\n\x02id\x18\x01 \x01(\t\x12\x11\n\tbook_name\x18\x03 \x01(\t\x12\x12\n\x05\x64\x65\x62it\x18\x04 \x01(\x03H\x00\x88\x01\x01\x12\x13\n\x06\x63redit\x18\x05 \x01(\x03H\x01\x88\x01\x01\x12\x10\n\x08\x63urrency\x18\x06 \x01(\t\x12\x14\n\x0c\x62ook_balance\x18\x07 \x01(\x03\x12\x11\n\tentity_id\x18\x08 \x01(\tB\x08\n\x06_debitB\t\n\x07_creditJ\x04\x08\x02\x10\x03\"K\n\x1a\x43reateJournalEntryResponse\x12-\n\rjournal_entry\x18\x01 \x01(\x0b\x32\x16.janus.v1.JournalEntry\"g\n\x1aReverseJournalEntryRequest\x12\x10\n\x08\x65ntry_id\x18\x01 \x01(\t\x12\x17\n\x0fidempotency_key\x18\x02 \x01(\t\x12\x13\n\x06reason\x18\x03 \x01(\tH\x00\x88\x01\x01\x42\t\n\x07_reason\"L\n\x1bReverseJournalEntryResponse\x12-\n\rjournal_entry\x18\x01 \x01(\x0b\x32\x16.janus.v1.JournalEntry\"$\n\x16GetJournalEntryRequest\x12\n\n\x02id\x18\x01 \x01(\t\"6\n\x1bGetJournalEntryByKeyRequest\x12\x17\n\x0fidempotency_key\x18\x01 \x01(\t\"_\n\x17GetJournalEntryResponse\x12\x32\n\rjournal_entry\x18\x01 \x01(\x0b\x32\x16.janus.v1.JournalEntryH\x00\x88\x01\x01\x42\x10\n\x0e_journal_entry\"T\n\x11GetBalanceRequest\x12\x0c\n\x04\x62ook\x18\x01 \x01(\t\x12\'\n\x05\x61s_of\x18\x02 \x01(\x0b\x32\x13.janus.v1.TimestampH\x00\x88\x01\x01\x42\x08\n\x06_as_of\"\x7f\n\x12GetBalanceResponse\x12\x0f\n\x07\x62ook_id\x18\x01 \x01(\t\x12\x11\n\tbook_name\x18\x02 \x01(\t\x12\x0f\n\x07\x62\x61lance\x18\x03 \x01(\x03\x12\x10\n\x08\x63urrency\x18\x04 \x01(\t\x12\"\n\x05\x61s_of\x18\x05 \x01(\x0b\x32\x13.janus.v1.Timestamp\"V\n\x12GetBalancesRequest\x12\r\n\x05\x62ooks\x18\x01 \x03(\t\x12\'\n\x05\x61s_of\x18\x02 \x01(\x0b\x32\x13.janus.v1.TimestampH\x00\x88\x01\x01\x42\x08\n\x06_as_of\"E\n\x13GetBalancesResponse\x12.\n\x08\x62\x61lances\x18\x01 \x03(\x0b\x32\x1c.janus.v1.GetBalanceResponse2\xd5\x07\n\x0cJanusService\x12M\n\x0c\x43reateEntity\x12\x1d.janus.v1.CreateEntityRequest\x1a\x1e.janus.v1.CreateEntityResponse\x12\x44\n\tGetEntity\x12\x1a.janus.v1.GetEntityRequest\x1a\x1b.janus.v1.GetEntityResponse\x12M\n\x0cListEntities\x12\x1d.janus.v1.ListEntitiesRequest\x1a\x1e.janus.v1.ListEntitiesResponse\x12G\n\nCreateBook\x12\x1b.janus.v1.CreateBookRequest\x1a\x1c.janus.v1.CreateBookResponse\x12>\n\x07GetBook\x12\x18.janus.v1.GetBookRequest\x1a\x19.janus.v1.GetBookResponse\x12\x44\n\tListBooks\x12\x1a.janus.v1.ListBooksRequest\x1a\x1b.janus.v1.ListBooksResponse\x12_\n\x12\x43reateJournalEntry\x12#.janus.v1.CreateJournalEntryRequest\x1a$.janus.v1.CreateJournalEntryResponse\x12\x62\n\x13ReverseJournalEntry\x12$.janus.v1.ReverseJournalEntryRequest\x1a%.janus.v1.ReverseJournalEntryResponse\x12V\n\x0fGetJournalEntry\x12 .janus.v1.GetJournalEntryRequest\x1a!.janus.v1.GetJournalEntryResponse\x12`\n\x14GetJournalEntryByKey\x12%.janus.v1.GetJournalEntryByKeyRequest\x1a!.janus.v1.GetJournalEntryResponse\x12G\n\nGetBalance\x12\x1b.janus.v1.GetBalanceRequest\x1a\x1c.janus.v1.GetBalanceResponse\x12J\n\x0bGetBalances\x12\x1c.janus.v1.GetBalancesRequest\x1a\x1d.janus.v1.GetBalancesResponseb\x06proto3"
+
+pool = ::Google::Protobuf::DescriptorPool.generated_pool
+pool.add_serialized_file(descriptor_data)
+
+module Janus
+  module V1
+    Timestamp = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("janus.v1.Timestamp").msgclass
+    Entity = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("janus.v1.Entity").msgclass
+    CreateEntityRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("janus.v1.CreateEntityRequest").msgclass
+    CreateEntityResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("janus.v1.CreateEntityResponse").msgclass
+    GetEntityRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("janus.v1.GetEntityRequest").msgclass
+    GetEntityResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("janus.v1.GetEntityResponse").msgclass
+    ListEntitiesRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("janus.v1.ListEntitiesRequest").msgclass
+    ListEntitiesResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("janus.v1.ListEntitiesResponse").msgclass
+    Book = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("janus.v1.Book").msgclass
+    CreateBookRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("janus.v1.CreateBookRequest").msgclass
+    CreateBookResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("janus.v1.CreateBookResponse").msgclass
+    GetBookRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("janus.v1.GetBookRequest").msgclass
+    GetBookResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("janus.v1.GetBookResponse").msgclass
+    ListBooksRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("janus.v1.ListBooksRequest").msgclass
+    ListBooksResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("janus.v1.ListBooksResponse").msgclass
+    BookEntryInput = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("janus.v1.BookEntryInput").msgclass
+    CreateJournalEntryRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("janus.v1.CreateJournalEntryRequest").msgclass
+    JournalEntry = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("janus.v1.JournalEntry").msgclass
+    BookEntry = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("janus.v1.BookEntry").msgclass
+    CreateJournalEntryResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("janus.v1.CreateJournalEntryResponse").msgclass
+    ReverseJournalEntryRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("janus.v1.ReverseJournalEntryRequest").msgclass
+    ReverseJournalEntryResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("janus.v1.ReverseJournalEntryResponse").msgclass
+    GetJournalEntryRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("janus.v1.GetJournalEntryRequest").msgclass
+    GetJournalEntryByKeyRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("janus.v1.GetJournalEntryByKeyRequest").msgclass
+    GetJournalEntryResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("janus.v1.GetJournalEntryResponse").msgclass
+    GetBalanceRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("janus.v1.GetBalanceRequest").msgclass
+    GetBalanceResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("janus.v1.GetBalanceResponse").msgclass
+    GetBalancesRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("janus.v1.GetBalancesRequest").msgclass
+    GetBalancesResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("janus.v1.GetBalancesResponse").msgclass
+  end
+end

data/lib/janus/_generated/janus_services_pb.rb

@@ -0,0 +1,42 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# Source: janus.proto for package 'janus.v1'
+# Original file comments:
+# JanusService provides double-entry accounting operations
+
+require 'grpc'
+require_relative 'janus_pb'
+
+module Janus
+  module V1
+    module JanusService
+      # JanusService provides double-entry accounting operations
+      class Service
+
+        include ::GRPC::GenericService
+
+        self.marshal_class_method = :encode
+        self.unmarshal_class_method = :decode
+        self.service_name = 'janus.v1.JanusService'
+
+        # Entities
+        rpc :CreateEntity, ::Janus::V1::CreateEntityRequest, ::Janus::V1::CreateEntityResponse
+        rpc :GetEntity, ::Janus::V1::GetEntityRequest, ::Janus::V1::GetEntityResponse
+        rpc :ListEntities, ::Janus::V1::ListEntitiesRequest, ::Janus::V1::ListEntitiesResponse
+        # Books
+        rpc :CreateBook, ::Janus::V1::CreateBookRequest, ::Janus::V1::CreateBookResponse
+        rpc :GetBook, ::Janus::V1::GetBookRequest, ::Janus::V1::GetBookResponse
+        rpc :ListBooks, ::Janus::V1::ListBooksRequest, ::Janus::V1::ListBooksResponse
+        # Journal Entries
+        rpc :CreateJournalEntry, ::Janus::V1::CreateJournalEntryRequest, ::Janus::V1::CreateJournalEntryResponse
+        rpc :ReverseJournalEntry, ::Janus::V1::ReverseJournalEntryRequest, ::Janus::V1::ReverseJournalEntryResponse
+        rpc :GetJournalEntry, ::Janus::V1::GetJournalEntryRequest, ::Janus::V1::GetJournalEntryResponse
+        rpc :GetJournalEntryByKey, ::Janus::V1::GetJournalEntryByKeyRequest, ::Janus::V1::GetJournalEntryResponse
+        # Balances
+        rpc :GetBalance, ::Janus::V1::GetBalanceRequest, ::Janus::V1::GetBalanceResponse
+        rpc :GetBalances, ::Janus::V1::GetBalancesRequest, ::Janus::V1::GetBalancesResponse
+      end
+
+      Stub = Service.rpc_stub_class
+    end
+  end
+end

data/lib/janus.rb

@@ -0,0 +1,270 @@
+# frozen_string_literal: true
+
+# Janus -- Ruby gRPC Client
+#
+# Connects to a remote janus-server via gRPC.
+#
+# @example Connect to a gRPC server
+#   client = Janus.new(server_url: 'localhost:50051')
+#
+# @example With TLS
+#   client = Janus.new(server_url: 'janus.example.com:443', secure: true)
+#
+module Janus
+  VERSION = '0.8.0'
+
+  Entity = Struct.new(
+    :id, :external_id, :name, :description, :metadata, :created_at, :updated_at,
+    keyword_init: true
+  )
+
+  Book = Struct.new(
+    :id, :entity_id, :name, :book_type, :currency,
+    :metadata, :created_at, :updated_at,
+    keyword_init: true
+  )
+
+  BookEntry = Struct.new(
+    :id, :book_name, :debit, :credit, :currency,
+    :book_balance, :entity_id,
+    keyword_init: true
+  )
+
+  JournalEntry = Struct.new(
+    :id, :idempotency_key, :effective_date, :metadata,
+    :created_at, :reversed_at, :reversed_by_id, :reverses_id,
+    :book_entries,
+    keyword_init: true
+  )
+
+  BalanceResult = Struct.new(
+    :book_id, :book_name, :balance, :currency, :as_of,
+    keyword_init: true
+  )
+
+  # Money helpers
+  module Money
+    def self.cents(amount, currency = 'USD')
+      { amount: amount, currency: currency }
+    end
+
+    def self.from_decimal(amount, currency = 'USD', decimals = 2)
+      multiplier = 10**decimals
+      { amount: (amount * multiplier).round, currency: currency }
+    end
+
+    def self.to_decimal(amount, decimals = 2)
+      divisor = 10**decimals
+      amount.to_f / divisor
+    end
+  end
+
+  # gRPC-only Janus client
+  class Client
+    def initialize(server_url:, secure: false)
+      require 'grpc'
+      require 'json'
+      require_relative 'janus/_generated/janus_pb'
+      require_relative 'janus/_generated/janus_services_pb'
+
+      credentials = secure ? :this_channel_is_secure : :this_channel_is_insecure
+      @stub = ::Janus::V1::JanusService::Stub.new(server_url, credentials)
+    end
+
+    # --- Entity methods ---
+
+    def create_entity(external_id:, name:, description: nil, metadata: nil)
+      meta = metadata ? JSON.parse(metadata) : {}
+      req = ::Janus::V1::CreateEntityRequest.new(
+        external_id: external_id,
+        name: name,
+        metadata: meta
+      )
+      req.description = description if description
+      resp = @stub.create_entity(req)
+      map_entity(resp.entity)
+    end
+
+    def get_entity(external_id_or_id:)
+      resp = @stub.get_entity(
+        ::Janus::V1::GetEntityRequest.new(external_id_or_id: external_id_or_id)
+      )
+      return nil unless resp.entity
+      map_entity(resp.entity)
+    end
+
+    def list_entities
+      resp = @stub.list_entities(::Janus::V1::ListEntitiesRequest.new)
+      resp.entities.map { |e| map_entity(e) }
+    end
+
+    # --- Book methods ---
+
+    def create_book(name:, book_type:, entity_id:, currency: nil, metadata: nil)
+      meta = metadata ? JSON.parse(metadata) : {}
+      req = ::Janus::V1::CreateBookRequest.new(
+        entity_external_id: entity_id,
+        name: name,
+        type: book_type,
+        currency: currency || 'USD',
+        metadata: meta
+      )
+      resp = @stub.create_book(req)
+      map_book(resp.book)
+    end
+
+    def get_book(name_or_id:)
+      resp = @stub.get_book(
+        ::Janus::V1::GetBookRequest.new(type_or_id: name_or_id)
+      )
+      return nil unless resp.book
+      map_book(resp.book)
+    end
+
+    def list_books(book_type: nil, entity_id: nil)
+      req = ::Janus::V1::ListBooksRequest.new
+      req.type = book_type if book_type
+      req.entity_external_id = entity_id if entity_id
+      resp = @stub.list_books(req)
+      resp.books.map { |b| map_book(b) }
+    end
+
+    # --- Journal Entry methods ---
+
+    def create_journal_entry(idempotency_key:, book_entries_json:, effective_date: nil, metadata: nil)
+      entries = JSON.parse(book_entries_json)
+      pb_entries = entries.map do |e|
+        entry = ::Janus::V1::BookEntryInput.new(book: e['book'], metadata: e.fetch('metadata', {}))
+        entry.debit = e['debit'] if e.key?('debit') && !e['debit'].nil?
+        entry.credit = e['credit'] if e.key?('credit') && !e['credit'].nil?
+        entry
+      end
+
+      meta = metadata ? JSON.parse(metadata) : {}
+      req = ::Janus::V1::CreateJournalEntryRequest.new(
+        idempotency_key: idempotency_key,
+        book_entries: pb_entries,
+        metadata: meta
+      )
+      req.effective_date = effective_date if effective_date
+      resp = @stub.create_journal_entry(req)
+      map_journal_entry(resp.journal_entry)
+    end
+
+    def get_journal_entry(id:)
+      resp = @stub.get_journal_entry(
+        ::Janus::V1::GetJournalEntryRequest.new(id: id)
+      )
+      return nil unless resp.journal_entry
+      map_journal_entry(resp.journal_entry)
+    end
+
+    def get_journal_entry_by_key(key:)
+      resp = @stub.get_journal_entry_by_key(
+        ::Janus::V1::GetJournalEntryByKeyRequest.new(idempotency_key: key)
+      )
+      return nil unless resp.journal_entry
+      map_journal_entry(resp.journal_entry)
+    end
+
+    def reverse_journal_entry(entry_id:, idempotency_key:, reason: nil)
+      req = ::Janus::V1::ReverseJournalEntryRequest.new(
+        entry_id: entry_id,
+        idempotency_key: idempotency_key
+      )
+      req.reason = reason if reason
+      resp = @stub.reverse_journal_entry(req)
+      map_journal_entry(resp.journal_entry)
+    end
+
+    # --- Balance methods ---
+
+    def get_balance(book:)
+      resp = @stub.get_balance(
+        ::Janus::V1::GetBalanceRequest.new(book: book)
+      )
+      map_balance(resp)
+    end
+
+    def get_balances(books:)
+      resp = @stub.get_balances(
+        ::Janus::V1::GetBalancesRequest.new(books: books)
+      )
+      resp.balances.map { |b| map_balance(b) }
+    end
+
+    # --- Lifecycle ---
+
+    def close
+      # no-op for gRPC (channel managed by grpc gem)
+    end
+
+    private
+
+    def map_entity(e)
+      Entity.new(
+        id: e.id,
+        external_id: e.external_id,
+        name: e.name,
+        description: e.description.empty? ? nil : e.description,
+        metadata: e.metadata.to_h.to_s,
+        created_at: e.created_at ? e.created_at.seconds.to_s : '',
+        updated_at: e.updated_at ? e.updated_at.seconds.to_s : ''
+      )
+    end
+
+    def map_book(b)
+      Book.new(
+        id: b.id,
+        entity_id: b.entity_id,
+        name: b.name,
+        book_type: b.type.empty? ? 'asset' : b.type,
+        currency: b.currency,
+        metadata: b.metadata.to_h.to_s,
+        created_at: b.created_at ? b.created_at.seconds.to_s : '',
+        updated_at: b.updated_at ? b.updated_at.seconds.to_s : ''
+      )
+    end
+
+    def map_book_entry(be)
+      BookEntry.new(
+        id: be.id,
+        book_name: be.book_name,
+        debit: be.respond_to?(:has_debit?) && be.has_debit? ? be.debit : nil,
+        credit: be.respond_to?(:has_credit?) && be.has_credit? ? be.credit : nil,
+        currency: be.currency,
+        book_balance: be.book_balance,
+        entity_id: be.entity_id.empty? ? nil : be.entity_id
+      )
+    end
+
+    def map_journal_entry(je)
+      JournalEntry.new(
+        id: je.id,
+        idempotency_key: je.idempotency_key,
+        effective_date: je.effective_date,
+        metadata: je.metadata.to_h.to_s,
+        created_at: je.created_at ? je.created_at.seconds.to_s : '',
+        reversed_at: je.reversed_at ? je.reversed_at.seconds.to_s : nil,
+        reversed_by_id: nil,
+        reverses_id: je.respond_to?(:has_reverses_id?) && je.has_reverses_id? ? je.reverses_id : nil,
+        book_entries: je.book_entries.map { |be| map_book_entry(be) }
+      )
+    end
+
+    def map_balance(b)
+      BalanceResult.new(
+        book_id: b.book_id,
+        book_name: b.book_name,
+        balance: b.balance,
+        currency: b.currency,
+        as_of: b.as_of ? b.as_of.seconds.to_s : ''
+      )
+    end
+  end
+
+  # Module-level constructor for convenience
+  def self.new(server_url:, secure: false)
+    Client.new(server_url: server_url, secure: secure)
+  end
+end

data/proto/janus.proto

@@ -0,0 +1,207 @@
+syntax = "proto3";
+
+package janus.v1;
+
+// JanusService provides double-entry accounting operations
+service JanusService {
+  // Entities
+  rpc CreateEntity(CreateEntityRequest) returns (CreateEntityResponse);
+  rpc GetEntity(GetEntityRequest) returns (GetEntityResponse);
+  rpc ListEntities(ListEntitiesRequest) returns (ListEntitiesResponse);
+
+  // Books
+  rpc CreateBook(CreateBookRequest) returns (CreateBookResponse);
+  rpc GetBook(GetBookRequest) returns (GetBookResponse);
+  rpc ListBooks(ListBooksRequest) returns (ListBooksResponse);
+
+  // Journal Entries
+  rpc CreateJournalEntry(CreateJournalEntryRequest) returns (CreateJournalEntryResponse);
+  rpc ReverseJournalEntry(ReverseJournalEntryRequest) returns (ReverseJournalEntryResponse);
+  rpc GetJournalEntry(GetJournalEntryRequest) returns (GetJournalEntryResponse);
+  rpc GetJournalEntryByKey(GetJournalEntryByKeyRequest) returns (GetJournalEntryResponse);
+
+  // Balances
+  rpc GetBalance(GetBalanceRequest) returns (GetBalanceResponse);
+  rpc GetBalances(GetBalancesRequest) returns (GetBalancesResponse);
+}
+
+// Common types
+message Timestamp {
+  int64 seconds = 1;
+  int32 nanos = 2;
+}
+
+// Entity messages
+message Entity {
+  string id = 1;
+  string external_id = 2;
+  string name = 3;
+  optional string description = 4;
+  map<string, string> metadata = 5;
+  Timestamp created_at = 6;
+  Timestamp updated_at = 7;
+}
+
+message CreateEntityRequest {
+  string external_id = 1;
+  string name = 2;
+  optional string description = 3;
+  map<string, string> metadata = 4;
+}
+
+message CreateEntityResponse {
+  Entity entity = 1;
+}
+
+message GetEntityRequest {
+  string external_id_or_id = 1;
+}
+
+message GetEntityResponse {
+  optional Entity entity = 1;
+}
+
+message ListEntitiesRequest {
+}
+
+message ListEntitiesResponse {
+  repeated Entity entities = 1;
+}
+
+// Book messages
+message Book {
+  string id = 1;
+  reserved 2;  // removed: code
+  string name = 3;
+  string type = 4;
+  string currency = 5;
+  int64 balance = 6;
+  reserved 7;  // removed: parent_id
+  map<string, string> metadata = 8;
+  Timestamp created_at = 9;
+  Timestamp updated_at = 10;
+  string entity_id = 11;
+  string entity_external_id = 12;
+}
+
+message CreateBookRequest {
+  reserved 1;  // removed: code
+  string name = 2;
+  string type = 3;
+  string currency = 4;
+  reserved 5;  // removed: parent_code
+  map<string, string> metadata = 6;
+  string entity_external_id = 7;
+}
+
+message CreateBookResponse {
+  Book book = 1;
+}
+
+message GetBookRequest {
+  string type_or_id = 1;
+}
+
+message GetBookResponse {
+  optional Book book = 1;
+}
+
+message ListBooksRequest {
+  optional string type = 1;
+  reserved 2;  // removed: parent_code
+  int32 limit = 3;
+  int32 offset = 4;
+  optional string entity_external_id = 5;
+}
+
+message ListBooksResponse {
+  repeated Book books = 1;
+}
+
+// Journal Entry messages
+message BookEntryInput {
+  string book = 1;
+  optional int64 debit = 2;
+  optional int64 credit = 3;
+  map<string, string> metadata = 4;
+}
+
+message CreateJournalEntryRequest {
+  string idempotency_key = 1;
+  reserved 2, 3, 7;  // removed: entry_type, description, auto_post
+  optional string effective_date = 4;  // YYYY-MM-DD
+  repeated BookEntryInput book_entries = 5;
+  map<string, string> metadata = 6;
+}
+
+message JournalEntry {
+  string id = 1;
+  string idempotency_key = 2;
+  reserved 3, 4, 6, 9;  // removed: entry_type, description, status, posted_at
+  string effective_date = 5;
+  map<string, string> metadata = 7;
+  Timestamp created_at = 8;
+  optional Timestamp reversed_at = 10;
+  optional string reverses_id = 11;
+  repeated BookEntry book_entries = 12;
+}
+
+message BookEntry {
+  string id = 1;
+  reserved 2;  // removed: book_code
+  string book_name = 3;
+  optional int64 debit = 4;
+  optional int64 credit = 5;
+  string currency = 6;
+  int64 book_balance = 7;
+  string entity_id = 8;
+}
+
+message CreateJournalEntryResponse {
+  JournalEntry journal_entry = 1;
+}
+
+message ReverseJournalEntryRequest {
+  string entry_id = 1;
+  string idempotency_key = 2;
+  optional string reason = 3;
+}
+
+message ReverseJournalEntryResponse {
+  JournalEntry journal_entry = 1;
+}
+
+message GetJournalEntryRequest {
+  string id = 1;
+}
+
+message GetJournalEntryByKeyRequest {
+  string idempotency_key = 1;
+}
+
+message GetJournalEntryResponse {
+  optional JournalEntry journal_entry = 1;
+}
+
+// Balance messages
+message GetBalanceRequest {
+  string book = 1;
+  optional Timestamp as_of = 2;
+}
+
+message GetBalanceResponse {
+  string book_id = 1;
+  string book_name = 2;
+  int64 balance = 3;
+  string currency = 4;
+  Timestamp as_of = 5;
+}
+
+message GetBalancesRequest {
+  repeated string books = 1;
+  optional Timestamp as_of = 2;
+}
+
+message GetBalancesResponse {
+  repeated GetBalanceResponse balances = 1;
+}

metadata

@@ -0,0 +1,103 @@
+--- !ruby/object:Gem::Specification
+name: janus-ledger
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Solumos
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-03-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: grpc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.60'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.60'
+- !ruby/object:Gem::Dependency
+  name: google-protobuf
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.25'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.25'
+- !ruby/object:Gem::Dependency
+  name: grpc-tools
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.60'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.60'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+description: A Ruby gRPC client library for the Janus double-entry accounting engine.
+email:
+- dev@solumos.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/janus.rb
+- lib/janus/_generated/janus_pb.rb
+- lib/janus/_generated/janus_services_pb.rb
+- proto/janus.proto
+homepage: https://github.com/solumos/janus
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Ruby gRPC client for Janus
+test_files: []