pgmq-ruby 0.8.1 → 0.8.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f66e00ebdfb72d1bdf92956a632bb22e0ca4f36a5dc262c3e3e206a3e35884cc
-  data.tar.gz: 93d9c3f674990f774581c70fb9c59d2f5c7920d617f9dcf9ad9c051efb7e661b
+  metadata.gz: 943d0ebf4cffa43c1163f651575cbfb0e9785fc675f388ef7b208538e9dab8a3
+  data.tar.gz: fd9ab2693a0bf87c6230330ac8c4e046c585c420ecbdce0b77b06a6b652fd266
 SHA512:
-  metadata.gz: 131525c92fceebbbf80964b98168bd4343fccb221eea5a13c55d6cf0f84a168641e09f3a686d5ef35ecc6854e8b6a8f9577d2a5e7553423bd4c44ba41df09f3c
-  data.tar.gz: b851ab706d9986c718855577e3eaebd8e3c79562aabf67943bdb7573427847a9392f5385dfb399edb642c1e2a663028adecbb7bfa6790964ea684d54125e1b02
+  metadata.gz: 6cc612c51d2b89e7ecfd3ea6879eb3e731a8ce96cba961863119a34b9dd094b0e5c139045d0c0cdf0df964130ec0e65a9df4961defe6843603767e9369b60800
+  data.tar.gz: ff1caf1d8012504204f5d793b577c0c3603ba2d156257786a32fab73618d52971d0c49edfba0860f9a5ad9dd56e34dca272891e594b55521761f514fd8fdc053

data/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.8.2 (2026-11-02)
+
+### Queue Naming
+- **[Fix]** The `InvalidQueueNameError` message for a too-long queue name states the real limit: "exceeds maximum
+  length of 47 characters" (was 48; a 48-character name was already rejected). The README now gives 47 as the maximum
+  and no longer calls queue names case-sensitive: names differing only in case share one table (PGMQ lower-cases
+  table names) but get separate `pgmq.meta` rows, so use one spelling per queue.### Documentation
+- **[Fix]** The README `wait_for_notify` example said the call returns the notification payload; it returns the
+  channel name (`nil` on timeout).
+
 ## 0.8.1 (2026-10-30)
 
 ### Producer

data/README.md

@@ -23,7 +23,7 @@ PGMQ-Ruby is a Ruby client for PGMQ (PostgreSQL Message Queue). It provides dire
 - [Requirements](#requirements)
 - [Installation](#installation)
 - [Quick Start](#quick-start)
-- [Configuration](#configuration)
+- [Connection Options](#connection-options)
 - [API Reference](#api-reference)
   - [Queue Management](#queue-management)
   - [Sending Messages](#sending-messages)
@@ -91,7 +91,7 @@ This gem provides complete support for all core PGMQ SQL functions. Based on the
 | | Conditional Filtering | Server-side JSONB filtering with `conditional:` | ✅ |
 | | Multi-Queue Ops | Read/pop/delete/archive from multiple queues | ✅ |
 | | Consumer | Minimal single-threaded `PGMQ::Consumer` loop over one or more queues with ack on success | ✅ |
-| | Queue Validation | 48-character limit and name validation | ✅ |
+| | Queue Validation | 47-character limit and name validation | ✅ |
 | | Connection Pooling | Thread-safe connection pool for concurrency | ✅ |
 | | Pluggable Serializers | JSON (default) with custom serializer support | ✅ |
 
@@ -427,10 +427,11 @@ queues = client.list_queues
 
 Queue names must follow PostgreSQL identifier rules with PGMQ-specific constraints:
 
-- **Maximum 48 characters** (PGMQ enforces this limit for table prefixes)
+- **Maximum 47 characters** (PGMQ enforces this limit for table prefixes)
 - Must start with a letter or underscore
 - Can contain only letters, digits, and underscores
-- Case-sensitive
+- Names that differ only in case (`Orders`, `orders`) share one message table, because PGMQ lower-cases table names.
+  PGMQ still registers each spelling separately in `pgmq.meta`, so always use one spelling per queue (e.g. lower case)
 
 **Valid Queue Names:**
 
@@ -881,7 +882,7 @@ end
 client.disable_notify_insert("queue_name")
 
 # Block until a NOTIFY arrives on the queue's channel (or timeout expires)
-# Returns the payload string on notification, nil on timeout
+# Returns the channel name on notification, nil on timeout
 client.wait_for_notify("queue_name", timeout: 5)
 
 # Block form — inspect notification metadata

data/lib/pgmq/queue_name.rb

@@ -28,8 +28,8 @@ module PGMQ
   #   PGMQ::QueueName.sanitize!("!!!")           # => raises InvalidQueueNameError
   #   PGMQ::QueueName.sanitize("99 Problems!")   # => "q_99_problems"
   module QueueName
-    # Maximum queue name length. PGMQ creates tables with prefixes (+q_+, +a_+) and PostgreSQL caps identifiers at 63
-    # characters; PGMQ enforces 48 to leave room for those prefixes and suffixes.
+    # Queue names must be shorter than this. PGMQ creates tables with prefixes (+q_+, +a_+) and PostgreSQL caps
+    # identifiers at 63 characters; PGMQ rejects names of 48+ characters to leave room for those prefixes and suffixes.
     MAX_LENGTH = 48
 
     # A valid queue name: starts with a letter or underscore, then letters, digits, or underscores.
@@ -67,7 +67,7 @@ module PGMQ
 
       if str.length >= MAX_LENGTH
         raise Errors::InvalidQueueNameError,
-          "Queue name '#{str}' exceeds maximum length of #{MAX_LENGTH} characters " \
+          "Queue name '#{str}' exceeds maximum length of #{MAX_LENGTH - 1} characters " \
           "(current length: #{str.length})"
       end
 

data/lib/pgmq/version.rb

@@ -2,5 +2,5 @@
 
 module PGMQ
   # Current version of the pgmq-ruby gem
-  VERSION = "0.8.1"
+  VERSION = "0.8.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pgmq-ruby
 version: !ruby/object:Gem::Version
-  version: 0.8.1
+  version: 0.8.2
 platform: ruby
 authors:
 - Maciej Mensfeld