pgoutput-client 0.0.0 → 0.2.0

data/sig/pgoutput/client/configuration.rbs

@@ -0,0 +1,436 @@
+module Pgoutput
+  module Client
+    # Immutable configuration for a PostgreSQL logical replication stream.
+    #
+    # A configuration describes how `pgoutput-client` should connect to
+    # PostgreSQL and how it should request logical replication from the server.
+    # It deliberately contains transport-level settings only; parsing pgoutput
+    # records and decoding PostgreSQL values belong to downstream layers.
+    #
+    # The object freezes itself and its string/array attributes during
+    # initialization so it can be safely shared by transport components without
+    # defensive copying.
+    #
+    # @example Minimal configuration
+    #   config = Pgoutput::Client::Configuration.new(
+    #     database_url: "postgres://localhost/app",
+    #     slot_name: "cdc_slot",
+    #     publication_names: "app_publication"
+    #   )
+    #
+    # @example Start from a known LSN and request binary values from pgoutput
+    #   config = Pgoutput::Client::Configuration.new(
+    #     database_url: ENV.fetch("DATABASE_URL"),
+    #     slot_name: "cdc_slot",
+    #     publication_names: %w[app_publication],
+    #     start_lsn: "0/16B6C50",
+    #     binary: true
+    #   )
+    #
+    # @api public
+    class Configuration
+      @database_url: untyped
+
+      @slot_name: untyped
+
+      @publication_names: untyped
+
+      @start_lsn: untyped
+
+      @proto_version: untyped
+
+      @binary: untyped
+
+      @messages: untyped
+
+      @auto_create_slot: untyped
+
+      @temporary_slot: untyped
+
+      @feedback_interval: untyped
+
+      # Fixed logical decoding output plugin.
+      #
+      # @return [String]
+      DEFAULT_PLUGIN: "pgoutput"
+
+      # Default pgoutput protocol version.
+      #
+      # @return [Integer]
+      DEFAULT_PROTO_VERSION: 1
+
+      # Default interval, in seconds, between standby status feedback messages.
+      #
+      # @return [Float]
+      DEFAULT_FEEDBACK_INTERVAL: ::Float
+
+      # @!attribute [r] database_url
+      #   PostgreSQL connection URL.
+      #   @return [String]
+      # @!attribute [r] slot_name
+      #   Logical replication slot name.
+      #   @return [String]
+      # @!attribute [r] publication_names
+      #   Publication names requested from pgoutput.
+      #   @return [Array<String>]
+      # @!attribute [r] start_lsn
+      #   Optional normalized starting LSN.
+      #   @return [String, nil]
+      # @!attribute [r] proto_version
+      #   pgoutput protocol version.
+      #   @return [Integer]
+      # @!attribute [r] binary
+      #   Whether to request binary column values from pgoutput.
+      #   @return [Boolean]
+      # @!attribute [r] messages
+      #   Whether to request logical decoding messages from pgoutput.
+      #   @return [Boolean]
+      # @!attribute [r] auto_create_slot
+      #   Whether the client should create the slot before streaming.
+      #   @return [Boolean]
+      # @!attribute [r] temporary_slot
+      #   Whether a newly created slot should be temporary.
+      #   @return [Boolean]
+      # @!attribute [r] feedback_interval
+      #   Standby feedback interval in seconds.
+      #   @return [Float]
+      attr_reader database_url: untyped
+
+      # @!attribute [r] database_url
+      #   PostgreSQL connection URL.
+      #   @return [String]
+      # @!attribute [r] slot_name
+      #   Logical replication slot name.
+      #   @return [String]
+      # @!attribute [r] publication_names
+      #   Publication names requested from pgoutput.
+      #   @return [Array<String>]
+      # @!attribute [r] start_lsn
+      #   Optional normalized starting LSN.
+      #   @return [String, nil]
+      # @!attribute [r] proto_version
+      #   pgoutput protocol version.
+      #   @return [Integer]
+      # @!attribute [r] binary
+      #   Whether to request binary column values from pgoutput.
+      #   @return [Boolean]
+      # @!attribute [r] messages
+      #   Whether to request logical decoding messages from pgoutput.
+      #   @return [Boolean]
+      # @!attribute [r] auto_create_slot
+      #   Whether the client should create the slot before streaming.
+      #   @return [Boolean]
+      # @!attribute [r] temporary_slot
+      #   Whether a newly created slot should be temporary.
+      #   @return [Boolean]
+      # @!attribute [r] feedback_interval
+      #   Standby feedback interval in seconds.
+      #   @return [Float]
+      attr_reader slot_name: untyped
+
+      # @!attribute [r] database_url
+      #   PostgreSQL connection URL.
+      #   @return [String]
+      # @!attribute [r] slot_name
+      #   Logical replication slot name.
+      #   @return [String]
+      # @!attribute [r] publication_names
+      #   Publication names requested from pgoutput.
+      #   @return [Array<String>]
+      # @!attribute [r] start_lsn
+      #   Optional normalized starting LSN.
+      #   @return [String, nil]
+      # @!attribute [r] proto_version
+      #   pgoutput protocol version.
+      #   @return [Integer]
+      # @!attribute [r] binary
+      #   Whether to request binary column values from pgoutput.
+      #   @return [Boolean]
+      # @!attribute [r] messages
+      #   Whether to request logical decoding messages from pgoutput.
+      #   @return [Boolean]
+      # @!attribute [r] auto_create_slot
+      #   Whether the client should create the slot before streaming.
+      #   @return [Boolean]
+      # @!attribute [r] temporary_slot
+      #   Whether a newly created slot should be temporary.
+      #   @return [Boolean]
+      # @!attribute [r] feedback_interval
+      #   Standby feedback interval in seconds.
+      #   @return [Float]
+      attr_reader publication_names: untyped
+
+      # @!attribute [r] database_url
+      #   PostgreSQL connection URL.
+      #   @return [String]
+      # @!attribute [r] slot_name
+      #   Logical replication slot name.
+      #   @return [String]
+      # @!attribute [r] publication_names
+      #   Publication names requested from pgoutput.
+      #   @return [Array<String>]
+      # @!attribute [r] start_lsn
+      #   Optional normalized starting LSN.
+      #   @return [String, nil]
+      # @!attribute [r] proto_version
+      #   pgoutput protocol version.
+      #   @return [Integer]
+      # @!attribute [r] binary
+      #   Whether to request binary column values from pgoutput.
+      #   @return [Boolean]
+      # @!attribute [r] messages
+      #   Whether to request logical decoding messages from pgoutput.
+      #   @return [Boolean]
+      # @!attribute [r] auto_create_slot
+      #   Whether the client should create the slot before streaming.
+      #   @return [Boolean]
+      # @!attribute [r] temporary_slot
+      #   Whether a newly created slot should be temporary.
+      #   @return [Boolean]
+      # @!attribute [r] feedback_interval
+      #   Standby feedback interval in seconds.
+      #   @return [Float]
+      attr_reader start_lsn: untyped
+
+      # @!attribute [r] database_url
+      #   PostgreSQL connection URL.
+      #   @return [String]
+      # @!attribute [r] slot_name
+      #   Logical replication slot name.
+      #   @return [String]
+      # @!attribute [r] publication_names
+      #   Publication names requested from pgoutput.
+      #   @return [Array<String>]
+      # @!attribute [r] start_lsn
+      #   Optional normalized starting LSN.
+      #   @return [String, nil]
+      # @!attribute [r] proto_version
+      #   pgoutput protocol version.
+      #   @return [Integer]
+      # @!attribute [r] binary
+      #   Whether to request binary column values from pgoutput.
+      #   @return [Boolean]
+      # @!attribute [r] messages
+      #   Whether to request logical decoding messages from pgoutput.
+      #   @return [Boolean]
+      # @!attribute [r] auto_create_slot
+      #   Whether the client should create the slot before streaming.
+      #   @return [Boolean]
+      # @!attribute [r] temporary_slot
+      #   Whether a newly created slot should be temporary.
+      #   @return [Boolean]
+      # @!attribute [r] feedback_interval
+      #   Standby feedback interval in seconds.
+      #   @return [Float]
+      attr_reader proto_version: untyped
+
+      # @!attribute [r] database_url
+      #   PostgreSQL connection URL.
+      #   @return [String]
+      # @!attribute [r] slot_name
+      #   Logical replication slot name.
+      #   @return [String]
+      # @!attribute [r] publication_names
+      #   Publication names requested from pgoutput.
+      #   @return [Array<String>]
+      # @!attribute [r] start_lsn
+      #   Optional normalized starting LSN.
+      #   @return [String, nil]
+      # @!attribute [r] proto_version
+      #   pgoutput protocol version.
+      #   @return [Integer]
+      # @!attribute [r] binary
+      #   Whether to request binary column values from pgoutput.
+      #   @return [Boolean]
+      # @!attribute [r] messages
+      #   Whether to request logical decoding messages from pgoutput.
+      #   @return [Boolean]
+      # @!attribute [r] auto_create_slot
+      #   Whether the client should create the slot before streaming.
+      #   @return [Boolean]
+      # @!attribute [r] temporary_slot
+      #   Whether a newly created slot should be temporary.
+      #   @return [Boolean]
+      # @!attribute [r] feedback_interval
+      #   Standby feedback interval in seconds.
+      #   @return [Float]
+      attr_reader binary: untyped
+
+      # @!attribute [r] database_url
+      #   PostgreSQL connection URL.
+      #   @return [String]
+      # @!attribute [r] slot_name
+      #   Logical replication slot name.
+      #   @return [String]
+      # @!attribute [r] publication_names
+      #   Publication names requested from pgoutput.
+      #   @return [Array<String>]
+      # @!attribute [r] start_lsn
+      #   Optional normalized starting LSN.
+      #   @return [String, nil]
+      # @!attribute [r] proto_version
+      #   pgoutput protocol version.
+      #   @return [Integer]
+      # @!attribute [r] binary
+      #   Whether to request binary column values from pgoutput.
+      #   @return [Boolean]
+      # @!attribute [r] messages
+      #   Whether to request logical decoding messages from pgoutput.
+      #   @return [Boolean]
+      # @!attribute [r] auto_create_slot
+      #   Whether the client should create the slot before streaming.
+      #   @return [Boolean]
+      # @!attribute [r] temporary_slot
+      #   Whether a newly created slot should be temporary.
+      #   @return [Boolean]
+      # @!attribute [r] feedback_interval
+      #   Standby feedback interval in seconds.
+      #   @return [Float]
+      attr_reader messages: untyped
+
+      # @!attribute [r] database_url
+      #   PostgreSQL connection URL.
+      #   @return [String]
+      # @!attribute [r] slot_name
+      #   Logical replication slot name.
+      #   @return [String]
+      # @!attribute [r] publication_names
+      #   Publication names requested from pgoutput.
+      #   @return [Array<String>]
+      # @!attribute [r] start_lsn
+      #   Optional normalized starting LSN.
+      #   @return [String, nil]
+      # @!attribute [r] proto_version
+      #   pgoutput protocol version.
+      #   @return [Integer]
+      # @!attribute [r] binary
+      #   Whether to request binary column values from pgoutput.
+      #   @return [Boolean]
+      # @!attribute [r] messages
+      #   Whether to request logical decoding messages from pgoutput.
+      #   @return [Boolean]
+      # @!attribute [r] auto_create_slot
+      #   Whether the client should create the slot before streaming.
+      #   @return [Boolean]
+      # @!attribute [r] temporary_slot
+      #   Whether a newly created slot should be temporary.
+      #   @return [Boolean]
+      # @!attribute [r] feedback_interval
+      #   Standby feedback interval in seconds.
+      #   @return [Float]
+      attr_reader auto_create_slot: untyped
+
+      # @!attribute [r] database_url
+      #   PostgreSQL connection URL.
+      #   @return [String]
+      # @!attribute [r] slot_name
+      #   Logical replication slot name.
+      #   @return [String]
+      # @!attribute [r] publication_names
+      #   Publication names requested from pgoutput.
+      #   @return [Array<String>]
+      # @!attribute [r] start_lsn
+      #   Optional normalized starting LSN.
+      #   @return [String, nil]
+      # @!attribute [r] proto_version
+      #   pgoutput protocol version.
+      #   @return [Integer]
+      # @!attribute [r] binary
+      #   Whether to request binary column values from pgoutput.
+      #   @return [Boolean]
+      # @!attribute [r] messages
+      #   Whether to request logical decoding messages from pgoutput.
+      #   @return [Boolean]
+      # @!attribute [r] auto_create_slot
+      #   Whether the client should create the slot before streaming.
+      #   @return [Boolean]
+      # @!attribute [r] temporary_slot
+      #   Whether a newly created slot should be temporary.
+      #   @return [Boolean]
+      # @!attribute [r] feedback_interval
+      #   Standby feedback interval in seconds.
+      #   @return [Float]
+      attr_reader temporary_slot: untyped
+
+      # @!attribute [r] database_url
+      #   PostgreSQL connection URL.
+      #   @return [String]
+      # @!attribute [r] slot_name
+      #   Logical replication slot name.
+      #   @return [String]
+      # @!attribute [r] publication_names
+      #   Publication names requested from pgoutput.
+      #   @return [Array<String>]
+      # @!attribute [r] start_lsn
+      #   Optional normalized starting LSN.
+      #   @return [String, nil]
+      # @!attribute [r] proto_version
+      #   pgoutput protocol version.
+      #   @return [Integer]
+      # @!attribute [r] binary
+      #   Whether to request binary column values from pgoutput.
+      #   @return [Boolean]
+      # @!attribute [r] messages
+      #   Whether to request logical decoding messages from pgoutput.
+      #   @return [Boolean]
+      # @!attribute [r] auto_create_slot
+      #   Whether the client should create the slot before streaming.
+      #   @return [Boolean]
+      # @!attribute [r] temporary_slot
+      #   Whether a newly created slot should be temporary.
+      #   @return [Boolean]
+      # @!attribute [r] feedback_interval
+      #   Standby feedback interval in seconds.
+      #   @return [Float]
+      attr_reader feedback_interval: untyped
+
+      # Build and validate a logical replication stream configuration.
+      #
+      # `slot_name` and every publication name are intentionally limited to
+      # simple PostgreSQL identifier-like strings. This keeps command rendering
+      # small and predictable while avoiding quoting rules in this transport
+      # layer.
+      #
+      # Boolean options are normalized with Ruby truthiness. `nil` and `false`
+      # become `false`; all other values become `true`.
+      #
+      # @param database_url [#to_s] PostgreSQL connection URL
+      # @param slot_name [#to_s] logical replication slot name
+      # @param publication_names [Array<#to_s>, #to_s] one or more publication
+      #   names to pass to pgoutput
+      # @param start_lsn [String, Integer, nil] starting LSN as a PostgreSQL LSN
+      #   string, an integer WAL position, or `nil` for `0/0`
+      # @param proto_version [#to_int, #to_s] pgoutput protocol version
+      # @param binary [Object] truthy to request binary column values
+      # @param messages [Object] truthy to request logical decoding messages
+      # @param auto_create_slot [Object] truthy to create the slot before
+      #   starting replication
+      # @param temporary_slot [Object] truthy to create a temporary replication
+      #   slot when `auto_create_slot` is enabled
+      # @param feedback_interval [#to_f, #to_s] seconds between periodic standby
+      #   feedback messages
+      # @return [void]
+      # @raise [ConfigurationError] if publication names are empty or numeric
+      #   settings are invalid
+      # @raise [ArgumentError] if `start_lsn`, `proto_version`, or
+      #   `feedback_interval` cannot be coerced
+      def initialize: (database_url: untyped, slot_name: untyped, publication_names: untyped, ?start_lsn: untyped?, ?proto_version: untyped, ?binary: bool, ?messages: bool, ?auto_create_slot: bool, ?temporary_slot: bool, ?feedback_interval: untyped) -> void
+
+      # Starting LSN to render in `START_REPLICATION`.
+      #
+      # @return [String] normalized LSN string, defaulting to `"0/0"`
+      def start_lsn_string: () -> untyped
+
+      private
+
+      def validate!: () -> untyped
+
+      def normalize_lsn: (untyped value) -> (nil | untyped)
+
+      def validate_identifier: (untyped value, untyped field) -> untyped
+
+      # Boolean type checking helper
+      def boolean: (untyped value, untyped name) -> (true | false | untyped)
+    end
+  end
+end

data/sig/pgoutput/client/connection.rbs

@@ -0,0 +1,91 @@
+module Pgoutput
+  module Client
+    # Thin wrapper around `PG::Connection` for logical replication operations.
+    #
+    # `Connection` hides the small amount of PostgreSQL driver plumbing needed by
+    # the rest of the transport layer. It opens the connection in replication
+    # mode, renders replication commands through {Commands}, and translates
+    # `PG::Error` exceptions into {ConnectionError}.
+    #
+    # @api private
+    class Connection
+      @configuration: untyped
+
+      @pg_connection: untyped
+
+      # Configuration associated with this connection.
+      #
+      # @return [Configuration]
+      attr_reader configuration: untyped
+
+      # Open a PostgreSQL connection in database replication mode.
+      #
+      # @param configuration [Configuration] replication configuration
+      # @return [Connection] wrapper around an open `PG::Connection`
+      # @raise [ConnectionError] if the `pg` gem cannot connect
+      def self.open: (untyped configuration) -> untyped
+
+      # Build a connection wrapper.
+      #
+      # This constructor is public primarily for tests and alternative connection
+      # factories. Normal callers should use {.open}.
+      #
+      # @param configuration [Configuration] replication configuration
+      # @param pg_connection [PG::Connection] connected PostgreSQL driver object
+      # @return [void]
+      def initialize: (configuration: untyped, pg_connection: untyped) -> void
+
+      # Execute PostgreSQL's `IDENTIFY_SYSTEM` replication command.
+      #
+      # @return [PG::Result] server identity result
+      # @raise [ConnectionError] if PostgreSQL rejects the command
+      def identify_system: () -> untyped
+
+      # Create the configured logical replication slot.
+      #
+      # @return [PG::Result] command result
+      # @raise [ConnectionError] if PostgreSQL rejects the command
+      def create_replication_slot: () -> untyped
+
+      # Drop the configured logical replication slot.
+      #
+      # @return [PG::Result] command result
+      # @raise [ConnectionError] if PostgreSQL rejects the command
+      def drop_replication_slot: () -> untyped
+
+      # Start streaming logical replication from the configured slot and LSN.
+      #
+      # @return [PG::Result] command result
+      # @raise [ConnectionError] if PostgreSQL rejects the command
+      def start_replication: () -> untyped
+
+      # Receive one CopyData payload from the server.
+      #
+      # The call is non-blocking because the underlying `pg` call receives
+      # `false` for its blocking argument. `nil` means no complete CopyData
+      # payload is currently available.
+      #
+      # @return [String, nil] raw CopyData payload or `nil`
+      # @raise [ConnectionError] if receiving fails
+      def get_copy_data: () -> untyped
+
+      # Send one CopyData payload to the server.
+      #
+      # Used for standby status feedback messages.
+      #
+      # @param payload [String] raw CopyData payload
+      # @return [void]
+      # @raise [ConnectionError] if sending fails
+      def put_copy_data: (untyped payload) -> untyped
+
+      # Close the PostgreSQL connection if it is still open.
+      #
+      # @return [void]
+      def close: () -> (untyped | nil)
+
+      private
+
+      def exec: (untyped sql) -> untyped
+    end
+  end
+end

data/sig/pgoutput/client/errors.rbs

@@ -0,0 +1,43 @@
+module Pgoutput
+  module Client
+    # Base error class for all pgoutput-client failures.
+    #
+    # Rescue this class when callers want to handle any error raised by the
+    # transport layer without also rescuing unrelated Ruby or PostgreSQL driver
+    # exceptions.
+    #
+    # @api public
+    class Error < StandardError
+    end
+
+    # Raised when stream configuration is invalid.
+    #
+    # Examples include an empty publication list, invalid replication slot name,
+    # invalid publication name, non-positive protocol version, or non-positive
+    # feedback interval.
+    #
+    # @api public
+    class ConfigurationError < Error
+    end
+
+    # Raised when a replication protocol envelope cannot be parsed.
+    #
+    # This error represents malformed or unexpected CopyData payloads at the
+    # transport-envelope level. It does not describe pgoutput plugin payload
+    # parsing errors; those belong to the parser layer.
+    #
+    # @api public
+    class ProtocolError < Error
+    end
+
+    # Raised when a PostgreSQL replication connection operation fails.
+    #
+    # `Connection` converts `PG::Error` instances into this error so public
+    # callers do not need to depend on the PostgreSQL driver's exception classes
+    # for transport-level handling.
+    #
+    # @api public
+    class ConnectionError < Error
+    end
+  end
+end

data/sig/pgoutput/client/feedback.rbs

@@ -0,0 +1,71 @@
+module Pgoutput
+  module Client
+    class FeedbackData < Data
+      attr_reader received_lsn: Integer
+      attr_reader flushed_lsn: Integer
+      attr_reader applied_lsn: Integer
+      attr_reader client_clock: Integer
+      attr_reader reply_requested: bool
+
+      def self.new: (
+        Integer received_lsn,
+        Integer flushed_lsn,
+        Integer applied_lsn,
+        Integer client_clock,
+        bool reply_requested
+      ) -> instance
+    end
+    
+    # Standby status feedback message builder.
+    #
+    # Logical replication clients periodically send standby status updates to
+    # tell PostgreSQL which WAL location has been received, flushed, and applied.
+    # `Feedback` models that update and can serialize itself into the CopyData
+    # payload expected by the replication protocol.
+    #
+    # @attr_reader received_lsn [Integer] latest WAL location received by the client
+    # @attr_reader flushed_lsn [Integer] latest WAL location flushed by the client
+    # @attr_reader applied_lsn [Integer] latest WAL location applied by the client
+    # @attr_reader client_clock [Integer] PostgreSQL timestamp in microseconds since 2000-01-01 UTC
+    # @attr_reader reply_requested [Boolean] whether this feedback is responding to an immediate-reply request
+    class Feedback < FeedbackData
+      def self.build: (
+        Integer received_lsn,
+        Integer flushed_lsn,
+        Integer applied_lsn,
+        ?reply_requested: bool
+      ) -> Feedback
+
+      # Build feedback using the current wall-clock time.
+      #
+      # By default, flushed and applied LSNs follow the received LSN. Callers can
+      # pass lower values if they need to distinguish receipt from durable flush
+      # or application progress.
+      #
+      # @param received_lsn [Integer] latest WAL location received by the client
+      # @param flushed_lsn [Integer] latest WAL location flushed by the client
+      # @param applied_lsn [Integer] latest WAL location applied by the client
+      # @param reply_requested [Boolean] whether this is an immediate reply
+      # @return [Feedback] immutable feedback value
+      def self.now: (received_lsn: untyped, ?flushed_lsn: untyped, ?applied_lsn: untyped, ?reply_requested: bool) -> untyped
+
+      # Build a protocol CopyData payload for standby status update.
+      #
+      # The payload begins with the standby status update tag `r`, followed by
+      # three unsigned 64-bit LSN fields, the PostgreSQL timestamp, and a
+      # one-byte reply-requested flag.
+      #
+      # @return [String] frozen binary CopyData payload
+      def to_copy_data: () -> untyped
+
+      # Current PostgreSQL protocol timestamp.
+      #
+      # PostgreSQL timestamps in replication messages are expressed as
+      # microseconds since 2000-01-01 00:00:00 UTC, not Unix epoch
+      # microseconds.
+      #
+      # @return [Integer] microseconds since 2000-01-01 UTC
+      def self.current_pg_time: () -> untyped
+    end
+  end
+end

data/sig/pgoutput/client/keepalive.rbs

@@ -0,0 +1,55 @@
+module Pgoutput
+  module Client   
+    class KeepaliveData < Data
+      attr_reader wal_end: Integer
+      attr_reader server_clock: Integer
+      attr_reader reply_requested: bool
+
+      def self.new: (
+        Integer wal_end,
+        Integer server_clock,
+        bool reply_requested
+      ) -> instance
+    end
+
+    # Immutable primary keepalive replication message.
+    #
+    # PostgreSQL sends keepalive CopyData payloads while a replication stream is
+    # active. The payload layout is:
+    #
+    # ```text
+    # Byte 0      : message tag `k`
+    # Bytes 1-8   : current server WAL end, unsigned 64-bit big-endian
+    # Bytes 9-16  : server clock, PostgreSQL timestamp format
+    # Byte 17     : reply-requested flag, 1 for immediate feedback
+    # ```
+    #
+    # The stream layer uses this message to advance its known WAL position and to
+    # decide whether to send standby status feedback immediately.
+    #
+    # @attr_reader wal_end [Integer] latest server WAL position
+    # @attr_reader server_clock [Integer] PostgreSQL server timestamp in
+    #   microseconds since 2000-01-01 UTC
+    # @attr_reader reply_requested [Boolean] whether PostgreSQL requested
+    #   immediate feedback
+    class Keepalive < KeepaliveData
+      # Parse a keepalive CopyData payload.
+      #
+      # @param bytes [String] raw CopyData payload beginning with `k`
+      # @return [Keepalive] immutable parsed keepalive message
+      # @raise [ProtocolError] if the payload is empty, has the wrong message
+      #   tag, or is too short to contain the required fields
+      def self.parse: (untyped bytes) -> untyped
+
+      # Latest server WAL position formatted as a PostgreSQL LSN string.
+      #
+      # @return [String]
+      def wal_end_lsn: () -> untyped
+
+      # @param binary [String]
+      # @param offset [Integer]
+      # @return [Integer]
+      def self.unpack_u64: (untyped binary, untyped offset) -> untyped
+    end
+  end
+end