# AbstractBulkAdvisoryParser

> Parses the npm registry's bulk advisories document, which the native manager fetches and bun audit prints.

[API reference](/docs/api/index.md) › [Foxy](/docs/extensions/foxy/reference/index.md) › [Audit](/docs/extensions/foxy/reference/audit/index.md) › [Parser](/docs/extensions/foxy/reference/audit/parser/index.md) › AbstractBulkAdvisoryParser

| abstract class | `Foxy\Audit\Parser\AbstractBulkAdvisoryParser` |
| --- | --- |
| Extends | [`AbstractAuditParser`](/docs/extensions/foxy/reference/audit/parser/abstractauditparser/index.md) |
| Implements | [`Foxy\Audit\AuditParserInterface`](/docs/extensions/foxy/reference/audit/auditparserinterface/index.md) |
| Source | [`src/Audit/Parser/AbstractBulkAdvisoryParser.php`](https://github.com/php-forge/foxy/blob/main/src/Audit/Parser/AbstractBulkAdvisoryParser.php#L19) |

2 subclasses:

- [`BunAuditParser`](/docs/extensions/foxy/reference/audit/parser/bunauditparser/index.md)
- [`NativeAuditParser`](/docs/extensions/foxy/reference/audit/parser/nativeauditparser/index.md)

Parses the npm registry's bulk advisories document, which the `native` manager fetches and `bun audit` prints.

The document maps each package name to its advisories; it does not say which locked version matched, so the
findings carry no affected versions and no dependency paths.

## Methods

| Method | Description | Defined by |
| --- | --- | --- |
| [`parse()`](#method-parse) | Parses a bulk advisories JSON object into normalized findings. | `AbstractBulkAdvisoryParser` |
| <span id="method-assertNotErrorDocument"></span>[`assertNotErrorDocument()`](/docs/extensions/foxy/reference/audit/parser/abstractauditparser/index.md#method-assertNotErrorDocument) protected final | Rejects a JSON document that represents a package manager error. | [`AbstractAuditParser`](/docs/extensions/foxy/reference/audit/parser/abstractauditparser/index.md) |
| <span id="method-assertOutputSize"></span>[`assertOutputSize()`](/docs/extensions/foxy/reference/audit/parser/abstractauditparser/index.md#method-assertOutputSize) protected final | Rejects audit output that exceeds the parser's size limit. | [`AbstractAuditParser`](/docs/extensions/foxy/reference/audit/parser/abstractauditparser/index.md) |
| <span id="method-decodeObject"></span>[`decodeObject()`](/docs/extensions/foxy/reference/audit/parser/abstractauditparser/index.md#method-decodeObject) protected final | Decodes an audit JSON object after validating its size and shape. | [`AbstractAuditParser`](/docs/extensions/foxy/reference/audit/parser/abstractauditparser/index.md) |
| <span id="method-getAdvisoryId"></span>[`getAdvisoryId()`](/docs/extensions/foxy/reference/audit/parser/abstractauditparser/index.md#method-getAdvisoryId) protected final | Selects a GHSA identifier from the candidate or URL, falling back to the source identifier. | [`AbstractAuditParser`](/docs/extensions/foxy/reference/audit/parser/abstractauditparser/index.md) |
| <span id="method-getBoolean"></span>[`getBoolean()`](/docs/extensions/foxy/reference/audit/parser/abstractauditparser/index.md#method-getBoolean) protected final | Returns a required boolean field. | [`AbstractAuditParser`](/docs/extensions/foxy/reference/audit/parser/abstractauditparser/index.md) |
| <span id="method-getCves"></span>[`getCves()`](/docs/extensions/foxy/reference/audit/parser/abstractauditparser/index.md#method-getCves) protected final | Returns validated, normalized CVE identifiers. | [`AbstractAuditParser`](/docs/extensions/foxy/reference/audit/parser/abstractauditparser/index.md) |
| <span id="method-getGhsaId"></span>[`getGhsaId()`](/docs/extensions/foxy/reference/audit/parser/abstractauditparser/index.md#method-getGhsaId) protected final | Extracts and normalizes a GHSA identifier from a value or URL. | [`AbstractAuditParser`](/docs/extensions/foxy/reference/audit/parser/abstractauditparser/index.md) |
| <span id="method-getManagerName"></span>[`getManagerName()`](/docs/extensions/foxy/reference/audit/parser/abstractauditparser/index.md#method-getManagerName) protected abstract | Returns the package manager name used in malformed-output errors. | [`AbstractAuditParser`](/docs/extensions/foxy/reference/audit/parser/abstractauditparser/index.md) |
| <span id="method-getNonNegativeInteger"></span>[`getNonNegativeInteger()`](/docs/extensions/foxy/reference/audit/parser/abstractauditparser/index.md#method-getNonNegativeInteger) protected final | Returns a required non-negative integer field. | [`AbstractAuditParser`](/docs/extensions/foxy/reference/audit/parser/abstractauditparser/index.md) |
| <span id="method-getObject"></span>[`getObject()`](/docs/extensions/foxy/reference/audit/parser/abstractauditparser/index.md#method-getObject) protected final | Converts a decoded JSON object into its property map. | [`AbstractAuditParser`](/docs/extensions/foxy/reference/audit/parser/abstractauditparser/index.md) |
| <span id="method-getOptionalString"></span>[`getOptionalString()`](/docs/extensions/foxy/reference/audit/parser/abstractauditparser/index.md#method-getOptionalString) protected final | Returns a sanitized optional string field, or `null` when absent or empty. | [`AbstractAuditParser`](/docs/extensions/foxy/reference/audit/parser/abstractauditparser/index.md) |
| <span id="method-getSeverity"></span>[`getSeverity()`](/docs/extensions/foxy/reference/audit/parser/abstractauditparser/index.md#method-getSeverity) protected final | Returns a supported normalized severity value. | [`AbstractAuditParser`](/docs/extensions/foxy/reference/audit/parser/abstractauditparser/index.md) |
| <span id="method-getSeverityCount"></span>[`getSeverityCount()`](/docs/extensions/foxy/reference/audit/parser/abstractauditparser/index.md#method-getSeverityCount) protected final | Returns the sum of severity counts and optionally validates the reported total. | [`AbstractAuditParser`](/docs/extensions/foxy/reference/audit/parser/abstractauditparser/index.md) |
| <span id="method-getSourceId"></span>[`getSourceId()`](/docs/extensions/foxy/reference/audit/parser/abstractauditparser/index.md#method-getSourceId) protected final | Returns a non-empty source identifier from a string or integer value. | [`AbstractAuditParser`](/docs/extensions/foxy/reference/audit/parser/abstractauditparser/index.md) |
| <span id="method-getString"></span>[`getString()`](/docs/extensions/foxy/reference/audit/parser/abstractauditparser/index.md#method-getString) protected final | Returns a required sanitized string field. | [`AbstractAuditParser`](/docs/extensions/foxy/reference/audit/parser/abstractauditparser/index.md) |
| <span id="method-getStringList"></span>[`getStringList()`](/docs/extensions/foxy/reference/audit/parser/abstractauditparser/index.md#method-getStringList) protected final | Returns a normalized list containing only strings. | [`AbstractAuditParser`](/docs/extensions/foxy/reference/audit/parser/abstractauditparser/index.md) |
| <span id="method-malformed"></span>[`malformed()`](/docs/extensions/foxy/reference/audit/parser/abstractauditparser/index.md#method-malformed) protected final | Creates a package-manager-specific malformed-output exception. | [`AbstractAuditParser`](/docs/extensions/foxy/reference/audit/parser/abstractauditparser/index.md) |
| <span id="method-sanitizeString"></span>[`sanitizeString()`](/docs/extensions/foxy/reference/audit/parser/abstractauditparser/index.md#method-sanitizeString) protected final | Replaces control characters and trims surrounding whitespace. | [`AbstractAuditParser`](/docs/extensions/foxy/reference/audit/parser/abstractauditparser/index.md) |
| <span id="method-uniqueStrings"></span>[`uniqueStrings()`](/docs/extensions/foxy/reference/audit/parser/abstractauditparser/index.md#method-uniqueStrings) protected final | Returns unique strings in deterministic order. | [`AbstractAuditParser`](/docs/extensions/foxy/reference/audit/parser/abstractauditparser/index.md) |

## Method details

### parse() <span id="method-parse"></span>

```php
public function parse(string $output): array
```

Parses a bulk advisories JSON object into normalized findings.

**Parameters**

| Parameter | Type | Description |
| --- | --- | --- |
| `$output` | `string` |  |

**Returns**

`array`