smplkit 3.0.112 → 3.0.113

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2e838dad6d55b34ff943e6098ef70867585eaacfdf3598bbebdfaa04c41243be
-  data.tar.gz: bb246e8ac29688fc37d4ebc687d31a1231a2be1eb0625c18e453a31e4ea4a0e2
+  metadata.gz: 2a17d3fa81a862f3b33087a957eab5c99db055027b39c914d2c1cbac05854961
+  data.tar.gz: ee3716c54c5d56ae8e956bf672774b494e0f1698ed795dec829c30365fea0dce
 SHA512:
-  metadata.gz: b0b3291a8c8f129f16b36f0e271c6c9519c0ac6f4a40bf3b391501c512c22e069e6500c60e95b3c03ea9c0211af2f6b5a0c227f84a3b161c64e5803b4e378024
-  data.tar.gz: d9c58b7d15d2b49810ffd56a2d900ff9c17dd9818ad6176baae8178ad1957107b610efc375951b0f43b18ea652681eb14d32147da000a3af62932d084db9af11
+  metadata.gz: f10c44c9a4c8e784e55f630b8c136ec3f53a1cf2d42b3284e47e37cf218f579e730bb4dfe483deaff75ea165c8be5460cd45b53e7fb1c03cc717e92f98b18d6c
+  data.tar.gz: 0daec91acc15dc5cb3b7c7041a9765237d8a71bc59ea8f41df58fe657bf9b67e37b66184bfb2c7b0f4f0eb6c9326402a2f660629000ca97f02bcf9aa39fce705

data/lib/smplkit/_generated/jobs/lib/smplkit_jobs_client/api/jobs_api.rb

@@ -215,12 +215,11 @@ module SmplkitGeneratedClient::Jobs
     end
 
     # List Jobs
-    # List this account's jobs.  Default sort is `name` ascending. Sort by `name`, `created_at`, `updated_at`, `next_run_at`, or `enabled`, ascending or descending (prefix `-` for descending). Filter with `filter[enabled]` (enabled in at least one environment), `filter[recurring]`, and `filter[name]` (case-insensitive substring match on the name); filters compose with AND. A scoped caller sees each job's `environments` map narrowed to the environments it may access.
+    # List this account's jobs.  Default sort is `name` ascending. Sort by `name`, `created_at`, or `updated_at`, ascending or descending (prefix `-` for descending). Filter with `filter[recurring]` and `filter[name]` (case-insensitive substring match on the name); filters compose with AND. Each job reports its per-environment enablement and `next_run_at` inside its `environments` map; a scoped caller sees that map narrowed to the environments it may access.
     # @param [Hash] opts the optional parameters
-    # @option opts [Boolean] :filter_enabled 
     # @option opts [Boolean] :filter_recurring 
     # @option opts [String] :filter_name Case-insensitive substring match on the job `name` (matches when the name contains the given text).
-    # @option opts [String] :sort Field to sort by. Prefix with `-` for descending order. Default: `name`. Allowed values: `created_at`, `-created_at`, `enabled`, `-enabled`, `name`, `-name`, `next_run_at`, `-next_run_at`, `updated_at`, `-updated_at`. (default to 'name')
+    # @option opts [String] :sort Field to sort by. Prefix with `-` for descending order. Default: `name`. Allowed values: `created_at`, `-created_at`, `name`, `-name`, `updated_at`, `-updated_at`. (default to 'name')
     # @option opts [Integer] :page_number 1-based page number to return. Optional; defaults to `1` when omitted. Must be `>= 1` — requests with a smaller value are rejected with a 400 error. (default to 1)
     # @option opts [Integer] :page_size Number of items per page. Optional; defaults to `1000` when omitted. Must be between `1` and `1000` inclusive — requests outside that range are rejected with a 400 error. (default to 1000)
     # @option opts [Boolean] :meta_total When `true`, the response's `meta.pagination` block includes `total` (the total number of matching items across all pages) and `total_pages`. Computing these requires an extra `COUNT` query, so omit (or pass `false`) when the totals are not needed. Defaults to `false`. (default to false)
@@ -231,12 +230,11 @@ module SmplkitGeneratedClient::Jobs
     end
 
     # List Jobs
-    # List this account's jobs.  Default sort is `name` ascending. Sort by `name`, `created_at`, `updated_at`, `next_run_at`, or `enabled`, ascending or descending (prefix `-` for descending). Filter with `filter[enabled]` (enabled in at least one environment), `filter[recurring]`, and `filter[name]` (case-insensitive substring match on the name); filters compose with AND. A scoped caller sees each job's `environments` map narrowed to the environments it may access.
+    # List this account's jobs.  Default sort is `name` ascending. Sort by `name`, `created_at`, or `updated_at`, ascending or descending (prefix `-` for descending). Filter with `filter[recurring]` and `filter[name]` (case-insensitive substring match on the name); filters compose with AND. Each job reports its per-environment enablement and `next_run_at` inside its `environments` map; a scoped caller sees that map narrowed to the environments it may access.
     # @param [Hash] opts the optional parameters
-    # @option opts [Boolean] :filter_enabled 
     # @option opts [Boolean] :filter_recurring 
     # @option opts [String] :filter_name Case-insensitive substring match on the job `name` (matches when the name contains the given text).
-    # @option opts [String] :sort Field to sort by. Prefix with `-` for descending order. Default: `name`. Allowed values: `created_at`, `-created_at`, `enabled`, `-enabled`, `name`, `-name`, `next_run_at`, `-next_run_at`, `updated_at`, `-updated_at`. (default to 'name')
+    # @option opts [String] :sort Field to sort by. Prefix with `-` for descending order. Default: `name`. Allowed values: `created_at`, `-created_at`, `name`, `-name`, `updated_at`, `-updated_at`. (default to 'name')
     # @option opts [Integer] :page_number 1-based page number to return. Optional; defaults to `1` when omitted. Must be `>= 1` — requests with a smaller value are rejected with a 400 error. (default to 1)
     # @option opts [Integer] :page_size Number of items per page. Optional; defaults to `1000` when omitted. Must be between `1` and `1000` inclusive — requests outside that range are rejected with a 400 error. (default to 1000)
     # @option opts [Boolean] :meta_total When `true`, the response's `meta.pagination` block includes `total` (the total number of matching items across all pages) and `total_pages`. Computing these requires an extra `COUNT` query, so omit (or pass `false`) when the totals are not needed. Defaults to `false`. (default to false)
@@ -245,7 +243,7 @@ module SmplkitGeneratedClient::Jobs
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: JobsApi.list_jobs ...'
       end
-      allowable_values = ["created_at", "-created_at", "enabled", "-enabled", "name", "-name", "next_run_at", "-next_run_at", "updated_at", "-updated_at"]
+      allowable_values = ["created_at", "-created_at", "name", "-name", "updated_at", "-updated_at"]
       if @api_client.config.client_side_validation && opts[:'sort'] && !allowable_values.include?(opts[:'sort'])
         fail ArgumentError, "invalid value for \"sort\", must be one of #{allowable_values}"
       end
@@ -254,7 +252,6 @@ module SmplkitGeneratedClient::Jobs
 
       # query parameters
       query_params = opts[:query_params] || {}
-      query_params[:'filter[enabled]'] = opts[:'filter_enabled'] if !opts[:'filter_enabled'].nil?
       query_params[:'filter[recurring]'] = opts[:'filter_recurring'] if !opts[:'filter_recurring'].nil?
       query_params[:'filter[name]'] = opts[:'filter_name'] if !opts[:'filter_name'].nil?
       query_params[:'sort'] = opts[:'sort'] if !opts[:'sort'].nil?
@@ -363,7 +360,7 @@ module SmplkitGeneratedClient::Jobs
     end
 
     # Update Job
-    # Replace an existing job. Every writable field is overwritten.  Set enablement per environment via the `environments` map (a recurring job), or by recreating a one-off job in the desired environment. Editing the schedule recomputes the next fire time; changing only which environments are enabled preserves the existing cadence.
+    # Replace an existing job. Every writable field is overwritten.  Set enablement per environment via the `environments` map (a recurring job), or by recreating a one-off job in the desired environment. Each environment may carry its own cron `schedule` override. Editing an environment's effective schedule recomputes its next fire time; an edit that leaves an environment's schedule unchanged preserves its existing cadence.
     # @param job_id [String] 
     # @param job_request [JobRequest] 
     # @param [Hash] opts the optional parameters
@@ -375,7 +372,7 @@ module SmplkitGeneratedClient::Jobs
     end
 
     # Update Job
-    # Replace an existing job. Every writable field is overwritten.  Set enablement per environment via the `environments` map (a recurring job), or by recreating a one-off job in the desired environment. Editing the schedule recomputes the next fire time; changing only which environments are enabled preserves the existing cadence.
+    # Replace an existing job. Every writable field is overwritten.  Set enablement per environment via the `environments` map (a recurring job), or by recreating a one-off job in the desired environment. Each environment may carry its own cron `schedule` override. Editing an environment's effective schedule recomputes its next fire time; an edit that leaves an environment's schedule unchanged preserves its existing cadence.
     # @param job_id [String] 
     # @param job_request [JobRequest] 
     # @param [Hash] opts the optional parameters

data/lib/smplkit/_generated/jobs/lib/smplkit_jobs_client/api/usage_api.rb

@@ -20,7 +20,7 @@ module SmplkitGeneratedClient::Jobs
       @api_client = api_client
     end
     # Get Usage
-    # Report this account's current-period usage against its plan allotments.  `runs_used` is the number of runs metered so far this calendar month; `active_jobs` is the number of currently-enabled jobs.
+    # Report this account's current-period usage against its plan allotments.  `runs_used` is the number of runs metered so far this calendar month; `active_jobs` is the number of recurring (scheduled) jobs, which is what the plan's job limit bounds.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :filter_period  (default to 'current')
     # @return [UsageResponse]
@@ -30,7 +30,7 @@ module SmplkitGeneratedClient::Jobs
     end
 
     # Get Usage
-    # Report this account's current-period usage against its plan allotments.  `runs_used` is the number of runs metered so far this calendar month; `active_jobs` is the number of currently-enabled jobs.
+    # Report this account's current-period usage against its plan allotments.  `runs_used` is the number of runs metered so far this calendar month; `active_jobs` is the number of recurring (scheduled) jobs, which is what the plan's job limit bounds.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :filter_period  (default to 'current')
     # @return [Array<(UsageResponse, Integer, Hash)>] UsageResponse data, response status code and response headers

data/lib/smplkit/_generated/jobs/lib/smplkit_jobs_client/models/job.rb

@@ -14,7 +14,7 @@ require 'date'
 require 'time'
 
 module SmplkitGeneratedClient::Jobs
-  # A scheduled unit of work: an HTTP request run on a schedule.  The job is the definition; each time it fires the service records a run capturing the request, response, timing, and outcome. A job is enabled per environment: set `environments[<env>].enabled` to schedule runs there. A recurring (cron) job may be enabled in several environments at once and fires once per enabled environment; a one-off (`now` or future datetime) job runs a single time in the environment it was created in.
+  # A scheduled unit of work: an HTTP request run on a schedule.  The job is the definition; each time it fires the service records a run capturing the request, response, timing, and outcome. A job runs per environment: set `environments[<env>].enabled` to schedule runs there, and optionally give that environment its own `schedule` or `configuration`. A recurring (cron) job may be enabled in several environments at once and fires once per enabled environment, each on its own next-fire schedule; a one-off (`now` or future datetime) job runs a single time in the environment it was created in.
   class Job < ApiModelBase
     # Human-readable name for the job.
     attr_accessor :name
@@ -22,28 +22,22 @@ module SmplkitGeneratedClient::Jobs
     # Free-text description for the job.
     attr_accessor :description
 
-    # Whether the job is enabled in at least one environment. Read-only roll-up of `environments[*].enabled`; set enablement per environment via `environments`.
-    attr_accessor :enabled
-
     # Job type. Only `http` is supported today.
     attr_accessor :type
 
-    # When the job runs. One of: an ISO-8601 datetime (a one-off run at that instant), a 5-field cron expression evaluated in **UTC** (recurring), or the literal `now` (run once, as soon as possible). A datetime or `now` job disables itself after it fires.
+    # The base schedule every environment inherits unless it overrides it. One of: an ISO-8601 datetime (a one-off run at that instant), a 5-field cron expression evaluated in **UTC** (recurring), or the literal `now` (run once, as soon as possible). A datetime or `now` job disables itself after it fires.
     attr_accessor :schedule
 
     # The HTTP request to perform, including method, url, headers, body, and timeout.
     attr_accessor :configuration
 
-    # Per-environment overrides keyed by environment key (e.g. `production`, `staging`). Each entry sets `enabled` (whether the job schedules runs in that environment) and an optional `configuration` override (omit to inherit the base `configuration`). A job with no entry for an environment is disabled there. For a recurring job, supply this map to choose where it runs. For a one-off job, the environment it is created in is recorded here automatically — name it with the `X-Smplkit-Environment` header. Every referenced environment must exist for the account.
+    # Per-environment overrides keyed by environment key (e.g. `production`, `staging`). Each entry sets `enabled` (whether the job schedules runs in that environment), an optional `schedule` override (a cron expression for recurring jobs; omit to inherit the base `schedule`), and an optional `configuration` override (omit to inherit the base `configuration`); it also reports the read-only `next_run_at` for that environment. A job with no entry for an environment is disabled there. For a recurring job, supply this map to choose where and how it runs. For a one-off job, the environment it is created in is recorded here automatically — name it with the `X-Smplkit-Environment` header. Every referenced environment must exist for the account.
     attr_accessor :environments
 
     # How overlapping runs are handled. `ALLOW` (the only value today) permits them.
     attr_accessor :concurrency_policy
 
-    # The next scheduled fire time. `null` once a one-off job has fired.
-    attr_accessor :next_run_at
-
-    # Whether the job runs on a repeating schedule. `true` for a cron schedule; `false` for a one-off datetime or `now` schedule, which runs a single time. Derived from `schedule`.
+    # Whether the job runs on a repeating schedule. `true` for a cron schedule; `false` for a one-off datetime or `now` schedule, which runs a single time. Derived from the base `schedule`.
     attr_accessor :recurring
 
     # When the job was created.
@@ -85,13 +79,11 @@ module SmplkitGeneratedClient::Jobs
       {
         :'name' => :'name',
         :'description' => :'description',
-        :'enabled' => :'enabled',
         :'type' => :'type',
         :'schedule' => :'schedule',
         :'configuration' => :'configuration',
         :'environments' => :'environments',
         :'concurrency_policy' => :'concurrency_policy',
-        :'next_run_at' => :'next_run_at',
         :'recurring' => :'recurring',
         :'created_at' => :'created_at',
         :'updated_at' => :'updated_at',
@@ -115,13 +107,11 @@ module SmplkitGeneratedClient::Jobs
       {
         :'name' => :'String',
         :'description' => :'String',
-        :'enabled' => :'Boolean',
         :'type' => :'String',
         :'schedule' => :'String',
         :'configuration' => :'JobHttpConfiguration',
         :'environments' => :'Hash<String, JobEnvironment>',
         :'concurrency_policy' => :'String',
-        :'next_run_at' => :'Time',
         :'recurring' => :'Boolean',
         :'created_at' => :'Time',
         :'updated_at' => :'Time',
@@ -134,8 +124,6 @@ module SmplkitGeneratedClient::Jobs
     def self.openapi_nullable
       Set.new([
         :'description',
-        :'enabled',
-        :'next_run_at',
         :'recurring',
         :'created_at',
         :'updated_at',
@@ -170,10 +158,6 @@ module SmplkitGeneratedClient::Jobs
         self.description = attributes[:'description']
       end
 
-      if attributes.key?(:'enabled')
-        self.enabled = attributes[:'enabled']
-      end
-
       if attributes.key?(:'type')
         self.type = attributes[:'type']
       else
@@ -204,10 +188,6 @@ module SmplkitGeneratedClient::Jobs
         self.concurrency_policy = 'ALLOW'
       end
 
-      if attributes.key?(:'next_run_at')
-        self.next_run_at = attributes[:'next_run_at']
-      end
-
       if attributes.key?(:'recurring')
         self.recurring = attributes[:'recurring']
       end
@@ -353,13 +333,11 @@ module SmplkitGeneratedClient::Jobs
       self.class == o.class &&
           name == o.name &&
           description == o.description &&
-          enabled == o.enabled &&
           type == o.type &&
           schedule == o.schedule &&
           configuration == o.configuration &&
           environments == o.environments &&
           concurrency_policy == o.concurrency_policy &&
-          next_run_at == o.next_run_at &&
           recurring == o.recurring &&
           created_at == o.created_at &&
           updated_at == o.updated_at &&
@@ -376,7 +354,7 @@ module SmplkitGeneratedClient::Jobs
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [name, description, enabled, type, schedule, configuration, environments, concurrency_policy, next_run_at, recurring, created_at, updated_at, deleted_at, version].hash
+      [name, description, type, schedule, configuration, environments, concurrency_policy, recurring, created_at, updated_at, deleted_at, version].hash
     end
 
     # Builds the object from hash

data/lib/smplkit/_generated/jobs/lib/smplkit_jobs_client/models/job_environment.rb

@@ -14,19 +14,27 @@ require 'date'
 require 'time'
 
 module SmplkitGeneratedClient::Jobs
-  # Per-environment override for a job's enablement and configuration.
+  # Per-environment override for a job's enablement, schedule, and configuration.
   class JobEnvironment < ApiModelBase
     # Whether the job schedules runs in this environment. A job runs in an environment only via this field; it is disabled in every environment by default.
     attr_accessor :enabled
 
+    # Per-environment schedule override. Omit to inherit the job's base `schedule`. When present, it must be a 5-field cron expression evaluated in **UTC** (e.g. `0 3 * * *`), and is only allowed on a recurring (cron) job — it varies the cadence within that environment, it cannot turn a one-off job recurring or vice-versa.
+    attr_accessor :schedule
+
     # Per-environment HTTP request override. Omit to inherit the job's base `configuration`. When present, it fully replaces the base configuration for runs in this environment.
     attr_accessor :configuration
 
+    # The next scheduled fire time in this environment. `null` when the environment is not enabled, or once a one-off run has fired.
+    attr_accessor :next_run_at
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
         :'enabled' => :'enabled',
-        :'configuration' => :'configuration'
+        :'schedule' => :'schedule',
+        :'configuration' => :'configuration',
+        :'next_run_at' => :'next_run_at'
       }
     end
 
@@ -44,14 +52,18 @@ module SmplkitGeneratedClient::Jobs
     def self.openapi_types
       {
         :'enabled' => :'Boolean',
-        :'configuration' => :'JobHttpConfiguration'
+        :'schedule' => :'String',
+        :'configuration' => :'JobHttpConfiguration',
+        :'next_run_at' => :'Time'
       }
     end
 
     # List of attributes with nullable: true
     def self.openapi_nullable
       Set.new([
-        :'configuration'
+        :'schedule',
+        :'configuration',
+        :'next_run_at'
       ])
     end
 
@@ -77,9 +89,17 @@ module SmplkitGeneratedClient::Jobs
         self.enabled = false
       end
 
+      if attributes.key?(:'schedule')
+        self.schedule = attributes[:'schedule']
+      end
+
       if attributes.key?(:'configuration')
         self.configuration = attributes[:'configuration']
       end
+
+      if attributes.key?(:'next_run_at')
+        self.next_run_at = attributes[:'next_run_at']
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -103,7 +123,9 @@ module SmplkitGeneratedClient::Jobs
       return true if self.equal?(o)
       self.class == o.class &&
           enabled == o.enabled &&
-          configuration == o.configuration
+          schedule == o.schedule &&
+          configuration == o.configuration &&
+          next_run_at == o.next_run_at
     end
 
     # @see the `==` method
@@ -115,7 +137,7 @@ module SmplkitGeneratedClient::Jobs
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [enabled, configuration].hash
+      [enabled, schedule, configuration, next_run_at].hash
     end
 
     # Builds the object from hash

data/lib/smplkit/_generated/jobs/lib/smplkit_jobs_client/models/usage.rb

@@ -25,10 +25,10 @@ module SmplkitGeneratedClient::Jobs
     # Runs included in the plan this period (`-1` means unlimited).
     attr_accessor :runs_included
 
-    # Number of currently-enabled jobs.
+    # Number of recurring (scheduled) jobs.
     attr_accessor :active_jobs
 
-    # Maximum enabled jobs the plan allows (`-1` means unlimited).
+    # Maximum recurring jobs the plan allows (`-1` means unlimited).
     attr_accessor :active_jobs_limit
 
     # Attribute mapping from ruby-style variable name to JSON key.

data/lib/smplkit/_generated/jobs/spec/api/jobs_api_spec.rb

@@ -71,12 +71,11 @@ describe 'JobsApi' do
 
   # unit tests for list_jobs
   # List Jobs
-  # List this account's jobs.  Default sort is `name` ascending. Sort by `name`, `created_at`, `updated_at`, `next_run_at`, or `enabled`, ascending or descending (prefix `-` for descending). Filter with `filter[enabled]` (enabled in at least one environment), `filter[recurring]`, and `filter[name]` (case-insensitive substring match on the name); filters compose with AND. A scoped caller sees each job's `environments` map narrowed to the environments it may access.
+  # List this account's jobs.  Default sort is `name` ascending. Sort by `name`, `created_at`, or `updated_at`, ascending or descending (prefix `-` for descending). Filter with `filter[recurring]` and `filter[name]` (case-insensitive substring match on the name); filters compose with AND. Each job reports its per-environment enablement and `next_run_at` inside its `environments` map; a scoped caller sees that map narrowed to the environments it may access.
   # @param [Hash] opts the optional parameters
-  # @option opts [Boolean] :filter_enabled 
   # @option opts [Boolean] :filter_recurring 
   # @option opts [String] :filter_name Case-insensitive substring match on the job `name` (matches when the name contains the given text).
-  # @option opts [String] :sort Field to sort by. Prefix with `-` for descending order. Default: `name`. Allowed values: `created_at`, `-created_at`, `enabled`, `-enabled`, `name`, `-name`, `next_run_at`, `-next_run_at`, `updated_at`, `-updated_at`.
+  # @option opts [String] :sort Field to sort by. Prefix with `-` for descending order. Default: `name`. Allowed values: `created_at`, `-created_at`, `name`, `-name`, `updated_at`, `-updated_at`.
   # @option opts [Integer] :page_number 1-based page number to return. Optional; defaults to `1` when omitted. Must be `>= 1` — requests with a smaller value are rejected with a 400 error.
   # @option opts [Integer] :page_size Number of items per page. Optional; defaults to `1000` when omitted. Must be between `1` and `1000` inclusive — requests outside that range are rejected with a 400 error.
   # @option opts [Boolean] :meta_total When `true`, the response's `meta.pagination` block includes `total` (the total number of matching items across all pages) and `total_pages`. Computing these requires an extra `COUNT` query, so omit (or pass `false`) when the totals are not needed. Defaults to `false`.
@@ -102,7 +101,7 @@ describe 'JobsApi' do
 
   # unit tests for update_job
   # Update Job
-  # Replace an existing job. Every writable field is overwritten.  Set enablement per environment via the `environments` map (a recurring job), or by recreating a one-off job in the desired environment. Editing the schedule recomputes the next fire time; changing only which environments are enabled preserves the existing cadence.
+  # Replace an existing job. Every writable field is overwritten.  Set enablement per environment via the `environments` map (a recurring job), or by recreating a one-off job in the desired environment. Each environment may carry its own cron `schedule` override. Editing an environment's effective schedule recomputes its next fire time; an edit that leaves an environment's schedule unchanged preserves its existing cadence.
   # @param job_id 
   # @param job_request 
   # @param [Hash] opts the optional parameters

data/lib/smplkit/_generated/jobs/spec/api/usage_api_spec.rb

@@ -34,7 +34,7 @@ describe 'UsageApi' do
 
   # unit tests for get_usage
   # Get Usage
-  # Report this account's current-period usage against its plan allotments.  `runs_used` is the number of runs metered so far this calendar month; `active_jobs` is the number of currently-enabled jobs.
+  # Report this account's current-period usage against its plan allotments.  `runs_used` is the number of runs metered so far this calendar month; `active_jobs` is the number of recurring (scheduled) jobs, which is what the plan's job limit bounds.
   # @param [Hash] opts the optional parameters
   # @option opts [String] :filter_period 
   # @return [UsageResponse]

data/lib/smplkit/_generated/jobs/spec/models/job_environment_spec.rb

@@ -33,10 +33,22 @@ describe SmplkitGeneratedClient::Jobs::JobEnvironment do
     end
   end
 
+  describe 'test attribute "schedule"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   describe 'test attribute "configuration"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
     end
   end
 
+  describe 'test attribute "next_run_at"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
 end

data/lib/smplkit/_generated/jobs/spec/models/job_spec.rb

@@ -39,12 +39,6 @@ describe SmplkitGeneratedClient::Jobs::Job do
     end
   end
 
-  describe 'test attribute "enabled"' do
-    it 'should work' do
-      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
-    end
-  end
-
   describe 'test attribute "type"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
@@ -83,12 +77,6 @@ describe SmplkitGeneratedClient::Jobs::Job do
     end
   end
 
-  describe 'test attribute "next_run_at"' do
-    it 'should work' do
-      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
-    end
-  end
-
   describe 'test attribute "recurring"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/

data/lib/smplkit/jobs/client.rb

@@ -194,10 +194,10 @@ module Smplkit
       # @param environments [Hash{String => Smplkit::Jobs::JobEnvironment, Hash}, nil]
       #   Per-environment overrides for a recurring job, keyed by environment key
       #   — each a {Smplkit::Jobs::JobEnvironment}, or a plain hash
-      #   (+{ enabled: true }+, optionally with a +:configuration+
-      #   {Smplkit::Jobs::HttpConfig} override). A recurring job fires only in
-      #   environments enabled here. Ignored for a one-off job, which is born in
-      #   +environment+ below.
+      #   (+{ enabled: true }+, optionally with a +:schedule+ cron override and/or
+      #   a +:configuration+ {Smplkit::Jobs::HttpConfig} override). A recurring
+      #   job fires only in environments enabled here. Ignored for a one-off job,
+      #   which is born in +environment+ below.
       # @param concurrency_policy [String] How overlapping runs are handled.
       #   Defaults to +"ALLOW"+.
       # @param environment [String, nil] For a one-off job (+"now"+ / datetime
@@ -221,8 +221,6 @@ module Smplkit
 
       # List jobs for the authenticated account.
       #
-      # @param enabled [Boolean, nil] Filter to jobs matching this enabled state
-      #   (the server-derived roll-up across environments).
       # @param recurring [Boolean, nil] Filter to recurring (+true+) or one-off
       #   (+false+) jobs. +nil+ lists both.
       # @param name [String, nil] Filter to jobs whose name contains this text
@@ -230,9 +228,8 @@ module Smplkit
       # @param page_number [Integer, nil] 1-based page number to return.
       # @param page_size [Integer, nil] Items per page.
       # @return [Array<Smplkit::Jobs::Job>]
-      def list(enabled: nil, recurring: nil, name: nil, page_number: nil, page_size: nil)
+      def list(recurring: nil, name: nil, page_number: nil, page_size: nil)
         opts = {}
-        opts[:filter_enabled] = enabled unless enabled.nil?
         opts[:filter_recurring] = recurring unless recurring.nil?
         opts[:filter_name] = name unless name.nil?
         opts[:page_number] = page_number unless page_number.nil?
@@ -318,12 +315,14 @@ module Smplkit
 
       # Convert the wrapper +environments+ map to the generated model hash.
       #
-      # Each entry's +enabled+ is always written; a per-environment
-      # +configuration+ override is sent as a full {HttpConfig} payload only when
-      # present (omit to inherit the base configuration).
+      # Each entry's +enabled+ is always written; a per-environment +schedule+
+      # (cron) override and +configuration+ override are each sent only when
+      # present (omit to inherit the job's base +schedule+ / +configuration+).
+      # The read-only per-environment +next_run_at+ is never written.
       def environments_to_wire(environments)
         (environments || {}).each_with_object({}) do |(env_key, env), out|
           attrs = { enabled: env.enabled }
+          attrs[:schedule] = env.schedule unless env.schedule.nil?
           attrs[:configuration] = HttpConfig.to_wire(env.configuration) unless env.configuration.nil?
           out[env_key.to_s] = SmplkitGeneratedClient::Jobs::JobEnvironment.new(attrs)
         end

data/lib/smplkit/jobs/models.rb

@@ -13,8 +13,9 @@ module Smplkit
   #
   # A job is enabled per environment: a recurring (cron) job may run in several
   # environments at once, a one-off (+now+ / future datetime) job runs a single
-  # time in the environment it was created in. Base +enabled+ is a read-only,
-  # server-derived roll-up (+true+ when enabled in at least one environment).
+  # time in the environment it was created in. Base {Job#enabled} is a derived
+  # roll-up (+true+ when enabled in at least one environment), computed from the
+  # per-environment {Job#environments} map.
   module Jobs
     # Wrap a generated-jobs-API call and translate +ApiError+ into the
     # +Smplkit::Error+ hierarchy. Connection-level failures (no response
@@ -73,10 +74,10 @@ module Smplkit
     # Coerce a caller's +environments+ map to {JobEnvironment} instances.
     #
     # Accepts either {JobEnvironment} values or plain hashes
-    # (+{ enabled: true, configuration: HttpConfig.new(...) }+) so callers can
-    # use the lightweight hash form without importing the model. A dict-form
-    # +configuration+ override is coerced to an {HttpConfig} so it serializes on
-    # save.
+    # (+{ enabled: true, schedule: "0 3 * * *", configuration: HttpConfig.new(...) }+)
+    # so callers can use the lightweight hash form without importing the model. A
+    # dict-form +configuration+ override is coerced to an {HttpConfig} so it
+    # serializes on save; an optional +schedule+ cron override passes through.
     #
     # @api private
     def self.normalize_environments(environments)
@@ -90,6 +91,7 @@ module Smplkit
                               cfg = HttpConfig.new(**cfg) if cfg.is_a?(Hash)
                               JobEnvironment.new(
                                 enabled: value[:enabled] || value["enabled"] || false,
+                                schedule: value[:schedule] || value["schedule"],
                                 configuration: cfg
                               )
                             end
@@ -244,7 +246,7 @@ module Smplkit
     end
     # rubocop:enable Lint/StructNewOverride
 
-    # Per-environment enablement and optional configuration override for a job.
+    # Per-environment enablement, schedule, and configuration override for a job.
     #
     # A recurring job fires in a given environment only when that environment
     # has an entry in {Job#environments} with +enabled: true+; an environment
@@ -253,14 +255,24 @@ module Smplkit
     # @!attribute [rw] enabled
     #   @return [Boolean] Whether the job fires in this environment. Defaults to
     #     +false+.
+    # @!attribute [rw] schedule
+    #   @return [String, nil] Optional per-environment cron schedule override
+    #     that varies the cadence in this environment. +nil+ (the default)
+    #     inherits the job's base {Job#schedule}. When present, it must be a
+    #     5-field UTC cron expression and is only meaningful on a recurring job —
+    #     it cannot turn a one-off job recurring or vice-versa.
     # @!attribute [rw] configuration
     #   @return [HttpConfig, nil] Optional per-environment request configuration
     #     that fully replaces the job's base {Job#configuration} for this
     #     environment. +nil+ (the default) inherits the base configuration. As
     #     with the base configuration, header values are returned in plaintext on
     #     reads, so a get-mutate-put round-trip preserves them.
-    JobEnvironment = Struct.new(:enabled, :configuration, keyword_init: true) do
-      def initialize(enabled: false, configuration: nil)
+    # @!attribute [rw] next_run_at
+    #   @return [String, nil] Read-only. The next scheduled fire time in this
+    #     environment. +nil+ when the environment is not enabled, or once a
+    #     one-off run has fired. Never written back on save.
+    JobEnvironment = Struct.new(:enabled, :schedule, :configuration, :next_run_at, keyword_init: true) do
+      def initialize(enabled: false, schedule: nil, configuration: nil, next_run_at: nil)
         super
       end
 
@@ -275,7 +287,9 @@ module Smplkit
         cfg = src.configuration
         new(
           enabled: src.enabled.nil? ? false : src.enabled,
-          configuration: cfg.nil? ? nil : HttpConfig.from_wire(cfg)
+          schedule: src.schedule,
+          configuration: cfg.nil? ? nil : HttpConfig.from_wire(cfg),
+          next_run_at: src.next_run_at
         )
       end
     end
@@ -289,9 +303,10 @@ module Smplkit
     # values without re-entering secrets.
     #
     # Enablement is per environment, set via {#set_enabled} (and read via
-    # {#is_enabled}); base {#enabled} is a read-only roll-up. The schedule is
-    # environment-agnostic — one cron / datetime / +now+ shared across every
-    # environment the job runs in.
+    # {#is_enabled}); base {#enabled} is a derived roll-up over {#environments}.
+    # The base schedule is environment-agnostic — one cron / datetime / +now+
+    # shared across every environment the job runs in — while each environment
+    # may carry its own cron {#set_schedule} override.
     class Job
       # @return [String] Caller-supplied unique identifier for the job (the
       #   resource +id+). Unique within the account and immutable; the service
@@ -304,11 +319,13 @@ module Smplkit
       # @return [String, nil] Free-text description. +nil+ when unset.
       attr_accessor :description
 
-      # @return [Boolean] Read-only, server-derived roll-up: +true+ when the job
-      #   is enabled in at least one environment. Set enablement per environment
-      #   via {#set_enabled} / {#environments}; mutating this field directly has
-      #   no effect on the server (it is never written).
-      attr_accessor :enabled
+      # @return [Boolean] Derived roll-up: +true+ when the job is enabled in at
+      #   least one environment. Computed from {#environments} rather than read
+      #   from the wire — the API no longer carries a top-level +enabled+. Set
+      #   enablement per environment via {#set_enabled} / {#environments}.
+      def enabled
+        (@environments || {}).each_value.any?(&:enabled)
+      end
 
       # @return [Hash{String => JobEnvironment}] Per-environment overrides keyed
       #   by environment key (e.g. +"production"+). The writable surface for
@@ -341,10 +358,6 @@ module Smplkit
       #   value) permits them.
       attr_accessor :concurrency_policy
 
-      # @return [String, nil] The next scheduled fire time. +nil+ once a one-off
-      #   job has fired.
-      attr_accessor :next_run_at
-
       # @return [String, nil] ISO-8601 timestamp of first persist. +nil+ for an
       #   unsaved instance.
       attr_accessor :created_at
@@ -366,23 +379,21 @@ module Smplkit
       attr_accessor :birth_environment
 
       def initialize(client = nil, id:, name:, schedule:, configuration:,
-                     description: nil, environments: nil, enabled: false,
+                     description: nil, environments: nil,
                      recurring: nil, type: "http", concurrency_policy: "ALLOW",
-                     birth_environment: nil, next_run_at: nil, created_at: nil,
+                     birth_environment: nil, created_at: nil,
                      updated_at: nil, deleted_at: nil, version: nil)
         @client = client
         @id = id
         @name = name
         @description = description
         @environments = environments || {}
-        @enabled = enabled
         @recurring = recurring
         @type = type
         @schedule = schedule
         @configuration = configuration
         @concurrency_policy = concurrency_policy
         @birth_environment = birth_environment
-        @next_run_at = next_run_at
         @created_at = created_at
         @updated_at = updated_at
         @deleted_at = deleted_at
@@ -394,8 +405,8 @@ module Smplkit
       # Upsert behavior is driven by {#created_at}: a job with no +created_at+
       # is created (POST); otherwise it's full-replace updated (PUT). After the
       # call, every field is refreshed from the server response (including
-      # newly-assigned +created_at+, +version+, +next_run_at+, and the derived
-      # +enabled+ roll-up).
+      # newly-assigned +created_at+, +version+, and per-environment +next_run_at+
+      # inside {#environments}).
       #
       # @return [self]
       def save
@@ -440,7 +451,7 @@ module Smplkit
       #   roll-up across every environment.
       # @return [Boolean]
       def is_enabled(environment: nil)
-        return @enabled if environment.nil?
+        return enabled if environment.nil?
 
         override = @environments[environment]
         return false if override.nil?
@@ -485,17 +496,30 @@ module Smplkit
         @configuration
       end
 
-      # Set the job's schedule.
+      # Set the job's schedule — base (+environment+ omitted) or per-environment.
       #
-      # The schedule is environment-agnostic — a job has a single cron /
-      # datetime / +"now"+ schedule shared across every environment it runs in
-      # (each enabled environment fires on the same cadence). There is no
-      # per-environment schedule, so this setter takes no +environment+.
+      # With +environment+ omitted (the default), sets the base {#schedule} —
+      # an ISO-8601 datetime, a 5-field UTC cron expression, or the literal
+      # +"now"+ — which every environment inherits unless it overrides it.
+      #
+      # With +environment+ given, sets that environment's per-environment cron
+      # +schedule+ override on {#environments}, creating the override entry if it
+      # doesn't exist yet (preserving any already-set +enabled+ / +configuration+
+      # on it). A per-environment override is a cron expression only and varies
+      # the cadence within that environment; it cannot turn a one-off job
+      # recurring or vice-versa. Call {#save} to persist.
       #
       # @param schedule [String] An ISO-8601 datetime, a 5-field UTC cron
-      #   expression, or the literal +"now"+.
-      def set_schedule(schedule)
-        @schedule = schedule
+      #   expression, or the literal +"now"+ (base); a 5-field UTC cron
+      #   expression (per-environment).
+      # @param environment [String, nil] An environment key for a per-environment
+      #   override, or +nil+ to set the base schedule.
+      def set_schedule(schedule, environment: nil)
+        if environment.nil?
+          @schedule = schedule
+        else
+          _environment_override(environment).schedule = schedule
+        end
       end
 
       # Trigger one immediate, manual run of this job (a +MANUAL+ run).
@@ -547,14 +571,12 @@ module Smplkit
         @id = other.id
         @name = other.name
         @description = other.description
-        @enabled = other.enabled
         @environments = other.environments
         @recurring = other.recurring
         @type = other.type
         @schedule = other.schedule
         @configuration = other.configuration
         @concurrency_policy = other.concurrency_policy
-        @next_run_at = other.next_run_at
         @created_at = other.created_at
         @updated_at = other.updated_at
         @deleted_at = other.deleted_at
@@ -577,16 +599,14 @@ module Smplkit
           id: resource.id,
           name: a.name,
           description: a.description,
-          # The base +enabled+ is a server-derived roll-up; round-trip whatever
-          # the server returned without assuming a default of true.
-          enabled: a.enabled.nil? ? false : a.enabled,
+          # The base +enabled+ roll-up is derived from +environments+, not read
+          # from the wire — the API no longer carries a top-level +enabled+.
           environments: environments,
           recurring: a.recurring,
           type: a.type || "http",
           schedule: a.schedule,
           configuration: HttpConfig.from_wire(a.configuration),
           concurrency_policy: a.concurrency_policy || "ALLOW",
-          next_run_at: a.next_run_at,
           created_at: a.created_at,
           updated_at: a.updated_at,
           deleted_at: a.deleted_at,

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: smplkit
 version: !ruby/object:Gem::Version
-  version: 3.0.112
+  version: 3.0.113
 platform: ruby
 authors:
 - Smpl Solutions LLC