diff --git a/.fern/metadata.json b/.fern/metadata.json index 2164ad6..197ca20 100644 --- a/.fern/metadata.json +++ b/.fern/metadata.json @@ -14,7 +14,7 @@ }, "originGitCommitIsDirty": null, "invokedBy": "ci", - "requestedVersion": "1.31.0", + "requestedVersion": "1.32.0", "ciProvider": "gitlab", - "sdkVersion": "1.31.0" + "sdkVersion": "1.32.0" } \ No newline at end of file diff --git a/.fern/replay.lock b/.fern/replay.lock index 77afb74..c510cb7 100644 --- a/.fern/replay.lock +++ b/.fern/replay.lock @@ -12,5 +12,11 @@ generations: cli_version: unknown generator_versions: fernapi/fern-php-sdk: 2.10.15 -current_generation: 9fe8bd0428e461a8640a32efb10ec0c702475b82 + - commit_sha: 3228ea919c0e5a7947f838cb7c232ff51265d291 + tree_hash: 31a8b169388a72a5bf00bb56d9e998b645fc64d4 + timestamp: 2026-08-04T20:33:12.483Z + cli_version: unknown + generator_versions: + fernapi/fern-php-sdk: 2.10.15 +current_generation: 3228ea919c0e5a7947f838cb7c232ff51265d291 patches: [] diff --git a/composer.json b/composer.json index 712f8f2..5bb6a72 100644 --- a/composer.json +++ b/composer.json @@ -1,6 +1,6 @@ { "name": "namecom/core-api", - "version": "1.31.0", + "version": "1.32.0", "description": "Official PHP SDK for the name.com Core API", "keywords": [ "namecom", diff --git a/reference.md b/reference.md index 3244964..2255e03 100644 --- a/reference.md +++ b/reference.md @@ -3815,9 +3815,10 @@ $client->webhookNotifications->getSubscribedNotifications(); Creates a webhook subscription to receive real-time notifications about specific domain or account events (e.g. transfer completions, renewals). Pass the callback URL and event types. This allows external systems to stay in sync with name.com changes. Supported webhook event names: - `account.credit.balance_change` – account credit balance changes (increases or decreases). +- `account.domain.removal` – domain removed from the subscribing account. - `domain.lock.status_change` – domain lock added or removed. - `domain.transfer.status_change` – domain transfer IN to name.com; status updates while name.com is the gaining registrar. -- `domain.transfer_out.status_change` – domain transfer OUT from name.com to another registrar; fires when the domain is removed from the account. +- `domain.transfer_out.status_change` – domain transfer OUT from name.com; `initiated`, `completed` (domain removed), or `canceled` (no longer pending at the registry). - `domain.transfer.internal_in` - name.com domain transfers in to the subscribing account via internal transfer. - `domain.transfer.internal_out` - name.com domain transfers out of the subscribing account via internal transfer. - `contact.verification.status_change` - contact verification status changes (verified or unverified). @@ -4576,6 +4577,7 @@ $client->transfers->cancelTransfer(
Cancels an outbound transfer for the given domain. Use this when the domain is being transferred out of name.com (losing registrar) to another (gaining) registrar and the registrant or reseller wants to cancel that transfer. +On success, subscribers receive `domain.transfer_out.status_change` with status `canceled`. The endpoint validates that the domain exists and belongs to the authenticated account. Only domains in a pending transfer (out) state can be canceled.
diff --git a/src/NamecomClient.php b/src/NamecomClient.php index d2be1a9..5740ff7 100644 --- a/src/NamecomClient.php +++ b/src/NamecomClient.php @@ -145,8 +145,8 @@ public function __construct( $defaultHeaders = [ 'X-Fern-Language' => 'PHP', 'X-Fern-SDK-Name' => 'Namecom', - 'X-Fern-SDK-Version' => '1.31.0', - 'User-Agent' => 'namecom/core-api/1.31.0', + 'X-Fern-SDK-Version' => '1.32.0', + 'User-Agent' => 'namecom/core-api/1.32.0', ]; $defaultHeaders['Authorization'] = "Basic " . base64_encode($username . ":" . $password); diff --git a/src/Transfers/TransfersClient.php b/src/Transfers/TransfersClient.php index e196483..2768dcc 100644 --- a/src/Transfers/TransfersClient.php +++ b/src/Transfers/TransfersClient.php @@ -278,6 +278,7 @@ public function cancelTransfer(string $domainName, ?array $options = null): ?Tra /** * Cancels an outbound transfer for the given domain. Use this when the domain is being transferred out of name.com (losing registrar) to another (gaining) registrar and the registrant or reseller wants to cancel that transfer. + * On success, subscribers receive `domain.transfer_out.status_change` with status `canceled`. * The endpoint validates that the domain exists and belongs to the authenticated account. Only domains in a pending transfer (out) state can be canceled. * * @param string $domainName DomainName is the domain whose transfer out should be canceled. diff --git a/src/Types/AccountDomainRemoval.php b/src/Types/AccountDomainRemoval.php new file mode 100644 index 0000000..cd5e3b3 --- /dev/null +++ b/src/Types/AccountDomainRemoval.php @@ -0,0 +1,63 @@ + $eventName The name of the subscription event + */ + #[JsonProperty('eventName')] + public string $eventName; + + /** + * @var string $domainName The name of the domain that was removed + */ + #[JsonProperty('domainName')] + public string $domainName; + + /** + * @var value-of $reason Why the domain left inventory: `expiration` (registry delete / post-expiry inventory loss), `agp_refund` (AGP refund delete), or `administrative` (ops/support removal). + */ + #[JsonProperty('reason')] + public string $reason; + + /** + * @var DateTime $expireDate The date and time when the domain expired + */ + #[JsonProperty('expireDate'), Date(Date::TYPE_DATETIME)] + public DateTime $expireDate; + + /** + * @param array{ + * eventName: value-of, + * domainName: string, + * reason: value-of, + * expireDate: DateTime, + * } $values + */ + public function __construct( + array $values, + ) { + $this->eventName = $values['eventName']; + $this->domainName = $values['domainName']; + $this->reason = $values['reason']; + $this->expireDate = $values['expireDate']; + } + + /** + * @return string + */ + public function __toString(): string + { + return $this->toJson(); + } +} diff --git a/src/Types/AccountDomainRemovalEventName.php b/src/Types/AccountDomainRemovalEventName.php new file mode 100644 index 0000000..1420268 --- /dev/null +++ b/src/Types/AccountDomainRemovalEventName.php @@ -0,0 +1,8 @@ + $status The status of the transfer out event. May be "initiated" (transfer out was started), "completed" (domain has been removed from the account), or "canceled" (transfer out was canceled before completion). + * @var value-of $status `initiated` (pending out started), `completed` (domain removed), or `canceled` (no longer pending at the registry). */ #[JsonProperty('status')] public string $status; diff --git a/src/WebhookNotifications/WebhookNotificationsClient.php b/src/WebhookNotifications/WebhookNotificationsClient.php index 1f59055..cf5a286 100644 --- a/src/WebhookNotifications/WebhookNotificationsClient.php +++ b/src/WebhookNotifications/WebhookNotificationsClient.php @@ -104,9 +104,10 @@ public function getSubscribedNotifications(?array $options = null): ?ListSubscri * Creates a webhook subscription to receive real-time notifications about specific domain or account events (e.g. transfer completions, renewals). Pass the callback URL and event types. This allows external systems to stay in sync with name.com changes. * Supported webhook event names: * - `account.credit.balance_change` – account credit balance changes (increases or decreases). + * - `account.domain.removal` – domain removed from the subscribing account. * - `domain.lock.status_change` – domain lock added or removed. * - `domain.transfer.status_change` – domain transfer IN to name.com; status updates while name.com is the gaining registrar. - * - `domain.transfer_out.status_change` – domain transfer OUT from name.com to another registrar; fires when the domain is removed from the account. + * - `domain.transfer_out.status_change` – domain transfer OUT from name.com; `initiated`, `completed` (domain removed), or `canceled` (no longer pending at the registry). * - `domain.transfer.internal_in` - name.com domain transfers in to the subscribing account via internal transfer. * - `domain.transfer.internal_out` - name.com domain transfers out of the subscribing account via internal transfer. * - `contact.verification.status_change` - contact verification status changes (verified or unverified).