client = $client ?? new AivieClient(); $this->contactMapper = $contactMapper ?? new ContactMapper(); $this->subscriptionMapper = $subscriptionMapper ?? new SubscriptionMapper(); $this->resolver = $resolver ?? new TrackingContactResolver(); } public function syncSubscription(int $subscriptionId, bool $force = false): SyncResult { $subscription = $this->loadSubscription($subscriptionId); if (null === $subscription) { Logger::error('Subscription sync failed because the subscription could not be loaded.', [ 'subscription_id' => $subscriptionId, ]); return new SyncResult('error', "Subscription {$subscriptionId} not found."); } if (! $force && ! Options::isEnabled()) { Logger::debug('Subscription sync skipped because the plugin is disabled.', [ 'subscription_id' => $subscriptionId, ]); return new SyncResult('skipped', 'Aivie plugin is disabled.'); } if ('' === Options::getBaseUrl() || '' === Options::getBearerToken()) { Logger::error('Subscription sync failed because API settings are incomplete.', [ 'subscription_id' => $subscriptionId, 'has_base_url' => '' !== Options::getBaseUrl(), 'has_token' => '' !== Options::getBearerToken(), ]); return new SyncResult('error', 'Aivie API URL or token is not configured.'); } $eventId = $this->subscriptionMapper->buildEventId($subscription); Logger::info('Starting subscription sync.', [ 'subscription_id' => $subscriptionId, 'event_id' => $eventId, 'force' => $force, ]); if (! $force && method_exists($subscription, 'get_meta') && $eventId === $subscription->get_meta('_aivie_wc_last_subscription_sync_event_id')) { Logger::debug('Subscription already synced with the same event ID, skipping.', [ 'subscription_id' => $subscriptionId, 'event_id' => $eventId, ]); return new SyncResult('skipped', 'Already synced with this event ID.', eventId: $eventId); } $contactId = null; $order = $this->resolveContactOrder($subscription); if ($order instanceof \WC_Order) { try { $resolvedContactId = $this->resolver->read($order); $contactId = $resolvedContactId > 0 ? $resolvedContactId : null; $contactPayload = $this->contactMapper->map($order); if ($resolvedContactId > 0) { $contactResponse = $this->client->updateContact($resolvedContactId, $contactPayload); } else { $contactResponse = $this->client->createContact($contactPayload); } if (! $contactResponse->success && ! $contactResponse->isDuplicate()) { Logger::error('Contact sync failed; continuing with subscription sync.', [ 'subscription_id' => $subscriptionId, 'http_code' => $contactResponse->httpCode, 'message' => $contactResponse->getSafeMessage(), ]); } } catch (\InvalidArgumentException $invalidContact) { // Contract violations from the generated models must not fatal the hook. Logger::error('Contact payload violates the API contract; continuing with subscription sync.', [ 'subscription_id' => $subscriptionId, 'message' => $invalidContact->getMessage(), ]); } } try { $payload = $this->subscriptionMapper->map($subscription, $order, $eventId); } catch (\InvalidArgumentException $invalidSubscription) { Logger::error('Subscription payload violates the API contract.', [ 'subscription_id' => $subscriptionId, 'message' => $invalidSubscription->getMessage(), ]); return new SyncResult('error', 'Invalid subscription payload: ' . $invalidSubscription->getMessage(), eventId: $eventId); } $alreadyInAivie = method_exists($subscription, 'get_meta') && absint($subscription->get_meta('_aivie_wc_subscription_id')) > 0; if ($alreadyInAivie) { Logger::debug('Subscription already recorded in Aivie; updating through the by-reference PATCH endpoint.', [ 'subscription_id' => $subscriptionId, 'source' => $payload->getSource(), 'source_subscription_id' => $payload->getSourceSubscriptionId(), ]); $response = $this->client->updateSubscription( (string) $payload->getSource(), (string) $payload->getSourceSubscriptionId(), $payload ); if ($response->isNotFound()) { // Subscription was deleted on the Aivie side; unlink and re-create. Logger::debug('Aivie subscription no longer exists (deleted remotely); unlinking and creating as new subscription.', [ 'subscription_id' => $subscriptionId, ]); if (method_exists($subscription, 'delete_meta_data')) { $subscription->delete_meta_data('_aivie_wc_subscription_id'); } if (method_exists($subscription, 'save_meta_data')) { $subscription->save_meta_data(); } $response = $this->client->createSubscription($payload); } } else { $response = $this->client->createSubscription($payload); if ($response->isConflict()) { Logger::debug('Subscription already exists in Aivie; retrying through the by-reference PATCH endpoint.', [ 'subscription_id' => $subscriptionId, 'source' => $payload->getSource(), 'source_subscription_id' => $payload->getSourceSubscriptionId(), ]); $response = $this->client->updateSubscription( (string) $payload->getSource(), (string) $payload->getSourceSubscriptionId(), $payload ); } } $status = $this->resolveStatus($response); $this->saveSyncMeta($subscription, $status, $eventId, $response); if ('error' === $status) { Logger::error('Subscription sync failed.', [ 'subscription_id' => $subscriptionId, 'event_id' => $eventId, 'http_code' => $response->httpCode, 'message' => $response->getSafeMessage(), ]); } else { Logger::info('Subscription sync finished.', [ 'subscription_id' => $subscriptionId, 'event_id' => $eventId, 'status' => $status, 'http_code' => $response->httpCode, ]); } return new SyncResult( status: $status, message: $response->getSafeMessage() ?: $status, contactId: $contactId, eventId: $eventId, ); } private function loadSubscription(int $subscriptionId): ?object { if (! function_exists('wcs_get_subscription')) { return null; } $subscription = wcs_get_subscription($subscriptionId); return is_object($subscription) ? $subscription : null; } private function resolveContactOrder(object $subscription): ?\WC_Order { $parentOrder = $this->subscriptionMapper->resolveParentOrder($subscription); if ($parentOrder instanceof \WC_Order) { return $parentOrder; } if (method_exists($subscription, 'get_last_order')) { $lastOrder = $subscription->get_last_order(); if ($lastOrder instanceof \WC_Order) { return $lastOrder; } } return null; } private function resolveStatus(AivieResponse $response): string { if ($response->isDuplicate()) { return 'duplicate'; } if ($response->success) { return 'success'; } return 'error'; } private function saveSyncMeta(object $subscription, string $status, string $eventId, AivieResponse $response): void { if (! method_exists($subscription, 'update_meta_data')) { return; } $subscription->update_meta_data('_aivie_wc_last_subscription_sync_status', $status); $subscription->update_meta_data('_aivie_wc_last_subscription_sync_at', (new \DateTime('now', new \DateTimeZone('UTC')))->format(\DateTime::ATOM)); $subscription->update_meta_data('_aivie_wc_last_subscription_sync_event_id', $eventId); $subscription->update_meta_data('_aivie_wc_last_subscription_sync_response', $response->getSafeMessage(200)); $aivieSubscriptionId = absint($response->body['subscription']['id'] ?? 0); if ($aivieSubscriptionId > 0) { $subscription->update_meta_data('_aivie_wc_subscription_id', $aivieSubscriptionId); } if (method_exists($subscription, 'save_meta_data')) { $subscription->save_meta_data(); } } }