smplkit 3.0.115 → 3.0.117

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d8888472ad2b1c73c05d0b83ab61f4baada0cf9092a6992bca748995db90eb20
-  data.tar.gz: a3590a7f5a3651b65c3620b6bf71f5f2271566398d59f83f6df577a31d86627c
+  metadata.gz: 5d24fdc29df5e09eeb9aced770603d9166f8afb58e38ab20c3dbe73ff2ce551b
+  data.tar.gz: 3b517f4874247ea7acdf945fcaa569a9049f8cde042457d270cf4a45a193b9d1
 SHA512:
-  metadata.gz: b44a039e00ab2bc2456a027d56e386fcb8c0053c549dc60425b78b0f319ff0c387fd710ccdd2e45d033681956bb800ec20c6a1d80fc5ed15650cf96de32bf5dc
-  data.tar.gz: c7f261894e9d31762af261a3413acd9d88396da7051a4dbd5c0feb8989146f3288d8b62c6bfcfa0942c02786c2c1b0efa7f74b0bb8837c57dedfed0bc4439ad9
+  metadata.gz: 1c18a392a7507b18fed79333f2c951507af3e8243d6eff12de84cd78ebfcd49d455ae45377ace9c125a8083571ac66524bc4599b1cd0f1b3674f7b59d1b6a405
+  data.tar.gz: ae50568454496b81f22fc3a28545bd0aa531b854443b33e865bebe5e2ede08bded4405b450412a5bfcdbbc365c687967bb2e10427701aeeaea0931d5ec1fbe90

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

@@ -146,7 +146,7 @@ module SmplkitGeneratedClient::Jobs
     end
 
     # List Runs
-    # List runs for this account (cursor paginated).  Default sort is `-created_at` (newest first). Sort by `created_at`, `started_at`, `finished_at`, `scheduled_for`, `status`, `job`, or `total_duration_ms`, ascending or descending (prefix `-` for descending). Keep the same `sort` value across paginated requests so the cursor stays consistent. Runs that have not reached the relevant lifecycle point (`started_at`, `finished_at`, `scheduled_for`, `total_duration_ms` unset) sort to the end regardless of direction.  Filters compose with AND:  - `filter[job]={id}` — a single job's run history. - `filter[status]` — one state or a comma-separated list (any-of). - `filter[environment]` — one environment key or a comma-separated list   (any-of); omitted covers every environment you can access. - `filter[created_at]` / `filter[started_at]` / `filter[finished_at]` /   `filter[scheduled_for]` — half-open `[start,end)` date ranges (see each   parameter for the interval syntax).
+    # List runs for this account (cursor paginated).  Default sort is `-created_at` (newest first). Sort by `created_at`, `started_at`, `finished_at`, `scheduled_for`, `status`, `job`, or `total_duration_ms`, ascending or descending (prefix `-` for descending). Keep the same `sort` value across paginated requests so the cursor stays consistent. Runs that have not reached the relevant lifecycle point (`started_at`, `finished_at`, `scheduled_for`, `total_duration_ms` unset) sort to the end regardless of direction.  Filters compose with AND:  - `filter[job]={id}` — a single job's run history. - `filter[status]` — one state or a comma-separated list (any-of). - `filter[environment]` — one environment key or a comma-separated list   (any-of); omitted covers every environment you can access. - `filter[created_at]` / `filter[started_at]` / `filter[finished_at]` /   `filter[scheduled_for]` — half-open `[start,end)` date ranges (see each   parameter for the interval syntax).  Set `last_run_only=true` to collapse the result to the last completed run for each job-and-environment combination. \"Completed\" means a terminal state — succeeded, failed, or canceled; in-flight runs (pending or running) are not included, so a job that is mid-run still surfaces its previous completed result and a combination with no completed run yet returns nothing. The filters above still apply, evaluated before the collapse, so each row is the most recent completed run in its group that also satisfies them.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :filter_job 
     # @option opts [String] :filter_status Restrict to runs in the given lifecycle state. One of `PENDING`, `RUNNING`, `SUCCEEDED`, `FAILED`, `CANCELED`, or a comma-separated list of them to match any (e.g. `SUCCEEDED,FAILED`).
@@ -155,6 +155,7 @@ module SmplkitGeneratedClient::Jobs
     # @option opts [String] :filter_started_at Restrict to runs whose `started_at` falls in a half-open `[start,end)` interval. Bounds are ISO-8601 timestamps; `*` leaves a bound open. The leading bracket is `[` (inclusive) or `(` (exclusive) and the trailing bracket is `]` (inclusive) or `)` (exclusive). Example: `[2026-06-01T00:00:00Z,2026-06-08T00:00:00Z)` selects the first week of June; `[2026-06-01T00:00:00Z,*)` is everything from then onward.
     # @option opts [String] :filter_finished_at Restrict to runs whose `finished_at` falls in a half-open `[start,end)` interval. Bounds are ISO-8601 timestamps; `*` leaves a bound open. The leading bracket is `[` (inclusive) or `(` (exclusive) and the trailing bracket is `]` (inclusive) or `)` (exclusive). Example: `[2026-06-01T00:00:00Z,2026-06-08T00:00:00Z)` selects the first week of June; `[2026-06-01T00:00:00Z,*)` is everything from then onward.
     # @option opts [String] :filter_scheduled_for Restrict to runs whose `scheduled_for` falls in a half-open `[start,end)` interval. Bounds are ISO-8601 timestamps; `*` leaves a bound open. The leading bracket is `[` (inclusive) or `(` (exclusive) and the trailing bracket is `]` (inclusive) or `)` (exclusive). Example: `[2026-06-01T00:00:00Z,2026-06-08T00:00:00Z)` selects the first week of June; `[2026-06-01T00:00:00Z,*)` is everything from then onward.
+    # @option opts [Boolean] :last_run_only Return only the last completed run for each job-and-environment combination. \"Completed\" means a terminal state — succeeded, failed, or canceled; runs still in flight (pending or running) are not included, so a job that is currently running still shows its previous completed result. The other filters and date ranges apply first, then the results collapse, so each row is the most recent completed run in its group that also matches them. Defaults to `false`. (default to false)
     # @option opts [Integer] :page_size Number of runs per page. Optional; defaults to `50` when omitted. Must be between `1` and `1000` inclusive — requests outside that range are rejected with a 400 error.
     # @option opts [String] :page_after 
     # @option opts [String] :sort Field to sort by. Prefix with `-` for descending order. Default: `-created_at`. Allowed values: `created_at`, `-created_at`, `finished_at`, `-finished_at`, `job`, `-job`, `scheduled_for`, `-scheduled_for`, `started_at`, `-started_at`, `status`, `-status`, `total_duration_ms`, `-total_duration_ms`. (default to '-created_at')
@@ -165,7 +166,7 @@ module SmplkitGeneratedClient::Jobs
     end
 
     # List Runs
-    # List runs for this account (cursor paginated).  Default sort is `-created_at` (newest first). Sort by `created_at`, `started_at`, `finished_at`, `scheduled_for`, `status`, `job`, or `total_duration_ms`, ascending or descending (prefix `-` for descending). Keep the same `sort` value across paginated requests so the cursor stays consistent. Runs that have not reached the relevant lifecycle point (`started_at`, `finished_at`, `scheduled_for`, `total_duration_ms` unset) sort to the end regardless of direction.  Filters compose with AND:  - `filter[job]={id}` — a single job's run history. - `filter[status]` — one state or a comma-separated list (any-of). - `filter[environment]` — one environment key or a comma-separated list   (any-of); omitted covers every environment you can access. - `filter[created_at]` / `filter[started_at]` / `filter[finished_at]` /   `filter[scheduled_for]` — half-open `[start,end)` date ranges (see each   parameter for the interval syntax).
+    # List runs for this account (cursor paginated).  Default sort is `-created_at` (newest first). Sort by `created_at`, `started_at`, `finished_at`, `scheduled_for`, `status`, `job`, or `total_duration_ms`, ascending or descending (prefix `-` for descending). Keep the same `sort` value across paginated requests so the cursor stays consistent. Runs that have not reached the relevant lifecycle point (`started_at`, `finished_at`, `scheduled_for`, `total_duration_ms` unset) sort to the end regardless of direction.  Filters compose with AND:  - `filter[job]={id}` — a single job's run history. - `filter[status]` — one state or a comma-separated list (any-of). - `filter[environment]` — one environment key or a comma-separated list   (any-of); omitted covers every environment you can access. - `filter[created_at]` / `filter[started_at]` / `filter[finished_at]` /   `filter[scheduled_for]` — half-open `[start,end)` date ranges (see each   parameter for the interval syntax).  Set `last_run_only=true` to collapse the result to the last completed run for each job-and-environment combination. \"Completed\" means a terminal state — succeeded, failed, or canceled; in-flight runs (pending or running) are not included, so a job that is mid-run still surfaces its previous completed result and a combination with no completed run yet returns nothing. The filters above still apply, evaluated before the collapse, so each row is the most recent completed run in its group that also satisfies them.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :filter_job 
     # @option opts [String] :filter_status Restrict to runs in the given lifecycle state. One of `PENDING`, `RUNNING`, `SUCCEEDED`, `FAILED`, `CANCELED`, or a comma-separated list of them to match any (e.g. `SUCCEEDED,FAILED`).
@@ -174,6 +175,7 @@ module SmplkitGeneratedClient::Jobs
     # @option opts [String] :filter_started_at Restrict to runs whose `started_at` falls in a half-open `[start,end)` interval. Bounds are ISO-8601 timestamps; `*` leaves a bound open. The leading bracket is `[` (inclusive) or `(` (exclusive) and the trailing bracket is `]` (inclusive) or `)` (exclusive). Example: `[2026-06-01T00:00:00Z,2026-06-08T00:00:00Z)` selects the first week of June; `[2026-06-01T00:00:00Z,*)` is everything from then onward.
     # @option opts [String] :filter_finished_at Restrict to runs whose `finished_at` falls in a half-open `[start,end)` interval. Bounds are ISO-8601 timestamps; `*` leaves a bound open. The leading bracket is `[` (inclusive) or `(` (exclusive) and the trailing bracket is `]` (inclusive) or `)` (exclusive). Example: `[2026-06-01T00:00:00Z,2026-06-08T00:00:00Z)` selects the first week of June; `[2026-06-01T00:00:00Z,*)` is everything from then onward.
     # @option opts [String] :filter_scheduled_for Restrict to runs whose `scheduled_for` falls in a half-open `[start,end)` interval. Bounds are ISO-8601 timestamps; `*` leaves a bound open. The leading bracket is `[` (inclusive) or `(` (exclusive) and the trailing bracket is `]` (inclusive) or `)` (exclusive). Example: `[2026-06-01T00:00:00Z,2026-06-08T00:00:00Z)` selects the first week of June; `[2026-06-01T00:00:00Z,*)` is everything from then onward.
+    # @option opts [Boolean] :last_run_only Return only the last completed run for each job-and-environment combination. \"Completed\" means a terminal state — succeeded, failed, or canceled; runs still in flight (pending or running) are not included, so a job that is currently running still shows its previous completed result. The other filters and date ranges apply first, then the results collapse, so each row is the most recent completed run in its group that also matches them. Defaults to `false`. (default to false)
     # @option opts [Integer] :page_size Number of runs per page. Optional; defaults to `50` when omitted. Must be between `1` and `1000` inclusive — requests outside that range are rejected with a 400 error.
     # @option opts [String] :page_after 
     # @option opts [String] :sort Field to sort by. Prefix with `-` for descending order. Default: `-created_at`. Allowed values: `created_at`, `-created_at`, `finished_at`, `-finished_at`, `job`, `-job`, `scheduled_for`, `-scheduled_for`, `started_at`, `-started_at`, `status`, `-status`, `total_duration_ms`, `-total_duration_ms`. (default to '-created_at')
@@ -202,6 +204,7 @@ module SmplkitGeneratedClient::Jobs
       query_params[:'filter[started_at]'] = opts[:'filter_started_at'] if !opts[:'filter_started_at'].nil?
       query_params[:'filter[finished_at]'] = opts[:'filter_finished_at'] if !opts[:'filter_finished_at'].nil?
       query_params[:'filter[scheduled_for]'] = opts[:'filter_scheduled_for'] if !opts[:'filter_scheduled_for'].nil?
+      query_params[:'last_run_only'] = opts[:'last_run_only'] if !opts[:'last_run_only'].nil?
       query_params[:'page[size]'] = opts[:'page_size'] if !opts[:'page_size'].nil?
       query_params[:'page[after]'] = opts[:'page_after'] if !opts[:'page_after'].nil?
       query_params[:'sort'] = opts[:'sort'] if !opts[:'sort'].nil?

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

@@ -58,7 +58,7 @@ describe 'RunsApi' do
 
   # unit tests for list_runs
   # List Runs
-  # List runs for this account (cursor paginated).  Default sort is `-created_at` (newest first). Sort by `created_at`, `started_at`, `finished_at`, `scheduled_for`, `status`, `job`, or `total_duration_ms`, ascending or descending (prefix `-` for descending). Keep the same `sort` value across paginated requests so the cursor stays consistent. Runs that have not reached the relevant lifecycle point (`started_at`, `finished_at`, `scheduled_for`, `total_duration_ms` unset) sort to the end regardless of direction.  Filters compose with AND:  - `filter[job]={id}` — a single job's run history. - `filter[status]` — one state or a comma-separated list (any-of). - `filter[environment]` — one environment key or a comma-separated list   (any-of); omitted covers every environment you can access. - `filter[created_at]` / `filter[started_at]` / `filter[finished_at]` /   `filter[scheduled_for]` — half-open `[start,end)` date ranges (see each   parameter for the interval syntax).
+  # List runs for this account (cursor paginated).  Default sort is `-created_at` (newest first). Sort by `created_at`, `started_at`, `finished_at`, `scheduled_for`, `status`, `job`, or `total_duration_ms`, ascending or descending (prefix `-` for descending). Keep the same `sort` value across paginated requests so the cursor stays consistent. Runs that have not reached the relevant lifecycle point (`started_at`, `finished_at`, `scheduled_for`, `total_duration_ms` unset) sort to the end regardless of direction.  Filters compose with AND:  - `filter[job]={id}` — a single job's run history. - `filter[status]` — one state or a comma-separated list (any-of). - `filter[environment]` — one environment key or a comma-separated list   (any-of); omitted covers every environment you can access. - `filter[created_at]` / `filter[started_at]` / `filter[finished_at]` /   `filter[scheduled_for]` — half-open `[start,end)` date ranges (see each   parameter for the interval syntax).  Set `last_run_only=true` to collapse the result to the last completed run for each job-and-environment combination. \"Completed\" means a terminal state — succeeded, failed, or canceled; in-flight runs (pending or running) are not included, so a job that is mid-run still surfaces its previous completed result and a combination with no completed run yet returns nothing. The filters above still apply, evaluated before the collapse, so each row is the most recent completed run in its group that also satisfies them.
   # @param [Hash] opts the optional parameters
   # @option opts [String] :filter_job 
   # @option opts [String] :filter_status Restrict to runs in the given lifecycle state. One of `PENDING`, `RUNNING`, `SUCCEEDED`, `FAILED`, `CANCELED`, or a comma-separated list of them to match any (e.g. `SUCCEEDED,FAILED`).
@@ -67,6 +67,7 @@ describe 'RunsApi' do
   # @option opts [String] :filter_started_at Restrict to runs whose `started_at` falls in a half-open `[start,end)` interval. Bounds are ISO-8601 timestamps; `*` leaves a bound open. The leading bracket is `[` (inclusive) or `(` (exclusive) and the trailing bracket is `]` (inclusive) or `)` (exclusive). Example: `[2026-06-01T00:00:00Z,2026-06-08T00:00:00Z)` selects the first week of June; `[2026-06-01T00:00:00Z,*)` is everything from then onward.
   # @option opts [String] :filter_finished_at Restrict to runs whose `finished_at` falls in a half-open `[start,end)` interval. Bounds are ISO-8601 timestamps; `*` leaves a bound open. The leading bracket is `[` (inclusive) or `(` (exclusive) and the trailing bracket is `]` (inclusive) or `)` (exclusive). Example: `[2026-06-01T00:00:00Z,2026-06-08T00:00:00Z)` selects the first week of June; `[2026-06-01T00:00:00Z,*)` is everything from then onward.
   # @option opts [String] :filter_scheduled_for Restrict to runs whose `scheduled_for` falls in a half-open `[start,end)` interval. Bounds are ISO-8601 timestamps; `*` leaves a bound open. The leading bracket is `[` (inclusive) or `(` (exclusive) and the trailing bracket is `]` (inclusive) or `)` (exclusive). Example: `[2026-06-01T00:00:00Z,2026-06-08T00:00:00Z)` selects the first week of June; `[2026-06-01T00:00:00Z,*)` is everything from then onward.
+  # @option opts [Boolean] :last_run_only Return only the last completed run for each job-and-environment combination. \"Completed\" means a terminal state — succeeded, failed, or canceled; runs still in flight (pending or running) are not included, so a job that is currently running still shows its previous completed result. The other filters and date ranges apply first, then the results collapse, so each row is the most recent completed run in its group that also matches them. Defaults to `false`.
   # @option opts [Integer] :page_size Number of runs per page. Optional; defaults to `50` when omitted. Must be between `1` and `1000` inclusive — requests outside that range are rejected with a 400 error.
   # @option opts [String] :page_after 
   # @option opts [String] :sort Field to sort by. Prefix with `-` for descending order. Default: `-created_at`. Allowed values: `created_at`, `-created_at`, `finished_at`, `-finished_at`, `job`, `-job`, `scheduled_for`, `-scheduled_for`, `started_at`, `-started_at`, `status`, `-status`, `total_duration_ms`, `-total_duration_ms`.

data/lib/smplkit/jobs/client.rb

@@ -394,13 +394,15 @@ module Smplkit
       # Convert the wrapper +environments+ map to the generated model hash.
       #
       # 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.
+      # (cron) override, +timezone+ override, and +configuration+ override are
+      # each sent only when present (omit to inherit the job's base +schedule+ /
+      # +timezone+ / +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[:timezone] = env.timezone unless env.timezone.nil?
           attrs[:configuration] = HttpConfig.to_wire(env.configuration) unless env.configuration.nil?
           out[env_key.to_s] = SmplkitGeneratedClient::Jobs::JobEnvironment.new(attrs)
         end
@@ -418,6 +420,11 @@ module Smplkit
           configuration: HttpConfig.to_wire(job.configuration),
           concurrency_policy: job.concurrency_policy
         }
+        # +timezone+ is only valid on a recurring (cron) job; an unset +nil+ is
+        # omitted, leaving the server default of UTC. (Unlike +schedule+, whose
+        # explicit +null+ creates a manual job, omitting +timezone+ simply
+        # inherits UTC — so it is sent only when present.)
+        attrs[:timezone] = job.timezone unless job.timezone.nil?
         environments = job.environments
         attrs[:environments] = environments_to_wire(environments) unless environments.nil? || environments.empty?
         SmplkitGeneratedClient::Jobs::Job.new(attrs)

data/lib/smplkit/jobs/models.rb

@@ -79,7 +79,8 @@ module Smplkit
     # (+{ 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.
+    # serializes on save; optional +schedule+ cron and +timezone+ overrides pass
+    # through.
     #
     # @api private
     def self.normalize_environments(environments)
@@ -94,6 +95,7 @@ module Smplkit
                               JobEnvironment.new(
                                 enabled: value[:enabled] || value["enabled"] || false,
                                 schedule: value[:schedule] || value["schedule"],
+                                timezone: value[:timezone] || value["timezone"],
                                 configuration: cfg
                               )
                             end
@@ -291,6 +293,13 @@ module Smplkit
     #     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] timezone
+    #   @return [String, nil] Optional per-environment IANA timezone override for
+    #     evaluating this environment's cron {#schedule} (recurring jobs only).
+    #     +nil+ (the default) inherits the base {Job#timezone}, else UTC. When
+    #     present, it must be a valid IANA zone key (e.g. +"America/New_York"+);
+    #     it may be set on an environment that inherits the base schedule (it
+    #     need not also override {#schedule}). Sent on writes only when present.
     # @!attribute [rw] configuration
     #   @return [HttpConfig, nil] Optional per-environment request configuration
     #     that fully replaces the job's base {Job#configuration} for this
@@ -301,8 +310,8 @@ module Smplkit
     #   @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)
+    JobEnvironment = Struct.new(:enabled, :schedule, :timezone, :configuration, :next_run_at, keyword_init: true) do
+      def initialize(enabled: false, schedule: nil, timezone: nil, configuration: nil, next_run_at: nil)
         super
       end
 
@@ -318,6 +327,7 @@ module Smplkit
         new(
           enabled: src.enabled.nil? ? false : src.enabled,
           schedule: src.schedule,
+          timezone: src.timezone,
           configuration: cfg.nil? ? nil : HttpConfig.from_wire(cfg),
           next_run_at: src.next_run_at
         )
@@ -386,6 +396,16 @@ module Smplkit
       #   {#set_schedule}.
       attr_accessor :schedule
 
+      # @return [String, nil] The base IANA timezone the cron {#schedule} is
+      #   evaluated in (e.g. +"America/New_York"+); +nil+ (the default) means
+      #   UTC. The base every environment inherits unless it sets its own
+      #   {JobEnvironment#timezone}. The cron fires on this zone's wall clock
+      #   (DST-aware) while +next_run_at+ is still reported as a UTC instant.
+      #   Only valid on a recurring (cron) job — leave +nil+ for a manual or
+      #   one-off job. Set it with {#set_timezone}; sent on writes only when
+      #   present.
+      attr_accessor :timezone
+
       # @return [HttpConfig] The base HTTP request to perform when the job fires.
       #   Per-environment overrides live in {#environments}.
       attr_accessor :configuration
@@ -416,7 +436,7 @@ module Smplkit
       attr_accessor :birth_environment
 
       def initialize(client = nil, id:, name:, configuration:, schedule: nil,
-                     description: nil, environments: nil,
+                     timezone: nil, description: nil, environments: nil,
                      kind: nil, type: "http", concurrency_policy: "ALLOW",
                      birth_environment: nil, created_at: nil,
                      updated_at: nil, deleted_at: nil, version: nil)
@@ -428,6 +448,7 @@ module Smplkit
         @kind = kind
         @type = type
         @schedule = schedule
+        @timezone = timezone
         @configuration = configuration
         @concurrency_policy = concurrency_policy
         @birth_environment = birth_environment
@@ -580,6 +601,29 @@ module Smplkit
         end
       end
 
+      # Set the IANA timezone the cron schedule is evaluated in — base
+      # (+environment+ omitted) or per-environment.
+      #
+      # With +environment+ omitted (the default), sets the base {#timezone}
+      # every environment inherits unless it overrides it. With an +environment+
+      # given, sets that environment's per-environment +timezone+ override on
+      # {#environments}, creating the override entry if it doesn't exist yet
+      # (preserving any already-set +enabled+ / +schedule+ / +configuration+ on
+      # it). A timezone is only valid on a recurring (cron) job; +nil+ means UTC
+      # (base) or "inherit the base" (per-environment). Call {#save} to persist.
+      #
+      # @param timezone [String, nil] A valid IANA timezone key (e.g.
+      #   +"America/New_York"+), or +nil+ for UTC / inherit.
+      # @param environment [String, nil] An environment key for a per-environment
+      #   override, or +nil+ to set the base timezone.
+      def set_timezone(timezone, environment: nil)
+        if environment.nil?
+          @timezone = timezone
+        else
+          _environment_override(environment).timezone = timezone
+        end
+      end
+
       # Trigger one immediate, manual run of this job (a +MANUAL+ run).
       #
       # @param environment [String, nil] Environment the run executes in.
@@ -633,6 +677,7 @@ module Smplkit
         @kind = other.kind
         @type = other.type
         @schedule = other.schedule
+        @timezone = other.timezone
         @configuration = other.configuration
         @concurrency_policy = other.concurrency_policy
         @created_at = other.created_at
@@ -663,6 +708,7 @@ module Smplkit
           kind: a.kind,
           type: a.type || "http",
           schedule: a.schedule,
+          timezone: a.timezone,
           configuration: HttpConfig.from_wire(a.configuration),
           concurrency_policy: a.concurrency_policy || "ALLOW",
           created_at: a.created_at,

metadata

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