zizq 0.1.0

data/sig/generated/zizq/query.rbs

@@ -0,0 +1,327 @@
+# Generated from lib/zizq/query.rb with RBS::Inline
+
+module Zizq
+  # Composable query builder for jobs in Zizq.
+  #
+  # Provides a chainable, immutable API for filtering, iterating, updating,
+  # and deleting jobs. Each filter method returns a new `Query` instance,
+  # leaving the original unchanged.
+  #
+  # `Query` is `Enumerable`— it lazily paginates through results, so
+  # standard Ruby methods like `count`, `map`, `select`, `first`, etc.
+  # work out of the box.
+  #
+  # Examples:
+  #
+  #   # Count ready jobs on a queue
+  #   Zizq::Query.new.by_queue("emails").by_status("ready").count
+  #
+  #   # Move all jobs from one queue to another
+  #   Zizq::Query.new.by_queue("old").update_all(queue: "new")
+  #
+  #   # Delete dead jobs matching a payload filter
+  #   Zizq::Query.new.by_status("dead").add_jq_filter(".user_id == 42").delete_all
+  #
+  #   # Iterate in batches
+  #   Zizq::Query.new.in_pages_of(100).each { |job| puts job.id }
+  #
+  #   # Move all jobs from one queue to another in batches.
+  #   Zizq::Query.new.by_queue("old").in_pages_of(100).update_all(queue: "new")
+  #
+  #   # Find jobs by class and arguments
+  #   Zizq::Query.new.by_job_class_and_args(SendEmailJob, 42, template: "welcome")
+  #
+  #   # Find jobs by class and arguments (subset)
+  #   Zizq::Query.new.by_job_class_and_args_subset(SendEmailJob, 42)
+  class Query
+    # Maximum page size the server can handle.
+    MAX_PAGE_SIZE: Integer
+
+    include ::Enumerable[Zizq::Resources::Job]
+
+    # Initialize the query with some initial parameters.
+    #
+    # @rbs id: (String | Array[String])?
+    # @rbs queue: (String | Array[String])?
+    # @rbs type: (String | Array[String])?
+    # @rbs status: (String | Array[String])?
+    # @rbs jq_filter: String?
+    # @rbs order: Zizq::sort_direction?
+    # @rbs limit: Integer?
+    # @rbs page_size: Integer?
+    # @rbs return: void
+    def initialize: (?id: (String | Array[String])?, ?queue: (String | Array[String])?, ?type: (String | Array[String])?, ?status: (String | Array[String])?, ?jq_filter: String?, ?order: Zizq::sort_direction?, ?limit: Integer?, ?page_size: Integer?) -> void
+
+    # Set the page size for paginated iteration.
+    #
+    # When set, `each_page` fetches pages of this size, and `each` fetches jobs
+    # in pages of this size. Also used by `update_all` and `delete_all` to
+    # batch operations by page.
+    #
+    # @rbs page_size: Integer?
+    # @rbs return: Query
+    def in_pages_of: (Integer? page_size) -> Query
+
+    # Filter by job ID (replaces any existing ID filter).
+    #
+    # @rbs id: (String | Array[String])?
+    # @rbs return: Query
+    def by_id: ((String | Array[String])? id) -> Query
+
+    # Add a job ID to the existing ID filter.
+    #
+    # @rbs id: String | Array[String]
+    # @rbs return: Query
+    def add_id: (String | Array[String] id) -> Query
+
+    # Filter by queue name (replaces any existing queue filter).
+    #
+    # @rbs queue: (String | Array[String])?
+    # @rbs return: Query
+    def by_queue: ((String | Array[String])? queue) -> Query
+
+    # Add a queue to the existing queue filter.
+    #
+    # @rbs queue: String | Array[String]
+    # @rbs return: Query
+    def add_queue: (String | Array[String] queue) -> Query
+
+    # Filter by job type (replaces any existing type filter).
+    #
+    # @rbs type: (String | Array[String])?
+    # @rbs return: Query
+    def by_type: ((String | Array[String])? type) -> Query
+
+    # Add a type to the existing type filter.
+    #
+    # @rbs type: String | Array[String]
+    # @rbs return: Query
+    def add_type: (String | Array[String] type) -> Query
+
+    # Filter by status (replaces any existing status filter).
+    #
+    # @rbs status: (String | Array[String])
+    # @rbs return: Query
+    def by_status: (String | Array[String] status) -> Query
+
+    # Add a status to the existing status filter.
+    #
+    # @rbs status: String | Array[String]
+    # @rbs return: Query
+    def add_status: (String | Array[String] status) -> Query
+
+    # Filter by job class and exact arguments.
+    #
+    # The job class must include `Zizq::Job` or for Active Job classes must
+    # extend `Zizq::ActiveJobConfig`.
+    #
+    # Sets the type filter to the class name and adds a jq payload filter
+    # for an exact match of the serialized arguments.
+    #
+    # @rbs job_class: Zizq::job_class
+    # @rbs *args: untyped
+    # @rbs **kwargs: untyped
+    # @rbs return: Query
+    def by_job_class_and_args: (Zizq::job_class job_class, *untyped args, **untyped kwargs) -> Query
+
+    # Filter by job class and a subset of arguments.
+    #
+    # Matches jobs whose positional args start with the given values and
+    # whose kwargs contain (at minimum) the given key/value pairs.
+    #
+    # The job class must include `Zizq::Job` or for Active Job classes must
+    # extend `Zizq::ActiveJobConfig`.
+    #
+    # @rbs job_class: Zizq::job_class
+    # @rbs *args: untyped
+    # @rbs **kwargs: untyped
+    # @rbs return: Query
+    def by_job_class_and_args_subset: (Zizq::job_class job_class, *untyped args, **untyped kwargs) -> Query
+
+    # Replace the jq payload filter expression.
+    #
+    # @rbs jq_filter: String?
+    # @rbs return: Query
+    def by_jq_filter: (String? jq_filter) -> Query
+
+    # Add a jq payload filter, logically combines with any existing filter via
+    # "and".
+    #
+    # @rbs jq_filter: String
+    # @rbs return: Query
+    def add_jq_filter: (String jq_filter) -> Query
+
+    # Set the sort order for iteration.
+    #
+    # @rbs order: Zizq::sort_direction?
+    # @rbs return: Query
+    def order: (Zizq::sort_direction? order) -> Query
+
+    # Limit the total number of jobs returned.
+    #
+    # This is a total limit, imposed across potentially multiple page fetches.
+    # This limit also applies to `update_all` and `delete_all` operations.
+    #
+    # @rbs limit: Integer?
+    # @rbs return: Query
+    def limit: (Integer? limit) -> Query
+
+    # Reverse the sort order.
+    #
+    # Returns a new query with the opposite order. If no order was set,
+    # defaults to descending (the server default is ascending).
+    #
+    # @rbs return: Query
+    def reverse_order: () -> Query
+
+    # Returns true if there are no matching jobs.
+    #
+    # Optimised: fetches a single job to check.
+    #
+    # @rbs return: bool
+    def empty?: () -> bool
+
+    # Returns true if there are any matching jobs.
+    #
+    # Without a block, optimised to fetch a single job. With a block,
+    # falls back to Enumerable (tests each job against the block).
+    #
+    # @rbs &block: ?(Resources::Job) -> bool
+    # @rbs return: bool
+    def any?: () ?{ (Resources::Job) -> bool } -> bool
+
+    # Returns true if there are no matching jobs.
+    #
+    # Without a block, optimised to fetch a single job. With a block,
+    # falls back to Enumerable (tests each job against the block).
+    #
+    # @rbs &block: ?(Resources::Job) -> bool
+    # @rbs return: bool
+    def none?: () ?{ (Resources::Job) -> bool } -> bool
+
+    # Returns true if there is exactly one matching job.
+    #
+    # Without a block, optimised to fetch at most two jobs. With a block,
+    # falls back to Enumerable.
+    #
+    # @rbs &block: ?(Resources::Job) -> bool
+    # @rbs return: bool
+    def one?: () ?{ (Resources::Job) -> bool } -> bool
+
+    # Iterate over matching jobs in reverse order.
+    #
+    # Optimised: pushes the reverse ordering to the server instead of
+    # fetching all jobs into memory and reversing.
+    #
+    # @rbs &block: ?(Resources::Job) -> void
+    # @rbs return: ::Enumerator[Zizq::Resources::Job, void]
+    def reverse_each: () ?{ (Resources::Job) -> void } -> ::Enumerator[Zizq::Resources::Job, void]
+
+    # Return the first matching job, or nil if none match.
+    #
+    # Optimised: fetches a single job from the server (`?limit=1`).
+    #
+    # @rbs return: Resources::Job?
+    def first: () -> Resources::Job?
+
+    # Return the last matching job, or nil if none match.
+    #
+    # Optimised: reverses the order and fetches a single job.
+    #
+    # @rbs return: Resources::Job?
+    def last: () -> Resources::Job?
+
+    # Return the first `n` matching jobs.
+    #
+    # Optimised: sets the limit to `n` so the server only returns what's
+    # needed.
+    #
+    # @rbs n: Integer
+    # @rbs return: Array[Resources::Job]
+    def take: (Integer n) -> Array[Resources::Job]
+
+    # Update the first matching job.
+    #
+    # Returns 1 if a job was updated, 0 if no jobs matched.
+    #
+    # @rbs queue: (String | singleton(Zizq::UNCHANGED))?
+    # @rbs priority: (Integer | singleton(Zizq::UNCHANGED))?
+    # @rbs ready_at: (Zizq::to_f | singleton(Zizq::RESET) | singleton(Zizq::UNCHANGED))?
+    # @rbs retry_limit: (Integer | singleton(Zizq::RESET) | singleton(Zizq::UNCHANGED))?
+    # @rbs backoff: (Zizq::backoff | singleton(Zizq::RESET) | singleton(Zizq::UNCHANGED))?
+    # @rbs retention: (Zizq::retention | singleton(Zizq::RESET) | singleton(Zizq::UNCHANGED))?
+    # @rbs return: Integer
+    def update_one: () -> Integer
+
+    # Delete the first matching job.
+    #
+    # Returns 1 if a job was deleted, 0 if no jobs matched.
+    #
+    # @rbs return: Integer
+    def delete_one: () -> Integer
+
+    # Iterate over matching jobs, lazily paginating through results.
+    #
+    # Respects `limit` if set. Without a block, returns an `Enumerator`.
+    #
+    # @rbs &block: ?(Resources::Job) -> void
+    # @rbs return: ::Enumerator[Zizq::Resources::Job, void]
+    def each: () ?{ (Resources::Job) -> void } -> ::Enumerator[Zizq::Resources::Job, void]
+
+    # Iterate over pages of matching jobs.
+    #
+    # Each page is a `Resources::JobPage`. Without a block, returns an
+    # `Enumerator`.
+    #
+    # If `limit` is set, terminates after the last page is reached that exceeds
+    # the limit, but does not truncate the page.
+    #
+    # @rbs &block: ?(Resources::JobPage) -> void
+    # @rbs return: ::Enumerator[Zizq::Resources::JobPage, void]
+    def each_page: () ?{ (Resources::JobPage) -> void } -> ::Enumerator[Zizq::Resources::JobPage, void]
+
+    # Update all matching jobs with the given field values.
+    #
+    # When `page_size` or `limit` is set, iterates page by page and
+    # issues a bulk update per page using the job IDs on that page. For safety
+    # query parameters are included in the scope along with all IDs. Otherwise,
+    # issues a single bulk update with the query parameters.
+    #
+    # Returns the total number of updated jobs.
+    #
+    # @rbs queue: (String | singleton(Zizq::UNCHANGED))?
+    # @rbs priority: (Integer | singleton(Zizq::UNCHANGED))?
+    # @rbs ready_at: (Zizq::to_f | singleton(Zizq::RESET) | singleton(Zizq::UNCHANGED))?
+    # @rbs retry_limit: (Integer | singleton(Zizq::RESET) | singleton(Zizq::UNCHANGED))?
+    # @rbs backoff: (Zizq::backoff | singleton(Zizq::RESET) | singleton(Zizq::UNCHANGED))?
+    # @rbs retention: (Zizq::retention | singleton(Zizq::RESET) | singleton(Zizq::UNCHANGED))?
+    # @rbs return: Integer
+    def update_all: (?queue: (String | singleton(Zizq::UNCHANGED))?, ?priority: (Integer | singleton(Zizq::UNCHANGED))?, ?ready_at: (Zizq::to_f | singleton(Zizq::RESET) | singleton(Zizq::UNCHANGED))?, ?retry_limit: (Integer | singleton(Zizq::RESET) | singleton(Zizq::UNCHANGED))?, ?backoff: (Zizq::backoff | singleton(Zizq::RESET) | singleton(Zizq::UNCHANGED))?, ?retention: (Zizq::retention | singleton(Zizq::RESET) | singleton(Zizq::UNCHANGED))?) -> Integer
+
+    # Delete all matching jobs.
+    #
+    # When `page_size` or `limit` is set, iterates page by page and
+    # issues a bulk delete per page using the job IDs on that page. For safety
+    # query parameters are included in the scope along with all IDs. Otherwise,
+    # issues a single bulk delete with the query filters.
+    #
+    # When called in a bare query, this deletes *all* jobs from the server,
+    # which is useful in tests.
+    #
+    # Returns the total number of deleted jobs.
+    #
+    # @rbs return: Integer
+    def delete_all: () -> Integer
+
+    private
+
+    # Build a new Query with the given overrides, preserving all other fields.
+    #
+    # @rbs return: Query
+    def rebuild: (?id: untyped, ?queue: untyped, ?type: untyped, ?status: untyped, ?jq_filter: untyped, ?order: untyped, ?limit: untyped, ?page_size: untyped) -> Query
+
+    # @rbs job_class: untyped
+    # @rbs return: void
+    def validate_job_class!: (untyped job_class) -> void
+  end
+end

data/sig/generated/zizq/resources/error_enumerator.rbs

@@ -0,0 +1,148 @@
+# Generated from lib/zizq/resources/error_enumerator.rb with RBS::Inline
+
+module Zizq
+  module Resources
+    # Provides a lazy Enumerator across all errors on a job following the
+    # cursor-based pagination.
+    class ErrorEnumerator
+      # Maximum page size the server can handle.
+      MAX_PAGE_SIZE: Integer
+
+      include ::Enumerable[Zizq::Resources::ErrorRecord]
+
+      # Initialize the enumerator.
+      #
+      # @rbs id: String
+      # @rbs order: Zizq::sort_direction?
+      # @rbs limit: Integer?
+      # @rbs page_size: Integer?
+      # @rbs return: void
+      def initialize: (String id, ?order: Zizq::sort_direction?, ?limit: Integer?, ?page_size: Integer?) -> void
+
+      # Set the page size for paginated iteration.
+      #
+      # When set, `each_page` fetches pages of this size, and `each` fetches
+      # errors in pages of this size.
+      #
+      # @rbs page_size: Integer?
+      # @rbs return: ErrorEnumerator
+      def in_pages_of: (Integer? page_size) -> ErrorEnumerator
+
+      # Set the sort order for iteration.
+      #
+      # @rbs order: Zizq::sort_direction?
+      # @rbs return: ErrorEnumerator
+      def order: (Zizq::sort_direction? order) -> ErrorEnumerator
+
+      # Limit the total number of errors returned.
+      #
+      # This is a total limit, imposed across potentially multiple page fetches.
+      #
+      # @rbs limit: Integer?
+      # @rbs return: ErrorEnumerator
+      def limit: (Integer? limit) -> ErrorEnumerator
+
+      # Reverse the sort order.
+      #
+      # Returns a new query with the opposite order. If no order was set,
+      # defaults to descending (the server default is ascending).
+      #
+      # @rbs return: ErrorEnumerator
+      def reverse_order: () -> ErrorEnumerator
+
+      # Returns true if there are no errors.
+      #
+      # Optimised: fetches a single error to check.
+      #
+      # @rbs return: bool
+      def empty?: () -> bool
+
+      # Returns true if there are any errors.
+      #
+      # Without a block, optimised to fetch a single error. With a block,
+      # falls back to Enumerable (tests each error against the block).
+      #
+      # @rbs &block: ?(Resources::ErrorRecord) -> bool
+      # @rbs return: bool
+      def any?: () ?{ (Resources::ErrorRecord) -> bool } -> bool
+
+      # Returns true if there are no errors.
+      #
+      # Without a block, optimised to fetch a single error. With a block,
+      # falls back to Enumerable (tests each error against the block).
+      #
+      # @rbs &block: ?(Resources::ErrorRecord) -> bool
+      # @rbs return: bool
+      def none?: () ?{ (Resources::ErrorRecord) -> bool } -> bool
+
+      # Returns true if there is exactly one error.
+      #
+      # Without a block, optimised to fetch at most two errors. With a block,
+      # falls back to Enumerable.
+      #
+      # @rbs &block: ?(Resources::ErrorRecord) -> bool
+      # @rbs return: bool
+      def one?: () ?{ (Resources::ErrorRecord) -> bool } -> bool
+
+      # Iterate over errors in reverse order.
+      #
+      # Optimised: pushes the reverse ordering to the server instead of
+      # fetching all errors into memory and reversing.
+      #
+      # @rbs &block: ?(Resources::ErrorRecord) -> void
+      # @rbs return: ::Enumerator[Zizq::Resources::ErrorRecord, void]
+      def reverse_each: () ?{ (Resources::ErrorRecord) -> void } -> ::Enumerator[Zizq::Resources::ErrorRecord, void]
+
+      # Return the first error, or nil if no errors.
+      #
+      # Optimised: fetches a single error from the server (`?limit=1`).
+      #
+      # @rbs return: Resources::ErrorRecord?
+      def first: () -> Resources::ErrorRecord?
+
+      # Return the last error, or nil if no errors.
+      #
+      # Optimised: reverses the order and fetches a single error.
+      #
+      # @rbs return: Resources::ErrorRecord?
+      def last: () -> Resources::ErrorRecord?
+
+      # Return the first `n` errors.
+      #
+      # Optimised: sets the limit to `n` so the server only returns what's
+      # needed.
+      #
+      # @rbs n: Integer
+      # @rbs return: Array[Resources::ErrorRecord]
+      def take: (Integer n) -> Array[Resources::ErrorRecord]
+
+      # Iterate over errors, lazily paginating through results.
+      #
+      # Respects `limit` if set. Without a block, returns an `Enumerator`.
+      #
+      # @rbs &block: ?(Resources::ErrorRecord) -> void
+      # @rbs return: ::Enumerator[Zizq::Resources::ErrorRecord, void]
+      def each: () ?{ (Resources::ErrorRecord) -> void } -> ::Enumerator[Zizq::Resources::ErrorRecord, void]
+
+      # Iterate over pages of errors.
+      #
+      # Each page is a `Resources::ErrorPage`. Without a block, returns an
+      # `Enumerator`.
+      #
+      # If `limit` is set, terminates after the last page is reached that
+      # exceeds the limit, but does not truncate the page.
+      #
+      # @rbs &block: ?(Resources::ErrorPage) -> void
+      # @rbs return: ::Enumerator[Zizq::Resources::ErrorPage, void]
+      def each_page: () ?{ (Resources::ErrorPage) -> void } -> ::Enumerator[Zizq::Resources::ErrorPage, void]
+
+      private
+
+      # Build a new ErrorEnumerator with the given overrides, preserving all
+      # other fields.
+      #
+      # @rbs return: ErrorEnumerator
+      def rebuild: (?untyped id, ?order: untyped, ?limit: untyped, ?page_size: untyped) -> ErrorEnumerator
+    end
+  end
+end

data/sig/generated/zizq/resources/error_page.rbs

@@ -0,0 +1,13 @@
+# Generated from lib/zizq/resources/error_page.rb with RBS::Inline
+
+module Zizq
+  module Resources
+    # Paginated list of error records.
+    # @rbs inherits Page[ErrorRecord]
+    class ErrorPage < Page[ErrorRecord]
+      def items: () -> untyped
+
+      alias errors items
+    end
+  end
+end

data/sig/generated/zizq/resources/error_record.rbs

@@ -0,0 +1,20 @@
+# Generated from lib/zizq/resources/error_record.rb with RBS::Inline
+
+module Zizq
+  module Resources
+    # Typed wrapper around a single error record from the job error history.
+    class ErrorRecord < Resource
+      def attempt: () -> untyped
+
+      def message: () -> untyped
+
+      def error_type: () -> untyped
+
+      def backtrace: () -> untyped
+
+      def dequeued_at: () -> untyped
+
+      def failed_at: () -> untyped
+    end
+  end
+end

data/sig/generated/zizq/resources/job.rbs

@@ -0,0 +1,89 @@
+# Generated from lib/zizq/resources/job.rb with RBS::Inline
+
+module Zizq
+  module Resources
+    # Typed wrapper around a job response hash.
+    #
+    # Exposes named accessor methods with Ruby-idiomatic types (fractional
+    # seconds instead of milliseconds) and link methods that follow related
+    # resources through the Client.
+    class Job < Resource
+      def id: () -> untyped
+
+      def type: () -> untyped
+
+      def queue: () -> untyped
+
+      def priority: () -> untyped
+
+      def status: () -> untyped
+
+      def ready_at: () -> untyped
+
+      def attempts: () -> untyped
+
+      def payload: () -> untyped
+
+      def dequeued_at: () -> untyped
+
+      def failed_at: () -> untyped
+
+      def completed_at: () -> untyped
+
+      def retry_limit: () -> untyped
+
+      def unique_key: () -> untyped
+
+      def unique_while: () -> untyped
+
+      def duplicate?: () -> untyped
+
+      # Backoff configuration converted from the wire format (ms) to the
+      # Ruby-idiomatic format (seconds), matching the Zizq::backoff type.
+      def backoff: () -> untyped
+
+      # Retention configuration converted from the wire format (ms) to the
+      # Ruby-idiomatic format (seconds), matching the Zizq::retention type.
+      def retention: () -> untyped
+
+      # Fetch the error history for this job.
+      #
+      # @rbs order: Zizq::sort_direction?
+      # @rbs limit: Integer?
+      # @rbs page_size: Integer?
+      # @rbs return: ErrorEnumerator
+      def errors: (?order: Zizq::sort_direction?, ?limit: Integer?, ?page_size: Integer?) -> ErrorEnumerator
+
+      # Mark this job as successfully completed.
+      def complete!: () -> untyped
+
+      # Report this job as failed.
+      #
+      # @rbs message: String
+      # @rbs error_type: String?
+      # @rbs backtrace: String?
+      # @rbs retry_at: Float?
+      # @rbs kill: bool
+      # @rbs return: Job
+      def fail!: (message: String, ?error_type: String?, ?backtrace: String?, ?retry_at: Float?, ?kill: bool) -> Job
+
+      # Delete this job.
+      #
+      # @rbs return: void
+      def delete: () -> void
+
+      # Update this job's mutable fields.
+      #
+      # Returns the updated job.
+      #
+      # @rbs queue: (String | singleton(Zizq::UNCHANGED))?
+      # @rbs priority: (Integer | singleton(Zizq::UNCHANGED))?
+      # @rbs ready_at: (Zizq::to_f | singleton(Zizq::RESET) | singleton(Zizq::UNCHANGED))?
+      # @rbs retry_limit: (Integer | singleton(Zizq::RESET) | singleton(Zizq::UNCHANGED))?
+      # @rbs backoff: (Zizq::backoff | singleton(Zizq::RESET) | singleton(Zizq::UNCHANGED))?
+      # @rbs retention: (Zizq::retention | singleton(Zizq::RESET) | singleton(Zizq::UNCHANGED))?
+      # @rbs return: Job
+      def update: (?queue: (String | singleton(Zizq::UNCHANGED))?, ?priority: (Integer | singleton(Zizq::UNCHANGED))?, ?ready_at: (Zizq::to_f | singleton(Zizq::RESET) | singleton(Zizq::UNCHANGED))?, ?retry_limit: (Integer | singleton(Zizq::RESET) | singleton(Zizq::UNCHANGED))?, ?backoff: (Zizq::backoff | singleton(Zizq::RESET) | singleton(Zizq::UNCHANGED))?, ?retention: (Zizq::retention | singleton(Zizq::RESET) | singleton(Zizq::UNCHANGED))?) -> Job
+    end
+  end
+end

data/sig/generated/zizq/resources/job_page.rbs

@@ -0,0 +1,33 @@
+# Generated from lib/zizq/resources/job_page.rb with RBS::Inline
+
+module Zizq
+  module Resources
+    # Paginated list of jobs.
+    # @rbs inherits Page[Job]
+    class JobPage < Page[Job]
+      def items: () -> untyped
+
+      alias jobs items
+
+      # Delete all jobs on this page.
+      #
+      # Returns the number of deleted jobs.
+      #
+      # @rbs return: Integer
+      def delete_all: () -> Integer
+
+      # Update all jobs on this page with the given field values.
+      #
+      # Returns the number of updated jobs.
+      #
+      # @rbs queue: (String | singleton(Zizq::UNCHANGED))?
+      # @rbs priority: (Integer | singleton(Zizq::UNCHANGED))?
+      # @rbs ready_at: (Zizq::to_f | singleton(Zizq::RESET) | singleton(Zizq::UNCHANGED))?
+      # @rbs retry_limit: (Integer | singleton(Zizq::RESET) | singleton(Zizq::UNCHANGED))?
+      # @rbs backoff: (Zizq::backoff | singleton(Zizq::RESET) | singleton(Zizq::UNCHANGED))?
+      # @rbs retention: (Zizq::retention | singleton(Zizq::RESET) | singleton(Zizq::UNCHANGED))?
+      # @rbs return: Integer
+      def update_all: (?queue: (String | singleton(Zizq::UNCHANGED))?, ?priority: (Integer | singleton(Zizq::UNCHANGED))?, ?ready_at: (Zizq::to_f | singleton(Zizq::RESET) | singleton(Zizq::UNCHANGED))?, ?retry_limit: (Integer | singleton(Zizq::RESET) | singleton(Zizq::UNCHANGED))?, ?backoff: (Zizq::backoff | singleton(Zizq::RESET) | singleton(Zizq::UNCHANGED))?, ?retention: (Zizq::retention | singleton(Zizq::RESET) | singleton(Zizq::UNCHANGED))?) -> Integer
+    end
+  end
+end

data/sig/generated/zizq/resources/page.rbs

@@ -0,0 +1,47 @@
+# Generated from lib/zizq/resources/page.rb with RBS::Inline
+
+module Zizq
+  module Resources
+    # Base class for paginated list responses.
+    #
+    # Stores the raw response data and provides navigation helpers that
+    # follow pagination links through the Client.
+    #
+    # @rbs generic T < Resource
+    class Page[T < Resource] < Resource
+      include ::Enumerable[T]
+
+      # Wrapped resource objects for this page.
+      def items: () -> untyped
+
+      # Returns the underlying raw response hash.
+      #
+      # Re-declared here because Enumerable#to_h would otherwise shadow
+      # the Resource#to_h definition.
+      def to_h: () -> untyped
+
+      # Yields each item on this page. Required by Enumerable.
+      #
+      # @rbs &block: (T) -> void
+      # @rbs return: Enumerator[T, void] | void
+      def each: () { (T) -> void } -> (Enumerator[T, void] | void)
+
+      # Returns true if there is a next page that can be fetched.
+      def has_next?: () -> untyped
+
+      # Returns true if there is a previous page that can be fetched.
+      def has_prev?: () -> untyped
+
+      # Fetch the next page, or nil if there isn't one.
+      def next_page: () -> untyped
+
+      # Fetch the previous page, or nil if there isn't one.
+      def prev_page: () -> untyped
+
+      private
+
+      # Subclasses override to wrap the raw page data in the correct Page type.
+      def wrap_page: (untyped data) -> untyped
+    end
+  end
+end