diff --git a/generated/Model/ContentStateStart.php b/generated/Model/ContentStateStart.php index e8d323c..fc0ff7e 100644 --- a/generated/Model/ContentStateStart.php +++ b/generated/Model/ContentStateStart.php @@ -35,7 +35,7 @@ * ContentStateStart Class Doc Comment * * @category Class - * @description Start payload requires title and type. For segmented_progress include number_of_steps and current_step. For progress include percentage or value with upper_limit. For metrics and stats include a non-empty metrics array. For value include a string or number in value; strings preserve currency, units, and other formatting. For alert include message. For timer include duration_seconds for countdowns, or set counts_down false without duration_seconds for an open-ended elapsed timer. Optional icon is supported by all Live Activity types. Optional badge is supported by alert, progress, segmented_progress, and value. For segmented_progress, number_of_steps is not locked and can be changed in later update or end calls. + * @description Start payload requires title and type. For segmented_progress include number_of_steps and current_step. For progress include percentage or value with upper_limit. For metrics and stats include a non-empty metrics array. For value include a string or number in value; strings preserve currency, units, and other formatting. For alert include message. For timer include duration_seconds or timer_end_at for countdowns, or set counts_down false without them for an open-ended elapsed timer. Add timer_start_at for a timer that started earlier. Optional icon is supported by all Live Activity types. Optional badge is supported by alert, progress, segmented_progress, and value. For segmented_progress, number_of_steps is not locked and can be changed in later update or end calls. * @package ActivitySmith\Generated * @author OpenAPI Generator team * @link https://openapi-generator.tech @@ -66,6 +66,8 @@ class ContentStateStart implements ModelInterface, ArrayAccess, \JsonSerializabl 'value' => '\ActivitySmith\Generated\Model\LiveActivityValue', 'upperLimit' => 'float', 'durationSeconds' => 'float', + 'timerStartAt' => '\DateTime', + 'timerEndAt' => '\DateTime', 'countsDown' => 'bool', 'isRunning' => 'bool', 'metrics' => '\ActivitySmith\Generated\Model\ActivityMetric[]', @@ -94,6 +96,8 @@ class ContentStateStart implements ModelInterface, ArrayAccess, \JsonSerializabl 'value' => null, 'upperLimit' => null, 'durationSeconds' => null, + 'timerStartAt' => 'date-time', + 'timerEndAt' => 'date-time', 'countsDown' => null, 'isRunning' => null, 'metrics' => null, @@ -120,6 +124,8 @@ class ContentStateStart implements ModelInterface, ArrayAccess, \JsonSerializabl 'value' => false, 'upperLimit' => false, 'durationSeconds' => false, + 'timerStartAt' => false, + 'timerEndAt' => false, 'countsDown' => false, 'isRunning' => false, 'metrics' => false, @@ -226,6 +232,8 @@ public function isNullableSetToNull(string $property): bool 'value' => 'value', 'upperLimit' => 'upper_limit', 'durationSeconds' => 'duration_seconds', + 'timerStartAt' => 'timer_start_at', + 'timerEndAt' => 'timer_end_at', 'countsDown' => 'counts_down', 'isRunning' => 'is_running', 'metrics' => 'metrics', @@ -252,6 +260,8 @@ public function isNullableSetToNull(string $property): bool 'value' => 'setValue', 'upperLimit' => 'setUpperLimit', 'durationSeconds' => 'setDurationSeconds', + 'timerStartAt' => 'setTimerStartAt', + 'timerEndAt' => 'setTimerEndAt', 'countsDown' => 'setCountsDown', 'isRunning' => 'setIsRunning', 'metrics' => 'setMetrics', @@ -278,6 +288,8 @@ public function isNullableSetToNull(string $property): bool 'value' => 'getValue', 'upperLimit' => 'getUpperLimit', 'durationSeconds' => 'getDurationSeconds', + 'timerStartAt' => 'getTimerStartAt', + 'timerEndAt' => 'getTimerEndAt', 'countsDown' => 'getCountsDown', 'isRunning' => 'getIsRunning', 'metrics' => 'getMetrics', @@ -473,6 +485,8 @@ public function __construct(array $data = null) $this->setIfExists('value', $data ?? [], null); $this->setIfExists('upperLimit', $data ?? [], null); $this->setIfExists('durationSeconds', $data ?? [], null); + $this->setIfExists('timerStartAt', $data ?? [], null); + $this->setIfExists('timerEndAt', $data ?? [], null); $this->setIfExists('countsDown', $data ?? [], true); $this->setIfExists('isRunning', $data ?? [], true); $this->setIfExists('metrics', $data ?? [], null); @@ -601,7 +615,7 @@ public function getTitle() /** * Sets title * - * @param string $title title + * @param string $title Title shown on the Live Activity. Send an empty string to show no title. * * @return self */ @@ -808,7 +822,7 @@ public function getDurationSeconds() /** * Sets durationSeconds * - * @param float|null $durationSeconds Timer duration in seconds. For type=timer countdowns, required on start when counts_down is true or omitted. + * @param float|null $durationSeconds Timer duration in seconds. For type=timer countdowns, required on start when counts_down is true or omitted, unless you send timer_end_at. Counts from timer_start_at when you send it. * * @return self */ @@ -822,6 +836,60 @@ public function setDurationSeconds($durationSeconds) return $this; } + /** + * Gets timerStartAt + * + * @return \DateTime|null + */ + public function getTimerStartAt() + { + return $this->container['timerStartAt']; + } + + /** + * Sets timerStartAt + * + * @param \DateTime|null $timerStartAt Use with type=timer. ISO 8601 date and time when the timer started. It can be in the past, so a countdown that started earlier shows the time already gone in its progress bar. Defaults to the request time. Must not be in the future. + * + * @return self + */ + public function setTimerStartAt($timerStartAt) + { + if (is_null($timerStartAt)) { + throw new \InvalidArgumentException('non-nullable timerStartAt cannot be null'); + } + $this->container['timerStartAt'] = $timerStartAt; + + return $this; + } + + /** + * Gets timerEndAt + * + * @return \DateTime|null + */ + public function getTimerEndAt() + { + return $this->container['timerEndAt']; + } + + /** + * Sets timerEndAt + * + * @param \DateTime|null $timerEndAt Use with type=timer. ISO 8601 date and time when the countdown ends. Must be after timer_start_at, or in the future when timer_start_at is omitted. Send duration_seconds or timer_end_at, not both. + * + * @return self + */ + public function setTimerEndAt($timerEndAt) + { + if (is_null($timerEndAt)) { + throw new \InvalidArgumentException('non-nullable timerEndAt cannot be null'); + } + $this->container['timerEndAt'] = $timerEndAt; + + return $this; + } + /** * Gets countsDown * diff --git a/generated/Model/ContentStateUpdate.php b/generated/Model/ContentStateUpdate.php index 255995f..a6539ef 100644 --- a/generated/Model/ContentStateUpdate.php +++ b/generated/Model/ContentStateUpdate.php @@ -66,6 +66,8 @@ class ContentStateUpdate implements ModelInterface, ArrayAccess, \JsonSerializab 'value' => '\ActivitySmith\Generated\Model\LiveActivityValue', 'upperLimit' => 'float', 'durationSeconds' => 'float', + 'timerStartAt' => '\DateTime', + 'timerEndAt' => '\DateTime', 'countsDown' => 'bool', 'isRunning' => 'bool', 'metrics' => '\ActivitySmith\Generated\Model\ActivityMetric[]', @@ -94,6 +96,8 @@ class ContentStateUpdate implements ModelInterface, ArrayAccess, \JsonSerializab 'value' => null, 'upperLimit' => null, 'durationSeconds' => null, + 'timerStartAt' => 'date-time', + 'timerEndAt' => 'date-time', 'countsDown' => null, 'isRunning' => null, 'metrics' => null, @@ -120,6 +124,8 @@ class ContentStateUpdate implements ModelInterface, ArrayAccess, \JsonSerializab 'value' => false, 'upperLimit' => false, 'durationSeconds' => false, + 'timerStartAt' => false, + 'timerEndAt' => false, 'countsDown' => false, 'isRunning' => false, 'metrics' => false, @@ -226,6 +232,8 @@ public function isNullableSetToNull(string $property): bool 'value' => 'value', 'upperLimit' => 'upper_limit', 'durationSeconds' => 'duration_seconds', + 'timerStartAt' => 'timer_start_at', + 'timerEndAt' => 'timer_end_at', 'countsDown' => 'counts_down', 'isRunning' => 'is_running', 'metrics' => 'metrics', @@ -252,6 +260,8 @@ public function isNullableSetToNull(string $property): bool 'value' => 'setValue', 'upperLimit' => 'setUpperLimit', 'durationSeconds' => 'setDurationSeconds', + 'timerStartAt' => 'setTimerStartAt', + 'timerEndAt' => 'setTimerEndAt', 'countsDown' => 'setCountsDown', 'isRunning' => 'setIsRunning', 'metrics' => 'setMetrics', @@ -278,6 +288,8 @@ public function isNullableSetToNull(string $property): bool 'value' => 'getValue', 'upperLimit' => 'getUpperLimit', 'durationSeconds' => 'getDurationSeconds', + 'timerStartAt' => 'getTimerStartAt', + 'timerEndAt' => 'getTimerEndAt', 'countsDown' => 'getCountsDown', 'isRunning' => 'getIsRunning', 'metrics' => 'getMetrics', @@ -473,6 +485,8 @@ public function __construct(array $data = null) $this->setIfExists('value', $data ?? [], null); $this->setIfExists('upperLimit', $data ?? [], null); $this->setIfExists('durationSeconds', $data ?? [], null); + $this->setIfExists('timerStartAt', $data ?? [], null); + $this->setIfExists('timerEndAt', $data ?? [], null); $this->setIfExists('countsDown', $data ?? [], true); $this->setIfExists('isRunning', $data ?? [], true); $this->setIfExists('metrics', $data ?? [], null); @@ -598,7 +612,7 @@ public function getTitle() /** * Sets title * - * @param string $title title + * @param string $title Title shown on the Live Activity. Send an empty string to show no title. * * @return self */ @@ -805,7 +819,7 @@ public function getDurationSeconds() /** * Sets durationSeconds * - * @param float|null $durationSeconds Timer duration in seconds. For type=timer, sending duration_seconds resets the timer window from the update request time; omit it to preserve the existing timer window. + * @param float|null $durationSeconds Timer duration in seconds. For type=timer, sending duration_seconds resets the timer window from the update request time, or from timer_start_at when you send it. Omit it to preserve the existing timer window. * * @return self */ @@ -819,6 +833,60 @@ public function setDurationSeconds($durationSeconds) return $this; } + /** + * Gets timerStartAt + * + * @return \DateTime|null + */ + public function getTimerStartAt() + { + return $this->container['timerStartAt']; + } + + /** + * Sets timerStartAt + * + * @param \DateTime|null $timerStartAt Use with type=timer. ISO 8601 date and time when the timer started. It can be in the past, so a countdown that started earlier shows the time already gone in its progress bar. Defaults to the request time. Must not be in the future. + * + * @return self + */ + public function setTimerStartAt($timerStartAt) + { + if (is_null($timerStartAt)) { + throw new \InvalidArgumentException('non-nullable timerStartAt cannot be null'); + } + $this->container['timerStartAt'] = $timerStartAt; + + return $this; + } + + /** + * Gets timerEndAt + * + * @return \DateTime|null + */ + public function getTimerEndAt() + { + return $this->container['timerEndAt']; + } + + /** + * Sets timerEndAt + * + * @param \DateTime|null $timerEndAt Use with type=timer. ISO 8601 date and time when the countdown ends. Must be after timer_start_at, or in the future when timer_start_at is omitted. Send duration_seconds or timer_end_at, not both. Send timer_end_at alone to move the end and keep the current start. + * + * @return self + */ + public function setTimerEndAt($timerEndAt) + { + if (is_null($timerEndAt)) { + throw new \InvalidArgumentException('non-nullable timerEndAt cannot be null'); + } + $this->container['timerEndAt'] = $timerEndAt; + + return $this; + } + /** * Gets countsDown * diff --git a/generated/Model/StreamContentState.php b/generated/Model/StreamContentState.php index bc318c8..af91edf 100644 --- a/generated/Model/StreamContentState.php +++ b/generated/Model/StreamContentState.php @@ -35,7 +35,7 @@ * StreamContentState Class Doc Comment * * @category Class - * @description Current state for a managed Live Activity stream. Include type on the first PUT, and whenever the stream may need to start a fresh activity. Supports segmented_progress, progress, metrics, stats, alert, timer, and value types. For timer, send duration_seconds to start or reset a bounded timer; omit duration_seconds on later updates to preserve the existing timer window. + * @description Current state for a managed Live Activity stream. Include type on the first PUT, and whenever the stream may need to start a fresh activity. Supports segmented_progress, progress, metrics, stats, alert, timer, and value types. For timer, send duration_seconds or timer_end_at to start or reset a bounded timer, and timer_start_at for a timer that started earlier. Omit them on later updates to preserve the existing timer window. * @package ActivitySmith\Generated * @author OpenAPI Generator team * @link https://openapi-generator.tech @@ -66,6 +66,8 @@ class StreamContentState implements ModelInterface, ArrayAccess, \JsonSerializab 'value' => '\ActivitySmith\Generated\Model\LiveActivityValue', 'upperLimit' => 'float', 'durationSeconds' => 'float', + 'timerStartAt' => '\DateTime', + 'timerEndAt' => '\DateTime', 'countsDown' => 'bool', 'isRunning' => 'bool', 'type' => 'string', @@ -96,6 +98,8 @@ class StreamContentState implements ModelInterface, ArrayAccess, \JsonSerializab 'value' => null, 'upperLimit' => null, 'durationSeconds' => null, + 'timerStartAt' => 'date-time', + 'timerEndAt' => 'date-time', 'countsDown' => null, 'isRunning' => null, 'type' => null, @@ -124,6 +128,8 @@ class StreamContentState implements ModelInterface, ArrayAccess, \JsonSerializab 'value' => false, 'upperLimit' => false, 'durationSeconds' => false, + 'timerStartAt' => false, + 'timerEndAt' => false, 'countsDown' => false, 'isRunning' => false, 'type' => false, @@ -232,6 +238,8 @@ public function isNullableSetToNull(string $property): bool 'value' => 'value', 'upperLimit' => 'upper_limit', 'durationSeconds' => 'duration_seconds', + 'timerStartAt' => 'timer_start_at', + 'timerEndAt' => 'timer_end_at', 'countsDown' => 'counts_down', 'isRunning' => 'is_running', 'type' => 'type', @@ -260,6 +268,8 @@ public function isNullableSetToNull(string $property): bool 'value' => 'setValue', 'upperLimit' => 'setUpperLimit', 'durationSeconds' => 'setDurationSeconds', + 'timerStartAt' => 'setTimerStartAt', + 'timerEndAt' => 'setTimerEndAt', 'countsDown' => 'setCountsDown', 'isRunning' => 'setIsRunning', 'type' => 'setType', @@ -288,6 +298,8 @@ public function isNullableSetToNull(string $property): bool 'value' => 'getValue', 'upperLimit' => 'getUpperLimit', 'durationSeconds' => 'getDurationSeconds', + 'timerStartAt' => 'getTimerStartAt', + 'timerEndAt' => 'getTimerEndAt', 'countsDown' => 'getCountsDown', 'isRunning' => 'getIsRunning', 'type' => 'getType', @@ -485,6 +497,8 @@ public function __construct(array $data = null) $this->setIfExists('value', $data ?? [], null); $this->setIfExists('upperLimit', $data ?? [], null); $this->setIfExists('durationSeconds', $data ?? [], null); + $this->setIfExists('timerStartAt', $data ?? [], null); + $this->setIfExists('timerEndAt', $data ?? [], null); $this->setIfExists('countsDown', $data ?? [], true); $this->setIfExists('isRunning', $data ?? [], true); $this->setIfExists('type', $data ?? [], null); @@ -620,7 +634,7 @@ public function getTitle() /** * Sets title * - * @param string $title title + * @param string $title Title shown on the Live Activity. Send an empty string to show no title. * * @return self */ @@ -827,7 +841,7 @@ public function getDurationSeconds() /** * Sets durationSeconds * - * @param float|null $durationSeconds Timer duration in seconds. For type=timer, send duration_seconds to start or reset the timer window; omit it on later stream updates to preserve the existing timer window. + * @param float|null $durationSeconds Timer duration in seconds. For type=timer, send duration_seconds to start or reset the timer window, counted from timer_start_at when you send it. Omit it on later stream updates to preserve the existing timer window. * * @return self */ @@ -841,6 +855,60 @@ public function setDurationSeconds($durationSeconds) return $this; } + /** + * Gets timerStartAt + * + * @return \DateTime|null + */ + public function getTimerStartAt() + { + return $this->container['timerStartAt']; + } + + /** + * Sets timerStartAt + * + * @param \DateTime|null $timerStartAt Use with type=timer. ISO 8601 date and time when the timer started. It can be in the past, so a countdown that started earlier shows the time already gone in its progress bar. Defaults to the request time. Must not be in the future. + * + * @return self + */ + public function setTimerStartAt($timerStartAt) + { + if (is_null($timerStartAt)) { + throw new \InvalidArgumentException('non-nullable timerStartAt cannot be null'); + } + $this->container['timerStartAt'] = $timerStartAt; + + return $this; + } + + /** + * Gets timerEndAt + * + * @return \DateTime|null + */ + public function getTimerEndAt() + { + return $this->container['timerEndAt']; + } + + /** + * Sets timerEndAt + * + * @param \DateTime|null $timerEndAt Use with type=timer. ISO 8601 date and time when the countdown ends. Must be after timer_start_at, or in the future when timer_start_at is omitted. Send duration_seconds or timer_end_at, not both. On later stream updates, send timer_end_at alone to move the end and keep the current start. + * + * @return self + */ + public function setTimerEndAt($timerEndAt) + { + if (is_null($timerEndAt)) { + throw new \InvalidArgumentException('non-nullable timerEndAt cannot be null'); + } + $this->container['timerEndAt'] = $timerEndAt; + + return $this; + } + /** * Gets countsDown * diff --git a/generated/openapi-source.json b/generated/openapi-source.json index 6150a4d..bba4174 100644 --- a/generated/openapi-source.json +++ b/generated/openapi-source.json @@ -1,6 +1,6 @@ { "repository": "ActivitySmithHQ/activitysmith-backend", - "commit": "15ba559268fc8a9faa46ac73ed6c5fdc96f7e4f7", + "commit": "b94943aee5de9d2c386a3fe164cd585666cc3907", "path": "openapi.json", - "sha256": "1964b1e64ee810e2dd4cadb41916e59b836720b8607ef60c298e3f990aeb9cb8" + "sha256": "5491f8ab50edb32b94813dd77adcb09d289aef69f29008ec9117e05af6eaed28" }