zizq 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 77ab05fe491ab193d0c5c3b1106aac3e5effe7b1dcb7e0117b70e0e05652426b
-  data.tar.gz: 05f26bd94ca2127e7e859212348e063bc9354d866945ae500514dcfbcfe57828
+  metadata.gz: fb5651af26b76aeb9da0d00636cb1c2f10479c544c52083d16436f46670ba346
+  data.tar.gz: 30b0a1142d96c565d11ef4252f07305e6ef55ac264217a8540975236ae007958
 SHA512:
-  metadata.gz: f12216566271dbd68395eeada829ffd68bfd853e86c1a8e598dbac6c3c7f5d8af5008ee084a9a7ebaef99d74144c6d05995fe32e01f0349b47dac6beb082c702
-  data.tar.gz: 505804d9abd2c1cff8a749bd9cb6ad3d224d09545648a314b54a3094a96f2d18cb18257661833479bf1b59959d6d300730e2cbcbb70572afee5195bb538d8460
+  metadata.gz: 73d90b0c47f1dcf3452d573829211d69f853b38aca8d0b7e14be74017ac9b802f3faa9151f11ae1fcc0644a574d0b91dc308eec7c8fd560dccf93e1ab31ef321
+  data.tar.gz: '0843a45519c6d0c6256450e242887a08489fdfb84040f6f302ba615118e5dfb9171cc52db1e5407446d0caa4012ff3b136a583f421c19ea3cd0fe6ba92a38371'

data/lib/zizq/client.rb

@@ -249,6 +249,37 @@ module Zizq
       Resources::JobPage.new(self, data)
     end
 
+    # Count jobs matching the given filters.
+    #
+    # Accepts the same filter arguments as `list_jobs` (minus pagination).
+    # Returns the count as an integer.
+    #
+    # @rbs id: (String | Array[String])?
+    # @rbs status: (String | Array[String])?
+    # @rbs queue: (String | Array[String])?
+    # @rbs type: (String | Array[String])?
+    # @rbs filter: String?
+    # @rbs return: Integer
+    def count_jobs(id: nil,
+                   status: nil,
+                   queue: nil,
+                   type: nil,
+                   filter: nil)
+      options = { id:, status:, queue:, type:, filter: }.compact #: Hash[Symbol, untyped]
+
+      multi_keys = %i[id status queue type]
+      params = build_where_params(options, multi_keys:)
+
+      # An empty filter ([] or "") matches nothing — short-circuit.
+      multi_keys.each do |key|
+        return 0 if params[key] == ""
+      end
+
+      response = get("/jobs/count", params:)
+      data = handle_response!(response, expected: 200)
+      data.fetch("count")
+    end
+
     # Delete a single job by ID.
     #
     # @rbs id: String

data/lib/zizq/query.rb

@@ -283,6 +283,32 @@ module Zizq
       limit(2).to_a.size == 1
     end
 
+    # Count matching jobs via the server-side count endpoint.
+    #
+    # Without a block or argument, uses `GET /jobs/count` for an efficient
+    # server-side count. When a limit is set, caps the result locally with
+    # `[total, limit].min`.
+    #
+    # With a block or argument, falls back to Enumerable (iterates and counts
+    # matching jobs).
+    #
+    # @rbs *args: untyped
+    # @rbs &block: ?(Resources::Job) -> bool
+    # @rbs return: Integer
+    def count(*args, &block)
+      return super if block || !args.empty?
+
+      total = Zizq.client.count_jobs(
+        id: @id,
+        queue: @queue,
+        type: @type,
+        status: @status,
+        filter: @jq_filter,
+      )
+
+      @limit ? [total, @limit].min : total
+    end
+
     # Iterate over matching jobs in reverse order.
     #
     # Optimised: pushes the reverse ordering to the server instead of

data/lib/zizq/version.rb

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

data/sig/generated/zizq/client.rbs

@@ -108,6 +108,19 @@ module Zizq
     # @rbs return: Resources::JobPage
     def list_jobs: (?id: (String | Array[String])?, ?status: (String | Array[String])?, ?queue: (String | Array[String])?, ?type: (String | Array[String])?, ?filter: String?, ?from: String?, ?order: Zizq::sort_direction?, ?limit: Integer?) -> Resources::JobPage
 
+    # Count jobs matching the given filters.
+    #
+    # Accepts the same filter arguments as `list_jobs` (minus pagination).
+    # Returns the count as an integer.
+    #
+    # @rbs id: (String | Array[String])?
+    # @rbs status: (String | Array[String])?
+    # @rbs queue: (String | Array[String])?
+    # @rbs type: (String | Array[String])?
+    # @rbs filter: String?
+    # @rbs return: Integer
+    def count_jobs: (?id: (String | Array[String])?, ?status: (String | Array[String])?, ?queue: (String | Array[String])?, ?type: (String | Array[String])?, ?filter: String?) -> Integer
+
     # Delete a single job by ID.
     #
     # @rbs id: String

data/sig/generated/zizq/query.rbs

@@ -208,6 +208,20 @@ module Zizq
     # @rbs return: bool
     def one?: () ?{ (Resources::Job) -> bool } -> bool
 
+    # Count matching jobs via the server-side count endpoint.
+    #
+    # Without a block or argument, uses `GET /jobs/count` for an efficient
+    # server-side count. When a limit is set, caps the result locally with
+    # `[total, limit].min`.
+    #
+    # With a block or argument, falls back to Enumerable (iterates and counts
+    # matching jobs).
+    #
+    # @rbs *args: untyped
+    # @rbs &block: ?(Resources::Job) -> bool
+    # @rbs return: Integer
+    def count: (*untyped args) ?{ (Resources::Job) -> bool } -> Integer
+
     # Iterate over matching jobs in reverse order.
     #
     # Optimised: pushes the reverse ordering to the server instead of

metadata

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