*/ public function defaults() { return array( 'schema' => 6, 'runtime_active' => true, 'connection' => array( 'status' => 'disconnected', 'binding_id' => '', 'installation_id' => '', 'project_id' => '', 'widget_pk' => '', 'site_origin' => '', 'site_key' => '', 'security_level' => '', 'completed_at' => '', 'management' => array( 'protocol' => '', 'token_type' => '', 'token' => '', 'heartbeat_path' => '', 'disconnect_path' => '', 'diagnostics_path' => '', 'heartbeat_interval_seconds' => 0, 'stale_after_days' => 0, ), ), 'lifecycle' => array( 'credential_status' => 'unknown', 'project_status' => 'unknown', 'index_status' => 'unknown', 'remote_last_seen_at' => '', 'remote_stale_at' => '', 'last_status_check_at' => 0, 'next_status_check_at' => 0, 'status_failures' => 0, 'last_heartbeat_at' => 0, 'next_heartbeat_at' => 0, 'heartbeat_failures' => 0, 'heartbeat_write_after_sec' => 0, ), 'placement' => array( 'enabled' => false, 'mode' => 'bubble', 'attach_selector' => '', 'selector_tested_at' => 0, 'selector_test_origin' => '', 'selector_test_site_key' => '', 'selector_test_hash' => '', 'selector_test_ok' => false, 'fallback_warning' => '', 'fallback_observed_at' => 0, 'fallback_observed_code' => '', ), 'release' => array( 'status' => 'missing', 'error_code' => '', 'control_sequence' => 0, 'control_hash' => '', 'control_generated_at' => '', 'control_expires_at' => '', 'manifest' => null, 'verified_at' => 0, 'next_refresh_at' => 0, 'refresh_failures' => 0, ), 'management_diagnostics' => array( 'attach_target_missing' => false, 'release_unavailable' => false, 'current_code' => '', 'observed_code' => '', 'error_first_seen_at' => '', 'error_last_seen_at' => '', 'next_send_at' => 0, 'send_failures' => 0, ), ); } /** @return array */ public function get() { $stored = get_option( self::OPTION_NAME, array() ); return $this->merge_recursive( $this->defaults(), is_array( $stored ) ? $stored : array() ); } /** * @param array $settings Settings. * @return bool */ public function save( $settings ) { $settings = $this->merge_recursive( $this->defaults(), $settings ); if ( false === get_option( self::OPTION_NAME, false ) ) { return add_option( self::OPTION_NAME, $settings, '', 'no' ); } return update_option( self::OPTION_NAME, $settings, false ); } /** * @param array $attempt Attempt state. * @param int $ttl TTL in seconds. * @return bool */ public function save_attempt( $attempt, $ttl = Protocol::ATTEMPT_TTL ) { return set_transient( self::ATTEMPT_TRANSIENT, $attempt, $ttl ); } /** @return array|null */ public function get_attempt() { $value = get_transient( self::ATTEMPT_TRANSIENT ); return is_array( $value ) ? $value : null; } public function delete_attempt() { delete_transient( self::ATTEMPT_TRANSIENT ); } /** * @param array $binding Validated binding fields. */ public function store_binding( $binding ) { $settings = $this->get(); $settings['connection'] = array( 'status' => 'verified', 'binding_id' => $binding['binding_id'], 'installation_id' => $binding['installation_id'], 'project_id' => $binding['project_id'], 'widget_pk' => $binding['widget_pk'], 'site_origin' => $binding['site_origin'], 'site_key' => $binding['site_key'], 'security_level' => $binding['security_level'], 'completed_at' => $binding['completed_at'], 'management' => $binding['management'], ); $settings['lifecycle'] = $this->defaults()['lifecycle']; $settings['release'] = $this->defaults()['release']; $settings['management_diagnostics'] = $this->defaults()['management_diagnostics']; $settings['runtime_active'] = true; $this->save( $settings ); } /** * Persist the backend-authoritative project and installation state. * * @param array $status Validated management status. * @param bool $heartbeat Whether a POST heartbeat produced it. * @param int|null $now Current Unix timestamp. */ public function apply_management_status( $status, $heartbeat = false, $now = null ) { $now = null === $now ? time() : (int) $now; $settings = $this->get(); $settings['lifecycle']['credential_status'] = $status['credential_status']; $settings['lifecycle']['project_status'] = $status['project']['status']; $settings['lifecycle']['index_status'] = $status['project']['index_status']; $settings['lifecycle']['remote_last_seen_at'] = $status['last_seen_at']; $settings['lifecycle']['remote_stale_at'] = $status['stale_at']; $settings['lifecycle']['last_status_check_at'] = $now; $settings['lifecycle']['next_status_check_at'] = $now + 300; $settings['lifecycle']['status_failures'] = 0; if ( $heartbeat ) { $settings['lifecycle']['last_heartbeat_at'] = $now; $settings['lifecycle']['next_heartbeat_at'] = $now + (int) $status['heartbeat_interval_seconds']; $settings['lifecycle']['heartbeat_failures'] = 0; $settings['lifecycle']['heartbeat_write_after_sec'] = (int) $status['write_after_seconds']; } $this->save( $settings ); } /** Remove the usable credential and release immediately after backend revocation. */ public function revoke_management( $reason = 'management_revoked' ) { $settings = $this->get(); $defaults = $this->defaults(); $settings['connection']['status'] = 'revoked'; $settings['connection']['widget_pk'] = ''; $settings['connection']['management'] = $defaults['connection']['management']; $settings['lifecycle']['credential_status'] = 'revoked'; $settings['release'] = $defaults['release']; $settings['management_diagnostics'] = $defaults['management_diagnostics']; $settings['release']['status'] = 'blocked'; $settings['release']['error_code'] = $reason; $this->save( $settings ); } /** @return bool */ public function has_management_binding( $settings = null ) { $settings = is_array( $settings ) ? $settings : $this->get(); $connection = isset( $settings['connection'] ) && is_array( $settings['connection'] ) ? $settings['connection'] : array(); $management = isset( $connection['management'] ) && is_array( $connection['management'] ) ? $connection['management'] : array(); return 'verified' === ( isset( $connection['status'] ) ? $connection['status'] : '' ) && isset( $connection['project_id'], $connection['binding_id'], $connection['installation_id'], $connection['widget_pk'] ) && Protocol::is_identifier( $connection['project_id'] ) && Protocol::is_identifier( $connection['binding_id'] ) && Protocol::is_identifier( $connection['installation_id'] ) && is_string( $connection['widget_pk'] ) && 1 === preg_match( '/^pk_[A-Za-z0-9_-]{3,252}$/', $connection['widget_pk'] ) && 'aip-management-v1' === ( isset( $management['protocol'] ) ? $management['protocol'] : '' ) && 'Bearer' === ( isset( $management['token_type'] ) ? $management['token_type'] : '' ) && isset( $management['token'] ) && is_string( $management['token'] ) && 1 === preg_match( '/^aipm_[A-Za-z0-9_-]{43}$/', $management['token'] ) && '/api/plugin/heartbeat' === ( isset( $management['heartbeat_path'] ) ? $management['heartbeat_path'] : '' ) && '/api/plugin/disconnect' === ( isset( $management['disconnect_path'] ) ? $management['disconnect_path'] : '' ) && '/api/plugin/diagnostics' === ( isset( $management['diagnostics_path'] ) ? $management['diagnostics_path'] : '' ) && 3600 === ( isset( $management['heartbeat_interval_seconds'] ) ? (int) $management['heartbeat_interval_seconds'] : 0 ) && 30 === ( isset( $management['stale_after_days'] ) ? (int) $management['stale_after_days'] : 0 ); } /** @return bool */ public function management_ready( $settings = null ) { $settings = is_array( $settings ) ? $settings : $this->get(); return $this->has_management_binding( $settings ) && 'active' === $settings['lifecycle']['credential_status'] && 'active' === $settings['lifecycle']['project_status'] && 'ready' === $settings['lifecycle']['index_status']; } /** * Reconcile the stored binding against the current WordPress origin. * * @return string Resulting connection status. */ public function reconcile_origin() { $settings = $this->get(); $status = $settings['connection']['status']; if ( empty( $settings['connection']['binding_id'] ) ) { return $status; } $current = Protocol::canonical_site( home_url( '/' ) ); if ( ! $current || empty( $settings['connection']['site_key'] ) || ! Crypto::safe_equal( $settings['connection']['site_key'], $current['site_key'] ) ) { $settings['connection']['status'] = 'needs_reverification'; $this->save( $settings ); return 'needs_reverification'; } if ( 'needs_reverification' === $status ) { return $status; } if ( ! Crypto::safe_equal( $settings['connection']['site_origin'], $current['site_origin'] ) || $settings['connection']['security_level'] !== $current['security_level'] ) { $settings['connection']['site_origin'] = $current['site_origin']; $settings['connection']['security_level'] = $current['security_level']; $this->save( $settings ); } return $status; } /** @return bool */ public function rendering_allowed() { $settings = $this->get(); if ( empty( $settings['runtime_active'] ) || empty( $settings['placement']['enabled'] ) || ! $this->management_ready( $settings ) || 'verified' !== $this->reconcile_origin() || 'active' !== $settings['lifecycle']['credential_status'] || 'active' !== $settings['lifecycle']['project_status'] || 'ready' !== $settings['lifecycle']['index_status'] ) { return false; } return ! empty( $settings['connection']['widget_pk'] ) && ! empty( $settings['connection']['project_id'] ); } /** * Check frontend eligibility from local state without changing connection metadata. * * @param array|null $settings Settings previously read from Storage. * @return bool */ public function frontend_rendering_allowed( $settings = null ) { $settings = is_array( $settings ) ? $settings : $this->get(); if ( empty( $settings['runtime_active'] ) || empty( $settings['placement']['enabled'] ) || ! $this->management_ready( $settings ) || 'verified' !== $settings['connection']['status'] || empty( $settings['connection']['widget_pk'] ) || empty( $settings['connection']['project_id'] ) ) { return false; } $current = Protocol::canonical_site( home_url( '/' ) ); return $current && ! empty( $settings['connection']['site_key'] ) && Crypto::safe_equal( $settings['connection']['site_key'], $current['site_key'] ); } /** @return bool */ public function migrate_legacy() { $legacy = get_option( self::LEGACY_OPTION, null ); if ( ! is_array( $legacy ) ) { return false; } $settings = $this->get(); if ( ! empty( $legacy['api_key'] ) && empty( $settings['connection']['binding_id'] ) ) { $settings['connection']['status'] = 'legacy_reconnect_required'; $this->save( $settings ); } delete_option( self::LEGACY_OPTION ); return true; } /** * @param array $defaults Defaults. * @param array $stored Stored values. * @return array */ private function merge_recursive( $defaults, $stored ) { foreach ( $stored as $key => $value ) { if ( isset( $defaults[ $key ] ) && is_array( $defaults[ $key ] ) && is_array( $value ) ) { $defaults[ $key ] = $this->merge_recursive( $defaults[ $key ], $value ); } elseif ( array_key_exists( $key, $defaults ) ) { $defaults[ $key ] = $value; } } return $defaults; } }