PR from Fastly

CHANGELOG.md

@@ -1,5 +1,241 @@
 # Changelog
 
+## [v12.1.0](https://github.com/fastly/fastly-php/releases/tag/release/v12.1.0) (2025-12-09)
+
+**Enhancements:**
+
+- feat(realtime, historical): Add new metrics `imgopto_compute_requests`, `dns_billable_responses_count`,
+                              `dns_nonbillable_responses_count`, and `upgrade`.
+- feat(products[ngwaf]): Add new parameter `traffic_ramp` to `enable-product-ngwaf`.
+- feat(products[ddos_protection]): Add new parameter `mode` to `enable-product-ddos-protection`.
+- feat(kv_store): Add `kv-store-put` operation.
+- feat(iam_roles): Add `DisplayName` field to model.
+- feat(domain_research): Add new Domain Research API.
+- feat(ddos_protection): Add `requests_allowed` and `requests_detected` fields to DDoS Protection event API.
+
+- feat(products): Add `domain_research` product to enablement API.
+
+
+
+**Documentation:**
+
+- doc(enabled-products): Add support for optional enablement parameters for some products.
+
+
+## [v12.0.0](https://github.com/fastly/fastly-php/releases/tag/release/v12.0.0) (2025-10-31)
+
+**Bug fixes:**
+
+- fix(dictionary): Correct example dictionary name to use valid characters
+
+**Enhancements:**
+
+- feat(iam_roles): Add new IAM Roles API.
+- feat(api_discovery): Add new API Discovery API.
+- feat(realtime, historical): Add new metric `api_discovery_requests_count`.
+- feat(user): Add the ability to assign multiple roles to users.
+- feat(healthcheck): Clarify the valid range for the `check_interval` parameter.
+- feat(ddos_protection): Add `traffic_percentage` field to DDoS Protection traffic statistics responses.
+- feat(ddos_protection): Update `ddos-protection-event-rule-list` with `include=traffic_stats` parameter for embedded traffic statistics.
+- feat(logging_https): Add `period` parameter to the logging HTTPS endpoint.
+
+**Documentation:**
+
+- doc(sudo): Spelling fixes.
+- doc(enabled-products): Add support for product ID `api_discovery`.
+
+
+## [v11.0.0](https://github.com/fastly/fastly-php/releases/tag/release/v11.0.0) (2025-08-28)
+
+**Breaking Changes:**
+
+- removed(ddos_protection): Remove enum configs `ddos_protection_action` and ``ddos_protection_traffic_attribute`.
+- changed(backend): Added default values to `tcp_keepalive_interval`, `tcp_keepalive_probes`, and `tcp_keepalive_time` properties.
+- removed(tls_subscriptions): Remove `force` parameter from TLS subscriptions.
+
+
+**Enhancements:**
+
+- feat(ngwaf_reports): Add Get attacks report endpoint.
+- feat(kv_store): Add `name` parameter to the List KV stores endpoint.
+- feat(historical): Add `services` parameter to the Historical Stats API endpoint.
+- feat(ddos_protection): Add PATCH endpoint in the Fastly DDoS Protection Events API allowing customers to update the DDoS rules action to `log`, `block`, `default`, or `off`.
+- feat(observability_timeseries): Add Observability Timeseries API for data visualized in the Sustainability dashboard.
+
+
+**Documentation:**
+
+- doc(backend, pool): Describe difference in behavior of `between_bytes_timeout` between
+                      Deliver and Compute services.
+- doc(ddos_protection): Update GET API docs describing that they can be accessed by any user role as long as the service belongs to the customer.
+
+
+## [v10.1.0](https://github.com/fastly/fastly-php/releases/tag/release/v10.1.0) (2025-07-07)
+
+**Bug fixes:**
+
+- fix(backend): Marked `prefer_ipv6` as not nullable, and documented that the default value differs for Delivery and Compute services.
+- fix(invitations): Marked `service_invitations.data` under relationships as nullable, and corrected model composition.
+
+
+**Enhancements:**
+
+- feat(tls_certificates): Add `allow_untrusted_root` attribute for TLS certificate creation and update endpoints
+
+
+**Documentation:**
+
+- doc: Update redirect URLs
+
+
+## [v10.0.0](https://github.com/fastly/fastly-php/releases/tag/release/v10.0.0) (2025-06-11)
+
+**Breaking Changes:**
+
+- removed(properties): Remove logging placement value `waf_debug`.
+
+
+**Bug fixes:**
+
+- fix(backend): Marked `prefer_ipv6` as nullable.
+
+
+**Enhancements:**
+
+- feat(historical): The following Next-Gen WAF metrics have been updated to include both Edge WAF and
+-                   Core WAF counts:`ngwaf_requests_total_count`, `ngwaf_requests_blocked_count`,
+
+
+**Documentation:**
+
+- doc(domain-discovery): Correct documentation of valid values of `scope` query parameter.
+- doc(observability-aggregations-for-logs): Correct documentation of valid values of `log-aggregations-filter` query
+                                            parameter.
+- doc(backend): Tweak language of `prefer_ipv6` description.
+- doc(service): Add documentation for `filter[versions.active]` query parameter when getting detailed information on
+                a specified service.
+
+
+## [v9.0.0](https://github.com/fastly/fastly-php/releases/tag/release/v9.0.0) (2025-05-12)
+
+**Breaking Changes:**
+
+- deprecated(user): The POST /user endpoint has been deprecated.
+
+- fix(acls_in_compute): Corrected the successful `PATCH` response code from the `/resources/acls/${acl_id}/entries` endpoint.
+
+
+**Enhancements:**
+
+- feat(products): Add endpoint to each service-level product to list services that enable that product.
+- feat(observability-aggregations-for-logs): Add new Observability Aggregations API for Logs.
+- feat(observability-timeseries-for-logs): Add new Observability Timeseries API for Logs.
+- feat(pops): Add new Mexico regions.
+- feat(historical): Add new Mexico regions.
+- feat(ddos-protection): Add `ddos-protection` product.
+- feat(backend): Add the `prefer_ipv6` option to prefer IPv6 during a backend DNS hostname lookup.
+- feat(products): Added new GET endpoint for all services with product enabled on a customer.
+
+**Documentation:**
+
+- doc(kv-store): Add clarification on valid KV Store names.
+- doc(kv-store-item): Add clarification on valid KV Store keys.
+- doc(dictionary): Usages of `edge dictionary` standardized to `dictionary`.
+- doc(acls-in-compute): Add documentation on how to remove a single ACL entry using the existing
+                        `compute-acl-update-acls` operation.
+- doc(acls-in-compute): Correct documentation on `action` field of `compute-acl-update-acls` endpoint.
+
+## [v8.0.0](https://github.com/fastly/fastly-php/releases/tag/release/v8.0.0) (2025-03-13)
+
+**Breaking Changes:**
+
+- fix(automation_tokens): Response content types corrected.
+- fix(automation_tokens): Removed timestamp fields.
+- removed(billing): Billing v2 API has been removed.
+
+- fix(acls_in_compute): Corrected `meta.limit` field type from string to integer.
+
+- fix(condition): Condition responses now always have a string value for the priority field.
+- fix(header): Header responses now always have a string value for the priority field.
+- fix(snippet): Snippet responses now always have string values for the priority and dynamic fields.
+
+- fix(kv_store_item): `kv-store-get-item` returns an inline object instead of a File object.
+
+
+**Enhancements:**
+
+- fix(automation_tokens): Added tls_access, creator_id fields to responses.
+- feat(billing_usage_metrics): Added filter by service identifier for service-usage-metrics endpoint.
+- feat(historical): Added new metrics: `ngwaf_requests_total_count`, `ngwaf_requests_unknown_count`,
+                    `ngwaf_requests_allowed_count`, `ngwaf_requests_logged_count`, `ngwaf_requests_blocked_count`,
+                    `ngwaf_requests_timeout_count`, and `ngwaf_requests_challenged_count`.
+- feat(tls_bulk_certificates): Added `not_before` and `not_after` filter parameters to allow for filtering of bulk TLS
+                               certificates by expiry.
+
+
+**Documentation:**
+
+- doc(billing_usage_metrics): Correct documentation of pagination limits.
+- doc(billing_usage_metrics): Correct documentation of api conditions for product_id and usage_type_name filters.
+- doc(logging_azureblob): Mention Azure Block size limits.
+
+
+## [v7.0.0](https://github.com/fastly/fastly-php/releases/tag/release/v7.0.0) (2025-02-26)
+
+**Breaking Changes:**
+
+- fix(snippet): Renamed `snippet_id` and `snippet_name` properties to `id` and `name` respectively.
+- feat(kv_store, kv_store_item): KV store endpoints have new operation names, and the associated data models also have
+                                 new names.
+- feat(product): Product enablement and configuration endpoints have been renamed into per-product operations.
+- fix(historical): Widened integer stats fields to 64 bits.
+- fix(realtime, domain_inspector): Widened integer stats fields to 64 bits.
+- fix(historical): Corrected field names of `ddos_protection_requests_detect_count`,
+                   `ddos_protection_requests_mitigate_count`, and `ddos_protection_requests_allow_count`.
+- fix(realtime): Corrected field names of `ddos_protection_requests_detect_count`,
+                 `ddos_protection_requests_mitigate_count`, and `ddos_protection_requests_allow_count`.
+- fix(billing_usage_metrics): added parameters `req_start_month` and `req_end_month`.
+- deprecated(billing): Billing v2 API has been deprecated.
+- removed(legacy_waf): Legacy WAF API has been removed.
+
+**Bug fixes:**
+
+- bugfix(php): Define apiKeys on the Configuration class (Fix PHP deprecated syntax)
+- fix(snippet): Marked `content` as nullable to support dynamic snippets.
+- fix(billing_usage_metrics): `product_id` and `usage_type_name` parameters are no longer required.
+
+**Enhancements:**
+
+- feat(products): Added `object_storage` and `ai_accelerator` products.
+- feat(historical): Added new metrics: `object_storage_class_a_operations_count`,
+                    `object_storage_class_b_operations_count`, `aia_requests`, `aia_status_1xx`,
+                    `aia_status_2xx`, `aia_status_3xx`, `aia_status_5xx`, `aia_response_usage_tokens`,
+                    `aia_origin_usage_tokens`, `aia_estimated_time_saved_ms`, `request_collapse_usable_count`,
+                    `request_collapse_unusable_count`, `status_530`, and `compute_cache_operations_count`.
+- feat(realtime): Added new metrics: `object_storage_class_a_operations_count`,
+                  `object_storage_class_b_operations_count`, `aia_requests`, `aia_status_1xx`,
+                  `aia_status_2xx`, `aia_status_3xx`, `aia_status_5xx`, `aia_response_usage_tokens`,
+                  `aia_origin_usage_tokens`, `aia_estimated_time_saved_ms`, `request_collapse_usable_count`,
+                  `request_collapse_unusable_count`, `status_530`, and `compute_cache_operations_count`.
+- feat(object_storage_access_keys): Added Object Storage Access Keys API.
+- feat(domain_inspector_historical, domain_inspector_realtime): Added new metrics: `status_530` and `origin_status_530`.
+- feat(origin_inspector_historical, origin_inspector_realtime): Added new metrics: `status_530`, `waf_status_530`,
+                                                                `compute_status_530`, and `all_status_530`.
+- feat(kv_store_item): Added support for `if-generation-match`.
+- feat(acls_in_compute): Added ACLs in Compute API.
+
+**Documentation:**
+
+- doc(billing_usage_metrics): Documented that `start_month` and `end_month` are required.
+- doc(historical): Correct default start time in description of Historical Stats API.
+- doc(domain_inspector_historical): Removed duplicate description.
+- doc(domain_inspector_realtime): Removed duplicate description.
+- doc(origin_inspector_historical): Removed duplicate description.
+- doc(origin_inspector_realtime): Removed duplicate description.
+- doc(backend): Updated description of Backend API.
+- doc(backend): Clarified default behavior of keepalive_time.
+- doc(waf): Updated EOL notice of legacy-waf.
+
 ## [v6.0.0](https://github.com/fastly/fastly-php/releases/tag/release/v6.0.0) (2024-12-05)
 
 **Breaking Changes:**