WP_Connector_Registry

48final class WP_Connector_Registry {49	/**50	 * The singleton instance of the registry.51	 *52	 * @since 7.0.053	 */54	private static ?WP_Connector_Registry $instance = null;55 56	/**57	 * Holds the registered connectors.58	 *59	 * Each connector is stored as an associative array with keys:60	 * name, description, type, authentication, and optionally plugin.61	 *62	 * @since 7.0.063	 * @var array<string, array>64	 * @phpstan-var array<string, Connector>65	 */66	private array $registered_connectors = array();67 68	/**69	 * Registers a new connector.70	 *71	 * Validates the provided arguments and stores the connector in the registry.72	 * For connectors with `api_key` authentication, a `setting_name` can be provided73	 * explicitly. If omitted, one is automatically generated using the pattern74	 * `connectors_{$type}_{$id}_api_key`, with hyphens in the type and ID normalized75	 * to underscores (e.g., connector type `spam_filtering` with ID `my_plugin` produces76	 * `connectors_spam_filtering_my_plugin_api_key`). This setting name is used for the77	 * Settings API registration and REST API exposure.78	 *79	 * Registering a connector with an ID that is already registered will trigger a80	 * `_doing_it_wrong()` notice and return `null`. To override an existing connector,81	 * call `unregister()` first.82	 *83	 * @since 7.0.084	 *85	 * @see WP_Connector_Registry::unregister()86	 *87	 * @param string $id   The unique connector identifier. Must match the pattern88	 *                     `/^[a-z0-9_-]+$/` (lowercase alphanumeric, hyphens, and underscores only).89	 * @param array  $args {90	 *     An associative array of arguments for the connector.91	 *92	 *     @type string $name           Required. The connector's display name.93	 *     @type string $description    Optional. The connector's description. Default empty string.94	 *     @type string $logo_url       Optional. URL to the connector's logo image.95	 *     @type string $type           Required. The connector type, e.g. 'ai_provider'.96	 *     @type array  $authentication {97	 *         Required. Authentication configuration.98	 *99	 *         @type string $method          Required. The authentication method: 'api_key' or 'none'.100	 *         @type string $credentials_url Optional. URL where users can obtain API credentials.101	 *         @type string $setting_name    Optional. The setting name for the API key.102	 *                                       When omitted, auto-generated as103	 *                                       `connectors_{$type}_{$id}_api_key`.104	 *                                       Must be a non-empty string when provided.105	 *         @type string $constant_name   Optional. PHP constant name for the API key106	 *                                       (e.g. 'ANTHROPIC_API_KEY'). Only checked when provided.107	 *         @type string $env_var_name    Optional. Environment variable name for the API key108	 *                                       (e.g. 'ANTHROPIC_API_KEY'). Only checked when provided.109	 *     }110	 *     @type array  $plugin         {111	 *         Optional. Plugin data for install/activate UI.112	 *113	 *         @type string   $file      Optional. The plugin's main file path relative to the114	 *                                   plugins directory (e.g. 'my-plugin/my-plugin.php' or115	 *                                   'hello.php').116	 *         @type callable $is_active Optional callback to determine whether the plugin117	 *                                   is active. Receives no arguments and must return bool.118	 *                                   Defaults to `__return_true`.119	 *     }120	 * }121	 * @return array|null The registered connector data on success, null on failure.122	 *123	 * @phpstan-param array{124	 *     name: non-empty-string,125	 *     description?: string,126	 *     logo_url?: non-empty-string,127	 *     type: non-empty-string,