zizq 0.3.6 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a95c96d7b844064db29aea81935d6ec6e3c6953fc47459fcfd6253b6b44aa1e7
-  data.tar.gz: 19a8e38ef04716ba02b21bb4ce1f8f2b3e597b1f9845ada71dde5ae7d31fecd3
+  metadata.gz: 16999267b593c3fbe71930e3e9d57754e8fd2fea5b336dbeef281e26aea80cb4
+  data.tar.gz: da78dd13533f26d22ad896435d62e0e6348ff4978047f96ee1dede9e98c06cc0
 SHA512:
-  metadata.gz: d4158e9e2b3f58e2c1b823b26f8c81a9ee5ab347d72683377909fed7b4d0d163caf3e27708d3e1f3cbd1af3018068fda34d97405ec6095732b0cda57909a82fc
-  data.tar.gz: 95c1453a0af6a82e8ad0abd5e2a8085550ce4cf5ef6b2871cb653fdd1068994f69b36bb04a5e30d2ec76c1ccc02a1e142621a5c5bde7de9bab84517917b90fef
+  metadata.gz: 24fa716817d30de27b041c693ea3275f24ad8eec6979d7b58b271e6d4868329a87a3a7a2402068699d21c7fcb96c19061609a77df2cc93034bbd4d355fb2277f
+  data.tar.gz: 23d3005105f3ce7140d2d644da28b2af508457c71e30e8df9754db44afa1ca3887b69c4f17fc950c65e46ea87bb2ce9bb8dda534a79321fd32a0138d5da9a6f9

data/README.md

@@ -33,13 +33,13 @@ API.
 Add it to your application's `Gemfile`:
 
 ```ruby
-gem 'zizq', '~> 0.3.6'
+gem 'zizq', '~> 0.4.0'
 ```
 
 Or install it manually:
 
 ```shell
-$ gem install zizq -v 0.3.6
+$ gem install zizq -v 0.4.0
 ```
 
 Ruby **3.2.8 or newer** is required. Client and server share version
@@ -161,7 +161,7 @@ Zizq.enqueue_raw(
 )
 ```
 
-### Cross-language and low-level dispatch { #router }
+### Cross-language and low-level dispatch
 
 When a Ruby app needs to *process* jobs enqueued by another language
 (or by `Zizq.enqueue_raw`), `Zizq::Router` maps `type` strings to

data/lib/zizq/client.rb

@@ -336,6 +336,26 @@ module Zizq
       data.fetch("deleted")
     end
 
+    # Wipe *every* cron group and *every* job on the server.
+    #
+    # Equivalent to calling `delete_all_crons` followed by
+    # `delete_all_jobs` (no filter), but in a single request. Useful
+    # primarily as a setup/teardown step in tests where you want a
+    # known-empty server between scenarios.
+    #
+    # **Destructive.** No filters, no escape hatch, no confirmation —
+    # the server-side operation simply returns once everything is gone.
+    #
+    # Named `erase_all_data` rather than `reset` because `Zizq.reset!`
+    # already exists at the module level for client-side SDK state.
+    #
+    # @rbs return: void
+    def erase_all_data
+      response = raw_post("/reset")
+      handle_response!(response, expected: 204)
+      nil
+    end
+
     # Update a single job's mutable fields.
     #
     # Fields not provided are left unchanged. Use `Zizq::RESET` to clear
@@ -502,6 +522,23 @@ module Zizq
       nil
     end
 
+    # Delete every cron group on the server in a single call.
+    #
+    # Returns the number of cron groups removed.
+    #
+    # **Destructive.** This deletes *every cron group on the server*.
+    # For granular deletes, use `delete_cron_group` with a specific
+    # name.
+    #
+    # Requires a Pro license on the server.
+    #
+    # @rbs return: Integer
+    def delete_all_crons
+      response = delete("/crons")
+      data = handle_response!(response, expected: 200)
+      data.fetch("deleted")
+    end
+
     # Fetch a single cron entry.
     #
     # @rbs group: String

data/lib/zizq/test/client.rb

@@ -4,6 +4,8 @@
 # rbs_inline: enabled
 # frozen_string_literal: true
 
+require "json"
+
 module Zizq
   module Test
     # A `Zizq::Client` stand-in for use in test suites.
@@ -143,7 +145,7 @@ module Zizq
         req = EnqueueRequest.new(
           queue:,
           type:,
-          payload:,
+          payload: self.class.normalize_payload(payload),
           priority:,
           ready_at:,
           retry_limit:,
@@ -162,7 +164,7 @@ module Zizq
             req = EnqueueRequest.new(
               queue:        params[:queue],
               type:         params[:type],
-              payload:      params[:payload],
+              payload:      self.class.normalize_payload(params[:payload]),
               priority:     params[:priority],
               ready_at:     params[:ready_at],
               retry_limit:  params[:retry_limit],
@@ -236,6 +238,22 @@ module Zizq
         "#{ID_PREFIX}#{counter.to_s.rjust(ID_LENGTH - ID_PREFIX.length, '0')}"
       end
 
+      public
+
+      # Round-trip the payload through JSON so the in-memory
+      # representation matches what a consumer would receive over the
+      # wire: symbol keys / Symbol values become strings, nested
+      # hashes and arrays are normalized recursively, and non-JSON-
+      # safe values (BigDecimal, custom objects) raise here rather
+      # than surviving in test mode only to break in production.
+      #
+      # Also used by `Zizq::Test.enqueued_raw?` / `enqueued_raw_count`
+      # to normalize the query side so symbol-keyed assertion payloads
+      # still match the (now string-keyed) buffer.
+      def self.normalize_payload(payload) #: (untyped) -> untyped
+        JSON.parse(JSON.generate(payload))
+      end
+
       # Returns entries matching every named filter AND the predicate.
       # All filter kwargs are optional; unset means "don't filter on
       # this axis." Callers must hold `@mutex` — public accessors do

data/lib/zizq/test.rb

@@ -168,7 +168,13 @@ module Zizq
       filters = {}
       filters[:only_queues] = queue if queue
       filters[:only_types]  = type  if type
-      filters[:filter]      = ->(job) { job.payload == payload } unless payload.nil?
+      unless payload.nil?
+        # Normalize the assertion-side payload the same way enqueue
+        # normalizes the buffered one, so symbol-keyed test payloads
+        # still match the (string-keyed) wire-format buffer.
+        normalized = Client.normalize_payload(payload)
+        filters[:filter] = ->(job) { job.payload == normalized }
+      end
       client.enqueued_jobs(**filters).size
     end
 

data/lib/zizq/version.rb

@@ -5,5 +5,5 @@
 # frozen_string_literal: true
 
 module Zizq
-  VERSION = "0.3.6" #: String
+  VERSION = "0.4.0" #: String
 end

data/sig/generated/zizq/client.rbs

@@ -146,6 +146,22 @@ module Zizq
     # @rbs return: Integer
     def delete_all_jobs: (?where: Zizq::where_params) -> Integer
 
+    # Wipe *every* cron group and *every* job on the server.
+    #
+    # Equivalent to calling `delete_all_crons` followed by
+    # `delete_all_jobs` (no filter), but in a single request. Useful
+    # primarily as a setup/teardown step in tests where you want a
+    # known-empty server between scenarios.
+    #
+    # **Destructive.** No filters, no escape hatch, no confirmation —
+    # the server-side operation simply returns once everything is gone.
+    #
+    # Named `erase_all_data` rather than `reset` because `Zizq.reset!`
+    # already exists at the module level for client-side SDK state.
+    #
+    # @rbs return: void
+    def erase_all_data: () -> void
+
     # Update a single job's mutable fields.
     #
     # Fields not provided are left unchanged. Use `Zizq::RESET` to clear
@@ -239,6 +255,19 @@ module Zizq
     # @rbs return: void
     def delete_cron_group: (String name) -> void
 
+    # Delete every cron group on the server in a single call.
+    #
+    # Returns the number of cron groups removed.
+    #
+    # **Destructive.** This deletes *every cron group on the server*.
+    # For granular deletes, use `delete_cron_group` with a specific
+    # name.
+    #
+    # Requires a Pro license on the server.
+    #
+    # @rbs return: Integer
+    def delete_all_crons: () -> Integer
+
     # Fetch a single cron entry.
     #
     # @rbs group: String

data/sig/generated/zizq/test/client.rbs

@@ -120,6 +120,20 @@ module Zizq
 
       def synthetic_id: (untyped counter) -> untyped
 
+      public
+
+      # Round-trip the payload through JSON so the in-memory
+      # representation matches what a consumer would receive over the
+      # wire: symbol keys / Symbol values become strings, nested
+      # hashes and arrays are normalized recursively, and non-JSON-
+      # safe values (BigDecimal, custom objects) raise here rather
+      # than surviving in test mode only to break in production.
+      #
+      # Also used by `Zizq::Test.enqueued_raw?` / `enqueued_raw_count`
+      # to normalize the query side so symbol-keyed assertion payloads
+      # still match the (now string-keyed) buffer.
+      def self.normalize_payload: (untyped payload) -> untyped
+
       # Returns entries matching every named filter AND the predicate.
       # All filter kwargs are optional; unset means "don't filter on
       # this axis." Callers must hold `@mutex` — public accessors do

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: zizq
 version: !ruby/object:Gem::Version
-  version: 0.3.6
+  version: 0.4.0
 platform: ruby
 authors:
 - Chris Corbyn <chris@zizq.io>
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-27 00:00:00.000000000 Z
+date: 2026-05-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: async-http