From fc7e1d9f3ebab8e1a0e3d84d46a0b0235d864adb Mon Sep 17 00:00:00 2001 From: p6rand <158173531+p6rand@users.noreply.github.com> Date: Tue, 17 Feb 2026 15:14:07 +0200 Subject: [PATCH 01/89] Update overview.md --- .../docs/API solutions/Threat Intelligence API/overview.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/src/content/docs/API solutions/Threat Intelligence API/overview.md b/src/content/docs/API solutions/Threat Intelligence API/overview.md index 3cc7628..eb78fc8 100644 --- a/src/content/docs/API solutions/Threat Intelligence API/overview.md +++ b/src/content/docs/API solutions/Threat Intelligence API/overview.md @@ -13,11 +13,12 @@ sidebar: --- ### Standard Threat Intelligence API -Fetch the latest vulnerability information for a single version of a particular plugin, theme or WordPress core. API is limited for 5000 calls / 24 hours. Price for that API is $249 / month. Access to this API can be purchased through the [Patchstack App](https://app.patchsatck.com/billing/subscription). +Fetch the latest vulnerability information for a single version of a particular plugin, theme or WordPress core. API is limited for 5000 calls / 24 hours. Access to this API can be purchased through the [Patchstack App](https://app.patchsatck.com/billing/subscription). [Standard Threat Intelligence API Documentation](/api-solutions/threat-intelligence-api/standard/) ### Extended Threat Intelligence API Access everything included in the Standard tier, bulk-request data for multiple plugins with one API call, and have additional endpoints with more information about vulnerabilities. Extended tier has custom pricing and is activated on request only. For access to these API endpoints, please [contact us here](https://patchstack.com/for-hosts/). -[Extended Threat Intelligence API Documentation](/api-solutions/threat-intelligence-api/extended/) \ No newline at end of file + +[Extended Threat Intelligence API Documentation](/api-solutions/threat-intelligence-api/extended/) From 932121e1d8874061be1db7fbe7ca59cab92bdba9 Mon Sep 17 00:00:00 2001 From: p6rand <158173531+p6rand@users.noreply.github.com> Date: Tue, 17 Feb 2026 15:14:35 +0200 Subject: [PATCH 02/89] Update index.mdx --- src/content/docs/API solutions/index.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/API solutions/index.mdx b/src/content/docs/API solutions/index.mdx index 5813b82..64b7598 100644 --- a/src/content/docs/API solutions/index.mdx +++ b/src/content/docs/API solutions/index.mdx @@ -29,7 +29,7 @@ This API has unlimited requests and can be used by all Developer plan users for Query our vulnerability database and retrieve information about all published vulnerabilities. Threat Intelligence API is available in two tiers: ### Standard tier -Fetch the latest vulnerability information for a single version of a particular plugin, theme or WordPress core. API is limited for 5000 calls / 24 hours. Price for that API is $249 / month. +Fetch the latest vulnerability information for a single version of a particular plugin, theme or WordPress core. API is limited for 5000 calls / 24 hours. Date: Fri, 6 Mar 2026 11:13:49 +0000 Subject: [PATCH 03/89] Add OWNERS.md for code ownership compliance (#18) Establishes code ownership documentation as part of our compliance requirements. Every repository must have a clearly defined owner responsible for security posture, maintenance decisions, and lifecycle management. Co-authored-by: Claude Opus 4.6 --- OWNERS.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) create mode 100644 OWNERS.md diff --git a/OWNERS.md b/OWNERS.md new file mode 100644 index 0000000..50e8bd1 --- /dev/null +++ b/OWNERS.md @@ -0,0 +1,13 @@ +# Code Ownership + +## Owner +- **Name:** Elliot Taylor +- **GitHub:** [@ejntaylor](https://github.com/ejntaylor) + +## Category +Marketing / Content + +## Responsibilities +- Security posture and patching +- Answering questions about purpose, lifecycle, and dependencies +- Deciding on continued maintenance or deprecation From 1d74529fbca615465ec4adb6ca7b6859bed9be80 Mon Sep 17 00:00:00 2001 From: Mario Tarosso Date: Tue, 21 Apr 2026 15:46:49 +0100 Subject: [PATCH 04/89] Remove country blocking entries from changelog (#20) Delete several changelog lines referencing the country blocking feature across multiple versions (including 2.3.3, 2.0.9, and 2.0.7/2.0.8 areas). This cleans up the plugin changelog to remove outdated or unwanted mentions of the country blocking functionality and related fixes. --- src/content/docs/Patchstack Plugin/plugin-changelog.md | 4 ---- 1 file changed, 4 deletions(-) diff --git a/src/content/docs/Patchstack Plugin/plugin-changelog.md b/src/content/docs/Patchstack Plugin/plugin-changelog.md index 2211b44..d87b4e4 100644 --- a/src/content/docs/Patchstack Plugin/plugin-changelog.md +++ b/src/content/docs/Patchstack Plugin/plugin-changelog.md @@ -38,7 +38,6 @@ sidebar:
  • Version 2.3.3
  • Removed: login hours restriction feature
  • -
  • Removed: country blocking feature
  • Fixed: undefined tippy error
  • @@ -278,7 +277,6 @@ sidebar:
  • Added: patchstack activate command to activate through WP CLI.
  • Fixed: Selectize library not loading.
  • Fixed: Fatal error due to wp-config.php salts not present on some environments.
  • -
  • Fixed: Execution order of country blocking feature.
  • Fixed: PHP version truncated in software sync.
  • @@ -525,7 +523,6 @@ sidebar:
    • Version 2.0.9
    • Fixed: The option to disable plugin/theme edit will no longer write to (or create) the wp-config.php file which could potentially cause fatal errors.
    • -
    • Fixed: Country blocking feature will no longer block Patchstack if USA is blocked as country.
    November 19th 2019 @@ -534,7 +531,6 @@ sidebar:
  • Version 2.0.8
  • Fixed: Fatal error in plugin update checker library.
  • Version 2.0.7
  • -
  • Added: Country blocking functionality. You can find this on the firewall settings page. It also has an option to inverse block, which means the selected countries will only be able to visit your site.
  • Fixed: Minor optimization to the firewall engine.
  • Fixed: Rare condition in whitelist rules handling that would throw an error.
  • Fixed: Error with PHP 7.3 in the plugin update checker library.
  • From 20536327ada98a740fd4760390ad6c77a950f441 Mon Sep 17 00:00:00 2001 From: Mario Tarosso Date: Wed, 22 Apr 2026 08:27:39 +0100 Subject: [PATCH 05/89] Add Beta Threat Intelligence API docs (#21) * Add Beta Threat Intelligence API docs Add a new beta API documentation page (src/content/docs/API solutions/Threat Intelligence API/beta.md) describing the Beta tier endpoints. The new doc covers npm ecosystem support, resource-based nested response shapes, optional advisory body (?include=details), offset and cursor pagination, endpoints (/all, /latest, /product, /batch), examples (curl/Node/PHP), error handling, and migration notes from v2. Also update overview.md to advertise and link to the new Beta Threat Intelligence API docs. * url update --- .../Threat Intelligence API/beta.md | 439 ++++++++++++++++++ .../Threat Intelligence API/overview.md | 5 + 2 files changed, 444 insertions(+) create mode 100644 src/content/docs/API solutions/Threat Intelligence API/beta.md diff --git a/src/content/docs/API solutions/Threat Intelligence API/beta.md b/src/content/docs/API solutions/Threat Intelligence API/beta.md new file mode 100644 index 0000000..e34d3b6 --- /dev/null +++ b/src/content/docs/API solutions/Threat Intelligence API/beta.md @@ -0,0 +1,439 @@ +--- +title: "Beta tier API" +excerpt: "Beta vulnerability endpoints — npm support, Resource-based shape, offset and cursor pagination, include=details." +hidden: false +metadata: + image: [] + robots: "index" +createdAt: "Tue Apr 21 2026 00:00:00 GMT+0000 (Coordinated Universal Time)" +updatedAt: "Tue Apr 21 2026 00:00:00 GMT+0000 (Coordinated Universal Time)" +sidebar: + order: 4 + label: "Beta tier API" +--- + +_The Beta endpoints live alongside the v2 API and add npm coverage, an optional full advisory body, a consistent nested response shape, and cursor pagination. They are the recommended endpoints for new integrations; v2 remains available for backwards compatibility._ + +## API Usage + +### Base URL + +``` +https://vdp-api.patchstack.com/database/api/beta/ +``` + +### Authentication + +Every request must include your API key in the **`PSKey`** HTTP request header. You can request an API key by reaching out on . + +``` +PSKey: +``` + +### Response format + +All responses are JSON. Beta responses are cached until the database updates, at which point the cache is cleared. A single response shape is shared across all three list endpoints (`/all`, `/latest`, `/product/npm/...`) so clients can parse them interchangeably. + +### Platforms + +Pass `?platform=npm` (or `?platform=wordpress` — the default) on list endpoints. Platform names are case-insensitive. + +### Rate limiting + +Same policy as the Extended Threat Intelligence API — please contact if you need an elevated quota. + +--- + +## Endpoints + +| Method | Endpoint | Purpose | +|---|---|---| +| `GET` | `/database/api/beta/all` | Paginated listing of every published vulnerability for a platform | +| `GET` | `/database/api/beta/latest` | Vulnerabilities added in the last 24 hours | +| `GET` | `/database/api/beta/product/{type}/{name}/{version}` | Match a single product/version (npm & WordPress family) | +| `GET` | `/database/api/beta/product/{type}/{name}/{version}/exists` | Boolean-only variant of the above | +| `POST` | `/database/api/beta/batch` | Check up to 50 products in a single request | + +--- + +## List all vulnerabilities + +**Description:** Paginated listing of every published vulnerability for the given platform, ordered by descending `id`. +**Endpoint:** `/database/api/beta/all` +**Method:** `GET` + +### Query parameters + +| Name | Type | Default | Description | +|---|---|---|---| +| `platform` | string | `wordpress` | `npm` or `wordpress`. Case-insensitive. | +| `page` | integer | `1` | Offset-pagination page (1-indexed). | +| `per_page` | integer | `100` | Page size, max `500`. | +| `cursor` | string | — | Opaque cursor (see below). Presence of the param switches to cursor mode. | +| `include` | string | — | Pass `details` to include the full advisory body in each item. | + +### Pagination modes + +`/all` supports **two independent pagination strategies**. Use whichever fits your client: + +- **Offset (`?page=&per_page=`)** — returns a `pagination` block with totals, `has_next_page`, `has_previous_page`, etc. Easy to jump to a specific page; slower at depth and susceptible to row-shift when new vulnerabilities land while you're paging. +- **Cursor (`?cursor=`)** — returns a `cursor` block with `next_cursor`, `has_more`, `per_page`. Stable under concurrent inserts and faster at any depth. No `total` count (deliberately skipped to keep cursor mode fast). + +`cursor` and `page` are mutually exclusive; passing both returns `422 Unprocessable Entity`. + +### Example — offset mode + +```bash +curl 'https://patchstack.com/database/api/beta/all?platform=npm&page=1&per_page=25' \ + -H 'PSKey: ' +``` + +Response: + +```json +{ + "vulnerabilities": [ /* 25 items */ ], + "pagination": { + "current_page": 1, + "per_page": 25, + "total": 6115, + "total_pages": 245, + "has_next_page": true, + "has_previous_page": false, + "next_page": 2, + "previous_page": null, + "from": 1, + "to": 25 + } +} +``` + +### Example — cursor mode + +First page — send `cursor=` with an empty value to bootstrap: + +```bash +curl 'https://patchstack.com/database/api/beta/all?platform=npm&per_page=25&cursor=' \ + -H 'PSKey: ' +``` + +Response: + +```json +{ + "vulnerabilities": [ /* 25 items */ ], + "cursor": { + "next_cursor": "djE6NDYzMzk", + "has_more": true, + "per_page": 25 + } +} +``` + +Follow `next_cursor` on the next request: + +```bash +curl 'https://patchstack.com/database/api/beta/all?platform=npm&per_page=25&cursor=djE6NDYzMzk' \ + -H 'PSKey: ' +``` + +Stop when `has_more: false` and `next_cursor: null`. + +### Example — with full advisory body + +```bash +curl 'https://patchstack.com/database/api/beta/all?platform=npm&per_page=25&include=details' \ + -H 'PSKey: ' +``` + +Adds an `advisory_details` field (markdown) to every item. + +--- + +## Latest (last 24 hours) + +**Description:** Returns vulnerabilities whose row was inserted into the Patchstack database in the last 24 hours. The filter is on `created_at` (insertion time), **not** `disclosure_date`. +**Endpoint:** `/database/api/beta/latest` +**Method:** `GET` + +Accepts the **same query parameters** as `/all` — `platform`, `page`, `per_page`, `cursor`, `include`. + +```bash +curl 'https://patchstack.com/database/api/beta/latest?platform=npm&per_page=50' \ + -H 'PSKey: ' +``` + +Cursor pagination works identically: + +```bash +curl 'https://patchstack.com/database/api/beta/latest?platform=npm&per_page=50&cursor=' \ + -H 'PSKey: ' +``` + +--- + +## Find vulnerability for a product + +**Description:** Match a specific product + version against the vulnerability database and return every applicable advisory. +**Endpoint:** `/database/api/beta/product/{type}/{name}/{version}/{exists?}` +**Method:** `GET` + +| Path param | Description | +|---|---| +| `type` | `npm`, `plugin`, `theme`, or `wordpress`. | +| `name` | npm package slug or WordPress plugin/theme slug. Use `wordpress` when `type=wordpress`. | +| `version` | Concrete version (e.g. `0.21.4`) or `*` to return every advisory for the product. | +| `exists` | Optional. Pass the literal string `exists` to get a boolean response only. | + +### Query parameters + +| Name | Type | Description | +|---|---|---| +| `include` | string | Pass `details` to include the full advisory body (`advisory_details`) per item. Applies only to npm. | + +### Example — npm, concrete version + +```bash +curl 'https://patchstack.com/database/api/beta/product/npm/axios/0.21.4?include=details' \ + -H 'PSKey: ' +``` + +### Example — npm, wildcard version (all advisories for the package) + +```bash +curl 'https://patchstack.com/database/api/beta/product/npm/axios/*' \ + -H 'PSKey: ' +``` + +### Example — boolean exists check + +```bash +curl 'https://patchstack.com/database/api/beta/product/npm/axios/0.21.4/exists' \ + -H 'PSKey: ' +``` + +Response: + +```json +{ "vulnerable": true } +``` + +### Note on scoped npm packages + +npm package slugs that include a `/` (e.g. `@scope/pkg`) conflict with the route separator. URL-encode the `/` as `%2F` or contact us for guidance on the encoding helper. + +--- + +## Bulk product check + +**Description:** Check up to 50 products in a single request. Mirrors the format documented for the Extended tier's `/batch` endpoint. +**Endpoint:** `/database/api/beta/batch` +**Method:** `POST` +**Payload:** Raw JSON array, ≤ 50 objects. + +```bash +curl -X POST 'https://patchstack.com/database/api/beta/batch' \ + -H 'PSKey: ' \ + -H 'Content-Type: application/json' \ + -d '[ + { "type": "npm", "name": "axios", "version": "0.21.4", "exists": false }, + { "type": "plugin", "name": "tutor", "version": "1.5.2", "exists": true }, + { "type": "wordpress","name":"wordpress","version": "6.0.0", "exists": true } + ]' +``` + +--- + +## Response shape (npm) + +The three list endpoints (`/all`, `/latest`, `/product/npm/...`) share the same per-item shape when `platform=npm`. `advisory_details` is only present when `?include=details` was passed. + +```json +{ + "id": 46500, + "title": "NPM: OpenClaw: ...", + "disclosed_at": "2026-04-03T03:15:56+00:00", + "created_at": "2026-04-21T08:38:34+00:00", + "url": "https://patchstack.com/database/npm/npm/openclaw/vulnerability/...", + "vuln_type": "Other Vulnerability Type", + "cve": "2026-41331", + "is_exploited": false, + "patch_priority": 2, + "advisory_details": "## Summary\n...", + "product": { + "id": 23595, + "name": "openclaw", + "slug": "openclaw" + }, + "cvss": { + "score": 6.9, + "vector": "CVSS:4.0/AV:N/AC:L/AT:N/PR:N/UI:N/VC:N/VI:N/VA:L/SC:N/SI:N/SA:N" + }, + "cwe": { + "id": 770, + "name": "Allocation of Resources Without Limits or Throttling" + }, + "capec": { + "id": null, + "name": null + }, + "references": [ + "https://github.com/openclaw/openclaw/security/advisories/GHSA-m6fx-m8hc-572m", + "https://github.com/openclaw/openclaw/releases/tag/v2026.3.31" + ], + "ghsa": "GHSA-m6fx-m8hc-572m", + "version_info": { + "affected": "<= 2026.3.28", + "fixed": "2026.3.31", + "patched_ranges": [] + } +} +``` + +### Field reference + +| Field | Type | Description | +|---|---|---| +| `id` | integer | Stable Patchstack vulnerability id. | +| `title` | string | Human-readable title (prefixed with `NPM:` for npm advisories). | +| `disclosed_at` | ISO-8601 | When the vulnerability was publicly disclosed. | +| `created_at` | ISO-8601 | When the row was inserted into the Patchstack DB. Drives `/latest` windowing. | +| `url` | string | Public Patchstack vulnerability page (token-tagged). | +| `vuln_type` | string | High-level vulnerability category. | +| `cve` | string | First CVE identifier, or `""` when none is assigned. | +| `is_exploited` | boolean | Whether exploitation has been observed in the wild. | +| `patch_priority` | integer | 1 (low) to 3 (high). | +| `advisory_details` | string \| absent | Full advisory body. Only present with `?include=details`. | +| `product.{id,name,slug}` | object | The affected package/product. | +| `cvss.{score,vector}` | object | CVSS score and vector (may be `null`). | +| `cwe.{id,name}` | object | CWE classification (may be `null`). | +| `capec.{id,name}` | object | CAPEC classification (may be `null`). | +| `references` | string[] | External reference URLs (advisories, commits, tags). | +| `ghsa` | string | GHSA identifier when the advisory came from the GitHub Advisory Database. | +| `version_info.affected` | string | Affected version range (e.g. `<= 2026.3.28`). | +| `version_info.fixed` | string | First fixed version. | +| `version_info.patched_ranges` | array | Structured list of `{from_version, to_version, fixed_in}` entries for advisories with multiple patch ranges. | + +--- + +## Testing + +### curl — one-liners + +```bash +# Latest 24h, npm +curl 'https://patchstack.com/database/api/beta/latest?platform=npm&per_page=10' \ + -H 'PSKey: ' + +# Cursor pagination walk (bootstrap + follow) +curl 'https://patchstack.com/database/api/beta/all?platform=npm&per_page=50&cursor=' \ + -H 'PSKey: ' + +# Check a specific npm package/version with full advisory text +curl 'https://patchstack.com/database/api/beta/product/npm/axios/0.21.4?include=details' \ + -H 'PSKey: ' + +# Boolean-only exists check +curl 'https://patchstack.com/database/api/beta/product/npm/axios/0.21.4/exists' \ + -H 'PSKey: ' +``` + +### Postman + +1. Create a new request, set the method, paste the URL. +2. Under **Headers**, add: + - Key: `PSKey` + - Value: your API key +3. Under **Headers**, add (recommended): + - Key: `Accept` + - Value: `application/json` +4. For `POST /batch`, set the body to **raw → JSON** and paste the array payload. + +### Cursor iteration (JavaScript / Node) + +```javascript +async function* allVulnerabilities(apiKey, platform = 'npm', perPage = 100) { + const base = 'https://patchstack.com/database/api/beta/all'; + let cursor = ''; // empty = bootstrap cursor mode + + while (true) { + const url = `${base}?platform=${platform}&per_page=${perPage}&cursor=${encodeURIComponent(cursor)}`; + const res = await fetch(url, { headers: { PSKey: apiKey } }).then(r => r.json()); + + for (const vuln of res.vulnerabilities) { + yield vuln; + } + + if (!res.cursor.has_more) return; + cursor = res.cursor.next_cursor; + } +} + +// usage +for await (const vuln of allVulnerabilities(process.env.PATCHSTACK_KEY)) { + console.log(vuln.id, vuln.title); +} +``` + +### Cursor iteration (PHP) + +```php + true, + CURLOPT_HTTPHEADER => ['PSKey: '.$apiKey, 'Accept: application/json'], + ]); + $response = json_decode(curl_exec($ch), true); + curl_close($ch); + + foreach ($response['vulnerabilities'] as $vuln) { + // handle $vuln + } + + $cursor = $response['cursor']['next_cursor'] ?? null; +} while ($response['cursor']['has_more'] ?? false); +``` + +--- + +## Errors + +| Status | Meaning | +|---|---| +| `401 Unauthorized` | Missing or invalid `PSKey` header. | +| `403 Forbidden` | API key not authorised for the requested endpoint. | +| `422 Unprocessable Entity` | Invalid parameter combination (e.g. `cursor` + `page`), invalid `platform`, or `per_page > 500`. | +| `429 Too Many Requests` | Rate limit exceeded. | +| `500` | Server error — please include the request id in any bug report. | + +When a cursor is malformed (invalid base64 or missing the `v1:` prefix), the endpoint returns `200` with an empty page: + +```json +{ + "vulnerabilities": [], + "cursor": { "next_cursor": null, "has_more": false, "per_page": 100 } +} +``` + +--- + +## Migration notes (v2 → beta) + +- Beta npm responses use **nested objects** (`product`, `cvss`, `cwe`, `capec`, `version_info`) whereas the v2 shape is flat. Update parsers accordingly. +- `ghsa_id` was renamed to `ghsa` at the top level. +- `direct_url` was renamed to `url` (the npm-flavoured shape exposes a single URL only). +- The `description` field was dropped for npm (the title already includes it). +- The response body always contains a `vulnerabilities` array, plus either `pagination` (offset mode) or `cursor` (cursor mode). + +## More information + +You can find more information about the Patchstack Threat Intelligence API on . If you have integration questions, email . diff --git a/src/content/docs/API solutions/Threat Intelligence API/overview.md b/src/content/docs/API solutions/Threat Intelligence API/overview.md index eb78fc8..f3ffd06 100644 --- a/src/content/docs/API solutions/Threat Intelligence API/overview.md +++ b/src/content/docs/API solutions/Threat Intelligence API/overview.md @@ -22,3 +22,8 @@ Access everything included in the Standard tier, bulk-request data for multiple [Extended Threat Intelligence API Documentation](/api-solutions/threat-intelligence-api/extended/) + +### Beta Threat Intelligence API +Adds npm ecosystem coverage, an opt-in full advisory body (`?include=details`), a consistent nested response shape, and cursor-based pagination alongside the existing offset pagination. These are the recommended endpoints for new integrations. + +[Beta Threat Intelligence API Documentation](/api-solutions/threat-intelligence-api/beta/) From cb280efafe1a63fcfcddd25b3c7789841449bbf1 Mon Sep 17 00:00:00 2001 From: Elliot Date: Thu, 23 Apr 2026 07:16:20 +0100 Subject: [PATCH 06/89] Threat Intelligence Beta: OpenAPI spec, interactive reference, Postman (#22) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Slim Beta tier page to narrative; endpoint detail lives in OpenAPI reference Removes the per-endpoint tables, request bodies, field reference, and response shapes from beta.md now that they're generated from the OpenAPI spec. Keeps the narrative that belongs on a prose page: auth, platforms, pagination strategy, error codes, testing recipes, and v2 migration notes. Co-Authored-By: Claude Opus 4.7 (1M context) * Flesh out OpenAPI info, tag, and operation descriptions Tag landing pages (e.g. /operations/tags/vulnerabilities/) and the overview were rendering only the one-line blurb for each tag. Expand the info, tags[].description, and the thinner operation descriptions so each generated page has usable content: auth, platforms, pagination strategies, errors, related pages, and per-tag endpoint guides with deep links. Co-Authored-By: Claude Opus 4.7 (1M context) * Wire starlight-openapi plugin and register API reference sidebar group Pins starlight-openapi ^0.22.1 (latest version compatible with Starlight 0.34 / Astro 5.9; 0.23+ requires Starlight ≥0.38). Renders the Threat Intelligence Beta YAML under /api-reference/threat-intelligence-beta/ and adds an "API reference" sidebar group populated by openAPISidebarGroups. Co-Authored-By: Claude Opus 4.7 (1M context) * Publish Threat Intelligence Beta spec + Postman collection - Move schemas/threat-intel-beta.yaml into public/ so it's served at https://docs.patchstack.com/schemas/threat-intel-beta.yaml. - Add a small Astro integration that runs openapi-to-postmanv2 at config:setup, writing public/schemas/threat-intel-beta.postman_collection.json on every build. The generated collection is gitignored — the OpenAPI YAML stays the single source of truth. - Expand beta.md with a "Use with Postman / Insomnia / Bruno / Hoppscotch" section including a Run in Postman button, a Claude Code / LLM assistants section, and openapi-generator snippets for SDK generation. Only the Threat Intelligence Beta API is wired up for now. Additional APIs can drop a YAML into public/schemas/ and add an entry to the postmanCollections array and starlightOpenAPI config. Co-Authored-By: Claude Opus 4.7 (1M context) * Consolidate API sidebar and pin Beta to top - Merge the standalone "API reference" top-level sidebar group into "API solutions" → "Threat Intelligence API", immediately below the Beta narrative. Users now have a single entry point to find anything API-related; the narrative and interactive reference sit side-by-side under the same parent. - Convert "API solutions" from autogenerate to a manual items list so the generated OpenAPI pages (openAPISidebarGroups) can be interleaved with the .md files. - Pin Beta to the top of the Threat Intelligence group via sidebar.order: 0 and add a "New" tip badge so it's discoverable. - Rename the OpenAPI reference label from "Threat Intelligence API (Beta)" to "Interactive reference (Beta)" to avoid redundancy with the parent group name. Trade-off: new pages dropped into API solutions subfolders no longer auto-appear in the sidebar — astro.config.mjs needs a manual entry. Acceptable for the current 6 pages across 2 APIs. Co-Authored-By: Claude Opus 4.7 (1M context) * Restore API solutions Introduction page in sidebar The manual items list dropped the index.mdx entry that autogenerate was picking up. Add { slug: 'api-solutions' } at the top so the Introduction page appears before App API and Threat Intelligence API, preserving the original order. Co-Authored-By: Claude Opus 4.7 (1M context) * Group Beta narrative + reference under one sidebar item Move the Beta entries to the bottom of the Threat Intelligence API group and nest them under a single expandable "Beta tier API" group (with the "New" badge on the group itself). The narrative is now labelled "Guide" and the OpenAPI-generated pages are labelled "Reference" — both together inside the Beta parent, so everything Beta is one click and one glance. Co-Authored-By: Claude Opus 4.7 (1M context) * Make Postman collection deterministic and commit it Strip `id` and `_postman_id` UUIDs from the generated collection (both optional in Collection v2.1 — Postman assigns new ones on import) and add example values to schemas where openapi-to-postmanv2 was otherwise synthesising random data (OffsetPagination, CursorPagination, ProductType/Name/Version path params). Two consecutive builds now produce byte-identical output. Commit the collection so it's reachable via GitHub raw URL the moment this PR merges, instead of waiting on a docs.patchstack.com deploy. Build-time regeneration stays in place so the JSON can never drift from the YAML. Update the Run in Postman button to use the GitHub raw URL on main and add a direct-download fallback link for testing locally and on deploy previews — Postman's cloud cannot fetch a localhost: URL, which was producing the "blank Run in Postman modal" symptom. Co-Authored-By: Claude Opus 4.7 (1M context) * Remove broken Run in Postman button from Beta guide The "Run in Postman" button relied on the deprecated `app.getpostman.com/run-collection/?collection=` endpoint, which no longer accepts raw collection URLs — it only works with collections published to Postman's Public API Network and referenced by UID. The button silently did nothing when clicked. Replacing it with a plain download link plus a `File → Import → Link` instruction is honest about the flow and actually works today. Can be re-added later if/when the collection is published to Postman. Co-Authored-By: Claude Opus 4.7 (1M context) * Revert "Remove broken Run in Postman button from Beta guide" This reverts commit fe4d16c93712dc24271604a619a3d4e727b3e8f4. * Remove broken Run in Postman button from Beta guide Per Mario's review on PR #22: the app.getpostman.com/run-collection/?collection= endpoint was deprecated. Postman now only accepts published collections referenced by UID through the Public API Network — raw JSON URLs fail silently, which is what produced the blank-modal symptom. Replace the button with the honest flow: download + File → Import → Link. Can be re-added later without a breaking change if someone publishes the collection to Postman. Co-Authored-By: Mario Tarosso Co-Authored-By: Claude Opus 4.7 (1M context) * Rename Beta tier → Beta API and add partner-only guidance to Overview Rename the sidebar group and page title from "Beta tier API" to "Beta API" — Beta isn't an access tier alongside Standard / Extended, it's a new generation of the API. The "tier" naming invited the wrong mental model. Add a "Which API should I use?" comparison table to Overview and clearly flag Beta as available to selected partners working directly with Patchstack only. Update the Beta guide intro and Overview's Beta blurb to match. Co-Authored-By: Claude Opus 4.7 (1M context) * Un-bold the Beta API sidebar group label Starlight applies .large (heavier weight + larger size) to sidebar group labels. In a sub-group where Beta API sits next to leaf items (Standard tier API, Extended tier API, API properties) the bold treatment made Beta look visually promoted, even though its "New" badge already carries the emphasis. Scope the override via :has() so it only fires on group labels that carry a badge — today that's Beta API, and any future badged group will get the same treatment automatically without affecting plain groups like App API or Threat Intelligence API. Co-Authored-By: Claude Opus 4.7 (1M context) --------- Co-authored-by: Claude Opus 4.7 (1M context) Co-authored-by: Mario Tarosso --- astro.config.mjs | 104 +- package-lock.json | 1122 ++++++++++- package.json | 6 +- .../threat-intel-beta.postman_collection.json | 1782 +++++++++++++++++ public/schemas/threat-intel-beta.yaml | 652 ++++++ .../Threat Intelligence API/beta.md | 350 +--- .../Threat Intelligence API/overview.md | 27 +- src/styles/custom.css | 8 + 8 files changed, 3748 insertions(+), 303 deletions(-) create mode 100644 public/schemas/threat-intel-beta.postman_collection.json create mode 100644 public/schemas/threat-intel-beta.yaml diff --git a/astro.config.mjs b/astro.config.mjs index 0c5339f..3a8ddef 100644 --- a/astro.config.mjs +++ b/astro.config.mjs @@ -1,11 +1,69 @@ +import { readFile, writeFile } from 'node:fs/promises'; +import { fileURLToPath } from 'node:url'; import { defineConfig, passthroughImageService } from 'astro/config'; import starlight from '@astrojs/starlight'; import starlightLlmsTxt from 'starlight-llms-txt' +import starlightOpenAPI, { openAPISidebarGroups } from 'starlight-openapi' +import Converter from 'openapi-to-postmanv2' const site_url = process.env.URL; const site = site_url || 'http://localhost:4321'; + +const postmanCollections = [ + { + openapi: './public/schemas/threat-intel-beta.yaml', + output: './public/schemas/threat-intel-beta.postman_collection.json', + }, +]; + +// Recursively drop `id` and `_postman_id` keys so the output is deterministic. +// openapi-to-postmanv2 inserts fresh UUIDs on every run, which would cause +// churn in git. Both fields are optional in Collection v2.1 — Postman assigns +// new ids on import. +function stripIds(value) { + if (Array.isArray(value)) return value.map(stripIds); + if (value && typeof value === 'object') { + const out = {}; + for (const [key, val] of Object.entries(value)) { + if (key === 'id' || key === '_postman_id') continue; + out[key] = stripIds(val); + } + return out; + } + return value; +} + +function postmanFromOpenAPI() { + return { + name: 'postman-from-openapi', + hooks: { + 'astro:config:setup': async ({ logger }) => { + for (const { openapi, output } of postmanCollections) { + const spec = await readFile(fileURLToPath(new URL(openapi, import.meta.url)), 'utf8'); + await new Promise((resolve, reject) => { + Converter.convert( + { type: 'string', data: spec }, + { requestParametersResolution: 'Example' }, + async (err, result) => { + if (err || !result.result) { + return reject(err ?? new Error(result.reason ?? 'Postman conversion failed')); + } + await writeFile( + fileURLToPath(new URL(output, import.meta.url)), + JSON.stringify(stripIds(result.output[0].data), null, 2), + ); + logger.info(`generated ${output}`); + resolve(); + }, + ); + }); + } + }, + }, + }; +} // https://astro.build/config export default defineConfig({ site: site, @@ -18,17 +76,17 @@ export default defineConfig({ }, integrations: [ + postmanFromOpenAPI(), starlight({ plugins: [ - starlightLlmsTxt() - // Generate the OpenAPI documentation pages. - // starlightOpenAPI([ - // { - // base: 'developer-api', - // label: 'My API', - // schema: './schemas/test.yaml', - // }, - // ]) + starlightLlmsTxt(), + starlightOpenAPI([ + { + base: 'api-reference/threat-intelligence-beta', + label: 'Reference', + schema: './public/schemas/threat-intel-beta.yaml', + }, + ]), ], title: 'Patchstack Docs', favicon: '/images/psfavicon.svg', @@ -73,7 +131,33 @@ export default defineConfig({ { label: 'API solutions', collapsed: true, - autogenerate: { directory: 'API solutions', collapsed: true }, + items: [ + { slug: 'api-solutions' }, + { + label: 'App API', + collapsed: true, + autogenerate: { directory: 'API solutions/App API', collapsed: true }, + }, + { + label: 'Threat Intelligence API', + collapsed: true, + items: [ + { slug: 'api-solutions/threat-intelligence-api/overview' }, + { slug: 'api-solutions/threat-intelligence-api/standard' }, + { slug: 'api-solutions/threat-intelligence-api/extended' }, + { slug: 'api-solutions/threat-intelligence-api/api-properties' }, + { + label: 'Beta API', + badge: { text: 'New', variant: 'tip' }, + collapsed: true, + items: [ + { slug: 'api-solutions/threat-intelligence-api/beta' }, + ...openAPISidebarGroups, + ], + }, + ], + }, + ], }, { label: 'Vulnerability Disclosure Program', diff --git a/package-lock.json b/package-lock.json index 8f9d49a..56d2b58 100644 --- a/package-lock.json +++ b/package-lock.json @@ -14,7 +14,27 @@ "astro-og-canvas": "^0.5.3", "js-cookie": "^3.0.5", "sharp": "^0.33.4", - "starlight-llms-txt": "^0.5.1" + "starlight-llms-txt": "^0.5.1", + "starlight-openapi": "^0.22.1" + }, + "devDependencies": { + "openapi-to-postmanv2": "^6.0.1" + } + }, + "node_modules/@apidevtools/json-schema-ref-parser": { + "version": "13.0.5", + "resolved": "https://registry.npmjs.org/@apidevtools/json-schema-ref-parser/-/json-schema-ref-parser-13.0.5.tgz", + "integrity": "sha512-xfh4xVJD62gG6spIc7lwxoWT+l16nZu1ELyU8FkjaP/oD2yP09EvLAU6KhtudN9aML2Khhs9pY6Slr7KGTES3w==", + "license": "MIT", + "dependencies": { + "@types/json-schema": "^7.0.15", + "js-yaml": "^4.1.0" + }, + "engines": { + "node": ">= 16" + }, + "funding": { + "url": "https://github.com/sponsors/philsturgeon" } }, "node_modules/@astrojs/compiler": { @@ -31,6 +51,7 @@ "version": "6.3.2", "resolved": "https://registry.npmjs.org/@astrojs/markdown-remark/-/markdown-remark-6.3.2.tgz", "integrity": "sha512-bO35JbWpVvyKRl7cmSJD822e8YA8ThR/YbUsciWNA7yTcqpIAL2hJDToWP5KcZBWxGT6IOdOkHSXARSNZc4l/Q==", + "peer": true, "dependencies": { "@astrojs/internal-helpers": "0.6.1", "@astrojs/prism": "3.3.0", @@ -106,6 +127,7 @@ "version": "0.34.8", "resolved": "https://registry.npmjs.org/@astrojs/starlight/-/starlight-0.34.8.tgz", "integrity": "sha512-XuYz0TfCZhje2u1Q9FNtmTdm7/B9QP91RDI1VkPgYvDhSYlME3k8gwgcBMHnR9ASDo2p9gskrqe7t1Pub/qryg==", + "peer": true, "dependencies": { "@astrojs/markdown-remark": "^6.3.1", "@astrojs/mdx": "^4.2.3", @@ -156,6 +178,20 @@ "node": "18.20.8 || ^20.3.0 || >=22.0.0" } }, + "node_modules/@babel/code-frame": { + "version": "7.29.0", + "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.29.0.tgz", + "integrity": "sha512-9NhCeYjq9+3uxgdtp20LSiJXJvN0FeCtNGpJxuMFZ1Kv3cWUNb6DOhJwUvcVCzKGR66cw4njwM6hrJLqgOwbcw==", + "license": "MIT", + "dependencies": { + "@babel/helper-validator-identifier": "^7.28.5", + "js-tokens": "^4.0.0", + "picocolors": "^1.1.1" + }, + "engines": { + "node": ">=6.9.0" + } + }, "node_modules/@babel/helper-string-parser": { "version": "7.27.1", "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.27.1.tgz", @@ -165,9 +201,10 @@ } }, "node_modules/@babel/helper-validator-identifier": { - "version": "7.27.1", - "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.27.1.tgz", - "integrity": "sha512-D2hP9eA+Sqx1kBZgzxZh0y1trbuU+JoDkiEwqhQ36nodYqJwyEIhPSdMNd7lOm/4io72luTPWH20Yda0xOuUow==", + "version": "7.28.5", + "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.28.5.tgz", + "integrity": "sha512-qSs4ifwzKJSV39ucNjsvc6WVHs6b7S03sOh2OcHF9UHfVPqWWALUsNUVzhSBiItjRZoLHx7nIarVjqKVusUZ1Q==", + "license": "MIT", "engines": { "node": ">=6.9.0" } @@ -623,6 +660,13 @@ "node": ">=18" } }, + "node_modules/@exodus/schemasafe": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/@exodus/schemasafe/-/schemasafe-1.3.0.tgz", + "integrity": "sha512-5Aap/GaRupgNx/feGBwLLTVv8OQFfv3pq2lPRzPg9R+IOBnDgghTGW7l7EuVXOvg5cc/xSAlRW8rBrjIC3Nvqw==", + "dev": true, + "license": "MIT" + }, "node_modules/@expressive-code/core": { "version": "0.41.3", "resolved": "https://registry.npmjs.org/@expressive-code/core/-/core-0.41.3.tgz", @@ -664,6 +708,23 @@ "@expressive-code/core": "^0.41.3" } }, + "node_modules/@faker-js/faker": { + "version": "5.5.3", + "resolved": "https://registry.npmjs.org/@faker-js/faker/-/faker-5.5.3.tgz", + "integrity": "sha512-R11tGE6yIFwqpaIqcfkcg7AICXzFg14+5h5v0TfF/9+RMDL6jhzCy/pxHVOfbALGdtVYdt6JdR21tuxEgl34dw==", + "deprecated": "Please update to a newer version.", + "dev": true, + "license": "MIT" + }, + "node_modules/@humanwhocodes/momoa": { + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/@humanwhocodes/momoa/-/momoa-2.0.4.tgz", + "integrity": "sha512-RE815I4arJFtt+FVeU1Tgp9/Xvecacji8w/V6XtXsWWH/wz/eNkNbhb+ny/+PlVZjV0rxQpRSQKNKE3lcktHEA==", + "license": "Apache-2.0", + "engines": { + "node": ">=10.10.0" + } + }, "node_modules/@img/sharp-darwin-arm64": { "version": "0.33.5", "resolved": "https://registry.npmjs.org/@img/sharp-darwin-arm64/-/sharp-darwin-arm64-0.33.5.tgz", @@ -1116,6 +1177,55 @@ "win32" ] }, + "node_modules/@readme/better-ajv-errors": { + "version": "2.4.0", + "resolved": "https://registry.npmjs.org/@readme/better-ajv-errors/-/better-ajv-errors-2.4.0.tgz", + "integrity": "sha512-9WODaOAKSl/mU+MYNZ2aHCrkoRSvmQ+1YkLj589OEqqjOAhbn8j7Z+ilYoiTu/he6X63/clsxxAB4qny9/dDzg==", + "license": "Apache-2.0", + "dependencies": { + "@babel/code-frame": "^7.22.5", + "@babel/runtime": "^7.22.5", + "@humanwhocodes/momoa": "^2.0.3", + "jsonpointer": "^5.0.0", + "leven": "^3.1.0", + "picocolors": "^1.1.1" + }, + "engines": { + "node": ">=18" + }, + "peerDependencies": { + "ajv": "4.11.8 - 8" + } + }, + "node_modules/@readme/openapi-parser": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/@readme/openapi-parser/-/openapi-parser-4.1.2.tgz", + "integrity": "sha512-lAFH88r/CHs5VZDUocEda0OSMSQsr6801sziIjOKyVA+0hSFN+BPuelPF5XvkMROHecnPd+XEJN1iNQqCgER/g==", + "license": "MIT", + "dependencies": { + "@apidevtools/json-schema-ref-parser": "^13.0.5", + "@readme/better-ajv-errors": "^2.3.2", + "@readme/openapi-schemas": "^3.1.0", + "@types/json-schema": "^7.0.15", + "ajv": "^8.12.0", + "ajv-draft-04": "^1.0.0" + }, + "engines": { + "node": ">=20" + }, + "peerDependencies": { + "openapi-types": ">=7" + } + }, + "node_modules/@readme/openapi-schemas": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/@readme/openapi-schemas/-/openapi-schemas-3.1.0.tgz", + "integrity": "sha512-9FC/6ho8uFa8fV50+FPy/ngWN53jaUu4GRXlAjcxIRrzhltJnpKkBG2Tp0IDraFJeWrOpk84RJ9EMEEYzaI1Bw==", + "license": "MIT", + "engines": { + "node": ">=18" + } + }, "node_modules/@rollup/pluginutils": { "version": "5.2.0", "resolved": "https://registry.npmjs.org/@rollup/pluginutils/-/pluginutils-5.2.0.tgz", @@ -1497,6 +1607,12 @@ "resolved": "https://registry.npmjs.org/@types/js-yaml/-/js-yaml-4.0.9.tgz", "integrity": "sha512-k4MGaQl5TGo/iipqb2UDG2UwjXziSWkh0uysQelTlJpX1qGlpUZYm8PnO4DxG1qBomtJUdYJ6qR6xdIah10JLg==" }, + "node_modules/@types/json-schema": { + "version": "7.0.15", + "resolved": "https://registry.npmjs.org/@types/json-schema/-/json-schema-7.0.15.tgz", + "integrity": "sha512-5+fP8P8MFNC+AyZCDxrB2pkZFPGzqQWUzpSeuuVLvm8VMcorNYavBqoFcxK8bQz4Qsbn4oUEEem4wDLfcysGHA==", + "license": "MIT" + }, "node_modules/@types/mdast": { "version": "4.0.4", "resolved": "https://registry.npmjs.org/@types/mdast/-/mdast-4.0.4.tgz", @@ -1566,6 +1682,7 @@ "version": "8.15.0", "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.15.0.tgz", "integrity": "sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==", + "peer": true, "bin": { "acorn": "bin/acorn" }, @@ -1581,6 +1698,55 @@ "acorn": "^6.0.0 || ^7.0.0 || ^8.0.0" } }, + "node_modules/ajv": { + "version": "8.18.0", + "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.18.0.tgz", + "integrity": "sha512-PlXPeEWMXMZ7sPYOHqmDyCJzcfNrUr3fGNKtezX14ykXOEIvyK81d+qydx89KY5O71FKMPaQ2vBfBFI5NHR63A==", + "license": "MIT", + "peer": true, + "dependencies": { + "fast-deep-equal": "^3.1.3", + "fast-uri": "^3.0.1", + "json-schema-traverse": "^1.0.0", + "require-from-string": "^2.0.2" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/epoberezkin" + } + }, + "node_modules/ajv-draft-04": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/ajv-draft-04/-/ajv-draft-04-1.0.0.tgz", + "integrity": "sha512-mv00Te6nmYbRp5DCwclxtt7yV/joXJPGS7nM+97GdxvuttCOfgI3K4U25zboyeX0O+myI8ERluxQe5wljMmVIw==", + "license": "MIT", + "peerDependencies": { + "ajv": "^8.5.0" + }, + "peerDependenciesMeta": { + "ajv": { + "optional": true + } + } + }, + "node_modules/ajv-formats": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/ajv-formats/-/ajv-formats-2.1.1.tgz", + "integrity": "sha512-Wx0Kx52hxE7C18hkMEggYlEifqWZtYaRgouJor+WMdPnQyEK13vgEWyVNup7SoeeoLMsr4kf5h6dOW11I15MUA==", + "dev": true, + "license": "MIT", + "dependencies": { + "ajv": "^8.0.0" + }, + "peerDependencies": { + "ajv": "^8.0.0" + }, + "peerDependenciesMeta": { + "ajv": { + "optional": true + } + } + }, "node_modules/ansi-align": { "version": "3.0.1", "resolved": "https://registry.npmjs.org/ansi-align/-/ansi-align-3.0.1.tgz", @@ -1710,6 +1876,7 @@ "version": "5.11.2", "resolved": "https://registry.npmjs.org/astro/-/astro-5.11.2.tgz", "integrity": "sha512-jKJCqp0PMZ1ZpP2xySghsJ1xK7ZNh/ISTRNBf/7khY3iEGq/zup49ZMhNZXK5Cd/dFWP/pdBNHD91SByA42IvQ==", + "peer": true, "dependencies": { "@astrojs/compiler": "^2.12.2", "@astrojs/internal-helpers": "0.6.1", @@ -1816,6 +1983,13 @@ "astro": "^3.0.0 || ^4.0.0 || ^5.0.0" } }, + "node_modules/async": { + "version": "3.2.6", + "resolved": "https://registry.npmjs.org/async/-/async-3.2.6.tgz", + "integrity": "sha512-htCUDlxyyCLMgaM3xXg0C0LW2xqfuQ6p05pCEIsXuyQ+a1koYKTuBMzRNwmybfLgvJDMd0r1LTn4+E0Ti6C2AA==", + "dev": true, + "license": "MIT" + }, "node_modules/axobject-query": { "version": "4.1.0", "resolved": "https://registry.npmjs.org/axobject-query/-/axobject-query-4.1.0.tgz", @@ -1944,6 +2118,13 @@ "base64-js": "^1.1.2" } }, + "node_modules/call-me-maybe": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/call-me-maybe/-/call-me-maybe-1.0.2.tgz", + "integrity": "sha512-HpX65o1Hnr9HH25ojC1YGs7HCQLq0GCOibSaWER0eNpgJ/Z1MZv2mTc7+xh6WOPxbRVcmgbv4hGU+uSQ/2xFZQ==", + "dev": true, + "license": "MIT" + }, "node_modules/camelcase": { "version": "8.0.0", "resolved": "https://registry.npmjs.org/camelcase/-/camelcase-8.0.0.tgz", @@ -2019,6 +2200,16 @@ "url": "https://github.com/sponsors/wooorm" } }, + "node_modules/charset": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/charset/-/charset-1.0.1.tgz", + "integrity": "sha512-6dVyOOYjpfFcL1Y4qChrAoQLRHvj2ziyhcm0QJlhOcAhykL/k1kTUPbeo+87MNRTRdk2OIIsIXbuF3x2wi5EXg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=4.0.0" + } + }, "node_modules/chokidar": { "version": "4.0.3", "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-4.0.3.tgz", @@ -2058,6 +2249,100 @@ "url": "https://github.com/sponsors/sindresorhus" } }, + "node_modules/cliui": { + "version": "8.0.1", + "resolved": "https://registry.npmjs.org/cliui/-/cliui-8.0.1.tgz", + "integrity": "sha512-BSeNnyus75C4//NQ9gQt1/csTXyo/8Sb+afLAkzAptFuMsod9HFokGNudZpi/oQV73hnVK+sR+5PVRMd+Dr7YQ==", + "dev": true, + "license": "ISC", + "dependencies": { + "string-width": "^4.2.0", + "strip-ansi": "^6.0.1", + "wrap-ansi": "^7.0.0" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/cliui/node_modules/ansi-regex": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz", + "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/cliui/node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "dev": true, + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/cliui/node_modules/emoji-regex": { + "version": "8.0.0", + "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz", + "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==", + "dev": true, + "license": "MIT" + }, + "node_modules/cliui/node_modules/string-width": { + "version": "4.2.3", + "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz", + "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==", + "dev": true, + "license": "MIT", + "dependencies": { + "emoji-regex": "^8.0.0", + "is-fullwidth-code-point": "^3.0.0", + "strip-ansi": "^6.0.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/cliui/node_modules/strip-ansi": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz", + "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-regex": "^5.0.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/cliui/node_modules/wrap-ansi": { + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz", + "integrity": "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.0.0", + "string-width": "^4.1.0", + "strip-ansi": "^6.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/wrap-ansi?sponsor=1" + } + }, "node_modules/clone": { "version": "2.1.2", "resolved": "https://registry.npmjs.org/clone/-/clone-2.1.2.tgz", @@ -2129,11 +2414,41 @@ "url": "https://github.com/sponsors/wooorm" } }, + "node_modules/commander": { + "version": "2.20.3", + "resolved": "https://registry.npmjs.org/commander/-/commander-2.20.3.tgz", + "integrity": "sha512-GpVkmM8vF2vQUkj2LvZmD35JxeJOLCwJ9cUkugyk2nuhbv3+mJvpLYYt+0+USMxE+oj+ey/lJEnhZw75x/OMcQ==", + "dev": true, + "license": "MIT" + }, "node_modules/common-ancestor-path": { "version": "1.0.1", "resolved": "https://registry.npmjs.org/common-ancestor-path/-/common-ancestor-path-1.0.1.tgz", "integrity": "sha512-L3sHRo1pXXEqX8VU28kfgUY+YGsk09hPqZiZmLacNib6XNTCM8ubYeT7ryXQw8asB1sKgcU5lkB7ONug08aB8w==" }, + "node_modules/compute-gcd": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/compute-gcd/-/compute-gcd-1.2.1.tgz", + "integrity": "sha512-TwMbxBNz0l71+8Sc4czv13h4kEqnchV9igQZBi6QUaz09dnz13juGnnaWWJTRsP3brxOoxeB4SA2WELLw1hCtg==", + "dev": true, + "dependencies": { + "validate.io-array": "^1.0.3", + "validate.io-function": "^1.0.2", + "validate.io-integer-array": "^1.0.0" + } + }, + "node_modules/compute-lcm": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/compute-lcm/-/compute-lcm-1.1.2.tgz", + "integrity": "sha512-OFNPdQAXnQhDSKioX8/XYT6sdUlXwpeMjfd6ApxMJfyZ4GxmLR1xvMERctlYhlHwIiz6CSpBc2+qYKjHGZw4TQ==", + "dev": true, + "dependencies": { + "compute-gcd": "^1.2.1", + "validate.io-array": "^1.0.3", + "validate.io-function": "^1.0.2", + "validate.io-integer-array": "^1.0.0" + } + }, "node_modules/cookie": { "version": "1.0.2", "resolved": "https://registry.npmjs.org/cookie/-/cookie-1.0.2.tgz", @@ -2342,6 +2657,13 @@ "resolved": "https://registry.npmjs.org/es-module-lexer/-/es-module-lexer-1.7.0.tgz", "integrity": "sha512-jEQoCwk8hyb2AZziIOLhDqpm5+2ww5uIE6lkO/6jcOCusfk6LhMHpXXfBLXTZ7Ydyt0j4VoUQv6uGNYbdW+kBA==" }, + "node_modules/es6-promise": { + "version": "3.3.1", + "resolved": "https://registry.npmjs.org/es6-promise/-/es6-promise-3.3.1.tgz", + "integrity": "sha512-SOp9Phqvqn7jtEUxPWdWfWoLmyt2VaJ6MpvP9Comy1MceMXqE6bxvaTu4iaxpYYPzhny28Lc+M87/c2cPK6lDg==", + "dev": true, + "license": "MIT" + }, "node_modules/esast-util-from-estree": { "version": "2.0.0", "resolved": "https://registry.npmjs.org/esast-util-from-estree/-/esast-util-from-estree-2.0.0.tgz", @@ -2412,6 +2734,16 @@ "@esbuild/win32-x64": "0.25.6" } }, + "node_modules/escalade": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.2.0.tgz", + "integrity": "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, "node_modules/escape-string-regexp": { "version": "5.0.0", "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-5.0.0.tgz", @@ -2533,6 +2865,29 @@ "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz", "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==" }, + "node_modules/fast-safe-stringify": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/fast-safe-stringify/-/fast-safe-stringify-2.1.1.tgz", + "integrity": "sha512-W+KJc2dmILlPplD/H4K9l9LcAHAfPtP6BY84uVLXQ6Evcz9Lcg33Y2z1IVblT6xdY54PXYVHEv+0Wpq8Io6zkA==", + "dev": true, + "license": "MIT" + }, + "node_modules/fast-uri": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.0.tgz", + "integrity": "sha512-iPeeDKJSWf4IEOasVVrknXpaBV0IApz/gp7S2bb7Z4Lljbl2MGJRqInZiUrQwV16cpzw/D3S5j5Julj/gT52AA==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/fastify" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/fastify" + } + ], + "license": "BSD-3-Clause" + }, "node_modules/fdir": { "version": "6.4.6", "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.4.6.tgz", @@ -2546,6 +2901,16 @@ } } }, + "node_modules/file-type": { + "version": "3.9.0", + "resolved": "https://registry.npmjs.org/file-type/-/file-type-3.9.0.tgz", + "integrity": "sha512-RLoqTXE8/vPmMuTI88DAzhMYC99I8BWv7zYP4A1puo5HIjEJ5EX48ighy4ZyKMG9EDXxBgW6e++cn7d1xuFghA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, "node_modules/fill-range": { "version": "7.1.1", "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz", @@ -2590,6 +2955,13 @@ "unicode-trie": "^2.0.0" } }, + "node_modules/foreach": { + "version": "2.0.6", + "resolved": "https://registry.npmjs.org/foreach/-/foreach-2.0.6.tgz", + "integrity": "sha512-k6GAGDyqLe9JaebCsFCoudPPWfihKu8pylYXRlqP1J7ms39iPoTtk2fviNglIeQEwdh0bQeKJ01ZPyuyQvKzwg==", + "dev": true, + "license": "MIT" + }, "node_modules/fsevents": { "version": "2.3.3", "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz", @@ -2603,6 +2975,16 @@ "node": "^8.16.0 || ^10.6.0 || >=11.0.0" } }, + "node_modules/get-caller-file": { + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-2.0.5.tgz", + "integrity": "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==", + "dev": true, + "license": "ISC", + "engines": { + "node": "6.* || 8.* || >= 10.*" + } + }, "node_modules/get-east-asian-width": { "version": "1.3.0", "resolved": "https://registry.npmjs.org/get-east-asian-width/-/get-east-asian-width-1.3.0.tgz", @@ -2619,6 +3001,16 @@ "resolved": "https://registry.npmjs.org/github-slugger/-/github-slugger-2.0.0.tgz", "integrity": "sha512-IaOQ9puYtjrkq7Y0Ygl9KDZnrf/aiUJYUpVf89y8kyaxbRG7Y1SrX/jaumrv81vc61+kiMempujsM3Yw7w5qcw==" }, + "node_modules/graphlib": { + "version": "2.1.8", + "resolved": "https://registry.npmjs.org/graphlib/-/graphlib-2.1.8.tgz", + "integrity": "sha512-jcLLfkpoVGmH7/InMC/1hIvOPSUh38oJtGhvrOFGzioE1DZ+0YW16RgmOJhHiuWTvGiJQ9Z1Ik43JvkRPRvE+A==", + "dev": true, + "license": "MIT", + "dependencies": { + "lodash": "^4.17.15" + } + }, "node_modules/h3": { "version": "1.15.3", "resolved": "https://registry.npmjs.org/h3/-/h3-1.15.3.tgz", @@ -3042,6 +3434,20 @@ "resolved": "https://registry.npmjs.org/http-cache-semantics/-/http-cache-semantics-4.2.0.tgz", "integrity": "sha512-dTxcvPXqPvXBQpq5dUr6mEMJX4oIEFv6bwom3FDwKRDsuIjjJGANqhBuoAn9c1RQJIdAKav33ED65E2ys+87QQ==" }, + "node_modules/http-reasons": { + "version": "0.1.0", + "resolved": "https://registry.npmjs.org/http-reasons/-/http-reasons-0.1.0.tgz", + "integrity": "sha512-P6kYh0lKZ+y29T2Gqz+RlC9WBLhKe8kDmcJ+A+611jFfxdPsbMRQ5aNmFRM3lENqFkK+HTTL+tlQviAiv0AbLQ==", + "dev": true, + "license": "Apache-2.0" + }, + "node_modules/http2-client": { + "version": "1.3.5", + "resolved": "https://registry.npmjs.org/http2-client/-/http2-client-1.3.5.tgz", + "integrity": "sha512-EC2utToWl4RKfs5zd36Mxq7nzHHBuomZboI0yYL6Y0RmBgT7Sgkq4rQ0ezFTYoIsSs7Tm9SJe+o2FcAg6GBhGA==", + "dev": true, + "license": "MIT" + }, "node_modules/i18next": { "version": "23.16.8", "resolved": "https://registry.npmjs.org/i18next/-/i18next-23.16.8.tgz", @@ -3064,6 +3470,19 @@ "@babel/runtime": "^7.23.2" } }, + "node_modules/iconv-lite": { + "version": "0.6.3", + "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.6.3.tgz", + "integrity": "sha512-4fCk79wshMdzMp2rH06qWrJE4iolqLhCUH+OiuIgU++RB0+94NlDL81atO7GX55uUKueo0txHNtvEyI6D7WdMw==", + "dev": true, + "license": "MIT", + "dependencies": { + "safer-buffer": ">= 2.1.2 < 3.0.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, "node_modules/import-meta-resolve": { "version": "4.1.0", "resolved": "https://registry.npmjs.org/import-meta-resolve/-/import-meta-resolve-4.1.0.tgz", @@ -3211,6 +3630,12 @@ "node": ">=14" } }, + "node_modules/js-tokens": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz", + "integrity": "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==", + "license": "MIT" + }, "node_modules/js-yaml": { "version": "4.1.0", "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.0.tgz", @@ -3222,6 +3647,56 @@ "js-yaml": "bin/js-yaml.js" } }, + "node_modules/json-pointer": { + "version": "0.6.2", + "resolved": "https://registry.npmjs.org/json-pointer/-/json-pointer-0.6.2.tgz", + "integrity": "sha512-vLWcKbOaXlO+jvRy4qNd+TI1QUPZzfJj1tpJ3vAXDych5XJf93ftpUKe5pKCrzyIIwgBJcOcCVRUfqQP25afBw==", + "dev": true, + "license": "MIT", + "dependencies": { + "foreach": "^2.0.4" + } + }, + "node_modules/json-schema-compare": { + "version": "0.2.2", + "resolved": "https://registry.npmjs.org/json-schema-compare/-/json-schema-compare-0.2.2.tgz", + "integrity": "sha512-c4WYmDKyJXhs7WWvAWm3uIYnfyWFoIp+JEoX34rctVvEkMYCPGhXtvmFFXiffBbxfZsvQ0RNnV5H7GvDF5HCqQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "lodash": "^4.17.4" + } + }, + "node_modules/json-schema-merge-allof": { + "version": "0.8.1", + "resolved": "https://registry.npmjs.org/json-schema-merge-allof/-/json-schema-merge-allof-0.8.1.tgz", + "integrity": "sha512-CTUKmIlPJbsWfzRRnOXz+0MjIqvnleIXwFTzz+t9T86HnYX/Rozria6ZVGLktAU9e+NygNljveP+yxqtQp/Q4w==", + "dev": true, + "license": "MIT", + "dependencies": { + "compute-lcm": "^1.1.2", + "json-schema-compare": "^0.2.2", + "lodash": "^4.17.20" + }, + "engines": { + "node": ">=12.0.0" + } + }, + "node_modules/json-schema-traverse": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz", + "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==", + "license": "MIT" + }, + "node_modules/jsonpointer": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/jsonpointer/-/jsonpointer-5.0.1.tgz", + "integrity": "sha512-p/nXbhSEcu3pZRdkW1OfJhpsVtW1gd4Wa1fnQc9YLiTfAjn0312eMKimbdIQzuZl9aa9xUGaRlP9T/CJE/ditQ==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, "node_modules/kleur": { "version": "4.1.5", "resolved": "https://registry.npmjs.org/kleur/-/kleur-4.1.5.tgz", @@ -3238,6 +3713,32 @@ "node": ">= 8" } }, + "node_modules/leven": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/leven/-/leven-3.1.0.tgz", + "integrity": "sha512-qsda+H8jTaUaN/x5vzW2rzc+8Rw4TAQ/4KjB46IwK5VH+IlVeeeje/EoZRpiXvIqjFgK84QffqPztGI3VBLG1A==", + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/liquid-json": { + "version": "0.3.1", + "resolved": "https://registry.npmjs.org/liquid-json/-/liquid-json-0.3.1.tgz", + "integrity": "sha512-wUayTU8MS827Dam6MxgD72Ui+KOSF+u/eIqpatOtjnvgJ0+mnDq33uC2M7J0tPK+upe/DpUAuK4JUU89iBoNKQ==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=4" + } + }, + "node_modules/lodash": { + "version": "4.17.21", + "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.21.tgz", + "integrity": "sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg==", + "dev": true, + "license": "MIT" + }, "node_modules/longest-streak": { "version": "3.1.0", "resolved": "https://registry.npmjs.org/longest-streak/-/longest-streak-3.1.0.tgz", @@ -4323,6 +4824,29 @@ "url": "https://github.com/sponsors/jonschlinkert" } }, + "node_modules/mime": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/mime/-/mime-3.0.0.tgz", + "integrity": "sha512-jSCU7/VB1loIWBZe14aEYHU/+1UMEHoaO7qxCOVJOw9GgH72VAWppxNcjU+x9a2k3GSIBXNKxXQFqRvvZ7vr3A==", + "dev": true, + "license": "MIT", + "bin": { + "mime": "cli.js" + }, + "engines": { + "node": ">=10.0.0" + } + }, + "node_modules/mime-format": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/mime-format/-/mime-format-2.0.2.tgz", + "integrity": "sha512-Y5ERWVcyh3sby9Fx2U5F1yatiTFjNsqF5NltihTWI9QgNtr5o3dbCZdcKa1l2wyfhnwwoP9HGNxga7LqZLA6gw==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "charset": "^1.0.0" + } + }, "node_modules/mrmime": { "version": "2.0.1", "resolved": "https://registry.npmjs.org/mrmime/-/mrmime-2.0.1.tgz", @@ -4392,6 +4916,19 @@ } } }, + "node_modules/node-fetch-h2": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/node-fetch-h2/-/node-fetch-h2-2.3.0.tgz", + "integrity": "sha512-ofRW94Ab0T4AOh5Fk8t0h8OBWrmjb0SSB20xh1H8YnPV9EJ+f5AMoYSUQ2zgJ4Iq2HAK0I2l5/Nequ8YzFS3Hg==", + "dev": true, + "license": "MIT", + "dependencies": { + "http2-client": "^1.2.5" + }, + "engines": { + "node": "4.x || >=6.0.0" + } + }, "node_modules/node-fetch-native": { "version": "1.6.6", "resolved": "https://registry.npmjs.org/node-fetch-native/-/node-fetch-native-1.6.6.tgz", @@ -4402,6 +4939,16 @@ "resolved": "https://registry.npmjs.org/node-mock-http/-/node-mock-http-1.0.1.tgz", "integrity": "sha512-0gJJgENizp4ghds/Ywu2FCmcRsgBTmRQzYPZm61wy+Em2sBarSka0OhQS5huLBg6od1zkNpnWMCZloQDFVvOMQ==" }, + "node_modules/node-readfiles": { + "version": "0.2.0", + "resolved": "https://registry.npmjs.org/node-readfiles/-/node-readfiles-0.2.0.tgz", + "integrity": "sha512-SU00ZarexNlE4Rjdm83vglt5Y9yiQ+XI1XpflWlb7q7UTN1JUItm69xMeiQCTxtTfnzt+83T8Cx+vI2ED++VDA==", + "dev": true, + "license": "MIT", + "dependencies": { + "es6-promise": "^3.2.1" + } + }, "node_modules/normalize-path": { "version": "3.0.0", "resolved": "https://registry.npmjs.org/normalize-path/-/normalize-path-3.0.0.tgz", @@ -4421,6 +4968,152 @@ "url": "https://github.com/fb55/nth-check?sponsor=1" } }, + "node_modules/oas-kit-common": { + "version": "1.0.8", + "resolved": "https://registry.npmjs.org/oas-kit-common/-/oas-kit-common-1.0.8.tgz", + "integrity": "sha512-pJTS2+T0oGIwgjGpw7sIRU8RQMcUoKCDWFLdBqKB2BNmGpbBMH2sdqAaOXUg8OzonZHU0L7vfJu1mJFEiYDWOQ==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "fast-safe-stringify": "^2.0.7" + } + }, + "node_modules/oas-linter": { + "version": "3.2.2", + "resolved": "https://registry.npmjs.org/oas-linter/-/oas-linter-3.2.2.tgz", + "integrity": "sha512-KEGjPDVoU5K6swgo9hJVA/qYGlwfbFx+Kg2QB/kd7rzV5N8N5Mg6PlsoCMohVnQmo+pzJap/F610qTodKzecGQ==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "@exodus/schemasafe": "^1.0.0-rc.2", + "should": "^13.2.1", + "yaml": "^1.10.0" + }, + "funding": { + "url": "https://github.com/Mermade/oas-kit?sponsor=1" + } + }, + "node_modules/oas-linter/node_modules/yaml": { + "version": "1.10.3", + "resolved": "https://registry.npmjs.org/yaml/-/yaml-1.10.3.tgz", + "integrity": "sha512-vIYeF1u3CjlhAFekPPAk2h/Kv4T3mAkMox5OymRiJQB0spDP10LHvt+K7G9Ny6NuuMAb25/6n1qyUjAcGNf/AA==", + "dev": true, + "license": "ISC", + "engines": { + "node": ">= 6" + } + }, + "node_modules/oas-resolver": { + "version": "2.5.6", + "resolved": "https://registry.npmjs.org/oas-resolver/-/oas-resolver-2.5.6.tgz", + "integrity": "sha512-Yx5PWQNZomfEhPPOphFbZKi9W93CocQj18NlD2Pa4GWZzdZpSJvYwoiuurRI7m3SpcChrnO08hkuQDL3FGsVFQ==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "node-fetch-h2": "^2.3.0", + "oas-kit-common": "^1.0.8", + "reftools": "^1.1.9", + "yaml": "^1.10.0", + "yargs": "^17.0.1" + }, + "bin": { + "resolve": "resolve.js" + }, + "funding": { + "url": "https://github.com/Mermade/oas-kit?sponsor=1" + } + }, + "node_modules/oas-resolver-browser": { + "version": "2.5.6", + "resolved": "https://registry.npmjs.org/oas-resolver-browser/-/oas-resolver-browser-2.5.6.tgz", + "integrity": "sha512-Jw5elT/kwUJrnGaVuRWe1D7hmnYWB8rfDDjBnpQ+RYY/dzAewGXeTexXzt4fGEo6PUE4eqKqPWF79MZxxvMppA==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "node-fetch-h2": "^2.3.0", + "oas-kit-common": "^1.0.8", + "path-browserify": "^1.0.1", + "reftools": "^1.1.9", + "yaml": "^1.10.0", + "yargs": "^17.0.1" + }, + "bin": { + "resolve": "resolve.js" + }, + "funding": { + "url": "https://github.com/Mermade/oas-kit?sponsor=1" + } + }, + "node_modules/oas-resolver-browser/node_modules/yaml": { + "version": "1.10.3", + "resolved": "https://registry.npmjs.org/yaml/-/yaml-1.10.3.tgz", + "integrity": "sha512-vIYeF1u3CjlhAFekPPAk2h/Kv4T3mAkMox5OymRiJQB0spDP10LHvt+K7G9Ny6NuuMAb25/6n1qyUjAcGNf/AA==", + "dev": true, + "license": "ISC", + "engines": { + "node": ">= 6" + } + }, + "node_modules/oas-resolver/node_modules/yaml": { + "version": "1.10.3", + "resolved": "https://registry.npmjs.org/yaml/-/yaml-1.10.3.tgz", + "integrity": "sha512-vIYeF1u3CjlhAFekPPAk2h/Kv4T3mAkMox5OymRiJQB0spDP10LHvt+K7G9Ny6NuuMAb25/6n1qyUjAcGNf/AA==", + "dev": true, + "license": "ISC", + "engines": { + "node": ">= 6" + } + }, + "node_modules/oas-schema-walker": { + "version": "1.1.5", + "resolved": "https://registry.npmjs.org/oas-schema-walker/-/oas-schema-walker-1.1.5.tgz", + "integrity": "sha512-2yucenq1a9YPmeNExoUa9Qwrt9RFkjqaMAA1X+U7sbb0AqBeTIdMHky9SQQ6iN94bO5NW0W4TRYXerG+BdAvAQ==", + "dev": true, + "license": "BSD-3-Clause", + "funding": { + "url": "https://github.com/Mermade/oas-kit?sponsor=1" + } + }, + "node_modules/oas-validator": { + "version": "5.0.8", + "resolved": "https://registry.npmjs.org/oas-validator/-/oas-validator-5.0.8.tgz", + "integrity": "sha512-cu20/HE5N5HKqVygs3dt94eYJfBi0TsZvPVXDhbXQHiEityDN+RROTleefoKRKKJ9dFAF2JBkDHgvWj0sjKGmw==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "call-me-maybe": "^1.0.1", + "oas-kit-common": "^1.0.8", + "oas-linter": "^3.2.2", + "oas-resolver": "^2.5.6", + "oas-schema-walker": "^1.1.5", + "reftools": "^1.1.9", + "should": "^13.2.1", + "yaml": "^1.10.0" + }, + "funding": { + "url": "https://github.com/Mermade/oas-kit?sponsor=1" + } + }, + "node_modules/oas-validator/node_modules/yaml": { + "version": "1.10.3", + "resolved": "https://registry.npmjs.org/yaml/-/yaml-1.10.3.tgz", + "integrity": "sha512-vIYeF1u3CjlhAFekPPAk2h/Kv4T3mAkMox5OymRiJQB0spDP10LHvt+K7G9Ny6NuuMAb25/6n1qyUjAcGNf/AA==", + "dev": true, + "license": "ISC", + "engines": { + "node": ">= 6" + } + }, + "node_modules/object-hash": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/object-hash/-/object-hash-3.0.0.tgz", + "integrity": "sha512-RSn9F68PjH9HqtltsSnqYC1XXoWe9Bju5+213R98cNGttag9q9yAOTzdbsqvIa7aNm5WffBZFpWYr2aWrklWAw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 6" + } + }, "node_modules/ofetch": { "version": "1.4.1", "resolved": "https://registry.npmjs.org/ofetch/-/ofetch-1.4.1.tgz", @@ -4451,6 +5144,66 @@ "regex-recursion": "^6.0.2" } }, + "node_modules/openapi-to-postmanv2": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/openapi-to-postmanv2/-/openapi-to-postmanv2-6.0.1.tgz", + "integrity": "sha512-zAjaTwXo07az6jjvZTw4d26QMQsFxZBxTqjj3LQQMDCCuO6+peATQc9bSmAq3QbzvikP+h2WEjTphMcIrcSurg==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "ajv": "^8.11.0", + "ajv-draft-04": "1.0.0", + "ajv-formats": "2.1.1", + "async": "3.2.6", + "commander": "2.20.3", + "graphlib": "2.1.8", + "js-yaml": "4.1.0", + "json-pointer": "0.6.2", + "json-schema-merge-allof": "0.8.1", + "lodash": "4.17.21", + "neotraverse": "0.6.15", + "oas-resolver-browser": "2.5.6", + "object-hash": "3.0.0", + "openapi-types": "^12.1.3", + "path-browserify": "1.0.1", + "postman-collection": "^5.0.0", + "swagger2openapi": "7.0.8", + "yaml": "1.10.2" + }, + "bin": { + "openapi2postmanv2": "bin/openapi2postmanv2.js" + }, + "engines": { + "node": ">=18" + } + }, + "node_modules/openapi-to-postmanv2/node_modules/neotraverse": { + "version": "0.6.15", + "resolved": "https://registry.npmjs.org/neotraverse/-/neotraverse-0.6.15.tgz", + "integrity": "sha512-HZpdkco+JeXq0G+WWpMJ4NsX3pqb5O7eR9uGz3FfoFt+LYzU8iRWp49nJtud6hsDoywM8tIrDo3gjgmOqJA8LA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 10" + } + }, + "node_modules/openapi-to-postmanv2/node_modules/yaml": { + "version": "1.10.2", + "resolved": "https://registry.npmjs.org/yaml/-/yaml-1.10.2.tgz", + "integrity": "sha512-r3vXyErRCYJ7wg28yvBY5VSoAF8ZvlcW9/BwUzEtUsjvX/DKs24dIkuwjtuprwJJHsbyUbLApepYTR1BN4uHrg==", + "dev": true, + "license": "ISC", + "engines": { + "node": ">= 6" + } + }, + "node_modules/openapi-types": { + "version": "12.1.3", + "resolved": "https://registry.npmjs.org/openapi-types/-/openapi-types-12.1.3.tgz", + "integrity": "sha512-N4YtSYJqghVu4iek2ZUvcN/0aqH1kRDuNqzcycDxhOUpg7GdvLa2F3DgS6yBNhInhv2r/6I0Flkn7CqL8+nIcw==", + "license": "MIT", + "peer": true + }, "node_modules/p-limit": { "version": "6.2.0", "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-6.2.0.tgz", @@ -4578,6 +5331,13 @@ "url": "https://github.com/fb55/entities?sponsor=1" } }, + "node_modules/path-browserify": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/path-browserify/-/path-browserify-1.0.1.tgz", + "integrity": "sha512-b7uo2UCUOYZcnF/3ID0lulOJi/bafxa1xPe7ZPsammBSpjSWQkjNxlt635YGS2MiR9GjvuXCtz2emr3jbsz98g==", + "dev": true, + "license": "MIT" + }, "node_modules/picocolors": { "version": "1.1.1", "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz", @@ -4612,6 +5372,7 @@ "url": "https://github.com/sponsors/ai" } ], + "peer": true, "dependencies": { "nanoid": "^3.3.11", "picocolors": "^1.1.1", @@ -4657,6 +5418,62 @@ "node": ">=4" } }, + "node_modules/postman-collection": { + "version": "5.3.0", + "resolved": "https://registry.npmjs.org/postman-collection/-/postman-collection-5.3.0.tgz", + "integrity": "sha512-PMa5vRheqDFfS1bkRg8WBidWxunRA80sT5YNLP27YC5+ycyfiLMCwPnqQd1zfvxkGk04Pr9UronWmmgsbpsVyQ==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@faker-js/faker": "5.5.3", + "file-type": "3.9.0", + "http-reasons": "0.1.0", + "iconv-lite": "0.6.3", + "liquid-json": "0.3.1", + "lodash": "4.17.23", + "mime": "3.0.0", + "mime-format": "2.0.2", + "postman-url-encoder": "3.0.8", + "semver": "7.7.1", + "uuid": "8.3.2" + }, + "engines": { + "node": ">=18" + } + }, + "node_modules/postman-collection/node_modules/lodash": { + "version": "4.17.23", + "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.23.tgz", + "integrity": "sha512-LgVTMpQtIopCi79SJeDiP0TfWi5CNEc/L/aRdTh3yIvmZXTnheWpKjSZhnvMl8iXbC1tFg9gdHHDMLoV7CnG+w==", + "dev": true, + "license": "MIT" + }, + "node_modules/postman-collection/node_modules/semver": { + "version": "7.7.1", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.1.tgz", + "integrity": "sha512-hlq8tAfn0m/61p4BVRcPzIGr6LKiMwo4VM6dGi6pt4qcRkmNzTcWq6eCEjEh+qXjkMDvPlOFFSGwQjoEa6gyMA==", + "dev": true, + "license": "ISC", + "bin": { + "semver": "bin/semver.js" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/postman-url-encoder": { + "version": "3.0.8", + "resolved": "https://registry.npmjs.org/postman-url-encoder/-/postman-url-encoder-3.0.8.tgz", + "integrity": "sha512-EOgUMBazo7JNP4TDrd64TsooCiWzzo4143Ws8E8WYGEpn2PKpq+S4XRTDhuRTYHm3VKOpUZs7ZYZq7zSDuesqA==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "punycode": "^2.3.1" + }, + "engines": { + "node": ">=10" + } + }, "node_modules/prismjs": { "version": "1.30.0", "resolved": "https://registry.npmjs.org/prismjs/-/prismjs-1.30.0.tgz", @@ -4694,6 +5511,16 @@ "url": "https://github.com/sponsors/wooorm" } }, + "node_modules/punycode": { + "version": "2.3.1", + "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.3.1.tgz", + "integrity": "sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, "node_modules/radix3": { "version": "1.1.2", "resolved": "https://registry.npmjs.org/radix3/-/radix3-1.1.2.tgz", @@ -4771,6 +5598,16 @@ "url": "https://opencollective.com/unified" } }, + "node_modules/reftools": { + "version": "1.1.9", + "resolved": "https://registry.npmjs.org/reftools/-/reftools-1.1.9.tgz", + "integrity": "sha512-OVede/NQE13xBQ+ob5CKd5KyeJYU2YInb1bmV4nRoOfquZPkAkxuOXicSe1PvqIuZZ4kD13sPKBbR7UFDmli6w==", + "dev": true, + "license": "BSD-3-Clause", + "funding": { + "url": "https://github.com/Mermade/oas-kit?sponsor=1" + } + }, "node_modules/regex": { "version": "6.0.1", "resolved": "https://registry.npmjs.org/regex/-/regex-6.0.1.tgz", @@ -5017,6 +5854,25 @@ "url": "https://opencollective.com/unified" } }, + "node_modules/require-directory": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/require-directory/-/require-directory-2.1.1.tgz", + "integrity": "sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/require-from-string": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz", + "integrity": "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, "node_modules/restructure": { "version": "3.0.2", "resolved": "https://registry.npmjs.org/restructure/-/restructure-3.0.2.tgz", @@ -5083,6 +5939,7 @@ "version": "4.45.1", "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.45.1.tgz", "integrity": "sha512-4iya7Jb76fVpQyLoiVpzUrsjQ12r3dM7fIVz+4NwoYvZOShknRmiv+iu9CClZml5ZLGb0XMcYLutK6w9tgxHDw==", + "peer": true, "dependencies": { "@types/estree": "1.0.8" }, @@ -5117,6 +5974,13 @@ "fsevents": "~2.3.2" } }, + "node_modules/safer-buffer": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz", + "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==", + "dev": true, + "license": "MIT" + }, "node_modules/sax": { "version": "1.4.1", "resolved": "https://registry.npmjs.org/sax/-/sax-1.4.1.tgz", @@ -5186,6 +6050,66 @@ "@types/hast": "^3.0.4" } }, + "node_modules/should": { + "version": "13.2.3", + "resolved": "https://registry.npmjs.org/should/-/should-13.2.3.tgz", + "integrity": "sha512-ggLesLtu2xp+ZxI+ysJTmNjh2U0TsC+rQ/pfED9bUZZ4DKefP27D+7YJVVTvKsmjLpIi9jAa7itwDGkDDmt1GQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "should-equal": "^2.0.0", + "should-format": "^3.0.3", + "should-type": "^1.4.0", + "should-type-adaptors": "^1.0.1", + "should-util": "^1.0.0" + } + }, + "node_modules/should-equal": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/should-equal/-/should-equal-2.0.0.tgz", + "integrity": "sha512-ZP36TMrK9euEuWQYBig9W55WPC7uo37qzAEmbjHz4gfyuXrEUgF8cUvQVO+w+d3OMfPvSRQJ22lSm8MQJ43LTA==", + "dev": true, + "license": "MIT", + "dependencies": { + "should-type": "^1.4.0" + } + }, + "node_modules/should-format": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/should-format/-/should-format-3.0.3.tgz", + "integrity": "sha512-hZ58adtulAk0gKtua7QxevgUaXTTXxIi8t41L3zo9AHvjXO1/7sdLECuHeIN2SRtYXpNkmhoUP2pdeWgricQ+Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "should-type": "^1.3.0", + "should-type-adaptors": "^1.0.1" + } + }, + "node_modules/should-type": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/should-type/-/should-type-1.4.0.tgz", + "integrity": "sha512-MdAsTu3n25yDbIe1NeN69G4n6mUnJGtSJHygX3+oN0ZbO3DTiATnf7XnYJdGT42JCXurTb1JI0qOBR65shvhPQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/should-type-adaptors": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/should-type-adaptors/-/should-type-adaptors-1.1.0.tgz", + "integrity": "sha512-JA4hdoLnN+kebEp2Vs8eBe9g7uy0zbRo+RMcU0EsNy+R+k049Ki+N5tT5Jagst2g7EAja+euFuoXFCa8vIklfA==", + "dev": true, + "license": "MIT", + "dependencies": { + "should-type": "^1.3.0", + "should-util": "^1.0.0" + } + }, + "node_modules/should-util": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/should-util/-/should-util-1.0.1.tgz", + "integrity": "sha512-oXF8tfxx5cDk8r2kYqlkUJzZpDBqVY/II2WhvU0n9Y3XYvAYRmeaf1PvvIvTgPnv4KJ+ES5M0PyDq5Jp+Ygy2g==", + "dev": true, + "license": "MIT" + }, "node_modules/simple-swizzle": { "version": "0.2.2", "resolved": "https://registry.npmjs.org/simple-swizzle/-/simple-swizzle-0.2.2.tgz", @@ -5284,6 +6208,25 @@ "astro": "^5.1.6" } }, + "node_modules/starlight-openapi": { + "version": "0.22.1", + "resolved": "https://registry.npmjs.org/starlight-openapi/-/starlight-openapi-0.22.1.tgz", + "integrity": "sha512-hpYYpomwqb7f1wgpV+aV7O7sQu2QuG1VYFN+PZiqYj5RjbiCK0FKSF5YNnCZSfqiZRW3tCahu2JrxVVSqPUI+A==", + "license": "MIT", + "dependencies": { + "@readme/openapi-parser": "^4.1.2", + "github-slugger": "^2.0.0", + "url-template": "^3.1.1" + }, + "engines": { + "node": ">=18.17.1" + }, + "peerDependencies": { + "@astrojs/markdown-remark": ">=6.0.1", + "@astrojs/starlight": ">=0.34.0", + "astro": ">=5.5.0" + } + }, "node_modules/stream-replace-string": { "version": "2.0.0", "resolved": "https://registry.npmjs.org/stream-replace-string/-/stream-replace-string-2.0.0.tgz", @@ -5348,6 +6291,44 @@ "inline-style-parser": "0.2.4" } }, + "node_modules/swagger2openapi": { + "version": "7.0.8", + "resolved": "https://registry.npmjs.org/swagger2openapi/-/swagger2openapi-7.0.8.tgz", + "integrity": "sha512-upi/0ZGkYgEcLeGieoz8gT74oWHA0E7JivX7aN9mAf+Tc7BQoRBvnIGHoPDw+f9TXTW4s6kGYCZJtauP6OYp7g==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "call-me-maybe": "^1.0.1", + "node-fetch": "^2.6.1", + "node-fetch-h2": "^2.3.0", + "node-readfiles": "^0.2.0", + "oas-kit-common": "^1.0.8", + "oas-resolver": "^2.5.6", + "oas-schema-walker": "^1.1.5", + "oas-validator": "^5.0.8", + "reftools": "^1.1.9", + "yaml": "^1.10.0", + "yargs": "^17.0.1" + }, + "bin": { + "boast": "boast.js", + "oas-validate": "oas-validate.js", + "swagger2openapi": "swagger2openapi.js" + }, + "funding": { + "url": "https://github.com/Mermade/oas-kit?sponsor=1" + } + }, + "node_modules/swagger2openapi/node_modules/yaml": { + "version": "1.10.3", + "resolved": "https://registry.npmjs.org/yaml/-/yaml-1.10.3.tgz", + "integrity": "sha512-vIYeF1u3CjlhAFekPPAk2h/Kv4T3mAkMox5OymRiJQB0spDP10LHvt+K7G9Ny6NuuMAb25/6n1qyUjAcGNf/AA==", + "dev": true, + "license": "ISC", + "engines": { + "node": ">= 6" + } + }, "node_modules/tiny-inflate": { "version": "1.0.3", "resolved": "https://registry.npmjs.org/tiny-inflate/-/tiny-inflate-1.0.3.tgz", @@ -5761,11 +6742,68 @@ } } }, + "node_modules/url-template": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/url-template/-/url-template-3.1.1.tgz", + "integrity": "sha512-4oszoaEKE/mQOtAmdMWqIRHmkxWkUZMnXFnjQ5i01CuRSK3uluxcH1MRVVVWmhlnzT1SCDfKxxficm2G37qzCA==", + "license": "BSD-3-Clause", + "engines": { + "node": "^12.20.0 || ^14.13.1 || >=16.0.0" + } + }, "node_modules/util-deprecate": { "version": "1.0.2", "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz", "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==" }, + "node_modules/uuid": { + "version": "8.3.2", + "resolved": "https://registry.npmjs.org/uuid/-/uuid-8.3.2.tgz", + "integrity": "sha512-+NYs2QeMWy+GWFOEm9xnn6HCDp0l7QBD7ml8zLUmJ+93Q5NF0NocErnwkTkXVFNiX3/fpC6afS8Dhb/gz7R7eg==", + "dev": true, + "license": "MIT", + "bin": { + "uuid": "dist/bin/uuid" + } + }, + "node_modules/validate.io-array": { + "version": "1.0.6", + "resolved": "https://registry.npmjs.org/validate.io-array/-/validate.io-array-1.0.6.tgz", + "integrity": "sha512-DeOy7CnPEziggrOO5CZhVKJw6S3Yi7e9e65R1Nl/RTN1vTQKnzjfvks0/8kQ40FP/dsjRAOd4hxmJ7uLa6vxkg==", + "dev": true, + "license": "MIT" + }, + "node_modules/validate.io-function": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/validate.io-function/-/validate.io-function-1.0.2.tgz", + "integrity": "sha512-LlFybRJEriSuBnUhQyG5bwglhh50EpTL2ul23MPIuR1odjO7XaMLFV8vHGwp7AZciFxtYOeiSCT5st+XSPONiQ==", + "dev": true + }, + "node_modules/validate.io-integer": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/validate.io-integer/-/validate.io-integer-1.0.5.tgz", + "integrity": "sha512-22izsYSLojN/P6bppBqhgUDjCkr5RY2jd+N2a3DCAUey8ydvrZ/OkGvFPR7qfOpwR2LC5p4Ngzxz36g5Vgr/hQ==", + "dev": true, + "dependencies": { + "validate.io-number": "^1.0.3" + } + }, + "node_modules/validate.io-integer-array": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/validate.io-integer-array/-/validate.io-integer-array-1.0.0.tgz", + "integrity": "sha512-mTrMk/1ytQHtCY0oNO3dztafHYyGU88KL+jRxWuzfOmQb+4qqnWmI+gykvGp8usKZOM0H7keJHEbRaFiYA0VrA==", + "dev": true, + "dependencies": { + "validate.io-array": "^1.0.3", + "validate.io-integer": "^1.0.4" + } + }, + "node_modules/validate.io-number": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/validate.io-number/-/validate.io-number-1.0.3.tgz", + "integrity": "sha512-kRAyotcbNaSYoDnXvb4MHg/0a1egJdLwS6oJ38TJY7aw9n93Fl/3blIXdyYvPOp55CNxywooG/3BcrwNrBpcSg==", + "dev": true + }, "node_modules/vfile": { "version": "6.0.3", "resolved": "https://registry.npmjs.org/vfile/-/vfile-6.0.3.tgz", @@ -5809,6 +6847,7 @@ "version": "6.3.5", "resolved": "https://registry.npmjs.org/vite/-/vite-6.3.5.tgz", "integrity": "sha512-cZn6NDFE7wdTpINgs++ZJ4N49W2vRp8LCKrn3Ob1kYNtOo21vfDoaV5GzBfLU4MovSAB8uNRm4jgzVQZ+mBzPQ==", + "peer": true, "dependencies": { "esbuild": "^0.25.0", "fdir": "^6.4.4", @@ -5962,6 +7001,35 @@ "resolved": "https://registry.npmjs.org/xxhash-wasm/-/xxhash-wasm-1.1.0.tgz", "integrity": "sha512-147y/6YNh+tlp6nd/2pWq38i9h6mz/EuQ6njIrmW8D1BS5nCqs0P6DG+m6zTGnNz5I+uhZ0SHxBs9BsPrwcKDA==" }, + "node_modules/y18n": { + "version": "5.0.8", + "resolved": "https://registry.npmjs.org/y18n/-/y18n-5.0.8.tgz", + "integrity": "sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==", + "dev": true, + "license": "ISC", + "engines": { + "node": ">=10" + } + }, + "node_modules/yargs": { + "version": "17.7.2", + "resolved": "https://registry.npmjs.org/yargs/-/yargs-17.7.2.tgz", + "integrity": "sha512-7dSzzRQ++CKnNI/krKnYRV7JKKPUXMEh61soaHKg9mrWEhzFWhFnxPxGl+69cD1Ou63C13NUPCnmIcrvqCuM6w==", + "dev": true, + "license": "MIT", + "dependencies": { + "cliui": "^8.0.1", + "escalade": "^3.1.1", + "get-caller-file": "^2.0.5", + "require-directory": "^2.1.1", + "string-width": "^4.2.3", + "y18n": "^5.0.5", + "yargs-parser": "^21.1.1" + }, + "engines": { + "node": ">=12" + } + }, "node_modules/yargs-parser": { "version": "21.1.1", "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-21.1.1.tgz", @@ -5970,6 +7038,51 @@ "node": ">=12" } }, + "node_modules/yargs/node_modules/ansi-regex": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz", + "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/yargs/node_modules/emoji-regex": { + "version": "8.0.0", + "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz", + "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==", + "dev": true, + "license": "MIT" + }, + "node_modules/yargs/node_modules/string-width": { + "version": "4.2.3", + "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz", + "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==", + "dev": true, + "license": "MIT", + "dependencies": { + "emoji-regex": "^8.0.0", + "is-fullwidth-code-point": "^3.0.0", + "strip-ansi": "^6.0.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/yargs/node_modules/strip-ansi": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz", + "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-regex": "^5.0.1" + }, + "engines": { + "node": ">=8" + } + }, "node_modules/yocto-queue": { "version": "1.2.1", "resolved": "https://registry.npmjs.org/yocto-queue/-/yocto-queue-1.2.1.tgz", @@ -6010,6 +7123,7 @@ "version": "3.25.76", "resolved": "https://registry.npmjs.org/zod/-/zod-3.25.76.tgz", "integrity": "sha512-gzUt/qt81nXsFGKIFcC3YnfEAx5NkunCfnDlvuBSSFS02bcXu4Lmea0AFIUwbLWxWPx3d9p8S5QoaujKcNQxcQ==", + "peer": true, "funding": { "url": "https://github.com/sponsors/colinhacks" } diff --git a/package.json b/package.json index 0b92ff4..606f7ea 100644 --- a/package.json +++ b/package.json @@ -16,6 +16,10 @@ "astro-og-canvas": "^0.5.3", "js-cookie": "^3.0.5", "sharp": "^0.33.4", - "starlight-llms-txt": "^0.5.1" + "starlight-llms-txt": "^0.5.1", + "starlight-openapi": "^0.22.1" + }, + "devDependencies": { + "openapi-to-postmanv2": "^6.0.1" } } diff --git a/public/schemas/threat-intel-beta.postman_collection.json b/public/schemas/threat-intel-beta.postman_collection.json new file mode 100644 index 0000000..8a6d981 --- /dev/null +++ b/public/schemas/threat-intel-beta.postman_collection.json @@ -0,0 +1,1782 @@ +{ + "item": [ + { + "name": "List all vulnerabilities", + "request": { + "name": "List all vulnerabilities", + "description": { + "content": "Paginated listing of every published vulnerability for the given\nplatform, ordered by descending `id`.\n\nSupports **two independent pagination strategies**:\n\n- **Offset** (`?page=&per_page=`) — returns a `pagination` block with\n totals. Easy to jump to a specific page; slower at depth and\n susceptible to row-shift when new vulnerabilities land while paging.\n- **Cursor** (`?cursor=`) — returns a `cursor` block with `next_cursor`,\n `has_more`, `per_page`. Stable under concurrent inserts and faster at\n any depth. No `total` count.\n\n`cursor` and `page` are mutually exclusive; passing both returns\n`422 Unprocessable Entity`.\n", + "type": "text/plain" + }, + "url": { + "path": [ + "all" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "key": "platform", + "value": "wordpress", + "description": "Platform to query. Case-insensitive." + }, + { + "disabled": false, + "key": "page", + "value": "1", + "description": "Offset-pagination page (1-indexed). Mutually exclusive with `cursor`." + }, + { + "disabled": false, + "key": "per_page", + "value": "100", + "description": "Page size." + }, + { + "disabled": false, + "key": "cursor", + "value": "string", + "description": "Opaque cursor. Presence of the param switches to cursor mode (send an\nempty value to bootstrap). Mutually exclusive with `page`.\n" + }, + { + "disabled": false, + "key": "include", + "value": "details", + "description": "Pass `details` to include the full advisory body (`advisory_details`) per item." + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "auth": null + }, + "response": [ + { + "name": "Paginated vulnerability listing.", + "originalRequest": { + "url": { + "path": [ + "all" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "key": "platform", + "value": "wordpress" + }, + { + "key": "page", + "value": "1" + }, + { + "key": "per_page", + "value": "100" + }, + { + "key": "cursor", + "value": "string" + }, + { + "key": "include", + "value": "details" + } + ], + "variable": [] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"vulnerabilities\": [],\n \"pagination\": {\n \"current_page\": 1,\n \"per_page\": 25,\n \"total\": 6115,\n \"total_pages\": 245,\n \"has_next_page\": true,\n \"has_previous_page\": false,\n \"next_page\": 2,\n \"previous_page\": null,\n \"from\": 1,\n \"to\": 25\n }\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "name": "Missing or invalid `PSKey` header.", + "originalRequest": { + "url": { + "path": [ + "all" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "key": "platform", + "value": "wordpress" + }, + { + "key": "page", + "value": "1" + }, + { + "key": "per_page", + "value": "100" + }, + { + "key": "cursor", + "value": "string" + }, + { + "key": "include", + "value": "details" + } + ], + "variable": [] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "GET", + "body": {} + }, + "status": "Unauthorized", + "code": 401, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + }, + { + "name": "API key not authorised for the requested endpoint.", + "originalRequest": { + "url": { + "path": [ + "all" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "key": "platform", + "value": "wordpress" + }, + { + "key": "page", + "value": "1" + }, + { + "key": "per_page", + "value": "100" + }, + { + "key": "cursor", + "value": "string" + }, + { + "key": "include", + "value": "details" + } + ], + "variable": [] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "GET", + "body": {} + }, + "status": "Forbidden", + "code": 403, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + }, + { + "name": "Invalid parameter combination (e.g. `cursor` + `page`), invalid `platform`, or `per_page > 500`.", + "originalRequest": { + "url": { + "path": [ + "all" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "key": "platform", + "value": "wordpress" + }, + { + "key": "page", + "value": "1" + }, + { + "key": "per_page", + "value": "100" + }, + { + "key": "cursor", + "value": "string" + }, + { + "key": "include", + "value": "details" + } + ], + "variable": [] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "GET", + "body": {} + }, + "status": "Unprocessable Entity (WebDAV) (RFC 4918)", + "code": 422, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + }, + { + "name": "Rate limit exceeded.", + "originalRequest": { + "url": { + "path": [ + "all" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "key": "platform", + "value": "wordpress" + }, + { + "key": "page", + "value": "1" + }, + { + "key": "per_page", + "value": "100" + }, + { + "key": "cursor", + "value": "string" + }, + { + "key": "include", + "value": "details" + } + ], + "variable": [] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "GET", + "body": {} + }, + "status": "Too Many Requests", + "code": 429, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "name": "Latest vulnerabilities (last 24 hours)", + "request": { + "name": "Latest vulnerabilities (last 24 hours)", + "description": { + "content": "Returns vulnerabilities whose row was inserted into the Patchstack\ndatabase in the last 24 hours. The filter is on `created_at`\n(insertion time), **not** `disclosure_date`.\n\nAccepts the same query parameters as `/all`.\n", + "type": "text/plain" + }, + "url": { + "path": [ + "latest" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "key": "platform", + "value": "wordpress", + "description": "Platform to query. Case-insensitive." + }, + { + "disabled": false, + "key": "page", + "value": "1", + "description": "Offset-pagination page (1-indexed). Mutually exclusive with `cursor`." + }, + { + "disabled": false, + "key": "per_page", + "value": "100", + "description": "Page size." + }, + { + "disabled": false, + "key": "cursor", + "value": "string", + "description": "Opaque cursor. Presence of the param switches to cursor mode (send an\nempty value to bootstrap). Mutually exclusive with `page`.\n" + }, + { + "disabled": false, + "key": "include", + "value": "details", + "description": "Pass `details` to include the full advisory body (`advisory_details`) per item." + } + ], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "auth": null + }, + "response": [ + { + "name": "Paginated 24h vulnerability listing.", + "originalRequest": { + "url": { + "path": [ + "latest" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "key": "platform", + "value": "wordpress" + }, + { + "key": "page", + "value": "1" + }, + { + "key": "per_page", + "value": "100" + }, + { + "key": "cursor", + "value": "string" + }, + { + "key": "include", + "value": "details" + } + ], + "variable": [] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"vulnerabilities\": [\n {\n \"id\": 46500,\n \"title\": \"NPM: OpenClaw: ...\",\n \"disclosed_at\": \"2026-04-03T03:15:56+00:00\",\n \"created_at\": \"2026-04-21T08:38:34+00:00\",\n \"url\": \"https://patchstack.com/database/npm/npm/openclaw/vulnerability/...\",\n \"vuln_type\": \"Other Vulnerability Type\",\n \"cve\": \"2026-41331\",\n \"is_exploited\": false,\n \"patch_priority\": 2,\n \"advisory_details\": \"## Summary\\n...\",\n \"product\": {\n \"id\": 23595,\n \"name\": \"openclaw\",\n \"slug\": \"openclaw\"\n },\n \"cvss\": {\n \"score\": 6.9,\n \"vector\": \"CVSS:4.0/AV:N/AC:L/AT:N/PR:N/UI:N/VC:N/VI:N/VA:L/SC:N/SI:N/SA:N\"\n },\n \"cwe\": {\n \"id\": 770,\n \"name\": \"Allocation of Resources Without Limits or Throttling\"\n },\n \"capec\": {\n \"id\": null,\n \"name\": null\n },\n \"references\": [\n \"https://github.com/openclaw/openclaw/security/advisories/GHSA-m6fx-m8hc-572m\",\n \"https://github.com/openclaw/openclaw/releases/tag/v2026.3.31\"\n ],\n \"ghsa\": \"GHSA-m6fx-m8hc-572m\",\n \"version_info\": {\n \"affected\": \"<= 2026.3.28\",\n \"fixed\": \"2026.3.31\"\n }\n },\n {\n \"id\": 46500,\n \"title\": \"NPM: OpenClaw: ...\",\n \"disclosed_at\": \"2026-04-03T03:15:56+00:00\",\n \"created_at\": \"2026-04-21T08:38:34+00:00\",\n \"url\": \"https://patchstack.com/database/npm/npm/openclaw/vulnerability/...\",\n \"vuln_type\": \"Other Vulnerability Type\",\n \"cve\": \"2026-41331\",\n \"is_exploited\": false,\n \"patch_priority\": 2,\n \"advisory_details\": \"## Summary\\n...\",\n \"product\": {\n \"id\": 23595,\n \"name\": \"openclaw\",\n \"slug\": \"openclaw\"\n },\n \"cvss\": {\n \"score\": 6.9,\n \"vector\": \"CVSS:4.0/AV:N/AC:L/AT:N/PR:N/UI:N/VC:N/VI:N/VA:L/SC:N/SI:N/SA:N\"\n },\n \"cwe\": {\n \"id\": 770,\n \"name\": \"Allocation of Resources Without Limits or Throttling\"\n },\n \"capec\": {\n \"id\": null,\n \"name\": null\n },\n \"references\": [\n \"https://github.com/openclaw/openclaw/security/advisories/GHSA-m6fx-m8hc-572m\",\n \"https://github.com/openclaw/openclaw/releases/tag/v2026.3.31\"\n ],\n \"ghsa\": \"GHSA-m6fx-m8hc-572m\",\n \"version_info\": {\n \"affected\": \"<= 2026.3.28\",\n \"fixed\": \"2026.3.31\"\n }\n }\n ],\n \"pagination\": {\n \"current_page\": 1,\n \"per_page\": 25,\n \"total\": 6115,\n \"total_pages\": 245,\n \"has_next_page\": true,\n \"has_previous_page\": false,\n \"from\": 1,\n \"to\": 25,\n \"next_page\": 2,\n \"previous_page\": null\n }\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "name": "Missing or invalid `PSKey` header.", + "originalRequest": { + "url": { + "path": [ + "latest" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "key": "platform", + "value": "wordpress" + }, + { + "key": "page", + "value": "1" + }, + { + "key": "per_page", + "value": "100" + }, + { + "key": "cursor", + "value": "string" + }, + { + "key": "include", + "value": "details" + } + ], + "variable": [] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "GET", + "body": {} + }, + "status": "Unauthorized", + "code": 401, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + }, + { + "name": "API key not authorised for the requested endpoint.", + "originalRequest": { + "url": { + "path": [ + "latest" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "key": "platform", + "value": "wordpress" + }, + { + "key": "page", + "value": "1" + }, + { + "key": "per_page", + "value": "100" + }, + { + "key": "cursor", + "value": "string" + }, + { + "key": "include", + "value": "details" + } + ], + "variable": [] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "GET", + "body": {} + }, + "status": "Forbidden", + "code": 403, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + }, + { + "name": "Invalid parameter combination (e.g. `cursor` + `page`), invalid `platform`, or `per_page > 500`.", + "originalRequest": { + "url": { + "path": [ + "latest" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "key": "platform", + "value": "wordpress" + }, + { + "key": "page", + "value": "1" + }, + { + "key": "per_page", + "value": "100" + }, + { + "key": "cursor", + "value": "string" + }, + { + "key": "include", + "value": "details" + } + ], + "variable": [] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "GET", + "body": {} + }, + "status": "Unprocessable Entity (WebDAV) (RFC 4918)", + "code": 422, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + }, + { + "name": "Rate limit exceeded.", + "originalRequest": { + "url": { + "path": [ + "latest" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "key": "platform", + "value": "wordpress" + }, + { + "key": "page", + "value": "1" + }, + { + "key": "per_page", + "value": "100" + }, + { + "key": "cursor", + "value": "string" + }, + { + "key": "include", + "value": "details" + } + ], + "variable": [] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "GET", + "body": {} + }, + "status": "Too Many Requests", + "code": 429, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "name": "product/{type}/{name}/{version}", + "item": [ + { + "name": "Find vulnerabilities for a product", + "request": { + "name": "Find vulnerabilities for a product", + "description": { + "content": "Match a specific product + version against the vulnerability database\nand return every applicable advisory.\n\nnpm package slugs that include a `/` (e.g. `@scope/pkg`) conflict with\nthe route separator. URL-encode the `/` as `%2F`.\n", + "type": "text/plain" + }, + "url": { + "path": [ + "product", + ":type", + ":name", + ":version" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "disabled": false, + "key": "include", + "value": "details", + "description": "Pass `details` to include the full advisory body (`advisory_details`) per item." + } + ], + "variable": [ + { + "disabled": false, + "type": "any", + "value": "npm", + "key": "type", + "description": "(Required) Product ecosystem." + }, + { + "disabled": false, + "type": "any", + "value": "axios", + "key": "name", + "description": "(Required) npm package slug or WordPress plugin/theme slug. Use `wordpress` when `type=wordpress`." + }, + { + "disabled": false, + "type": "any", + "value": "0.21.4", + "key": "version", + "description": "(Required) Concrete version (e.g. `0.21.4`) or `*` to return every advisory for the product." + } + ] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "auth": null + }, + "response": [ + { + "name": "Matched advisories (possibly empty).", + "originalRequest": { + "url": { + "path": [ + "product", + ":type", + ":name", + ":version" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "key": "include", + "value": "details" + } + ], + "variable": [ + { + "disabled": false, + "type": "any", + "value": "npm", + "key": "type", + "description": "(Required) Product ecosystem." + }, + { + "disabled": false, + "type": "any", + "value": "axios", + "key": "name", + "description": "(Required) npm package slug or WordPress plugin/theme slug. Use `wordpress` when `type=wordpress`." + }, + { + "disabled": false, + "type": "any", + "value": "0.21.4", + "key": "version", + "description": "(Required) Concrete version (e.g. `0.21.4`) or `*` to return every advisory for the product." + } + ] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"vulnerabilities\": [\n {\n \"id\": 46500,\n \"title\": \"NPM: OpenClaw: ...\",\n \"disclosed_at\": \"2026-04-03T03:15:56+00:00\",\n \"created_at\": \"2026-04-21T08:38:34+00:00\",\n \"url\": \"https://patchstack.com/database/npm/npm/openclaw/vulnerability/...\",\n \"vuln_type\": \"Other Vulnerability Type\",\n \"cve\": \"2026-41331\",\n \"is_exploited\": false,\n \"patch_priority\": 2,\n \"advisory_details\": \"## Summary\\n...\",\n \"product\": {\n \"id\": 23595,\n \"name\": \"openclaw\",\n \"slug\": \"openclaw\"\n },\n \"cvss\": {\n \"score\": 6.9,\n \"vector\": \"CVSS:4.0/AV:N/AC:L/AT:N/PR:N/UI:N/VC:N/VI:N/VA:L/SC:N/SI:N/SA:N\"\n },\n \"cwe\": {\n \"id\": 770,\n \"name\": \"Allocation of Resources Without Limits or Throttling\"\n },\n \"capec\": {\n \"id\": null,\n \"name\": null\n },\n \"references\": [\n \"https://github.com/openclaw/openclaw/security/advisories/GHSA-m6fx-m8hc-572m\",\n \"https://github.com/openclaw/openclaw/releases/tag/v2026.3.31\"\n ],\n \"ghsa\": \"GHSA-m6fx-m8hc-572m\",\n \"version_info\": {\n \"affected\": \"<= 2026.3.28\",\n \"fixed\": \"2026.3.31\"\n }\n },\n {\n \"id\": 46500,\n \"title\": \"NPM: OpenClaw: ...\",\n \"disclosed_at\": \"2026-04-03T03:15:56+00:00\",\n \"created_at\": \"2026-04-21T08:38:34+00:00\",\n \"url\": \"https://patchstack.com/database/npm/npm/openclaw/vulnerability/...\",\n \"vuln_type\": \"Other Vulnerability Type\",\n \"cve\": \"2026-41331\",\n \"is_exploited\": false,\n \"patch_priority\": 2,\n \"advisory_details\": \"## Summary\\n...\",\n \"product\": {\n \"id\": 23595,\n \"name\": \"openclaw\",\n \"slug\": \"openclaw\"\n },\n \"cvss\": {\n \"score\": 6.9,\n \"vector\": \"CVSS:4.0/AV:N/AC:L/AT:N/PR:N/UI:N/VC:N/VI:N/VA:L/SC:N/SI:N/SA:N\"\n },\n \"cwe\": {\n \"id\": 770,\n \"name\": \"Allocation of Resources Without Limits or Throttling\"\n },\n \"capec\": {\n \"id\": null,\n \"name\": null\n },\n \"references\": [\n \"https://github.com/openclaw/openclaw/security/advisories/GHSA-m6fx-m8hc-572m\",\n \"https://github.com/openclaw/openclaw/releases/tag/v2026.3.31\"\n ],\n \"ghsa\": \"GHSA-m6fx-m8hc-572m\",\n \"version_info\": {\n \"affected\": \"<= 2026.3.28\",\n \"fixed\": \"2026.3.31\"\n }\n }\n ]\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "name": "Missing or invalid `PSKey` header.", + "originalRequest": { + "url": { + "path": [ + "product", + ":type", + ":name", + ":version" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "key": "include", + "value": "details" + } + ], + "variable": [ + { + "disabled": false, + "type": "any", + "value": "npm", + "key": "type", + "description": "(Required) Product ecosystem." + }, + { + "disabled": false, + "type": "any", + "value": "axios", + "key": "name", + "description": "(Required) npm package slug or WordPress plugin/theme slug. Use `wordpress` when `type=wordpress`." + }, + { + "disabled": false, + "type": "any", + "value": "0.21.4", + "key": "version", + "description": "(Required) Concrete version (e.g. `0.21.4`) or `*` to return every advisory for the product." + } + ] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "GET", + "body": {} + }, + "status": "Unauthorized", + "code": 401, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + }, + { + "name": "API key not authorised for the requested endpoint.", + "originalRequest": { + "url": { + "path": [ + "product", + ":type", + ":name", + ":version" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "key": "include", + "value": "details" + } + ], + "variable": [ + { + "disabled": false, + "type": "any", + "value": "npm", + "key": "type", + "description": "(Required) Product ecosystem." + }, + { + "disabled": false, + "type": "any", + "value": "axios", + "key": "name", + "description": "(Required) npm package slug or WordPress plugin/theme slug. Use `wordpress` when `type=wordpress`." + }, + { + "disabled": false, + "type": "any", + "value": "0.21.4", + "key": "version", + "description": "(Required) Concrete version (e.g. `0.21.4`) or `*` to return every advisory for the product." + } + ] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "GET", + "body": {} + }, + "status": "Forbidden", + "code": 403, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + }, + { + "name": "Invalid parameter combination (e.g. `cursor` + `page`), invalid `platform`, or `per_page > 500`.", + "originalRequest": { + "url": { + "path": [ + "product", + ":type", + ":name", + ":version" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "key": "include", + "value": "details" + } + ], + "variable": [ + { + "disabled": false, + "type": "any", + "value": "npm", + "key": "type", + "description": "(Required) Product ecosystem." + }, + { + "disabled": false, + "type": "any", + "value": "axios", + "key": "name", + "description": "(Required) npm package slug or WordPress plugin/theme slug. Use `wordpress` when `type=wordpress`." + }, + { + "disabled": false, + "type": "any", + "value": "0.21.4", + "key": "version", + "description": "(Required) Concrete version (e.g. `0.21.4`) or `*` to return every advisory for the product." + } + ] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "GET", + "body": {} + }, + "status": "Unprocessable Entity (WebDAV) (RFC 4918)", + "code": 422, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + }, + { + "name": "Rate limit exceeded.", + "originalRequest": { + "url": { + "path": [ + "product", + ":type", + ":name", + ":version" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [ + { + "key": "include", + "value": "details" + } + ], + "variable": [ + { + "disabled": false, + "type": "any", + "value": "npm", + "key": "type", + "description": "(Required) Product ecosystem." + }, + { + "disabled": false, + "type": "any", + "value": "axios", + "key": "name", + "description": "(Required) npm package slug or WordPress plugin/theme slug. Use `wordpress` when `type=wordpress`." + }, + { + "disabled": false, + "type": "any", + "value": "0.21.4", + "key": "version", + "description": "(Required) Concrete version (e.g. `0.21.4`) or `*` to return every advisory for the product." + } + ] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "GET", + "body": {} + }, + "status": "Too Many Requests", + "code": 429, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "name": "Boolean exists check for a product", + "request": { + "name": "Boolean exists check for a product", + "description": { + "content": "Boolean-only variant of the product lookup. Returns `{ \"vulnerable\": true }`\nor `{ \"vulnerable\": false }` without the advisory payload — useful for\nlightweight health checks and dashboard tiles where the advisory body\nisn't needed.\n", + "type": "text/plain" + }, + "url": { + "path": [ + "product", + ":type", + ":name", + ":version", + "exists" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "disabled": false, + "type": "any", + "value": "npm", + "key": "type", + "description": "(Required) Product ecosystem." + }, + { + "disabled": false, + "type": "any", + "value": "axios", + "key": "name", + "description": "(Required) npm package slug or WordPress plugin/theme slug. Use `wordpress` when `type=wordpress`." + }, + { + "disabled": false, + "type": "any", + "value": "0.21.4", + "key": "version", + "description": "(Required) Concrete version (e.g. `0.21.4`) or `*` to return every advisory for the product." + } + ] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "auth": null + }, + "response": [ + { + "name": "Boolean result.", + "originalRequest": { + "url": { + "path": [ + "product", + ":type", + ":name", + ":version", + "exists" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "disabled": false, + "type": "any", + "value": "npm", + "key": "type", + "description": "(Required) Product ecosystem." + }, + { + "disabled": false, + "type": "any", + "value": "axios", + "key": "name", + "description": "(Required) npm package slug or WordPress plugin/theme slug. Use `wordpress` when `type=wordpress`." + }, + { + "disabled": false, + "type": "any", + "value": "0.21.4", + "key": "version", + "description": "(Required) Concrete version (e.g. `0.21.4`) or `*` to return every advisory for the product." + } + ] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"vulnerable\": true\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "name": "Missing or invalid `PSKey` header.", + "originalRequest": { + "url": { + "path": [ + "product", + ":type", + ":name", + ":version", + "exists" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "disabled": false, + "type": "any", + "value": "npm", + "key": "type", + "description": "(Required) Product ecosystem." + }, + { + "disabled": false, + "type": "any", + "value": "axios", + "key": "name", + "description": "(Required) npm package slug or WordPress plugin/theme slug. Use `wordpress` when `type=wordpress`." + }, + { + "disabled": false, + "type": "any", + "value": "0.21.4", + "key": "version", + "description": "(Required) Concrete version (e.g. `0.21.4`) or `*` to return every advisory for the product." + } + ] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "GET", + "body": {} + }, + "status": "Unauthorized", + "code": 401, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + }, + { + "name": "API key not authorised for the requested endpoint.", + "originalRequest": { + "url": { + "path": [ + "product", + ":type", + ":name", + ":version", + "exists" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "disabled": false, + "type": "any", + "value": "npm", + "key": "type", + "description": "(Required) Product ecosystem." + }, + { + "disabled": false, + "type": "any", + "value": "axios", + "key": "name", + "description": "(Required) npm package slug or WordPress plugin/theme slug. Use `wordpress` when `type=wordpress`." + }, + { + "disabled": false, + "type": "any", + "value": "0.21.4", + "key": "version", + "description": "(Required) Concrete version (e.g. `0.21.4`) or `*` to return every advisory for the product." + } + ] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "GET", + "body": {} + }, + "status": "Forbidden", + "code": 403, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + }, + { + "name": "Rate limit exceeded.", + "originalRequest": { + "url": { + "path": [ + "product", + ":type", + ":name", + ":version", + "exists" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "disabled": false, + "type": "any", + "value": "npm", + "key": "type", + "description": "(Required) Product ecosystem." + }, + { + "disabled": false, + "type": "any", + "value": "axios", + "key": "name", + "description": "(Required) npm package slug or WordPress plugin/theme slug. Use `wordpress` when `type=wordpress`." + }, + { + "disabled": false, + "type": "any", + "value": "0.21.4", + "key": "version", + "description": "(Required) Concrete version (e.g. `0.21.4`) or `*` to return every advisory for the product." + } + ] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "GET", + "body": {} + }, + "status": "Too Many Requests", + "code": 429, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + } + ], + "event": [] + }, + { + "name": "Bulk product check", + "request": { + "name": "Bulk product check", + "description": { + "content": "Check up to 50 products in a single request. Mirrors the format\ndocumented for the Extended tier's `/batch` endpoint.\n\nThe payload is a raw JSON array (not wrapped in an object). Each item\nis `{ \"type\", \"name\", \"version\", \"exists\"? }` — when `exists: true`\nthe result for that item is boolean-only; otherwise it's the full\nadvisory list for the product.\n", + "type": "text/plain" + }, + "url": { + "path": [ + "batch" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "auth": null, + "body": { + "mode": "raw", + "raw": "[\n {\n \"type\": \"npm\",\n \"name\": \"axios\",\n \"version\": \"0.21.4\",\n \"exists\": false\n },\n {\n \"type\": \"plugin\",\n \"name\": \"tutor\",\n \"version\": \"1.5.2\",\n \"exists\": true\n },\n {\n \"type\": \"wordpress\",\n \"name\": \"wordpress\",\n \"version\": \"6.0.0\",\n \"exists\": true\n }\n]", + "options": { + "raw": { + "language": "json" + } + } + } + }, + "response": [ + { + "name": "Per-item results, in request order.", + "originalRequest": { + "url": { + "path": [ + "batch" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "[\n {\n \"type\": \"npm\",\n \"name\": \"axios\",\n \"version\": \"0.21.4\",\n \"exists\": false\n },\n {\n \"type\": \"plugin\",\n \"name\": \"tutor\",\n \"version\": \"1.5.2\",\n \"exists\": true\n },\n {\n \"type\": \"wordpress\",\n \"name\": \"wordpress\",\n \"version\": \"6.0.0\",\n \"exists\": true\n }\n]", + "options": { + "raw": { + "language": "json" + } + } + } + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "[]", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "name": "Missing or invalid `PSKey` header.", + "originalRequest": { + "url": { + "path": [ + "batch" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "[\n {\n \"type\": \"npm\",\n \"name\": \"axios\",\n \"version\": \"0.21.4\",\n \"exists\": false\n },\n {\n \"type\": \"plugin\",\n \"name\": \"tutor\",\n \"version\": \"1.5.2\",\n \"exists\": true\n },\n {\n \"type\": \"wordpress\",\n \"name\": \"wordpress\",\n \"version\": \"6.0.0\",\n \"exists\": true\n }\n]", + "options": { + "raw": { + "language": "json" + } + } + } + }, + "status": "Unauthorized", + "code": 401, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + }, + { + "name": "API key not authorised for the requested endpoint.", + "originalRequest": { + "url": { + "path": [ + "batch" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "[\n {\n \"type\": \"npm\",\n \"name\": \"axios\",\n \"version\": \"0.21.4\",\n \"exists\": false\n },\n {\n \"type\": \"plugin\",\n \"name\": \"tutor\",\n \"version\": \"1.5.2\",\n \"exists\": true\n },\n {\n \"type\": \"wordpress\",\n \"name\": \"wordpress\",\n \"version\": \"6.0.0\",\n \"exists\": true\n }\n]", + "options": { + "raw": { + "language": "json" + } + } + } + }, + "status": "Forbidden", + "code": 403, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + }, + { + "name": "Invalid parameter combination (e.g. `cursor` + `page`), invalid `platform`, or `per_page > 500`.", + "originalRequest": { + "url": { + "path": [ + "batch" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "[\n {\n \"type\": \"npm\",\n \"name\": \"axios\",\n \"version\": \"0.21.4\",\n \"exists\": false\n },\n {\n \"type\": \"plugin\",\n \"name\": \"tutor\",\n \"version\": \"1.5.2\",\n \"exists\": true\n },\n {\n \"type\": \"wordpress\",\n \"name\": \"wordpress\",\n \"version\": \"6.0.0\",\n \"exists\": true\n }\n]", + "options": { + "raw": { + "language": "json" + } + } + } + }, + "status": "Unprocessable Entity (WebDAV) (RFC 4918)", + "code": 422, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + }, + { + "name": "Rate limit exceeded.", + "originalRequest": { + "url": { + "path": [ + "batch" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "[\n {\n \"type\": \"npm\",\n \"name\": \"axios\",\n \"version\": \"0.21.4\",\n \"exists\": false\n },\n {\n \"type\": \"plugin\",\n \"name\": \"tutor\",\n \"version\": \"1.5.2\",\n \"exists\": true\n },\n {\n \"type\": \"wordpress\",\n \"name\": \"wordpress\",\n \"version\": \"6.0.0\",\n \"exists\": true\n }\n]", + "options": { + "raw": { + "language": "json" + } + } + } + }, + "status": "Too Many Requests", + "code": 429, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + } + ], + "event": [], + "variable": [ + { + "type": "string", + "value": "https://patchstack.com/database/api/beta", + "key": "baseUrl" + } + ], + "auth": { + "type": "apikey", + "apikey": [ + { + "key": "key", + "value": "PSKey" + }, + { + "key": "value", + "value": "{{apiKey}}" + }, + { + "key": "in", + "value": "header" + } + ] + }, + "info": { + "name": "Patchstack Threat Intelligence API — Beta", + "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", + "description": { + "content": "The Beta endpoints live alongside the v2 API and add npm coverage, an optional\nfull advisory body, a consistent nested response shape, and cursor pagination.\nThey are the recommended endpoints for new integrations; v2 remains available\nfor backwards compatibility.\n\n## Authentication\n\nEvery request must include your API key in the `PSKey` HTTP request header.\nRequest a key via .\n\n## Platforms\n\nPass `?platform=npm` (or `?platform=wordpress` — the default) on list\nendpoints. Platform names are case-insensitive.\n\n## Pagination\n\n`/all` and `/latest` support two independent strategies, selected by which\nquery parameter you pass:\n\n- **Offset** (`?page=&per_page=`) — returns totals; easy to jump to a\n specific page; susceptible to row-shift when new rows land while paging.\n- **Cursor** (`?cursor=`) — stable under concurrent inserts, faster at\n depth, no `total` count. Bootstrap with an empty value: `?cursor=`.\n\n`cursor` and `page` are mutually exclusive; passing both returns `422`.\n\n## Including full advisory bodies\n\nPass `?include=details` on any list endpoint to add an `advisory_details`\nmarkdown field to each item.\n\n## Scoped npm packages\n\nnpm package slugs that include a `/` (e.g. `@scope/pkg`) conflict with the\nroute separator. URL-encode the `/` as `%2F`.\n\n## Rate limiting\n\nSame policy as the Extended Threat Intelligence API. Contact\n if you need an elevated quota.\n\n## Errors\n\n| Status | Meaning |\n|---|---|\n| `401` | Missing or invalid `PSKey` header. |\n| `403` | API key not authorised for the requested endpoint. |\n| `422` | Invalid parameter combination or value (e.g. `cursor` + `page`, invalid `platform`, `per_page > 500`). |\n| `429` | Rate limit exceeded. |\n| `500` | Server error — include the request id in any bug report. |\n\nA malformed cursor returns `200` with an empty page rather than an error:\n\n```json\n{ \"vulnerabilities\": [], \"cursor\": { \"next_cursor\": null, \"has_more\": false, \"per_page\": 100 } }\n```\n\n## Related pages\n\n- Narrative guide with code samples: [Beta tier API](/api-solutions/threat-intelligence-api/beta/)\n- OpenAPI spec (import into Postman / Insomnia / Bruno / Hoppscotch): \n- Postman collection (pre-imported): \n\nIntegration questions: .\n\n\nContact Support:\n Name: Patchstack\n Email: dave.jong@patchstack.com", + "type": "text/plain" + } + } +} \ No newline at end of file diff --git a/public/schemas/threat-intel-beta.yaml b/public/schemas/threat-intel-beta.yaml new file mode 100644 index 0000000..5b77a43 --- /dev/null +++ b/public/schemas/threat-intel-beta.yaml @@ -0,0 +1,652 @@ +openapi: 3.1.0 +info: + title: Patchstack Threat Intelligence API — Beta + version: beta + summary: npm + WordPress vulnerability intelligence with nested response shape and cursor pagination. + description: | + The Beta endpoints live alongside the v2 API and add npm coverage, an optional + full advisory body, a consistent nested response shape, and cursor pagination. + They are the recommended endpoints for new integrations; v2 remains available + for backwards compatibility. + + ## Authentication + + Every request must include your API key in the `PSKey` HTTP request header. + Request a key via . + + ## Platforms + + Pass `?platform=npm` (or `?platform=wordpress` — the default) on list + endpoints. Platform names are case-insensitive. + + ## Pagination + + `/all` and `/latest` support two independent strategies, selected by which + query parameter you pass: + + - **Offset** (`?page=&per_page=`) — returns totals; easy to jump to a + specific page; susceptible to row-shift when new rows land while paging. + - **Cursor** (`?cursor=`) — stable under concurrent inserts, faster at + depth, no `total` count. Bootstrap with an empty value: `?cursor=`. + + `cursor` and `page` are mutually exclusive; passing both returns `422`. + + ## Including full advisory bodies + + Pass `?include=details` on any list endpoint to add an `advisory_details` + markdown field to each item. + + ## Scoped npm packages + + npm package slugs that include a `/` (e.g. `@scope/pkg`) conflict with the + route separator. URL-encode the `/` as `%2F`. + + ## Rate limiting + + Same policy as the Extended Threat Intelligence API. Contact + if you need an elevated quota. + + ## Errors + + | Status | Meaning | + |---|---| + | `401` | Missing or invalid `PSKey` header. | + | `403` | API key not authorised for the requested endpoint. | + | `422` | Invalid parameter combination or value (e.g. `cursor` + `page`, invalid `platform`, `per_page > 500`). | + | `429` | Rate limit exceeded. | + | `500` | Server error — include the request id in any bug report. | + + A malformed cursor returns `200` with an empty page rather than an error: + + ```json + { "vulnerabilities": [], "cursor": { "next_cursor": null, "has_more": false, "per_page": 100 } } + ``` + + ## Related pages + + - Narrative guide with code samples: [Beta tier API](/api-solutions/threat-intelligence-api/beta/) + - OpenAPI spec (import into Postman / Insomnia / Bruno / Hoppscotch): + - Postman collection (pre-imported): + + Integration questions: . + contact: + name: Patchstack + url: https://patchstack.com/for-hosts/ + email: dave.jong@patchstack.com + +servers: + - url: https://patchstack.com/database/api/beta + description: Production + +security: + - PSKey: [] + +tags: + - name: Vulnerabilities + description: | + Listing endpoints that return published vulnerabilities for a platform, + ordered by descending `id`. + + - [`GET /all`](/api-reference/threat-intelligence-beta/operations/listallvulnerabilities/) + — every published vulnerability for the platform, paginated. + - [`GET /latest`](/api-reference/threat-intelligence-beta/operations/listlatestvulnerabilities/) + — vulnerabilities whose row was inserted in the last 24 hours (filter + is on `created_at`, not `disclosure_date`). + + Both endpoints share the same response shape and support offset and + cursor pagination — see the overview for details. + - name: Products + description: | + Match a specific product + version against the vulnerability database + and return every applicable advisory. + + - [`GET /product/{type}/{name}/{version}`](/api-reference/threat-intelligence-beta/operations/findproductvulnerabilities/) + — full advisory list for the product. Use `version=*` to return every + advisory for the product regardless of version. + - [`GET /product/{type}/{name}/{version}/exists`](/api-reference/threat-intelligence-beta/operations/productvulnerabilityexists/) + — boolean-only variant for fast "is this vulnerable?" checks. + + `type` accepts `npm`, `plugin`, `theme`, or `wordpress`. For scoped npm + packages, URL-encode the `/` as `%2F`. + - name: Batch + description: | + Bulk endpoint for checking up to 50 products in a single request. Use + this when walking a dependency manifest (e.g. `package.json` or a list + of installed WordPress plugins) — it's significantly cheaper than + issuing one request per product. + + - [`POST /batch`](/api-reference/threat-intelligence-beta/operations/batchproductcheck/) + — payload is a JSON array of up to 50 `{type, name, version, exists?}` + objects. Per-item results are returned in request order. + +paths: + /all: + get: + tags: [Vulnerabilities] + summary: List all vulnerabilities + description: | + Paginated listing of every published vulnerability for the given + platform, ordered by descending `id`. + + Supports **two independent pagination strategies**: + + - **Offset** (`?page=&per_page=`) — returns a `pagination` block with + totals. Easy to jump to a specific page; slower at depth and + susceptible to row-shift when new vulnerabilities land while paging. + - **Cursor** (`?cursor=`) — returns a `cursor` block with `next_cursor`, + `has_more`, `per_page`. Stable under concurrent inserts and faster at + any depth. No `total` count. + + `cursor` and `page` are mutually exclusive; passing both returns + `422 Unprocessable Entity`. + operationId: listAllVulnerabilities + parameters: + - $ref: '#/components/parameters/Platform' + - $ref: '#/components/parameters/Page' + - $ref: '#/components/parameters/PerPage' + - $ref: '#/components/parameters/Cursor' + - $ref: '#/components/parameters/Include' + responses: + '200': + description: Paginated vulnerability listing. + content: + application/json: + schema: + oneOf: + - $ref: '#/components/schemas/OffsetVulnerabilityList' + - $ref: '#/components/schemas/CursorVulnerabilityList' + examples: + offset: + summary: Offset mode + value: + vulnerabilities: [] + pagination: + current_page: 1 + per_page: 25 + total: 6115 + total_pages: 245 + has_next_page: true + has_previous_page: false + next_page: 2 + previous_page: null + from: 1 + to: 25 + cursor: + summary: Cursor mode + value: + vulnerabilities: [] + cursor: + next_cursor: djE6NDYzMzk + has_more: true + per_page: 25 + '401': { $ref: '#/components/responses/Unauthorized' } + '403': { $ref: '#/components/responses/Forbidden' } + '422': { $ref: '#/components/responses/UnprocessableEntity' } + '429': { $ref: '#/components/responses/TooManyRequests' } + + /latest: + get: + tags: [Vulnerabilities] + summary: Latest vulnerabilities (last 24 hours) + description: | + Returns vulnerabilities whose row was inserted into the Patchstack + database in the last 24 hours. The filter is on `created_at` + (insertion time), **not** `disclosure_date`. + + Accepts the same query parameters as `/all`. + operationId: listLatestVulnerabilities + parameters: + - $ref: '#/components/parameters/Platform' + - $ref: '#/components/parameters/Page' + - $ref: '#/components/parameters/PerPage' + - $ref: '#/components/parameters/Cursor' + - $ref: '#/components/parameters/Include' + responses: + '200': + description: Paginated 24h vulnerability listing. + content: + application/json: + schema: + oneOf: + - $ref: '#/components/schemas/OffsetVulnerabilityList' + - $ref: '#/components/schemas/CursorVulnerabilityList' + '401': { $ref: '#/components/responses/Unauthorized' } + '403': { $ref: '#/components/responses/Forbidden' } + '422': { $ref: '#/components/responses/UnprocessableEntity' } + '429': { $ref: '#/components/responses/TooManyRequests' } + + /product/{type}/{name}/{version}: + get: + tags: [Products] + summary: Find vulnerabilities for a product + description: | + Match a specific product + version against the vulnerability database + and return every applicable advisory. + + npm package slugs that include a `/` (e.g. `@scope/pkg`) conflict with + the route separator. URL-encode the `/` as `%2F`. + operationId: findProductVulnerabilities + parameters: + - $ref: '#/components/parameters/ProductType' + - $ref: '#/components/parameters/ProductName' + - $ref: '#/components/parameters/ProductVersion' + - $ref: '#/components/parameters/Include' + responses: + '200': + description: Matched advisories (possibly empty). + content: + application/json: + schema: + type: object + properties: + vulnerabilities: + type: array + items: + $ref: '#/components/schemas/Vulnerability' + '401': { $ref: '#/components/responses/Unauthorized' } + '403': { $ref: '#/components/responses/Forbidden' } + '422': { $ref: '#/components/responses/UnprocessableEntity' } + '429': { $ref: '#/components/responses/TooManyRequests' } + + /product/{type}/{name}/{version}/exists: + get: + tags: [Products] + summary: Boolean exists check for a product + description: | + Boolean-only variant of the product lookup. Returns `{ "vulnerable": true }` + or `{ "vulnerable": false }` without the advisory payload — useful for + lightweight health checks and dashboard tiles where the advisory body + isn't needed. + operationId: productVulnerabilityExists + parameters: + - $ref: '#/components/parameters/ProductType' + - $ref: '#/components/parameters/ProductName' + - $ref: '#/components/parameters/ProductVersion' + responses: + '200': + description: Boolean result. + content: + application/json: + schema: + type: object + required: [vulnerable] + properties: + vulnerable: + type: boolean + example: + vulnerable: true + '401': { $ref: '#/components/responses/Unauthorized' } + '403': { $ref: '#/components/responses/Forbidden' } + '429': { $ref: '#/components/responses/TooManyRequests' } + + /batch: + post: + tags: [Batch] + summary: Bulk product check + description: | + Check up to 50 products in a single request. Mirrors the format + documented for the Extended tier's `/batch` endpoint. + + The payload is a raw JSON array (not wrapped in an object). Each item + is `{ "type", "name", "version", "exists"? }` — when `exists: true` + the result for that item is boolean-only; otherwise it's the full + advisory list for the product. + operationId: batchProductCheck + requestBody: + required: true + content: + application/json: + schema: + type: array + maxItems: 50 + items: + $ref: '#/components/schemas/BatchItem' + example: + - { type: npm, name: axios, version: 0.21.4, exists: false } + - { type: plugin, name: tutor, version: 1.5.2, exists: true } + - { type: wordpress, name: wordpress, version: 6.0.0, exists: true } + responses: + '200': + description: Per-item results, in request order. + content: + application/json: + schema: + type: array + items: + type: object + '401': { $ref: '#/components/responses/Unauthorized' } + '403': { $ref: '#/components/responses/Forbidden' } + '422': { $ref: '#/components/responses/UnprocessableEntity' } + '429': { $ref: '#/components/responses/TooManyRequests' } + +components: + securitySchemes: + PSKey: + type: apiKey + in: header + name: PSKey + description: API key issued by Patchstack. Request one via . + + parameters: + Platform: + name: platform + in: query + description: Platform to query. Case-insensitive. + required: false + schema: + type: string + enum: [wordpress, npm] + default: wordpress + Page: + name: page + in: query + description: Offset-pagination page (1-indexed). Mutually exclusive with `cursor`. + required: false + schema: + type: integer + minimum: 1 + default: 1 + PerPage: + name: per_page + in: query + description: Page size. + required: false + schema: + type: integer + minimum: 1 + maximum: 500 + default: 100 + Cursor: + name: cursor + in: query + description: | + Opaque cursor. Presence of the param switches to cursor mode (send an + empty value to bootstrap). Mutually exclusive with `page`. + required: false + schema: + type: string + Include: + name: include + in: query + description: Pass `details` to include the full advisory body (`advisory_details`) per item. + required: false + schema: + type: string + enum: [details] + ProductType: + name: type + in: path + required: true + description: Product ecosystem. + schema: + type: string + enum: [npm, plugin, theme, wordpress] + example: npm + ProductName: + name: name + in: path + required: true + description: npm package slug or WordPress plugin/theme slug. Use `wordpress` when `type=wordpress`. + schema: + type: string + example: axios + ProductVersion: + name: version + in: path + required: true + description: Concrete version (e.g. `0.21.4`) or `*` to return every advisory for the product. + schema: + type: string + example: 0.21.4 + + responses: + Unauthorized: + description: Missing or invalid `PSKey` header. + Forbidden: + description: API key not authorised for the requested endpoint. + UnprocessableEntity: + description: Invalid parameter combination (e.g. `cursor` + `page`), invalid `platform`, or `per_page > 500`. + TooManyRequests: + description: Rate limit exceeded. + + schemas: + Vulnerability: + type: object + description: Per-item shape shared across list endpoints when `platform=npm`. + required: + - id + - title + - disclosed_at + - created_at + - url + - vuln_type + - cve + - is_exploited + - patch_priority + - product + - cvss + - cwe + - capec + - references + - ghsa + - version_info + properties: + id: + type: integer + description: Stable Patchstack vulnerability id. + example: 46500 + title: + type: string + description: Human-readable title (prefixed with `NPM:` for npm advisories). + example: "NPM: OpenClaw: ..." + disclosed_at: + type: string + format: date-time + description: When the vulnerability was publicly disclosed. + created_at: + type: string + format: date-time + description: When the row was inserted into the Patchstack DB. Drives `/latest` windowing. + url: + type: string + format: uri + description: Public Patchstack vulnerability page (token-tagged). + vuln_type: + type: string + description: High-level vulnerability category. + example: Other Vulnerability Type + cve: + type: string + description: First CVE identifier, or empty string when none is assigned. + example: "2026-41331" + is_exploited: + type: boolean + description: Whether exploitation has been observed in the wild. + patch_priority: + type: integer + minimum: 1 + maximum: 3 + description: 1 (low) to 3 (high). + advisory_details: + type: string + description: Full advisory body (markdown). Only present when `?include=details` was passed. + product: + type: object + required: [id, name, slug] + properties: + id: { type: integer } + name: { type: string } + slug: { type: string } + cvss: + type: object + nullable: true + properties: + score: + type: number + format: float + nullable: true + vector: + type: string + nullable: true + cwe: + type: object + nullable: true + properties: + id: + type: integer + nullable: true + name: + type: string + nullable: true + capec: + type: object + nullable: true + properties: + id: + type: integer + nullable: true + name: + type: string + nullable: true + references: + type: array + description: External reference URLs (advisories, commits, tags). + items: + type: string + format: uri + ghsa: + type: string + description: GHSA identifier when the advisory came from the GitHub Advisory Database. + version_info: + type: object + required: [affected, fixed, patched_ranges] + properties: + affected: + type: string + description: Affected version range (e.g. `<= 2026.3.28`). + fixed: + type: string + description: First fixed version. + patched_ranges: + type: array + description: Structured list of patch ranges for advisories with multiple patch ranges. + items: + type: object + properties: + from_version: { type: string } + to_version: { type: string } + fixed_in: { type: string } + example: + id: 46500 + title: "NPM: OpenClaw: ..." + disclosed_at: "2026-04-03T03:15:56+00:00" + created_at: "2026-04-21T08:38:34+00:00" + url: "https://patchstack.com/database/npm/npm/openclaw/vulnerability/..." + vuln_type: Other Vulnerability Type + cve: "2026-41331" + is_exploited: false + patch_priority: 2 + advisory_details: "## Summary\n..." + product: + id: 23595 + name: openclaw + slug: openclaw + cvss: + score: 6.9 + vector: "CVSS:4.0/AV:N/AC:L/AT:N/PR:N/UI:N/VC:N/VI:N/VA:L/SC:N/SI:N/SA:N" + cwe: + id: 770 + name: Allocation of Resources Without Limits or Throttling + capec: + id: null + name: null + references: + - "https://github.com/openclaw/openclaw/security/advisories/GHSA-m6fx-m8hc-572m" + - "https://github.com/openclaw/openclaw/releases/tag/v2026.3.31" + ghsa: GHSA-m6fx-m8hc-572m + version_info: + affected: "<= 2026.3.28" + fixed: "2026.3.31" + patched_ranges: [] + + OffsetPagination: + type: object + required: + - current_page + - per_page + - total + - total_pages + - has_next_page + - has_previous_page + - from + - to + properties: + current_page: { type: integer, example: 1 } + per_page: { type: integer, example: 25 } + total: { type: integer, example: 6115 } + total_pages: { type: integer, example: 245 } + has_next_page: { type: boolean, example: true } + has_previous_page: { type: boolean, example: false } + next_page: + type: integer + nullable: true + example: 2 + previous_page: + type: integer + nullable: true + example: null + from: { type: integer, example: 1 } + to: { type: integer, example: 25 } + + CursorPagination: + type: object + required: [next_cursor, has_more, per_page] + properties: + next_cursor: + type: string + nullable: true + description: Opaque cursor for the next page. `null` when there are no more pages. + example: djE6NDYzMzk + has_more: + type: boolean + example: true + per_page: + type: integer + example: 25 + + OffsetVulnerabilityList: + type: object + required: [vulnerabilities, pagination] + properties: + vulnerabilities: + type: array + items: + $ref: '#/components/schemas/Vulnerability' + pagination: + $ref: '#/components/schemas/OffsetPagination' + + CursorVulnerabilityList: + type: object + required: [vulnerabilities, cursor] + properties: + vulnerabilities: + type: array + items: + $ref: '#/components/schemas/Vulnerability' + cursor: + $ref: '#/components/schemas/CursorPagination' + + BatchItem: + type: object + required: [type, name, version] + properties: + type: + type: string + enum: [npm, plugin, theme, wordpress] + name: + type: string + version: + type: string + exists: + type: boolean + description: When `true`, return a boolean-only result for this item. diff --git a/src/content/docs/API solutions/Threat Intelligence API/beta.md b/src/content/docs/API solutions/Threat Intelligence API/beta.md index e34d3b6..489f160 100644 --- a/src/content/docs/API solutions/Threat Intelligence API/beta.md +++ b/src/content/docs/API solutions/Threat Intelligence API/beta.md @@ -1,319 +1,127 @@ --- -title: "Beta tier API" +title: "Beta API" excerpt: "Beta vulnerability endpoints — npm support, Resource-based shape, offset and cursor pagination, include=details." hidden: false metadata: image: [] robots: "index" createdAt: "Tue Apr 21 2026 00:00:00 GMT+0000 (Coordinated Universal Time)" -updatedAt: "Tue Apr 21 2026 00:00:00 GMT+0000 (Coordinated Universal Time)" +updatedAt: "Wed Apr 22 2026 00:00:00 GMT+0000 (Coordinated Universal Time)" sidebar: - order: 4 - label: "Beta tier API" + label: "Guide" --- -_The Beta endpoints live alongside the v2 API and add npm coverage, an optional full advisory body, a consistent nested response shape, and cursor pagination. They are the recommended endpoints for new integrations; v2 remains available for backwards compatibility._ +_The Beta API is a new generation of the Threat Intelligence API, currently available to **selected partners working directly with Patchstack**. It lives alongside the v2 API (Standard / Extended) and adds npm coverage, an optional full advisory body, a consistent nested response shape, and cursor pagination. If you'd like access to run an integration on Beta, [contact us](https://patchstack.com/for-hosts/)._ -## API Usage +> **Interactive reference:** Every endpoint, parameter, request body and response shape is documented in the [Threat Intelligence API (Beta) reference](/api-reference/threat-intelligence-beta/). -### Base URL +This page covers the concepts you need to use the API effectively — authentication, platforms, pagination, rate limiting, and migration from v2. Use it alongside the interactive reference. -``` -https://vdp-api.patchstack.com/database/api/beta/ -``` +## Use with Postman, Insomnia, Bruno or Hoppscotch -### Authentication - -Every request must include your API key in the **`PSKey`** HTTP request header. You can request an API key by reaching out on . - -``` -PSKey: -``` +We publish the API as an [OpenAPI 3.1 spec](https://docs.patchstack.com/schemas/threat-intel-beta.yaml) and a pre-built [Postman collection](https://docs.patchstack.com/schemas/threat-intel-beta.postman_collection.json). Every endpoint, parameter, request body and example is preconfigured — set your `PSKey` once and the whole collection authenticates. -### Response format - -All responses are JSON. Beta responses are cached until the database updates, at which point the cache is cleared. A single response shape is shared across all three list endpoints (`/all`, `/latest`, `/product/npm/...`) so clients can parse them interchangeably. - -### Platforms - -Pass `?platform=npm` (or `?platform=wordpress` — the default) on list endpoints. Platform names are case-insensitive. - -### Rate limiting - -Same policy as the Extended Threat Intelligence API — please contact if you need an elevated quota. +[Download the collection](/schemas/threat-intel-beta.postman_collection.json) and drag it into Postman/Insomnia/Bruno/Hoppscotch, or import it by URL from inside the tool. ---- - -## Endpoints - -| Method | Endpoint | Purpose | -|---|---|---| -| `GET` | `/database/api/beta/all` | Paginated listing of every published vulnerability for a platform | -| `GET` | `/database/api/beta/latest` | Vulnerabilities added in the last 24 hours | -| `GET` | `/database/api/beta/product/{type}/{name}/{version}` | Match a single product/version (npm & WordPress family) | -| `GET` | `/database/api/beta/product/{type}/{name}/{version}/exists` | Boolean-only variant of the above | -| `POST` | `/database/api/beta/batch` | Check up to 50 products in a single request | - ---- - -## List all vulnerabilities - -**Description:** Paginated listing of every published vulnerability for the given platform, ordered by descending `id`. -**Endpoint:** `/database/api/beta/all` -**Method:** `GET` - -### Query parameters +| Tool | How to import | +|---|---| +| **Postman** | `File → Import → Link` and paste the collection URL. | +| **Insomnia** | `Create → Import From → URL` → paste the OpenAPI URL. | +| **Bruno** | `Collection → Import → OpenAPI V3 Spec` → paste the OpenAPI URL. | +| **Hoppscotch** | `Collections → Import/Export → OpenAPI` → paste the OpenAPI URL. | -| Name | Type | Default | Description | -|---|---|---|---| -| `platform` | string | `wordpress` | `npm` or `wordpress`. Case-insensitive. | -| `page` | integer | `1` | Offset-pagination page (1-indexed). | -| `per_page` | integer | `100` | Page size, max `500`. | -| `cursor` | string | — | Opaque cursor (see below). Presence of the param switches to cursor mode. | -| `include` | string | — | Pass `details` to include the full advisory body in each item. | +**Authentication:** in Postman set the collection `Authorization` to **API Key**, key `PSKey`, value `{{PSKEY}}`, and add `PSKEY` as a collection variable with your real key as the **Current value** (leave Initial blank so it doesn't sync to teammates). Other tools work the same way — set `PSKey` as a collection header once. -### Pagination modes +## Use with Claude Code or other LLM coding assistants -`/all` supports **two independent pagination strategies**. Use whichever fits your client: +Point your assistant at the spec. LLMs parse OpenAPI cleanly and will generate clients that match the real field names instead of hallucinating. -- **Offset (`?page=&per_page=`)** — returns a `pagination` block with totals, `has_next_page`, `has_previous_page`, etc. Easy to jump to a specific page; slower at depth and susceptible to row-shift when new vulnerabilities land while you're paging. -- **Cursor (`?cursor=`)** — returns a `cursor` block with `next_cursor`, `has_more`, `per_page`. Stable under concurrent inserts and faster at any depth. No `total` count (deliberately skipped to keep cursor mode fast). +- **Ad hoc:** paste the spec URL into your prompt. Example: *"Write a Python client for `https://docs.patchstack.com/schemas/threat-intel-beta.yaml`. I need cursor-mode iteration over `/all` for npm."* +- **In your repo:** download the spec to `docs/vendor/patchstack-threat-intel-beta.yaml` and reference it from your `CLAUDE.md` / `AGENTS.md`. Your assistant can then grep the YAML for specific fields without refetching. +- **Plain-text fallback:** for tools that don't parse YAML, our [`llms-full.txt`](/llms-full.txt) contains the full reference as flat markdown. -`cursor` and `page` are mutually exclusive; passing both returns `422 Unprocessable Entity`. +## SDK generation -### Example — offset mode +Generate a client in any language from the same spec: ```bash -curl 'https://patchstack.com/database/api/beta/all?platform=npm&page=1&per_page=25' \ - -H 'PSKey: ' -``` - -Response: +# TypeScript +npx @openapitools/openapi-generator-cli generate \ + -i https://docs.patchstack.com/schemas/threat-intel-beta.yaml \ + -g typescript-fetch -o ./patchstack-client -```json -{ - "vulnerabilities": [ /* 25 items */ ], - "pagination": { - "current_page": 1, - "per_page": 25, - "total": 6115, - "total_pages": 245, - "has_next_page": true, - "has_previous_page": false, - "next_page": 2, - "previous_page": null, - "from": 1, - "to": 25 - } -} -``` - -### Example — cursor mode - -First page — send `cursor=` with an empty value to bootstrap: - -```bash -curl 'https://patchstack.com/database/api/beta/all?platform=npm&per_page=25&cursor=' \ - -H 'PSKey: ' +# Python +npx @openapitools/openapi-generator-cli generate \ + -i https://docs.patchstack.com/schemas/threat-intel-beta.yaml \ + -g python -o ./patchstack-client-py ``` -Response: +Speakeasy and Fern also consume the same spec and produce more idiomatic SDKs if you need a polished client library. -```json -{ - "vulnerabilities": [ /* 25 items */ ], - "cursor": { - "next_cursor": "djE6NDYzMzk", - "has_more": true, - "per_page": 25 - } -} -``` +> **Spec stability:** the Beta spec may change without a version bump while the API is in beta. Pin a commit of the YAML in production integrations, or wait for the GA release when we'll publish versioned URLs. -Follow `next_cursor` on the next request: +## Base URL -```bash -curl 'https://patchstack.com/database/api/beta/all?platform=npm&per_page=25&cursor=djE6NDYzMzk' \ - -H 'PSKey: ' ``` - -Stop when `has_more: false` and `next_cursor: null`. - -### Example — with full advisory body - -```bash -curl 'https://patchstack.com/database/api/beta/all?platform=npm&per_page=25&include=details' \ - -H 'PSKey: ' +https://vdp-api.patchstack.com/database/api/beta/ ``` -Adds an `advisory_details` field (markdown) to every item. - ---- - -## Latest (last 24 hours) +## Authentication -**Description:** Returns vulnerabilities whose row was inserted into the Patchstack database in the last 24 hours. The filter is on `created_at` (insertion time), **not** `disclosure_date`. -**Endpoint:** `/database/api/beta/latest` -**Method:** `GET` - -Accepts the **same query parameters** as `/all` — `platform`, `page`, `per_page`, `cursor`, `include`. +Every request must include your API key in the **`PSKey`** HTTP request header. You can request an API key by reaching out on . -```bash -curl 'https://patchstack.com/database/api/beta/latest?platform=npm&per_page=50' \ - -H 'PSKey: ' ``` - -Cursor pagination works identically: - -```bash -curl 'https://patchstack.com/database/api/beta/latest?platform=npm&per_page=50&cursor=' \ - -H 'PSKey: ' +PSKey: ``` ---- - -## Find vulnerability for a product +## Platforms -**Description:** Match a specific product + version against the vulnerability database and return every applicable advisory. -**Endpoint:** `/database/api/beta/product/{type}/{name}/{version}/{exists?}` -**Method:** `GET` - -| Path param | Description | -|---|---| -| `type` | `npm`, `plugin`, `theme`, or `wordpress`. | -| `name` | npm package slug or WordPress plugin/theme slug. Use `wordpress` when `type=wordpress`. | -| `version` | Concrete version (e.g. `0.21.4`) or `*` to return every advisory for the product. | -| `exists` | Optional. Pass the literal string `exists` to get a boolean response only. | - -### Query parameters - -| Name | Type | Description | -|---|---|---| -| `include` | string | Pass `details` to include the full advisory body (`advisory_details`) per item. Applies only to npm. | +Pass `?platform=npm` (or `?platform=wordpress` — the default) on list endpoints. Platform names are case-insensitive. -### Example — npm, concrete version +## Response format -```bash -curl 'https://patchstack.com/database/api/beta/product/npm/axios/0.21.4?include=details' \ - -H 'PSKey: ' -``` +All responses are JSON. Beta responses are cached until the database updates, at which point the cache is cleared. A single response shape is shared across all three list endpoints (`/all`, `/latest`, `/product/npm/...`) so clients can parse them interchangeably. -### Example — npm, wildcard version (all advisories for the package) +## Pagination -```bash -curl 'https://patchstack.com/database/api/beta/product/npm/axios/*' \ - -H 'PSKey: ' -``` +`/all` and `/latest` support **two independent pagination strategies**. Use whichever fits your client: -### Example — boolean exists check +- **Offset (`?page=&per_page=`)** — returns a `pagination` block with totals, `has_next_page`, `has_previous_page`, etc. Easy to jump to a specific page; slower at depth and susceptible to row-shift when new vulnerabilities land while you're paging. +- **Cursor (`?cursor=`)** — returns a `cursor` block with `next_cursor`, `has_more`, `per_page`. Stable under concurrent inserts and faster at any depth. No `total` count (deliberately skipped to keep cursor mode fast). -```bash -curl 'https://patchstack.com/database/api/beta/product/npm/axios/0.21.4/exists' \ - -H 'PSKey: ' -``` +`cursor` and `page` are mutually exclusive; passing both returns `422 Unprocessable Entity`. To bootstrap cursor mode, send `?cursor=` with an empty value. -Response: +## Including full advisory bodies -```json -{ "vulnerable": true } -``` +Pass `?include=details` on any list endpoint to add an `advisory_details` markdown field to each item. Applies to npm results. -### Note on scoped npm packages +## Scoped npm packages npm package slugs that include a `/` (e.g. `@scope/pkg`) conflict with the route separator. URL-encode the `/` as `%2F` or contact us for guidance on the encoding helper. ---- - -## Bulk product check - -**Description:** Check up to 50 products in a single request. Mirrors the format documented for the Extended tier's `/batch` endpoint. -**Endpoint:** `/database/api/beta/batch` -**Method:** `POST` -**Payload:** Raw JSON array, ≤ 50 objects. +## Rate limiting -```bash -curl -X POST 'https://patchstack.com/database/api/beta/batch' \ - -H 'PSKey: ' \ - -H 'Content-Type: application/json' \ - -d '[ - { "type": "npm", "name": "axios", "version": "0.21.4", "exists": false }, - { "type": "plugin", "name": "tutor", "version": "1.5.2", "exists": true }, - { "type": "wordpress","name":"wordpress","version": "6.0.0", "exists": true } - ]' -``` +Same policy as the Extended Threat Intelligence API — please contact if you need an elevated quota. ---- +## Errors -## Response shape (npm) +| Status | Meaning | +|---|---| +| `401 Unauthorized` | Missing or invalid `PSKey` header. | +| `403 Forbidden` | API key not authorised for the requested endpoint. | +| `422 Unprocessable Entity` | Invalid parameter combination (e.g. `cursor` + `page`), invalid `platform`, or `per_page > 500`. | +| `429 Too Many Requests` | Rate limit exceeded. | +| `500` | Server error — please include the request id in any bug report. | -The three list endpoints (`/all`, `/latest`, `/product/npm/...`) share the same per-item shape when `platform=npm`. `advisory_details` is only present when `?include=details` was passed. +When a cursor is malformed (invalid base64 or missing the `v1:` prefix), the endpoint returns `200` with an empty page: ```json { - "id": 46500, - "title": "NPM: OpenClaw: ...", - "disclosed_at": "2026-04-03T03:15:56+00:00", - "created_at": "2026-04-21T08:38:34+00:00", - "url": "https://patchstack.com/database/npm/npm/openclaw/vulnerability/...", - "vuln_type": "Other Vulnerability Type", - "cve": "2026-41331", - "is_exploited": false, - "patch_priority": 2, - "advisory_details": "## Summary\n...", - "product": { - "id": 23595, - "name": "openclaw", - "slug": "openclaw" - }, - "cvss": { - "score": 6.9, - "vector": "CVSS:4.0/AV:N/AC:L/AT:N/PR:N/UI:N/VC:N/VI:N/VA:L/SC:N/SI:N/SA:N" - }, - "cwe": { - "id": 770, - "name": "Allocation of Resources Without Limits or Throttling" - }, - "capec": { - "id": null, - "name": null - }, - "references": [ - "https://github.com/openclaw/openclaw/security/advisories/GHSA-m6fx-m8hc-572m", - "https://github.com/openclaw/openclaw/releases/tag/v2026.3.31" - ], - "ghsa": "GHSA-m6fx-m8hc-572m", - "version_info": { - "affected": "<= 2026.3.28", - "fixed": "2026.3.31", - "patched_ranges": [] - } + "vulnerabilities": [], + "cursor": { "next_cursor": null, "has_more": false, "per_page": 100 } } ``` -### Field reference - -| Field | Type | Description | -|---|---|---| -| `id` | integer | Stable Patchstack vulnerability id. | -| `title` | string | Human-readable title (prefixed with `NPM:` for npm advisories). | -| `disclosed_at` | ISO-8601 | When the vulnerability was publicly disclosed. | -| `created_at` | ISO-8601 | When the row was inserted into the Patchstack DB. Drives `/latest` windowing. | -| `url` | string | Public Patchstack vulnerability page (token-tagged). | -| `vuln_type` | string | High-level vulnerability category. | -| `cve` | string | First CVE identifier, or `""` when none is assigned. | -| `is_exploited` | boolean | Whether exploitation has been observed in the wild. | -| `patch_priority` | integer | 1 (low) to 3 (high). | -| `advisory_details` | string \| absent | Full advisory body. Only present with `?include=details`. | -| `product.{id,name,slug}` | object | The affected package/product. | -| `cvss.{score,vector}` | object | CVSS score and vector (may be `null`). | -| `cwe.{id,name}` | object | CWE classification (may be `null`). | -| `capec.{id,name}` | object | CAPEC classification (may be `null`). | -| `references` | string[] | External reference URLs (advisories, commits, tags). | -| `ghsa` | string | GHSA identifier when the advisory came from the GitHub Advisory Database. | -| `version_info.affected` | string | Affected version range (e.g. `<= 2026.3.28`). | -| `version_info.fixed` | string | First fixed version. | -| `version_info.patched_ranges` | array | Structured list of `{from_version, to_version, fixed_in}` entries for advisories with multiple patch ranges. | - --- ## Testing @@ -338,16 +146,9 @@ curl 'https://patchstack.com/database/api/beta/product/npm/axios/0.21.4/exists' -H 'PSKey: ' ``` -### Postman +### Postman / Insomnia / Bruno / Hoppscotch -1. Create a new request, set the method, paste the URL. -2. Under **Headers**, add: - - Key: `PSKey` - - Value: your API key -3. Under **Headers**, add (recommended): - - Key: `Accept` - - Value: `application/json` -4. For `POST /batch`, set the body to **raw → JSON** and paste the array payload. +Import the OpenAPI spec directly from [`threat-intel-beta.yaml`](https://docs.patchstack.com/schemas/threat-intel-beta.yaml) — authentication, parameters and example payloads are preconfigured. Set the `PSKey` security value to your API key once and every request in the collection will use it. ### Cursor iteration (JavaScript / Node) @@ -405,27 +206,6 @@ do { --- -## Errors - -| Status | Meaning | -|---|---| -| `401 Unauthorized` | Missing or invalid `PSKey` header. | -| `403 Forbidden` | API key not authorised for the requested endpoint. | -| `422 Unprocessable Entity` | Invalid parameter combination (e.g. `cursor` + `page`), invalid `platform`, or `per_page > 500`. | -| `429 Too Many Requests` | Rate limit exceeded. | -| `500` | Server error — please include the request id in any bug report. | - -When a cursor is malformed (invalid base64 or missing the `v1:` prefix), the endpoint returns `200` with an empty page: - -```json -{ - "vulnerabilities": [], - "cursor": { "next_cursor": null, "has_more": false, "per_page": 100 } -} -``` - ---- - ## Migration notes (v2 → beta) - Beta npm responses use **nested objects** (`product`, `cvss`, `cwe`, `capec`, `version_info`) whereas the v2 shape is flat. Update parsers accordingly. diff --git a/src/content/docs/API solutions/Threat Intelligence API/overview.md b/src/content/docs/API solutions/Threat Intelligence API/overview.md index f3ffd06..e80fa54 100644 --- a/src/content/docs/API solutions/Threat Intelligence API/overview.md +++ b/src/content/docs/API solutions/Threat Intelligence API/overview.md @@ -12,18 +12,39 @@ sidebar: hidden: false --- +Patchstack publishes three ways to consume its vulnerability database. Standard and Extended are the stable tiers of the v2 API; the Beta API is a new generation available to selected partners only. + +## Which API should I use? + +| | **Standard** | **Extended** | **Beta** | +|---|---|---|---| +| **Status** | Stable (v2) | Stable (v2) | Beta — selected partners only | +| **Access** | Purchase via [Patchstack App](https://app.patchstack.com/billing/subscription) | Custom pricing, activated on request — [contact us](https://patchstack.com/for-hosts/) | By invitation. If you're working with Patchstack on an integration, [get in touch](https://patchstack.com/for-hosts/) | +| **Rate limit** | 5,000 calls / 24 hours | Custom | Custom | +| **Ecosystems** | WordPress plugins, themes, core | WordPress plugins, themes, core | WordPress + **npm** | +| **Lookups** | Single plugin/theme/version | Single + bulk | Single + bulk | +| **Pagination** | Offset | Offset | Offset **and** cursor | +| **Response shape** | Flat | Flat | Nested (`product`, `cvss`, `cwe`, `version_info`…) | +| **Full advisory body** | No | Yes | Opt-in via `?include=details` | +| **OpenAPI spec / Postman collection** | — | — | [Yes](/api-solutions/threat-intelligence-api/beta/#use-with-postman-insomnia-bruno-or-hoppscotch) | + +**New integration?** If you have Beta access, use Beta — it's the direction we're heading, and Standard/Extended will eventually adopt the same shape. If not, start with Standard or Extended depending on your data needs. + +**Existing integration?** Standard and Extended remain supported; no migration is required. + +--- + ### Standard Threat Intelligence API -Fetch the latest vulnerability information for a single version of a particular plugin, theme or WordPress core. API is limited for 5000 calls / 24 hours. Access to this API can be purchased through the [Patchstack App](https://app.patchsatck.com/billing/subscription). +Fetch the latest vulnerability information for a single version of a particular plugin, theme or WordPress core. API is limited for 5000 calls / 24 hours. Access to this API can be purchased through the [Patchstack App](https://app.patchstack.com/billing/subscription). [Standard Threat Intelligence API Documentation](/api-solutions/threat-intelligence-api/standard/) ### Extended Threat Intelligence API Access everything included in the Standard tier, bulk-request data for multiple plugins with one API call, and have additional endpoints with more information about vulnerabilities. Extended tier has custom pricing and is activated on request only. For access to these API endpoints, please [contact us here](https://patchstack.com/for-hosts/). - [Extended Threat Intelligence API Documentation](/api-solutions/threat-intelligence-api/extended/) ### Beta Threat Intelligence API -Adds npm ecosystem coverage, an opt-in full advisory body (`?include=details`), a consistent nested response shape, and cursor-based pagination alongside the existing offset pagination. These are the recommended endpoints for new integrations. +A new generation of the Threat Intelligence API, currently available to **selected partners working directly with Patchstack**. Adds npm ecosystem coverage, an opt-in full advisory body (`?include=details`), a consistent nested response shape, and cursor-based pagination alongside the existing offset pagination. If you're already working with us on an integration and would like access, [contact us](https://patchstack.com/for-hosts/). [Beta Threat Intelligence API Documentation](/api-solutions/threat-intelligence-api/beta/) diff --git a/src/styles/custom.css b/src/styles/custom.css index 2d59027..3d4c0c5 100644 --- a/src/styles/custom.css +++ b/src/styles/custom.css @@ -135,4 +135,12 @@ header button { .main-frame { margin-bottom: 30px; +} + +/* Match sidebar group labels that carry a badge (e.g. Beta API [New]) to the + weight/size of sibling leaf links, so the badge carries the emphasis + instead of the label doubling up. */ +.group-label .large:has(+ .sl-badge) { + font-size: var(--sl-text-sm); + font-weight: normal; } \ No newline at end of file From 5cd95582c4b5d4438995afc237eb8b5212ffc82a Mon Sep 17 00:00:00 2001 From: Mario Tarosso Date: Thu, 23 Apr 2026 09:51:30 +0100 Subject: [PATCH 07/89] Update API label/badge and clean banner whitespace (#23) * Update API label/badge and clean banner whitespace Rename the navigation label for the Threat Intelligence API from "Beta API" to "NPM standard API" and change the badge text from "New" to "Beta" (badge variant remains "tip"). Also remove an extra blank/whitespace line after the banner content in astro.config.mjs. These are non-functional wording/formatting updates. * Rename Beta API to Npm Dataset API (Beta) Update docs to refer to the Npm Dataset API (Beta): change page title and intro in beta.md and update overview wording in overview.md. Also adjust custom.css comments and whitespace (align sidebar badge comment, remove trailing whitespace, and add final newline) to reflect the new name and clean up formatting. --- astro.config.mjs | 6 +++--- .../docs/API solutions/Threat Intelligence API/beta.md | 4 ++-- .../API solutions/Threat Intelligence API/overview.md | 4 ++-- src/styles/custom.css | 8 ++++---- 4 files changed, 11 insertions(+), 11 deletions(-) diff --git a/astro.config.mjs b/astro.config.mjs index 3a8ddef..9014f3c 100644 --- a/astro.config.mjs +++ b/astro.config.mjs @@ -73,7 +73,7 @@ export default defineConfig({ banner: { enabled: false, content: 'Black Friday Deal - 50% off dev plan for 6 months', - + }, integrations: [ postmanFromOpenAPI(), @@ -147,8 +147,8 @@ export default defineConfig({ { slug: 'api-solutions/threat-intelligence-api/extended' }, { slug: 'api-solutions/threat-intelligence-api/api-properties' }, { - label: 'Beta API', - badge: { text: 'New', variant: 'tip' }, + label: 'NPM standard API', + badge: { text: 'Beta', variant: 'tip' }, collapsed: true, items: [ { slug: 'api-solutions/threat-intelligence-api/beta' }, diff --git a/src/content/docs/API solutions/Threat Intelligence API/beta.md b/src/content/docs/API solutions/Threat Intelligence API/beta.md index 489f160..5fe7371 100644 --- a/src/content/docs/API solutions/Threat Intelligence API/beta.md +++ b/src/content/docs/API solutions/Threat Intelligence API/beta.md @@ -1,5 +1,5 @@ --- -title: "Beta API" +title: "Npm Dataset API (Beta)" excerpt: "Beta vulnerability endpoints — npm support, Resource-based shape, offset and cursor pagination, include=details." hidden: false metadata: @@ -11,7 +11,7 @@ sidebar: label: "Guide" --- -_The Beta API is a new generation of the Threat Intelligence API, currently available to **selected partners working directly with Patchstack**. It lives alongside the v2 API (Standard / Extended) and adds npm coverage, an optional full advisory body, a consistent nested response shape, and cursor pagination. If you'd like access to run an integration on Beta, [contact us](https://patchstack.com/for-hosts/)._ +_The Npm Dataset API (Beta) is a new generation of the Threat Intelligence API, currently available to **selected partners working directly with Patchstack**. It lives alongside the v2 API (Standard / Extended) and adds npm coverage, an optional full advisory body, a consistent nested response shape, and cursor pagination. If you'd like access to run an integration on Beta, [contact us](https://patchstack.com/for-hosts/)._ > **Interactive reference:** Every endpoint, parameter, request body and response shape is documented in the [Threat Intelligence API (Beta) reference](/api-reference/threat-intelligence-beta/). diff --git a/src/content/docs/API solutions/Threat Intelligence API/overview.md b/src/content/docs/API solutions/Threat Intelligence API/overview.md index e80fa54..b6e0a04 100644 --- a/src/content/docs/API solutions/Threat Intelligence API/overview.md +++ b/src/content/docs/API solutions/Threat Intelligence API/overview.md @@ -1,7 +1,7 @@ --- title: "Overview" excerpt: "" -metadata: +metadata: image: [] robots: "index" createdAt: "Thu Jun 01 2023 12:04:17 GMT+0000 (Coordinated Universal Time)" @@ -12,7 +12,7 @@ sidebar: hidden: false --- -Patchstack publishes three ways to consume its vulnerability database. Standard and Extended are the stable tiers of the v2 API; the Beta API is a new generation available to selected partners only. +Patchstack publishes three ways to consume its vulnerability database. Standard and Extended are the stable tiers of the v2 API; the Npm Dataset API (Beta) is a new generation available to selected partners only. ## Which API should I use? diff --git a/src/styles/custom.css b/src/styles/custom.css index 3d4c0c5..f6a346d 100644 --- a/src/styles/custom.css +++ b/src/styles/custom.css @@ -72,7 +72,7 @@ header button { --sl-color-black: #ffffff; --sl-color-bg-nav: #24272f; --sl-color-text-invert:#24272f; - + starlight-theme-select select, starlight-theme-select option, @@ -111,7 +111,7 @@ header button { border: 0; } .tagline { - font-family: Faktum Regular, sans-serif; + font-family: Faktum Regular, sans-serif; font-size: 1rem; line-height: var(--sl-line-height); } @@ -137,10 +137,10 @@ header button { margin-bottom: 30px; } -/* Match sidebar group labels that carry a badge (e.g. Beta API [New]) to the +/* Match sidebar group labels that carry a badge (e.g. Npm Dataset API (Beta) [New]) to the weight/size of sibling leaf links, so the badge carries the emphasis instead of the label doubling up. */ .group-label .large:has(+ .sl-badge) { font-size: var(--sl-text-sm); font-weight: normal; -} \ No newline at end of file +} From 35ffc9e229b69d3d5254d4c11f76eccbbee4ef4a Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Thu, 23 Apr 2026 12:06:30 +0100 Subject: [PATCH 08/89] Bump h3 from 1.15.3 to 1.15.11 (#24) Bumps [h3](https://github.com/h3js/h3) from 1.15.3 to 1.15.11. - [Release notes](https://github.com/h3js/h3/releases) - [Changelog](https://github.com/h3js/h3/blob/v1.15.11/CHANGELOG.md) - [Commits](https://github.com/h3js/h3/compare/v1.15.3...v1.15.11) --- updated-dependencies: - dependency-name: h3 dependency-version: 1.15.11 dependency-type: indirect ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- package-lock.json | 57 +++++++++++++++++++++-------------------------- 1 file changed, 26 insertions(+), 31 deletions(-) diff --git a/package-lock.json b/package-lock.json index 56d2b58..b85cb84 100644 --- a/package-lock.json +++ b/package-lock.json @@ -51,7 +51,6 @@ "version": "6.3.2", "resolved": "https://registry.npmjs.org/@astrojs/markdown-remark/-/markdown-remark-6.3.2.tgz", "integrity": "sha512-bO35JbWpVvyKRl7cmSJD822e8YA8ThR/YbUsciWNA7yTcqpIAL2hJDToWP5KcZBWxGT6IOdOkHSXARSNZc4l/Q==", - "peer": true, "dependencies": { "@astrojs/internal-helpers": "0.6.1", "@astrojs/prism": "3.3.0", @@ -127,7 +126,6 @@ "version": "0.34.8", "resolved": "https://registry.npmjs.org/@astrojs/starlight/-/starlight-0.34.8.tgz", "integrity": "sha512-XuYz0TfCZhje2u1Q9FNtmTdm7/B9QP91RDI1VkPgYvDhSYlME3k8gwgcBMHnR9ASDo2p9gskrqe7t1Pub/qryg==", - "peer": true, "dependencies": { "@astrojs/markdown-remark": "^6.3.1", "@astrojs/mdx": "^4.2.3", @@ -1682,7 +1680,6 @@ "version": "8.15.0", "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.15.0.tgz", "integrity": "sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==", - "peer": true, "bin": { "acorn": "bin/acorn" }, @@ -1703,7 +1700,6 @@ "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.18.0.tgz", "integrity": "sha512-PlXPeEWMXMZ7sPYOHqmDyCJzcfNrUr3fGNKtezX14ykXOEIvyK81d+qydx89KY5O71FKMPaQ2vBfBFI5NHR63A==", "license": "MIT", - "peer": true, "dependencies": { "fast-deep-equal": "^3.1.3", "fast-uri": "^3.0.1", @@ -1876,7 +1872,6 @@ "version": "5.11.2", "resolved": "https://registry.npmjs.org/astro/-/astro-5.11.2.tgz", "integrity": "sha512-jKJCqp0PMZ1ZpP2xySghsJ1xK7ZNh/ISTRNBf/7khY3iEGq/zup49ZMhNZXK5Cd/dFWP/pdBNHD91SByA42IvQ==", - "peer": true, "dependencies": { "@astrojs/compiler": "^2.12.2", "@astrojs/internal-helpers": "0.6.1", @@ -2458,9 +2453,10 @@ } }, "node_modules/cookie-es": { - "version": "1.2.2", - "resolved": "https://registry.npmjs.org/cookie-es/-/cookie-es-1.2.2.tgz", - "integrity": "sha512-+W7VmiVINB+ywl1HGXJXmrqkOhpKrIiVZV6tQuV54ZyQC7MMuBt81Vc336GMLoHBq5hV/F9eXgt5Mnx0Rha5Fg==" + "version": "1.2.3", + "resolved": "https://registry.npmjs.org/cookie-es/-/cookie-es-1.2.3.tgz", + "integrity": "sha512-lXVyvUvrNXblMqzIRrxHb57UUVmqsSWlxqt3XIjCkUP0wDAf6uicO6KMbEgYrMNtEvWgWHwe42CKxPu9MYAnWw==", + "license": "MIT" }, "node_modules/cross-fetch": { "version": "3.2.0", @@ -2545,9 +2541,10 @@ } }, "node_modules/defu": { - "version": "6.1.4", - "resolved": "https://registry.npmjs.org/defu/-/defu-6.1.4.tgz", - "integrity": "sha512-mEQCMmwJu317oSz8CwdIOdwf3xMif1ttiM8LTufzc3g6kR+9Pe236twL8j3IYT1F7GfRgGcW6MWxzZjLIkuHIg==" + "version": "6.1.7", + "resolved": "https://registry.npmjs.org/defu/-/defu-6.1.7.tgz", + "integrity": "sha512-7z22QmUWiQ/2d0KkdYmANbRUVABpZ9SNYyH5vx6PZ+nE5bcC0l7uFvEfHlyld/HcGBFTL536ClDt3DEcSlEJAQ==", + "license": "MIT" }, "node_modules/dequal": { "version": "2.0.3", @@ -3012,18 +3009,19 @@ } }, "node_modules/h3": { - "version": "1.15.3", - "resolved": "https://registry.npmjs.org/h3/-/h3-1.15.3.tgz", - "integrity": "sha512-z6GknHqyX0h9aQaTx22VZDf6QyZn+0Nh+Ym8O/u0SGSkyF5cuTJYKlc8MkzW3Nzf9LE1ivcpmYC3FUGpywhuUQ==", + "version": "1.15.11", + "resolved": "https://registry.npmjs.org/h3/-/h3-1.15.11.tgz", + "integrity": "sha512-L3THSe2MPeBwgIZVSH5zLdBBU90TOxarvhK9d04IDY2AmVS8j2Jz2LIWtwsGOU3lu2I5jCN7FNvVfY2+XyF+mg==", + "license": "MIT", "dependencies": { - "cookie-es": "^1.2.2", - "crossws": "^0.3.4", - "defu": "^6.1.4", + "cookie-es": "^1.2.3", + "crossws": "^0.3.5", + "defu": "^6.1.6", "destr": "^2.0.5", "iron-webcrypto": "^1.2.1", - "node-mock-http": "^1.0.0", + "node-mock-http": "^1.0.4", "radix3": "^1.1.2", - "ufo": "^1.6.1", + "ufo": "^1.6.3", "uncrypto": "^0.1.3" } }, @@ -4935,9 +4933,10 @@ "integrity": "sha512-8Mc2HhqPdlIfedsuZoc3yioPuzp6b+L5jRCRY1QzuWZh2EGJVQrGppC6V6cF0bLdbW0+O2YpqCA25aF/1lvipQ==" }, "node_modules/node-mock-http": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/node-mock-http/-/node-mock-http-1.0.1.tgz", - "integrity": "sha512-0gJJgENizp4ghds/Ywu2FCmcRsgBTmRQzYPZm61wy+Em2sBarSka0OhQS5huLBg6od1zkNpnWMCZloQDFVvOMQ==" + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/node-mock-http/-/node-mock-http-1.0.4.tgz", + "integrity": "sha512-8DY+kFsDkNXy1sJglUfuODx1/opAGJGyrTuFqEoN90oRc2Vk0ZbD4K2qmKXBBEhZQzdKHIVfEJpDU8Ak2NJEvQ==", + "license": "MIT" }, "node_modules/node-readfiles": { "version": "0.2.0", @@ -5201,8 +5200,7 @@ "version": "12.1.3", "resolved": "https://registry.npmjs.org/openapi-types/-/openapi-types-12.1.3.tgz", "integrity": "sha512-N4YtSYJqghVu4iek2ZUvcN/0aqH1kRDuNqzcycDxhOUpg7GdvLa2F3DgS6yBNhInhv2r/6I0Flkn7CqL8+nIcw==", - "license": "MIT", - "peer": true + "license": "MIT" }, "node_modules/p-limit": { "version": "6.2.0", @@ -5372,7 +5370,6 @@ "url": "https://github.com/sponsors/ai" } ], - "peer": true, "dependencies": { "nanoid": "^3.3.11", "picocolors": "^1.1.1", @@ -5939,7 +5936,6 @@ "version": "4.45.1", "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.45.1.tgz", "integrity": "sha512-4iya7Jb76fVpQyLoiVpzUrsjQ12r3dM7fIVz+4NwoYvZOShknRmiv+iu9CClZml5ZLGb0XMcYLutK6w9tgxHDw==", - "peer": true, "dependencies": { "@types/estree": "1.0.8" }, @@ -6446,9 +6442,10 @@ } }, "node_modules/ufo": { - "version": "1.6.1", - "resolved": "https://registry.npmjs.org/ufo/-/ufo-1.6.1.tgz", - "integrity": "sha512-9a4/uxlTWJ4+a5i0ooc1rU7C7YOw3wT+UGqdeNNHWnOF9qcMBgLRS+4IYUqbczewFx4mLEig6gawh7X6mFlEkA==" + "version": "1.6.3", + "resolved": "https://registry.npmjs.org/ufo/-/ufo-1.6.3.tgz", + "integrity": "sha512-yDJTmhydvl5lJzBmy/hyOAA0d+aqCBuwl818haVdYCRrWV84o7YyeVm4QlVHStqNrrJSTb6jKuFAVqAFsr+K3Q==", + "license": "MIT" }, "node_modules/ultrahtml": { "version": "1.6.0", @@ -6847,7 +6844,6 @@ "version": "6.3.5", "resolved": "https://registry.npmjs.org/vite/-/vite-6.3.5.tgz", "integrity": "sha512-cZn6NDFE7wdTpINgs++ZJ4N49W2vRp8LCKrn3Ob1kYNtOo21vfDoaV5GzBfLU4MovSAB8uNRm4jgzVQZ+mBzPQ==", - "peer": true, "dependencies": { "esbuild": "^0.25.0", "fdir": "^6.4.4", @@ -7123,7 +7119,6 @@ "version": "3.25.76", "resolved": "https://registry.npmjs.org/zod/-/zod-3.25.76.tgz", "integrity": "sha512-gzUt/qt81nXsFGKIFcC3YnfEAx5NkunCfnDlvuBSSFS02bcXu4Lmea0AFIUwbLWxWPx3d9p8S5QoaujKcNQxcQ==", - "peer": true, "funding": { "url": "https://github.com/sponsors/colinhacks" } From 6a2be3265616679180dc3e0342eb46920f2a8ba9 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Thu, 23 Apr 2026 12:46:00 +0100 Subject: [PATCH 09/89] Bump vite from 6.3.5 to 6.4.2 (#25) Bumps [vite](https://github.com/vitejs/vite/tree/HEAD/packages/vite) from 6.3.5 to 6.4.2. - [Release notes](https://github.com/vitejs/vite/releases) - [Changelog](https://github.com/vitejs/vite/blob/v6.4.2/packages/vite/CHANGELOG.md) - [Commits](https://github.com/vitejs/vite/commits/v6.4.2/packages/vite) --- updated-dependencies: - dependency-name: vite dependency-version: 6.4.2 dependency-type: indirect ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- package-lock.json | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/package-lock.json b/package-lock.json index b85cb84..cb4d06f 100644 --- a/package-lock.json +++ b/package-lock.json @@ -6841,9 +6841,10 @@ } }, "node_modules/vite": { - "version": "6.3.5", - "resolved": "https://registry.npmjs.org/vite/-/vite-6.3.5.tgz", - "integrity": "sha512-cZn6NDFE7wdTpINgs++ZJ4N49W2vRp8LCKrn3Ob1kYNtOo21vfDoaV5GzBfLU4MovSAB8uNRm4jgzVQZ+mBzPQ==", + "version": "6.4.2", + "resolved": "https://registry.npmjs.org/vite/-/vite-6.4.2.tgz", + "integrity": "sha512-2N/55r4JDJ4gdrCvGgINMy+HH3iRpNIz8K6SFwVsA+JbQScLiC+clmAxBgwiSPgcG9U15QmvqCGWzMbqda5zGQ==", + "license": "MIT", "dependencies": { "esbuild": "^0.25.0", "fdir": "^6.4.4", From 6db92cb5d99e21dd5e6ed345d0e4248f19cbb4ea Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Thu, 23 Apr 2026 12:46:11 +0100 Subject: [PATCH 10/89] Bump rollup from 4.45.1 to 4.60.2 (#26) Bumps [rollup](https://github.com/rollup/rollup) from 4.45.1 to 4.60.2. - [Release notes](https://github.com/rollup/rollup/releases) - [Changelog](https://github.com/rollup/rollup/blob/master/CHANGELOG.md) - [Commits](https://github.com/rollup/rollup/compare/v4.45.1...v4.60.2) --- updated-dependencies: - dependency-name: rollup dependency-version: 4.60.2 dependency-type: indirect ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- package-lock.json | 261 +++++++++++++++++++++++++++++++--------------- 1 file changed, 176 insertions(+), 85 deletions(-) diff --git a/package-lock.json b/package-lock.json index cb4d06f..8d85133 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1251,240 +1251,325 @@ "integrity": "sha512-Rfkk/Mp/DL7JVje3u18FxFujQlTNR2q6QfMSMB7AvCBx91NGj/ba3kCfza0f6dVDbw7YlRf/nDrn7pQrCCyQ/w==" }, "node_modules/@rollup/rollup-android-arm-eabi": { - "version": "4.45.1", - "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.45.1.tgz", - "integrity": "sha512-NEySIFvMY0ZQO+utJkgoMiCAjMrGvnbDLHvcmlA33UXJpYBCvlBEbMMtV837uCkS+plG2umfhn0T5mMAxGrlRA==", + "version": "4.60.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.60.2.tgz", + "integrity": "sha512-dnlp69efPPg6Uaw2dVqzWRfAWRnYVb1XJ8CyyhIbZeaq4CA5/mLeZ1IEt9QqQxmbdvagjLIm2ZL8BxXv5lH4Yw==", "cpu": [ "arm" ], + "license": "MIT", "optional": true, "os": [ "android" ] }, "node_modules/@rollup/rollup-android-arm64": { - "version": "4.45.1", - "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.45.1.tgz", - "integrity": "sha512-ujQ+sMXJkg4LRJaYreaVx7Z/VMgBBd89wGS4qMrdtfUFZ+TSY5Rs9asgjitLwzeIbhwdEhyj29zhst3L1lKsRQ==", + "version": "4.60.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.60.2.tgz", + "integrity": "sha512-OqZTwDRDchGRHHm/hwLOL7uVPB9aUvI0am/eQuWMNyFHf5PSEQmyEeYYheA0EPPKUO/l0uigCp+iaTjoLjVoHg==", "cpu": [ "arm64" ], + "license": "MIT", "optional": true, "os": [ "android" ] }, "node_modules/@rollup/rollup-darwin-arm64": { - "version": "4.45.1", - "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.45.1.tgz", - "integrity": "sha512-FSncqHvqTm3lC6Y13xncsdOYfxGSLnP+73k815EfNmpewPs+EyM49haPS105Rh4aF5mJKywk9X0ogzLXZzN9lA==", + "version": "4.60.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.60.2.tgz", + "integrity": "sha512-UwRE7CGpvSVEQS8gUMBe1uADWjNnVgP3Iusyda1nSRwNDCsRjnGc7w6El6WLQsXmZTbLZx9cecegumcitNfpmA==", "cpu": [ "arm64" ], + "license": "MIT", "optional": true, "os": [ "darwin" ] }, "node_modules/@rollup/rollup-darwin-x64": { - "version": "4.45.1", - "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.45.1.tgz", - "integrity": "sha512-2/vVn/husP5XI7Fsf/RlhDaQJ7x9zjvC81anIVbr4b/f0xtSmXQTFcGIQ/B1cXIYM6h2nAhJkdMHTnD7OtQ9Og==", + "version": "4.60.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.60.2.tgz", + "integrity": "sha512-gjEtURKLCC5VXm1I+2i1u9OhxFsKAQJKTVB8WvDAHF+oZlq0GTVFOlTlO1q3AlCTE/DF32c16ESvfgqR7343/g==", "cpu": [ "x64" ], + "license": "MIT", "optional": true, "os": [ "darwin" ] }, "node_modules/@rollup/rollup-freebsd-arm64": { - "version": "4.45.1", - "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.45.1.tgz", - "integrity": "sha512-4g1kaDxQItZsrkVTdYQ0bxu4ZIQ32cotoQbmsAnW1jAE4XCMbcBPDirX5fyUzdhVCKgPcrwWuucI8yrVRBw2+g==", + "version": "4.60.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.60.2.tgz", + "integrity": "sha512-Bcl6CYDeAgE70cqZaMojOi/eK63h5Me97ZqAQoh77VPjMysA/4ORQBRGo3rRy45x4MzVlU9uZxs8Uwy7ZaKnBw==", "cpu": [ "arm64" ], + "license": "MIT", "optional": true, "os": [ "freebsd" ] }, "node_modules/@rollup/rollup-freebsd-x64": { - "version": "4.45.1", - "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.45.1.tgz", - "integrity": "sha512-L/6JsfiL74i3uK1Ti2ZFSNsp5NMiM4/kbbGEcOCps99aZx3g8SJMO1/9Y0n/qKlWZfn6sScf98lEOUe2mBvW9A==", + "version": "4.60.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.60.2.tgz", + "integrity": "sha512-LU+TPda3mAE2QB0/Hp5VyeKJivpC6+tlOXd1VMoXV/YFMvk/MNk5iXeBfB4MQGRWyOYVJ01625vjkr0Az98OJQ==", "cpu": [ "x64" ], + "license": "MIT", "optional": true, "os": [ "freebsd" ] }, "node_modules/@rollup/rollup-linux-arm-gnueabihf": { - "version": "4.45.1", - "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.45.1.tgz", - "integrity": "sha512-RkdOTu2jK7brlu+ZwjMIZfdV2sSYHK2qR08FUWcIoqJC2eywHbXr0L8T/pONFwkGukQqERDheaGTeedG+rra6Q==", + "version": "4.60.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.60.2.tgz", + "integrity": "sha512-2QxQrM+KQ7DAW4o22j+XZ6RKdxjLD7BOWTP0Bv0tmjdyhXSsr2Ul1oJDQqh9Zf5qOwTuTc7Ek83mOFaKnodPjg==", "cpu": [ "arm" ], + "license": "MIT", "optional": true, "os": [ "linux" ] }, "node_modules/@rollup/rollup-linux-arm-musleabihf": { - "version": "4.45.1", - "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.45.1.tgz", - "integrity": "sha512-3kJ8pgfBt6CIIr1o+HQA7OZ9mp/zDk3ctekGl9qn/pRBgrRgfwiffaUmqioUGN9hv0OHv2gxmvdKOkARCtRb8Q==", + "version": "4.60.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.60.2.tgz", + "integrity": "sha512-TbziEu2DVsTEOPif2mKWkMeDMLoYjx95oESa9fkQQK7r/Orta0gnkcDpzwufEcAO2BLBsD7mZkXGFqEdMRRwfw==", "cpu": [ "arm" ], + "license": "MIT", "optional": true, "os": [ "linux" ] }, "node_modules/@rollup/rollup-linux-arm64-gnu": { - "version": "4.45.1", - "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.45.1.tgz", - "integrity": "sha512-k3dOKCfIVixWjG7OXTCOmDfJj3vbdhN0QYEqB+OuGArOChek22hn7Uy5A/gTDNAcCy5v2YcXRJ/Qcnm4/ma1xw==", + "version": "4.60.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.60.2.tgz", + "integrity": "sha512-bO/rVDiDUuM2YfuCUwZ1t1cP+/yqjqz+Xf2VtkdppefuOFS2OSeAfgafaHNkFn0t02hEyXngZkxtGqXcXwO8Rg==", "cpu": [ "arm64" ], + "license": "MIT", "optional": true, "os": [ "linux" ] }, "node_modules/@rollup/rollup-linux-arm64-musl": { - "version": "4.45.1", - "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.45.1.tgz", - "integrity": "sha512-PmI1vxQetnM58ZmDFl9/Uk2lpBBby6B6rF4muJc65uZbxCs0EA7hhKCk2PKlmZKuyVSHAyIw3+/SiuMLxKxWog==", + "version": "4.60.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.60.2.tgz", + "integrity": "sha512-hr26p7e93Rl0Za+JwW7EAnwAvKkehh12BU1Llm9Ykiibg4uIr2rbpxG9WCf56GuvidlTG9KiiQT/TXT1yAWxTA==", "cpu": [ "arm64" ], + "license": "MIT", "optional": true, "os": [ "linux" ] }, - "node_modules/@rollup/rollup-linux-loongarch64-gnu": { - "version": "4.45.1", - "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loongarch64-gnu/-/rollup-linux-loongarch64-gnu-4.45.1.tgz", - "integrity": "sha512-9UmI0VzGmNJ28ibHW2GpE2nF0PBQqsyiS4kcJ5vK+wuwGnV5RlqdczVocDSUfGX/Na7/XINRVoUgJyFIgipoRg==", + "node_modules/@rollup/rollup-linux-loong64-gnu": { + "version": "4.60.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-gnu/-/rollup-linux-loong64-gnu-4.60.2.tgz", + "integrity": "sha512-pOjB/uSIyDt+ow3k/RcLvUAOGpysT2phDn7TTUB3n75SlIgZzM6NKAqlErPhoFU+npgY3/n+2HYIQVbF70P9/A==", "cpu": [ "loong64" ], + "license": "MIT", "optional": true, "os": [ "linux" ] }, - "node_modules/@rollup/rollup-linux-powerpc64le-gnu": { - "version": "4.45.1", - "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-powerpc64le-gnu/-/rollup-linux-powerpc64le-gnu-4.45.1.tgz", - "integrity": "sha512-7nR2KY8oEOUTD3pBAxIBBbZr0U7U+R9HDTPNy+5nVVHDXI4ikYniH1oxQz9VoB5PbBU1CZuDGHkLJkd3zLMWsg==", + "node_modules/@rollup/rollup-linux-loong64-musl": { + "version": "4.60.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-musl/-/rollup-linux-loong64-musl-4.60.2.tgz", + "integrity": "sha512-2/w+q8jszv9Ww1c+6uJT3OwqhdmGP2/4T17cu8WuwyUuuaCDDJ2ojdyYwZzCxx0GcsZBhzi3HmH+J5pZNXnd+Q==", + "cpu": [ + "loong64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-ppc64-gnu": { + "version": "4.60.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-gnu/-/rollup-linux-ppc64-gnu-4.60.2.tgz", + "integrity": "sha512-11+aL5vKheYgczxtPVVRhdptAM2H7fcDR5Gw4/bTcteuZBlH4oP9f5s9zYO9aGZvoGeBpqXI/9TZZihZ609wKw==", + "cpu": [ + "ppc64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-ppc64-musl": { + "version": "4.60.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-musl/-/rollup-linux-ppc64-musl-4.60.2.tgz", + "integrity": "sha512-i16fokAGK46IVZuV8LIIwMdtqhin9hfYkCh8pf8iC3QU3LpwL+1FSFGej+O7l3E/AoknL6Dclh2oTdnRMpTzFQ==", "cpu": [ "ppc64" ], + "license": "MIT", "optional": true, "os": [ "linux" ] }, "node_modules/@rollup/rollup-linux-riscv64-gnu": { - "version": "4.45.1", - "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.45.1.tgz", - "integrity": "sha512-nlcl3jgUultKROfZijKjRQLUu9Ma0PeNv/VFHkZiKbXTBQXhpytS8CIj5/NfBeECZtY2FJQubm6ltIxm/ftxpw==", + "version": "4.60.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.60.2.tgz", + "integrity": "sha512-49FkKS6RGQoriDSK/6E2GkAsAuU5kETFCh7pG4yD/ylj9rKhTmO3elsnmBvRD4PgJPds5W2PkhC82aVwmUcJ7A==", "cpu": [ "riscv64" ], + "license": "MIT", "optional": true, "os": [ "linux" ] }, "node_modules/@rollup/rollup-linux-riscv64-musl": { - "version": "4.45.1", - "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.45.1.tgz", - "integrity": "sha512-HJV65KLS51rW0VY6rvZkiieiBnurSzpzore1bMKAhunQiECPuxsROvyeaot/tcK3A3aGnI+qTHqisrpSgQrpgA==", + "version": "4.60.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.60.2.tgz", + "integrity": "sha512-mjYNkHPfGpUR00DuM1ZZIgs64Hpf4bWcz9Z41+4Q+pgDx73UwWdAYyf6EG/lRFldmdHHzgrYyge5akFUW0D3mQ==", "cpu": [ "riscv64" ], + "license": "MIT", "optional": true, "os": [ "linux" ] }, "node_modules/@rollup/rollup-linux-s390x-gnu": { - "version": "4.45.1", - "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.45.1.tgz", - "integrity": "sha512-NITBOCv3Qqc6hhwFt7jLV78VEO/il4YcBzoMGGNxznLgRQf43VQDae0aAzKiBeEPIxnDrACiMgbqjuihx08OOw==", + "version": "4.60.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.60.2.tgz", + "integrity": "sha512-ALyvJz965BQk8E9Al/JDKKDLH2kfKFLTGMlgkAbbYtZuJt9LU8DW3ZoDMCtQpXAltZxwBHevXz5u+gf0yA0YoA==", "cpu": [ "s390x" ], + "license": "MIT", "optional": true, "os": [ "linux" ] }, "node_modules/@rollup/rollup-linux-x64-gnu": { - "version": "4.45.1", - "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.45.1.tgz", - "integrity": "sha512-+E/lYl6qu1zqgPEnTrs4WysQtvc/Sh4fC2nByfFExqgYrqkKWp1tWIbe+ELhixnenSpBbLXNi6vbEEJ8M7fiHw==", + "version": "4.60.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.60.2.tgz", + "integrity": "sha512-UQjrkIdWrKI626Du8lCQ6MJp/6V1LAo2bOK9OTu4mSn8GGXIkPXk/Vsp4bLHCd9Z9Iz2OTEaokUE90VweJgIYQ==", "cpu": [ "x64" ], + "license": "MIT", "optional": true, "os": [ "linux" ] }, "node_modules/@rollup/rollup-linux-x64-musl": { - "version": "4.45.1", - "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.45.1.tgz", - "integrity": "sha512-a6WIAp89p3kpNoYStITT9RbTbTnqarU7D8N8F2CV+4Cl9fwCOZraLVuVFvlpsW0SbIiYtEnhCZBPLoNdRkjQFw==", + "version": "4.60.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.60.2.tgz", + "integrity": "sha512-bTsRGj6VlSdn/XD4CGyzMnzaBs9bsRxy79eTqTCBsA8TMIEky7qg48aPkvJvFe1HyzQ5oMZdg7AnVlWQSKLTnw==", "cpu": [ "x64" ], + "license": "MIT", "optional": true, "os": [ "linux" ] }, + "node_modules/@rollup/rollup-openbsd-x64": { + "version": "4.60.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-openbsd-x64/-/rollup-openbsd-x64-4.60.2.tgz", + "integrity": "sha512-6d4Z3534xitaA1FcMWP7mQPq5zGwBmGbhphh2DwaA1aNIXUu3KTOfwrWpbwI4/Gr0uANo7NTtaykFyO2hPuFLg==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ] + }, + "node_modules/@rollup/rollup-openharmony-arm64": { + "version": "4.60.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-openharmony-arm64/-/rollup-openharmony-arm64-4.60.2.tgz", + "integrity": "sha512-NetAg5iO2uN7eB8zE5qrZ3CSil+7IJt4WDFLcC75Ymywq1VZVD6qJ6EvNLjZ3rEm6gB7XW5JdT60c6MN35Z85Q==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "openharmony" + ] + }, "node_modules/@rollup/rollup-win32-arm64-msvc": { - "version": "4.45.1", - "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.45.1.tgz", - "integrity": "sha512-T5Bi/NS3fQiJeYdGvRpTAP5P02kqSOpqiopwhj0uaXB6nzs5JVi2XMJb18JUSKhCOX8+UE1UKQufyD6Or48dJg==", + "version": "4.60.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.60.2.tgz", + "integrity": "sha512-NCYhOotpgWZ5kdxCZsv6Iudx0wX8980Q/oW4pNFNihpBKsDbEA1zpkfxJGC0yugsUuyDZ7gL37dbzwhR0VI7pQ==", "cpu": [ "arm64" ], + "license": "MIT", "optional": true, "os": [ "win32" ] }, "node_modules/@rollup/rollup-win32-ia32-msvc": { - "version": "4.45.1", - "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.45.1.tgz", - "integrity": "sha512-lxV2Pako3ujjuUe9jiU3/s7KSrDfH6IgTSQOnDWr9aJ92YsFd7EurmClK0ly/t8dzMkDtd04g60WX6yl0sGfdw==", + "version": "4.60.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.60.2.tgz", + "integrity": "sha512-RXsaOqXxfoUBQoOgvmmijVxJnW2IGB0eoMO7F8FAjaj0UTywUO/luSqimWBJn04WNgUkeNhh7fs7pESXajWmkg==", "cpu": [ "ia32" ], + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-x64-gnu": { + "version": "4.60.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-gnu/-/rollup-win32-x64-gnu-4.60.2.tgz", + "integrity": "sha512-qdAzEULD+/hzObedtmV6iBpdL5TIbKVztGiK7O3/KYSf+HIzU257+MX1EXJcyIiDbMAqmbwaufcYPvyRryeZtA==", + "cpu": [ + "x64" + ], + "license": "MIT", "optional": true, "os": [ "win32" ] }, "node_modules/@rollup/rollup-win32-x64-msvc": { - "version": "4.45.1", - "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.45.1.tgz", - "integrity": "sha512-M/fKi4sasCdM8i0aWJjCSFm2qEnYRR8AMLG2kxp6wD13+tMGA4Z1tVAuHkNRjud5SW2EM3naLuK35w9twvf6aA==", + "version": "4.60.2", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.60.2.tgz", + "integrity": "sha512-Nd/SgG27WoA9e+/TdK74KnHz852TLa94ovOYySo/yMPuTmpckK/jIF2jSwS3g7ELSKXK13/cVdmg1Z/DaCWKxA==", "cpu": [ "x64" ], + "license": "MIT", "optional": true, "os": [ "win32" @@ -5933,9 +6018,10 @@ } }, "node_modules/rollup": { - "version": "4.45.1", - "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.45.1.tgz", - "integrity": "sha512-4iya7Jb76fVpQyLoiVpzUrsjQ12r3dM7fIVz+4NwoYvZOShknRmiv+iu9CClZml5ZLGb0XMcYLutK6w9tgxHDw==", + "version": "4.60.2", + "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.60.2.tgz", + "integrity": "sha512-J9qZyW++QK/09NyN/zeO0dG/1GdGfyp9lV8ajHnRVLfo/uFsbji5mHnDgn/qYdUHyCkM2N+8VyspgZclfAh0eQ==", + "license": "MIT", "dependencies": { "@types/estree": "1.0.8" }, @@ -5947,26 +6033,31 @@ "npm": ">=8.0.0" }, "optionalDependencies": { - "@rollup/rollup-android-arm-eabi": "4.45.1", - "@rollup/rollup-android-arm64": "4.45.1", - "@rollup/rollup-darwin-arm64": "4.45.1", - "@rollup/rollup-darwin-x64": "4.45.1", - "@rollup/rollup-freebsd-arm64": "4.45.1", - "@rollup/rollup-freebsd-x64": "4.45.1", - "@rollup/rollup-linux-arm-gnueabihf": "4.45.1", - "@rollup/rollup-linux-arm-musleabihf": "4.45.1", - "@rollup/rollup-linux-arm64-gnu": "4.45.1", - "@rollup/rollup-linux-arm64-musl": "4.45.1", - "@rollup/rollup-linux-loongarch64-gnu": "4.45.1", - "@rollup/rollup-linux-powerpc64le-gnu": "4.45.1", - "@rollup/rollup-linux-riscv64-gnu": "4.45.1", - "@rollup/rollup-linux-riscv64-musl": "4.45.1", - "@rollup/rollup-linux-s390x-gnu": "4.45.1", - "@rollup/rollup-linux-x64-gnu": "4.45.1", - "@rollup/rollup-linux-x64-musl": "4.45.1", - "@rollup/rollup-win32-arm64-msvc": "4.45.1", - "@rollup/rollup-win32-ia32-msvc": "4.45.1", - "@rollup/rollup-win32-x64-msvc": "4.45.1", + "@rollup/rollup-android-arm-eabi": "4.60.2", + "@rollup/rollup-android-arm64": "4.60.2", + "@rollup/rollup-darwin-arm64": "4.60.2", + "@rollup/rollup-darwin-x64": "4.60.2", + "@rollup/rollup-freebsd-arm64": "4.60.2", + "@rollup/rollup-freebsd-x64": "4.60.2", + "@rollup/rollup-linux-arm-gnueabihf": "4.60.2", + "@rollup/rollup-linux-arm-musleabihf": "4.60.2", + "@rollup/rollup-linux-arm64-gnu": "4.60.2", + "@rollup/rollup-linux-arm64-musl": "4.60.2", + "@rollup/rollup-linux-loong64-gnu": "4.60.2", + "@rollup/rollup-linux-loong64-musl": "4.60.2", + "@rollup/rollup-linux-ppc64-gnu": "4.60.2", + "@rollup/rollup-linux-ppc64-musl": "4.60.2", + "@rollup/rollup-linux-riscv64-gnu": "4.60.2", + "@rollup/rollup-linux-riscv64-musl": "4.60.2", + "@rollup/rollup-linux-s390x-gnu": "4.60.2", + "@rollup/rollup-linux-x64-gnu": "4.60.2", + "@rollup/rollup-linux-x64-musl": "4.60.2", + "@rollup/rollup-openbsd-x64": "4.60.2", + "@rollup/rollup-openharmony-arm64": "4.60.2", + "@rollup/rollup-win32-arm64-msvc": "4.60.2", + "@rollup/rollup-win32-ia32-msvc": "4.60.2", + "@rollup/rollup-win32-x64-gnu": "4.60.2", + "@rollup/rollup-win32-x64-msvc": "4.60.2", "fsevents": "~2.3.2" } }, From 6a6010c587c45ac7cbefe54944488a9424a76cce Mon Sep 17 00:00:00 2001 From: patchstackdave <87758879+patchstackdave@users.noreply.github.com> Date: Thu, 23 Apr 2026 13:54:11 +0200 Subject: [PATCH 11/89] Added WP plugin 2.3.6 changelog (#29) --- .../docs/Patchstack Plugin/plugin-changelog.md | 13 +++++++++++-- 1 file changed, 11 insertions(+), 2 deletions(-) diff --git a/src/content/docs/Patchstack Plugin/plugin-changelog.md b/src/content/docs/Patchstack Plugin/plugin-changelog.md index d87b4e4..7b2c8df 100644 --- a/src/content/docs/Patchstack Plugin/plugin-changelog.md +++ b/src/content/docs/Patchstack Plugin/plugin-changelog.md @@ -8,10 +8,20 @@ updatedAt: "Wed Jan 17 2024 10:39:45 GMT+0000 (Coordinated Universal Time)" sidebar: order: 8 --- -January 6th, 2026 +April 22nd, 2026
      +
    • Version 2.3.6
    • +
    • Added: 2 new CLI commands (deactivate and status)
    • +
    • Added: a filter to the software gathering function
    • +
    • Added: constant to be able to disable the admin menu actions
    • +
    • Changed: prevent Patchstack init from running multiple times in case it has been invoked already
    • +
    • Changed: mu-plugin.php stub file to support mu-plugins directory for skipping execution
    • +
    + +January 6th, 2026 +
    • Version 2.3.5
    • Added: default policy for license activation
    • Added: clause to avoid HTTP call if htaccess feature is disabled
    • @@ -22,7 +32,6 @@ sidebar: December 3rd 2025
        -
      • Version 2.3.4
      • Changed: WordPress version stable tag
      • Fixed: plugin redirect if more than one plugin is being activated
      • From 3b511bbeb194cfef50e8f95742502d70fe1191fd Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Thu, 23 Apr 2026 12:57:15 +0100 Subject: [PATCH 12/89] Bump picomatch (#31) Bumps and [picomatch](https://github.com/micromatch/picomatch). These dependencies needed to be updated together. Updates `picomatch` from 4.0.3 to 4.0.4 - [Release notes](https://github.com/micromatch/picomatch/releases) - [Changelog](https://github.com/micromatch/picomatch/blob/master/CHANGELOG.md) - [Commits](https://github.com/micromatch/picomatch/compare/4.0.3...4.0.4) Updates `picomatch` from 2.3.1 to 2.3.2 - [Release notes](https://github.com/micromatch/picomatch/releases) - [Changelog](https://github.com/micromatch/picomatch/blob/master/CHANGELOG.md) - [Commits](https://github.com/micromatch/picomatch/compare/4.0.3...4.0.4) --- updated-dependencies: - dependency-name: picomatch dependency-version: 4.0.4 dependency-type: indirect - dependency-name: picomatch dependency-version: 2.3.2 dependency-type: indirect ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- package-lock.json | 21 ++++++++++++--------- 1 file changed, 12 insertions(+), 9 deletions(-) diff --git a/package-lock.json b/package-lock.json index 8d85133..0640278 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1908,9 +1908,10 @@ } }, "node_modules/anymatch/node_modules/picomatch": { - "version": "2.3.1", - "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.1.tgz", - "integrity": "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==", + "version": "2.3.2", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.2.tgz", + "integrity": "sha512-V7+vQEJ06Z+c5tSye8S+nHUfI51xoXIXjHQ99cQtKUkQqqO1kO/KCJUfZXuB47h/YBlDhah2H3hdUGXn8ie0oA==", + "license": "MIT", "engines": { "node": ">=8.6" }, @@ -4897,9 +4898,10 @@ } }, "node_modules/micromatch/node_modules/picomatch": { - "version": "2.3.1", - "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.1.tgz", - "integrity": "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==", + "version": "2.3.2", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.2.tgz", + "integrity": "sha512-V7+vQEJ06Z+c5tSye8S+nHUfI51xoXIXjHQ99cQtKUkQqqO1kO/KCJUfZXuB47h/YBlDhah2H3hdUGXn8ie0oA==", + "license": "MIT", "engines": { "node": ">=8.6" }, @@ -5427,9 +5429,10 @@ "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==" }, "node_modules/picomatch": { - "version": "4.0.3", - "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.3.tgz", - "integrity": "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==", + "version": "4.0.4", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.4.tgz", + "integrity": "sha512-QP88BAKvMam/3NxH6vj2o21R6MjxZUAd6nlwAS/pnGvN9IVLocLHxGYIzFhg6fUQ+5th6P4dv4eW9jX3DSIj7A==", + "license": "MIT", "engines": { "node": ">=12" }, From e80f91b4eae479143ec76b3cd96a03c019983613 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Thu, 23 Apr 2026 12:57:22 +0100 Subject: [PATCH 13/89] Bump devalue from 5.1.1 to 5.7.1 (#30) Bumps [devalue](https://github.com/sveltejs/devalue) from 5.1.1 to 5.7.1. - [Release notes](https://github.com/sveltejs/devalue/releases) - [Changelog](https://github.com/sveltejs/devalue/blob/main/CHANGELOG.md) - [Commits](https://github.com/sveltejs/devalue/compare/v5.1.1...v5.7.1) --- updated-dependencies: - dependency-name: devalue dependency-version: 5.7.1 dependency-type: indirect ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- package-lock.json | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/package-lock.json b/package-lock.json index 0640278..61b3543 100644 --- a/package-lock.json +++ b/package-lock.json @@ -2665,9 +2665,10 @@ } }, "node_modules/devalue": { - "version": "5.1.1", - "resolved": "https://registry.npmjs.org/devalue/-/devalue-5.1.1.tgz", - "integrity": "sha512-maua5KUiapvEwiEAe+XnlZ3Rh0GD+qI1J/nb9vrJc3muPXvcF/8gXYTWF76+5DAqHyDUtOIImEuo0YKE9mshVw==" + "version": "5.7.1", + "resolved": "https://registry.npmjs.org/devalue/-/devalue-5.7.1.tgz", + "integrity": "sha512-MUbZ586EgQqdRnC4yDrlod3BEdyvE4TapGYHMW2CiaW+KkkFmWEFqBUaLltEZCGi0iFXCEjRF0OjF0DV2QHjOA==", + "license": "MIT" }, "node_modules/devlop": { "version": "1.1.0", From cc84235f48b3d119a29cf722c2e249c62d736bfa Mon Sep 17 00:00:00 2001 From: Elliot Date: Thu, 23 Apr 2026 14:29:36 +0100 Subject: [PATCH 14/89] Add Dependabot config for weekly npm and Actions updates (#28) Groups minor/patch into a single PR and ignores major version bumps; security updates still bypass the ignore rule. Co-authored-by: Claude Opus 4.7 --- .github/dependabot.yml | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) create mode 100644 .github/dependabot.yml diff --git a/.github/dependabot.yml b/.github/dependabot.yml new file mode 100644 index 0000000..e16622d --- /dev/null +++ b/.github/dependabot.yml @@ -0,0 +1,28 @@ +version: 2 +updates: + - package-ecosystem: "npm" + directory: "/" + schedule: + interval: "weekly" + open-pull-requests-limit: 5 + labels: + - "dependencies" + - "frontend" + ignore: + - dependency-name: "*" + update-types: ["version-update:semver-major"] + groups: + non-major: + update-types: ["minor", "patch"] + + - package-ecosystem: "github-actions" + directory: "/" + schedule: + interval: "weekly" + open-pull-requests-limit: 3 + labels: + - "dependencies" + - "ci" + ignore: + - dependency-name: "*" + update-types: ["version-update:semver-major"] From c995fb5555ae2baedfe571f101b6e330e075c185 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Fri, 24 Apr 2026 09:15:11 +0100 Subject: [PATCH 15/89] Bump smol-toml from 1.4.1 to 1.6.1 (#35) Bumps [smol-toml](https://github.com/squirrelchat/smol-toml) from 1.4.1 to 1.6.1. - [Release notes](https://github.com/squirrelchat/smol-toml/releases) - [Commits](https://github.com/squirrelchat/smol-toml/compare/v1.4.1...v1.6.1) --- updated-dependencies: - dependency-name: smol-toml dependency-version: 1.6.1 dependency-type: indirect ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- package-lock.json | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/package-lock.json b/package-lock.json index 61b3543..01402de 100644 --- a/package-lock.json +++ b/package-lock.json @@ -6238,9 +6238,10 @@ "integrity": "sha512-w+tIMs3rq2afQdsPJlODhoUEKzFP1ayaoyl1CcnwtIlsVe7K7bA1NGm4s3PraqTLlXnbIN84zuBlxBWo1u9BLw==" }, "node_modules/smol-toml": { - "version": "1.4.1", - "resolved": "https://registry.npmjs.org/smol-toml/-/smol-toml-1.4.1.tgz", - "integrity": "sha512-CxdwHXyYTONGHThDbq5XdwbFsuY4wlClRGejfE2NtwUtiHYsP1QtNsHb/hnj31jKYSchztJsaA8pSQoVzkfCFg==", + "version": "1.6.1", + "resolved": "https://registry.npmjs.org/smol-toml/-/smol-toml-1.6.1.tgz", + "integrity": "sha512-dWUG8F5sIIARXih1DTaQAX4SsiTXhInKf1buxdY9DIg4ZYPZK5nGM1VRIYmEbDbsHt7USo99xSLFu5Q1IqTmsg==", + "license": "BSD-3-Clause", "engines": { "node": ">= 18" }, From b396bc544deae2d6bf37d141942e8a751f4ac0d7 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Fri, 24 Apr 2026 09:15:30 +0100 Subject: [PATCH 16/89] Bump diff from 5.2.0 to 5.2.2 (#34) Bumps [diff](https://github.com/kpdecker/jsdiff) from 5.2.0 to 5.2.2. - [Changelog](https://github.com/kpdecker/jsdiff/blob/master/release-notes.md) - [Commits](https://github.com/kpdecker/jsdiff/compare/v5.2.0...v5.2.2) --- updated-dependencies: - dependency-name: diff dependency-version: 5.2.2 dependency-type: indirect ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- package-lock.json | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/package-lock.json b/package-lock.json index 01402de..902d0f0 100644 --- a/package-lock.json +++ b/package-lock.json @@ -2688,9 +2688,10 @@ "integrity": "sha512-ED3jP8saaweFTjeGX8HQPjeC1YYyZs98jGNZx6IiBvxW7JG5v492kamAQB3m2wop07CvU/RQmzcKr6bgcC5D/Q==" }, "node_modules/diff": { - "version": "5.2.0", - "resolved": "https://registry.npmjs.org/diff/-/diff-5.2.0.tgz", - "integrity": "sha512-uIFDxqpRZGZ6ThOk84hEfqWoHx2devRFvpTZcTHur85vImfaxUbTW9Ryh4CpCuDnToOP1CEtXKIgytHBPVff5A==", + "version": "5.2.2", + "resolved": "https://registry.npmjs.org/diff/-/diff-5.2.2.tgz", + "integrity": "sha512-vtcDfH3TOjP8UekytvnHH1o1P4FcUdt4eQ1Y+Abap1tk/OB2MWQvcwS2ClCd1zuIhc3JKOx6p3kod8Vfys3E+A==", + "license": "BSD-3-Clause", "engines": { "node": ">=0.3.1" } From 2118d3ac76933e88b95092c1692f54f395707572 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Fri, 24 Apr 2026 09:17:06 +0100 Subject: [PATCH 17/89] Bump mdast-util-to-hast from 13.2.0 to 13.2.1 (#33) Bumps [mdast-util-to-hast](https://github.com/syntax-tree/mdast-util-to-hast) from 13.2.0 to 13.2.1. - [Release notes](https://github.com/syntax-tree/mdast-util-to-hast/releases) - [Commits](https://github.com/syntax-tree/mdast-util-to-hast/compare/13.2.0...13.2.1) --- updated-dependencies: - dependency-name: mdast-util-to-hast dependency-version: 13.2.1 dependency-type: indirect ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- package-lock.json | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/package-lock.json b/package-lock.json index 902d0f0..3e7f090 100644 --- a/package-lock.json +++ b/package-lock.json @@ -4131,9 +4131,10 @@ } }, "node_modules/mdast-util-to-hast": { - "version": "13.2.0", - "resolved": "https://registry.npmjs.org/mdast-util-to-hast/-/mdast-util-to-hast-13.2.0.tgz", - "integrity": "sha512-QGYKEuUsYT9ykKBCMOEDLsU5JRObWQusAolFMeko/tYPufNkRffBAQjIE+99jbA87xv6FgmjLtwjh9wBWajwAA==", + "version": "13.2.1", + "resolved": "https://registry.npmjs.org/mdast-util-to-hast/-/mdast-util-to-hast-13.2.1.tgz", + "integrity": "sha512-cctsq2wp5vTsLIcaymblUriiTcZd0CwWtCbLvrOzYCDZoWyMNV8sZ7krj09FSnsiJi3WVsHLM4k6Dq/yaPyCXA==", + "license": "MIT", "dependencies": { "@types/hast": "^3.0.0", "@types/mdast": "^4.0.0", From f4477ef86991e4fbea805d472adbc4a86a93567a Mon Sep 17 00:00:00 2001 From: Elliot Date: Fri, 24 Apr 2026 09:18:27 +0100 Subject: [PATCH 18/89] Threat Intelligence Standard + Extended: OpenAPI specs, interactive reference, Postman (#27) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Threat Intelligence Standard + Extended: OpenAPI specs, interactive reference, Postman Bring Standard and Extended tiers up to the Beta doc pattern: hand-authored OpenAPI 3.1 specs drive the interactive reference and generate deterministic Postman collections at build. Guide pages are slimmed to narrative content (auth, rate limits, errors, code samples) and the Overview comparison table is replaced with per-tier pointer blocks now that all three tiers are documented the same way. Sidebar nests each tier as Guide + Reference via per-schema createOpenAPISidebarGroup() placeholders. Co-Authored-By: Claude Opus 4.7 (1M context) * Threat Intelligence docs: consolidate shared tooling into Overview Postman / Insomnia / Bruno / Hoppscotch import instructions, LLM-assistant guidance, and SDK-generation snippets were duplicated across the three tier Guides. Moved to a single "Using the APIs with your tools" section on the Overview, with each Guide linking to it. Tier-specific content (base URL, auth, rate limits, errors, curl samples, tier-unique concepts) stays on the Guide pages. Co-Authored-By: Claude Opus 4.7 (1M context) * Remove sidebar badge down-weighting rule Previously the Beta group was the only sibling with a badge, so de-emphasising its label let the green [Beta] pill carry the emphasis. Now that Standard, Extended and Beta API are peer groups, the rule made the Beta row read as lighter than the other two. Drop it so all three groups render at the same weight; the badge is still there to signal Beta status. Co-Authored-By: Claude Opus 4.7 (1M context) * Fix typos: prioriy/severiy and ISO 127001 - Getting Started → "patch prioriy and severiy score" → "priority and severity" - FAQ → ISO 127001 → ISO 27001, in the page title and the URL slug. Renamed the file to match, redirected the old URL to the new one, and updated the existing /docs/ → /faq-troubleshooting/ redirect to land on the corrected URL. Co-Authored-By: Claude Opus 4.7 (1M context) --------- Co-authored-by: Claude Opus 4.7 (1M context) --- astro.config.mjs | 48 +- netlify.toml | 6 +- ...eat-intel-extended.postman_collection.json | 1494 +++++++++++++++++ public/schemas/threat-intel-extended.yaml | 643 +++++++ ...eat-intel-standard.postman_collection.json | 741 ++++++++ public/schemas/threat-intel-standard.yaml | 261 +++ .../Threat Intelligence API/beta.md | 47 +- .../Threat Intelligence API/extended.md | 610 ++----- .../Threat Intelligence API/overview.md | 142 +- .../Threat Intelligence API/standard.md | 125 +- ...oc2-iso-27001-or-other-security-checks.md} | 2 +- .../Getting Started/start-using-patchstack.md | 2 +- src/styles/custom.css | 8 - 13 files changed, 3447 insertions(+), 682 deletions(-) create mode 100644 public/schemas/threat-intel-extended.postman_collection.json create mode 100644 public/schemas/threat-intel-extended.yaml create mode 100644 public/schemas/threat-intel-standard.postman_collection.json create mode 100644 public/schemas/threat-intel-standard.yaml rename src/content/docs/FAQ Troubleshooting/Technical/{will-patchstack-plugin-help-my-site-pass-pci-dss-soc2-iso-127001-or-other-security-checks.md => will-patchstack-plugin-help-my-site-pass-pci-dss-soc2-iso-27001-or-other-security-checks.md} (93%) diff --git a/astro.config.mjs b/astro.config.mjs index 9014f3c..eb7302f 100644 --- a/astro.config.mjs +++ b/astro.config.mjs @@ -3,15 +3,27 @@ import { fileURLToPath } from 'node:url'; import { defineConfig, passthroughImageService } from 'astro/config'; import starlight from '@astrojs/starlight'; import starlightLlmsTxt from 'starlight-llms-txt' -import starlightOpenAPI, { openAPISidebarGroups } from 'starlight-openapi' +import starlightOpenAPI, { createOpenAPISidebarGroup } from 'starlight-openapi' import Converter from 'openapi-to-postmanv2' +const threatIntelStandardSidebarGroup = createOpenAPISidebarGroup(); +const threatIntelExtendedSidebarGroup = createOpenAPISidebarGroup(); +const threatIntelBetaSidebarGroup = createOpenAPISidebarGroup(); + const site_url = process.env.URL; const site = site_url || 'http://localhost:4321'; const postmanCollections = [ + { + openapi: './public/schemas/threat-intel-standard.yaml', + output: './public/schemas/threat-intel-standard.postman_collection.json', + }, + { + openapi: './public/schemas/threat-intel-extended.yaml', + output: './public/schemas/threat-intel-extended.postman_collection.json', + }, { openapi: './public/schemas/threat-intel-beta.yaml', output: './public/schemas/threat-intel-beta.postman_collection.json', @@ -81,10 +93,20 @@ export default defineConfig({ plugins: [ starlightLlmsTxt(), starlightOpenAPI([ + { + base: 'api-reference/threat-intelligence-standard', + schema: './public/schemas/threat-intel-standard.yaml', + sidebar: { label: 'Reference', group: threatIntelStandardSidebarGroup }, + }, + { + base: 'api-reference/threat-intelligence-extended', + schema: './public/schemas/threat-intel-extended.yaml', + sidebar: { label: 'Reference', group: threatIntelExtendedSidebarGroup }, + }, { base: 'api-reference/threat-intelligence-beta', - label: 'Reference', schema: './public/schemas/threat-intel-beta.yaml', + sidebar: { label: 'Reference', group: threatIntelBetaSidebarGroup }, }, ]), ], @@ -143,18 +165,32 @@ export default defineConfig({ collapsed: true, items: [ { slug: 'api-solutions/threat-intelligence-api/overview' }, - { slug: 'api-solutions/threat-intelligence-api/standard' }, - { slug: 'api-solutions/threat-intelligence-api/extended' }, - { slug: 'api-solutions/threat-intelligence-api/api-properties' }, + { + label: 'Standard API', + collapsed: true, + items: [ + { slug: 'api-solutions/threat-intelligence-api/standard' }, + threatIntelStandardSidebarGroup, + ], + }, + { + label: 'Extended API', + collapsed: true, + items: [ + { slug: 'api-solutions/threat-intelligence-api/extended' }, + threatIntelExtendedSidebarGroup, + ], + }, { label: 'NPM standard API', badge: { text: 'Beta', variant: 'tip' }, collapsed: true, items: [ { slug: 'api-solutions/threat-intelligence-api/beta' }, - ...openAPISidebarGroups, + threatIntelBetaSidebarGroup, ], }, + { slug: 'api-solutions/threat-intelligence-api/api-properties' }, ], }, ], diff --git a/netlify.toml b/netlify.toml index 7428d8b..16778d6 100644 --- a/netlify.toml +++ b/netlify.toml @@ -666,7 +666,11 @@ [[redirects]] from = "/docs/will-patchstack-plugin-help-my-site-pass-pci-dss-soc2-iso-127001-or-other-security-checks" - to = "/faq-troubleshooting/technical/will-patchstack-plugin-help-my-site-pass-pci-dss-soc2-iso-127001-or-other-security-checks/" + to = "/faq-troubleshooting/technical/will-patchstack-plugin-help-my-site-pass-pci-dss-soc2-iso-27001-or-other-security-checks/" + +[[redirects]] + from = "/faq-troubleshooting/technical/will-patchstack-plugin-help-my-site-pass-pci-dss-soc2-iso-127001-or-other-security-checks" + to = "/faq-troubleshooting/technical/will-patchstack-plugin-help-my-site-pass-pci-dss-soc2-iso-27001-or-other-security-checks/" [[redirects]] from = "/docs/updating-patchstack-from-2020" diff --git a/public/schemas/threat-intel-extended.postman_collection.json b/public/schemas/threat-intel-extended.postman_collection.json new file mode 100644 index 0000000..43d7c8b --- /dev/null +++ b/public/schemas/threat-intel-extended.postman_collection.json @@ -0,0 +1,1494 @@ +{ + "item": [ + { + "name": "Latest vulnerabilities", + "request": { + "name": "Latest vulnerabilities", + "description": { + "content": "Return the 20 most recently added vulnerabilities, ordered by\ndescending `created_at` (insertion time, not `disclosure_date`).\n", + "type": "text/plain" + }, + "url": { + "path": [ + "latest" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "auth": null + }, + "response": [ + { + "name": "The 20 most recent vulnerabilities.", + "originalRequest": { + "url": { + "path": [ + "latest" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"vulnerabilities\": [\n {\n \"id\": 7976,\n \"product_id\": 2175,\n \"title\": \"WordPress File Upload plugin <= 4.16.2 - Contributor+ Path Traversal vulnerability leading to Remote Code Execution (RCE)\",\n \"description\": \"Contributor+ Path Traversal vulnerability leading to Remote Code Execution (RCE) discovered by apple502j in WordPress File Upload plugin (versions <= 4.16.2).\",\n \"disclosed_at\": \"2022-03-01T00:00:00+00:00\",\n \"created_at\": \"2022-03-07T11:17:05+00:00\",\n \"url\": \"wordpress-file-upload-plugin-4-16-2-contributor-path-traversal-vulnerability-leading-to-remote-code-execution-rce\",\n \"product_slug\": \"wp-file-upload\",\n \"product_name\": \"WordPress File Upload\",\n \"product_type\": \"Plugin\",\n \"vuln_type\": \"Directory Traversal\",\n \"cve\": [\n \"2021-24962\"\n ],\n \"affected_in\": \"<= 4.16.2\",\n \"fixed_in\": \"4.16.3\",\n \"direct_url\": \"https://patchstack.com/database/vulnerability/wp-file-upload/wordpress-file-upload-plugin-4-16-2-contributor-path-traversal-vulnerability-leading-to-remote-code-execution-rce\",\n \"disclosure_date\": \"2022-03-01 00:00:00\",\n \"product_name_premium\": null,\n \"cvss_score\": 8.8,\n \"is_exploited\": false,\n \"patch_priority\": 3,\n \"patched_in_ranges\": [\n {\n \"from_version\": \"3.0\",\n \"to_version\": \"3.0.34.1\",\n \"fixed_in\": \"3.0.34.2\"\n },\n {\n \"from_version\": \"3.0\",\n \"to_version\": \"3.0.34.1\",\n \"fixed_in\": \"3.0.34.2\"\n }\n ]\n },\n {\n \"id\": 7976,\n \"product_id\": 2175,\n \"title\": \"WordPress File Upload plugin <= 4.16.2 - Contributor+ Path Traversal vulnerability leading to Remote Code Execution (RCE)\",\n \"description\": \"Contributor+ Path Traversal vulnerability leading to Remote Code Execution (RCE) discovered by apple502j in WordPress File Upload plugin (versions <= 4.16.2).\",\n \"disclosed_at\": \"2022-03-01T00:00:00+00:00\",\n \"created_at\": \"2022-03-07T11:17:05+00:00\",\n \"url\": \"wordpress-file-upload-plugin-4-16-2-contributor-path-traversal-vulnerability-leading-to-remote-code-execution-rce\",\n \"product_slug\": \"wp-file-upload\",\n \"product_name\": \"WordPress File Upload\",\n \"product_type\": \"Plugin\",\n \"vuln_type\": \"Directory Traversal\",\n \"cve\": [\n \"2021-24962\"\n ],\n \"affected_in\": \"<= 4.16.2\",\n \"fixed_in\": \"4.16.3\",\n \"direct_url\": \"https://patchstack.com/database/vulnerability/wp-file-upload/wordpress-file-upload-plugin-4-16-2-contributor-path-traversal-vulnerability-leading-to-remote-code-execution-rce\",\n \"disclosure_date\": \"2022-03-01 00:00:00\",\n \"product_name_premium\": null,\n \"cvss_score\": 8.8,\n \"is_exploited\": false,\n \"patch_priority\": 3,\n \"patched_in_ranges\": [\n {\n \"from_version\": \"3.0\",\n \"to_version\": \"3.0.34.1\",\n \"fixed_in\": \"3.0.34.2\"\n },\n {\n \"from_version\": \"3.0\",\n \"to_version\": \"3.0.34.1\",\n \"fixed_in\": \"3.0.34.2\"\n }\n ]\n }\n ]\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "name": "Missing or invalid `PSKey` header.", + "originalRequest": { + "url": { + "path": [ + "latest" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "GET", + "body": {} + }, + "status": "Unauthorized", + "code": 401, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + }, + { + "name": "API key not authorised for the requested endpoint.", + "originalRequest": { + "url": { + "path": [ + "latest" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "GET", + "body": {} + }, + "status": "Forbidden", + "code": 403, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + }, + { + "name": "Rate limit exceeded.", + "originalRequest": { + "url": { + "path": [ + "latest" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "GET", + "body": {} + }, + "status": "Too Many Requests", + "code": 429, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "name": "product/{type}/{name}/{version}", + "item": [ + { + "name": "Find vulnerabilities for a product", + "request": { + "name": "Find vulnerabilities for a product", + "description": { + "content": "Match a specific WordPress plugin, theme or core version and return\nevery applicable advisory with the full Extended payload.\n", + "type": "text/plain" + }, + "url": { + "path": [ + "product", + ":type", + ":name", + ":version" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "disabled": false, + "type": "any", + "value": "plugin", + "key": "type", + "description": "(Required) Product ecosystem." + }, + { + "disabled": false, + "type": "any", + "value": "tutor", + "key": "name", + "description": "(Required) WordPress plugin or theme slug. Use `wordpress` when `type=wordpress`.\nSlugs are lowercase — normalize your own data before comparison.\n" + }, + { + "disabled": false, + "type": "any", + "value": "1.5.2", + "key": "version", + "description": "(Required) Concrete version (e.g. `1.5.2`)." + } + ] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "auth": null + }, + "response": [ + { + "name": "Matched advisories (possibly empty).", + "originalRequest": { + "url": { + "path": [ + "product", + ":type", + ":name", + ":version" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "disabled": false, + "type": "any", + "value": "plugin", + "key": "type", + "description": "(Required) Product ecosystem." + }, + { + "disabled": false, + "type": "any", + "value": "tutor", + "key": "name", + "description": "(Required) WordPress plugin or theme slug. Use `wordpress` when `type=wordpress`.\nSlugs are lowercase — normalize your own data before comparison.\n" + }, + { + "disabled": false, + "type": "any", + "value": "1.5.2", + "key": "version", + "description": "(Required) Concrete version (e.g. `1.5.2`)." + } + ] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"vulnerabilities\": [\n {\n \"id\": 7976,\n \"product_id\": 2175,\n \"title\": \"WordPress File Upload plugin <= 4.16.2 - Contributor+ Path Traversal vulnerability leading to Remote Code Execution (RCE)\",\n \"description\": \"Contributor+ Path Traversal vulnerability leading to Remote Code Execution (RCE) discovered by apple502j in WordPress File Upload plugin (versions <= 4.16.2).\",\n \"disclosed_at\": \"2022-03-01T00:00:00+00:00\",\n \"created_at\": \"2022-03-07T11:17:05+00:00\",\n \"url\": \"wordpress-file-upload-plugin-4-16-2-contributor-path-traversal-vulnerability-leading-to-remote-code-execution-rce\",\n \"product_slug\": \"wp-file-upload\",\n \"product_name\": \"WordPress File Upload\",\n \"product_type\": \"Plugin\",\n \"vuln_type\": \"Directory Traversal\",\n \"cve\": [\n \"2021-24962\"\n ],\n \"affected_in\": \"<= 4.16.2\",\n \"fixed_in\": \"4.16.3\",\n \"direct_url\": \"https://patchstack.com/database/vulnerability/wp-file-upload/wordpress-file-upload-plugin-4-16-2-contributor-path-traversal-vulnerability-leading-to-remote-code-execution-rce\",\n \"disclosure_date\": \"2022-03-01 00:00:00\",\n \"product_name_premium\": null,\n \"cvss_score\": 8.8,\n \"is_exploited\": false,\n \"patch_priority\": 3,\n \"patched_in_ranges\": [\n {\n \"from_version\": \"3.0\",\n \"to_version\": \"3.0.34.1\",\n \"fixed_in\": \"3.0.34.2\"\n },\n {\n \"from_version\": \"3.0\",\n \"to_version\": \"3.0.34.1\",\n \"fixed_in\": \"3.0.34.2\"\n }\n ]\n },\n {\n \"id\": 7976,\n \"product_id\": 2175,\n \"title\": \"WordPress File Upload plugin <= 4.16.2 - Contributor+ Path Traversal vulnerability leading to Remote Code Execution (RCE)\",\n \"description\": \"Contributor+ Path Traversal vulnerability leading to Remote Code Execution (RCE) discovered by apple502j in WordPress File Upload plugin (versions <= 4.16.2).\",\n \"disclosed_at\": \"2022-03-01T00:00:00+00:00\",\n \"created_at\": \"2022-03-07T11:17:05+00:00\",\n \"url\": \"wordpress-file-upload-plugin-4-16-2-contributor-path-traversal-vulnerability-leading-to-remote-code-execution-rce\",\n \"product_slug\": \"wp-file-upload\",\n \"product_name\": \"WordPress File Upload\",\n \"product_type\": \"Plugin\",\n \"vuln_type\": \"Directory Traversal\",\n \"cve\": [\n \"2021-24962\"\n ],\n \"affected_in\": \"<= 4.16.2\",\n \"fixed_in\": \"4.16.3\",\n \"direct_url\": \"https://patchstack.com/database/vulnerability/wp-file-upload/wordpress-file-upload-plugin-4-16-2-contributor-path-traversal-vulnerability-leading-to-remote-code-execution-rce\",\n \"disclosure_date\": \"2022-03-01 00:00:00\",\n \"product_name_premium\": null,\n \"cvss_score\": 8.8,\n \"is_exploited\": false,\n \"patch_priority\": 3,\n \"patched_in_ranges\": [\n {\n \"from_version\": \"3.0\",\n \"to_version\": \"3.0.34.1\",\n \"fixed_in\": \"3.0.34.2\"\n },\n {\n \"from_version\": \"3.0\",\n \"to_version\": \"3.0.34.1\",\n \"fixed_in\": \"3.0.34.2\"\n }\n ]\n }\n ]\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "name": "Missing or invalid `PSKey` header.", + "originalRequest": { + "url": { + "path": [ + "product", + ":type", + ":name", + ":version" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "disabled": false, + "type": "any", + "value": "plugin", + "key": "type", + "description": "(Required) Product ecosystem." + }, + { + "disabled": false, + "type": "any", + "value": "tutor", + "key": "name", + "description": "(Required) WordPress plugin or theme slug. Use `wordpress` when `type=wordpress`.\nSlugs are lowercase — normalize your own data before comparison.\n" + }, + { + "disabled": false, + "type": "any", + "value": "1.5.2", + "key": "version", + "description": "(Required) Concrete version (e.g. `1.5.2`)." + } + ] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "GET", + "body": {} + }, + "status": "Unauthorized", + "code": 401, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + }, + { + "name": "API key not authorised for the requested endpoint.", + "originalRequest": { + "url": { + "path": [ + "product", + ":type", + ":name", + ":version" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "disabled": false, + "type": "any", + "value": "plugin", + "key": "type", + "description": "(Required) Product ecosystem." + }, + { + "disabled": false, + "type": "any", + "value": "tutor", + "key": "name", + "description": "(Required) WordPress plugin or theme slug. Use `wordpress` when `type=wordpress`.\nSlugs are lowercase — normalize your own data before comparison.\n" + }, + { + "disabled": false, + "type": "any", + "value": "1.5.2", + "key": "version", + "description": "(Required) Concrete version (e.g. `1.5.2`)." + } + ] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "GET", + "body": {} + }, + "status": "Forbidden", + "code": 403, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + }, + { + "name": "Unknown product/version/vulnerability id.", + "originalRequest": { + "url": { + "path": [ + "product", + ":type", + ":name", + ":version" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "disabled": false, + "type": "any", + "value": "plugin", + "key": "type", + "description": "(Required) Product ecosystem." + }, + { + "disabled": false, + "type": "any", + "value": "tutor", + "key": "name", + "description": "(Required) WordPress plugin or theme slug. Use `wordpress` when `type=wordpress`.\nSlugs are lowercase — normalize your own data before comparison.\n" + }, + { + "disabled": false, + "type": "any", + "value": "1.5.2", + "key": "version", + "description": "(Required) Concrete version (e.g. `1.5.2`)." + } + ] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "GET", + "body": {} + }, + "status": "Not Found", + "code": 404, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + }, + { + "name": "Rate limit exceeded.", + "originalRequest": { + "url": { + "path": [ + "product", + ":type", + ":name", + ":version" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "disabled": false, + "type": "any", + "value": "plugin", + "key": "type", + "description": "(Required) Product ecosystem." + }, + { + "disabled": false, + "type": "any", + "value": "tutor", + "key": "name", + "description": "(Required) WordPress plugin or theme slug. Use `wordpress` when `type=wordpress`.\nSlugs are lowercase — normalize your own data before comparison.\n" + }, + { + "disabled": false, + "type": "any", + "value": "1.5.2", + "key": "version", + "description": "(Required) Concrete version (e.g. `1.5.2`)." + } + ] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "GET", + "body": {} + }, + "status": "Too Many Requests", + "code": 429, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "name": "Boolean exists check for a product", + "request": { + "name": "Boolean exists check for a product", + "description": { + "content": "Boolean-only variant of the product lookup. Returns\n`{ \"vulnerable\": true }` or `{ \"vulnerable\": false }` — cheap when you\nonly need to know whether an installed version is affected.\n", + "type": "text/plain" + }, + "url": { + "path": [ + "product", + ":type", + ":name", + ":version", + "exists" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "disabled": false, + "type": "any", + "value": "plugin", + "key": "type", + "description": "(Required) Product ecosystem." + }, + { + "disabled": false, + "type": "any", + "value": "tutor", + "key": "name", + "description": "(Required) WordPress plugin or theme slug. Use `wordpress` when `type=wordpress`.\nSlugs are lowercase — normalize your own data before comparison.\n" + }, + { + "disabled": false, + "type": "any", + "value": "1.5.2", + "key": "version", + "description": "(Required) Concrete version (e.g. `1.5.2`)." + } + ] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "auth": null + }, + "response": [ + { + "name": "Boolean result.", + "originalRequest": { + "url": { + "path": [ + "product", + ":type", + ":name", + ":version", + "exists" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "disabled": false, + "type": "any", + "value": "plugin", + "key": "type", + "description": "(Required) Product ecosystem." + }, + { + "disabled": false, + "type": "any", + "value": "tutor", + "key": "name", + "description": "(Required) WordPress plugin or theme slug. Use `wordpress` when `type=wordpress`.\nSlugs are lowercase — normalize your own data before comparison.\n" + }, + { + "disabled": false, + "type": "any", + "value": "1.5.2", + "key": "version", + "description": "(Required) Concrete version (e.g. `1.5.2`)." + } + ] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"vulnerable\": true\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "name": "Missing or invalid `PSKey` header.", + "originalRequest": { + "url": { + "path": [ + "product", + ":type", + ":name", + ":version", + "exists" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "disabled": false, + "type": "any", + "value": "plugin", + "key": "type", + "description": "(Required) Product ecosystem." + }, + { + "disabled": false, + "type": "any", + "value": "tutor", + "key": "name", + "description": "(Required) WordPress plugin or theme slug. Use `wordpress` when `type=wordpress`.\nSlugs are lowercase — normalize your own data before comparison.\n" + }, + { + "disabled": false, + "type": "any", + "value": "1.5.2", + "key": "version", + "description": "(Required) Concrete version (e.g. `1.5.2`)." + } + ] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "GET", + "body": {} + }, + "status": "Unauthorized", + "code": 401, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + }, + { + "name": "API key not authorised for the requested endpoint.", + "originalRequest": { + "url": { + "path": [ + "product", + ":type", + ":name", + ":version", + "exists" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "disabled": false, + "type": "any", + "value": "plugin", + "key": "type", + "description": "(Required) Product ecosystem." + }, + { + "disabled": false, + "type": "any", + "value": "tutor", + "key": "name", + "description": "(Required) WordPress plugin or theme slug. Use `wordpress` when `type=wordpress`.\nSlugs are lowercase — normalize your own data before comparison.\n" + }, + { + "disabled": false, + "type": "any", + "value": "1.5.2", + "key": "version", + "description": "(Required) Concrete version (e.g. `1.5.2`)." + } + ] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "GET", + "body": {} + }, + "status": "Forbidden", + "code": 403, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + }, + { + "name": "Rate limit exceeded.", + "originalRequest": { + "url": { + "path": [ + "product", + ":type", + ":name", + ":version", + "exists" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "disabled": false, + "type": "any", + "value": "plugin", + "key": "type", + "description": "(Required) Product ecosystem." + }, + { + "disabled": false, + "type": "any", + "value": "tutor", + "key": "name", + "description": "(Required) WordPress plugin or theme slug. Use `wordpress` when `type=wordpress`.\nSlugs are lowercase — normalize your own data before comparison.\n" + }, + { + "disabled": false, + "type": "any", + "value": "1.5.2", + "key": "version", + "description": "(Required) Concrete version (e.g. `1.5.2`)." + } + ] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "GET", + "body": {} + }, + "status": "Too Many Requests", + "code": 429, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + } + ], + "event": [] + }, + { + "name": "Bulk product check", + "request": { + "name": "Bulk product check", + "description": { + "content": "Check up to 50 products in a single request. Items with `exists: true`\nreturn a boolean per slug; items with `exists: false` return the full\nadvisory list per slug.\n\nThe response is keyed by `product_slug`, **not** by array index —\nduplicate slugs in the request collapse.\n", + "type": "text/plain" + }, + "url": { + "path": [ + "batch" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "auth": null, + "body": { + "mode": "raw", + "raw": "[\n {\n \"name\": \"easy-digital-downloads1\",\n \"version\": \"1.0.0\",\n \"type\": \"plugin\",\n \"exists\": true\n },\n {\n \"name\": \"wordpress\",\n \"version\": \"3.0.0\",\n \"type\": \"wordpress\",\n \"exists\": true\n }\n]", + "options": { + "raw": { + "language": "json" + } + } + } + }, + "response": [ + { + "name": "Per-slug results.", + "originalRequest": { + "url": { + "path": [ + "batch" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "[\n {\n \"name\": \"easy-digital-downloads1\",\n \"version\": \"1.0.0\",\n \"type\": \"plugin\",\n \"exists\": true\n },\n {\n \"name\": \"wordpress\",\n \"version\": \"3.0.0\",\n \"type\": \"wordpress\",\n \"exists\": true\n }\n]", + "options": { + "raw": { + "language": "json" + } + } + } + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"vulnerabilities\": {\n \"easy-digital-downloads1\": true,\n \"wordpress\": true\n }\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "name": "Missing or invalid `PSKey` header.", + "originalRequest": { + "url": { + "path": [ + "batch" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "[\n {\n \"name\": \"easy-digital-downloads1\",\n \"version\": \"1.0.0\",\n \"type\": \"plugin\",\n \"exists\": true\n },\n {\n \"name\": \"wordpress\",\n \"version\": \"3.0.0\",\n \"type\": \"wordpress\",\n \"exists\": true\n }\n]", + "options": { + "raw": { + "language": "json" + } + } + } + }, + "status": "Unauthorized", + "code": 401, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + }, + { + "name": "API key not authorised for the requested endpoint.", + "originalRequest": { + "url": { + "path": [ + "batch" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "[\n {\n \"name\": \"easy-digital-downloads1\",\n \"version\": \"1.0.0\",\n \"type\": \"plugin\",\n \"exists\": true\n },\n {\n \"name\": \"wordpress\",\n \"version\": \"3.0.0\",\n \"type\": \"wordpress\",\n \"exists\": true\n }\n]", + "options": { + "raw": { + "language": "json" + } + } + } + }, + "status": "Forbidden", + "code": 403, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + }, + { + "name": "Invalid request payload (e.g. batch with more than 50 items).", + "originalRequest": { + "url": { + "path": [ + "batch" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "[\n {\n \"name\": \"easy-digital-downloads1\",\n \"version\": \"1.0.0\",\n \"type\": \"plugin\",\n \"exists\": true\n },\n {\n \"name\": \"wordpress\",\n \"version\": \"3.0.0\",\n \"type\": \"wordpress\",\n \"exists\": true\n }\n]", + "options": { + "raw": { + "language": "json" + } + } + } + }, + "status": "Unprocessable Entity (WebDAV) (RFC 4918)", + "code": 422, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + }, + { + "name": "Rate limit exceeded.", + "originalRequest": { + "url": { + "path": [ + "batch" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "POST", + "body": { + "mode": "raw", + "raw": "[\n {\n \"name\": \"easy-digital-downloads1\",\n \"version\": \"1.0.0\",\n \"type\": \"plugin\",\n \"exists\": true\n },\n {\n \"name\": \"wordpress\",\n \"version\": \"3.0.0\",\n \"type\": \"wordpress\",\n \"exists\": true\n }\n]", + "options": { + "raw": { + "language": "json" + } + } + } + }, + "status": "Too Many Requests", + "code": 429, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "name": "Find a vulnerability by id", + "request": { + "name": "Find a vulnerability by id", + "description": { + "content": "Look up a single advisory by its numeric id or PSID. Returns a richer\nshape than the list endpoints — includes CVSS vector, OWASP category,\nexternal references, credits, and submitter info.\n", + "type": "text/plain" + }, + "url": { + "path": [ + "vulnerability", + ":id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "disabled": false, + "type": "any", + "value": "4760", + "key": "id", + "description": "(Required) Numeric Patchstack id or PSID." + } + ] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "auth": null + }, + "response": [ + { + "name": "Detailed advisory payload.", + "originalRequest": { + "url": { + "path": [ + "vulnerability", + ":id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "disabled": false, + "type": "any", + "value": "4760", + "key": "id", + "description": "(Required) Numeric Patchstack id or PSID." + } + ] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"vulnerability\": {\n \"title\": \"WordPress Spam protection, AntiSpam, FireWall by CleanTalk plugin <= 5.153.3 - Unauthenticated Time-Based Blind SQL Injection (SQLi) vulnerability\",\n \"description\": \"Unauthenticated Time-Based Blind SQL Injection (SQLi) vulnerability discovered by WordFence in WordPress Spam protection, AntiSpam, FireWall by CleanTalk plugin (versions <= 5.153.3).\",\n \"disclosed_at\": \"2021-05-03T00:00:00+00:00\",\n \"created_at\": \"2021-09-28T14:17:02+00:00\",\n \"is_exploited\": true,\n \"url\": \"wordpress-spam-protection-antispam-firewall-by-cleantalk-plugin-5-153-3-unauthenticated-time-based-blind-sql-injection-sqli-vulnerability\",\n \"direct_url\": \"https://patchstack.com/database/vulnerability/cleantalk-spam-protect/wordpress-spam-protection-antispam-firewall-by-cleantalk-plugin-5-153-3-unauthenticated-time-based-blind-sql-injection-sqli-vulnerability\",\n \"disclosure_date\": \"2021-05-03 00:00:00\"\n },\n \"product\": {\n \"name\": \"Spam protection, AntiSpam, FireWall by CleanTalk\",\n \"slug\": \"cleantalk-spam-protect\",\n \"type\": \"Plugin\"\n },\n \"type\": \"SQL Injection\",\n \"cve\": [\n \"2021-24295\"\n ],\n \"versions\": {\n \"affected_in\": \"<= 5.153.3\",\n \"fixed_in\": \"5.153.4\"\n },\n \"cvss\": {\n \"score\": 7.5,\n \"vector\": \"CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:N/A:N\",\n \"description\": \"\"\n },\n \"owasp\": \"A1: Injection\",\n \"references_url\": [\n {\n \"url\": \"https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2021-24295\",\n \"title\": \"CVE\"\n },\n {\n \"url\": \"https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2021-24295\",\n \"title\": \"CVE\"\n }\n ],\n \"versions_list\": null,\n \"credit\": {\n \"name\": \"WordFence\",\n \"url\": \"https://twitter.com/wordfence\"\n },\n \"submitter\": {\n \"name\": \"h00die\",\n \"url\": \"https://packetstormsecurity.com/files/author/7166/\"\n }\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "name": "Missing or invalid `PSKey` header.", + "originalRequest": { + "url": { + "path": [ + "vulnerability", + ":id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "disabled": false, + "type": "any", + "value": "4760", + "key": "id", + "description": "(Required) Numeric Patchstack id or PSID." + } + ] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "GET", + "body": {} + }, + "status": "Unauthorized", + "code": 401, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + }, + { + "name": "API key not authorised for the requested endpoint.", + "originalRequest": { + "url": { + "path": [ + "vulnerability", + ":id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "disabled": false, + "type": "any", + "value": "4760", + "key": "id", + "description": "(Required) Numeric Patchstack id or PSID." + } + ] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "GET", + "body": {} + }, + "status": "Forbidden", + "code": 403, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + }, + { + "name": "Unknown product/version/vulnerability id.", + "originalRequest": { + "url": { + "path": [ + "vulnerability", + ":id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "disabled": false, + "type": "any", + "value": "4760", + "key": "id", + "description": "(Required) Numeric Patchstack id or PSID." + } + ] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "GET", + "body": {} + }, + "status": "Not Found", + "code": 404, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + }, + { + "name": "Rate limit exceeded.", + "originalRequest": { + "url": { + "path": [ + "vulnerability", + ":id" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "disabled": false, + "type": "any", + "value": "4760", + "key": "id", + "description": "(Required) Numeric Patchstack id or PSID." + } + ] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "GET", + "body": {} + }, + "status": "Too Many Requests", + "code": 429, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + } + ], + "event": [], + "variable": [ + { + "type": "string", + "value": "https://patchstack.com/database/api/v2", + "key": "baseUrl" + } + ], + "auth": { + "type": "apikey", + "apikey": [ + { + "key": "key", + "value": "PSKey" + }, + { + "key": "value", + "value": "{{apiKey}}" + }, + { + "key": "in", + "value": "header" + } + ] + }, + "info": { + "name": "Patchstack Threat Intelligence API — Extended", + "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", + "description": { + "content": "The Extended Threat Intelligence API is a superset of the\n[Standard tier](/api-solutions/threat-intelligence-api/standard/). It adds\nbulk product checks, the `/latest` rolling feed, advisory-by-id lookups,\nand a richer per-item payload (`description`, `cvss_score`, `cve`,\n`patch_priority`, `patched_in_ranges`, …).\n\nExtended has **custom pricing and is activated on request** — contact us\nat .\n\n## Authentication\n\nEvery request must include your API key in the `PSKey` HTTP request header.\n\n## Rate limiting\n\nCustom, set per contract. Contact if\nyou need a quota change.\n\n## Caching\n\nResponses are JSON and cached until the Patchstack database updates, at\nwhich point the appropriate caches are cleared.\n\n## Errors\n\n| Status | Meaning |\n|---|---|\n| `401` | Missing or invalid `PSKey` header. |\n| `403` | API key not authorised for the requested endpoint. |\n| `404` | Unknown product/version/vulnerability id. |\n| `422` | Invalid request payload (e.g. batch with more than 50 items). |\n| `429` | Rate limit exceeded. |\n| `500` | Server error — include the request id in any bug report. |\n\n## Related pages\n\n- Narrative guide with code samples: [Extended tier API](/api-solutions/threat-intelligence-api/extended/)\n- Field glossary: [API properties](/api-solutions/threat-intelligence-api/api-properties/)\n- OpenAPI spec (import into Postman / Insomnia / Bruno / Hoppscotch): \n- Postman collection (pre-imported): \n\nIntegration questions: .\n\n\nContact Support:\n Name: Patchstack\n Email: dave.jong@patchstack.com", + "type": "text/plain" + } + } +} \ No newline at end of file diff --git a/public/schemas/threat-intel-extended.yaml b/public/schemas/threat-intel-extended.yaml new file mode 100644 index 0000000..8621434 --- /dev/null +++ b/public/schemas/threat-intel-extended.yaml @@ -0,0 +1,643 @@ +openapi: 3.1.0 +info: + title: Patchstack Threat Intelligence API — Extended + version: v2 + summary: WordPress vulnerability intelligence with bulk lookups, latest-24h feed, and advisory-by-id details. + description: | + The Extended Threat Intelligence API is a superset of the + [Standard tier](/api-solutions/threat-intelligence-api/standard/). It adds + bulk product checks, the `/latest` rolling feed, advisory-by-id lookups, + and a richer per-item payload (`description`, `cvss_score`, `cve`, + `patch_priority`, `patched_in_ranges`, …). + + Extended has **custom pricing and is activated on request** — contact us + at . + + ## Authentication + + Every request must include your API key in the `PSKey` HTTP request header. + + ## Rate limiting + + Custom, set per contract. Contact if + you need a quota change. + + ## Caching + + Responses are JSON and cached until the Patchstack database updates, at + which point the appropriate caches are cleared. + + ## Errors + + | Status | Meaning | + |---|---| + | `401` | Missing or invalid `PSKey` header. | + | `403` | API key not authorised for the requested endpoint. | + | `404` | Unknown product/version/vulnerability id. | + | `422` | Invalid request payload (e.g. batch with more than 50 items). | + | `429` | Rate limit exceeded. | + | `500` | Server error — include the request id in any bug report. | + + ## Related pages + + - Narrative guide with code samples: [Extended tier API](/api-solutions/threat-intelligence-api/extended/) + - Field glossary: [API properties](/api-solutions/threat-intelligence-api/api-properties/) + - OpenAPI spec (import into Postman / Insomnia / Bruno / Hoppscotch): + - Postman collection (pre-imported): + + Integration questions: . + contact: + name: Patchstack + url: https://patchstack.com/for-hosts/ + email: dave.jong@patchstack.com + +servers: + - url: https://patchstack.com/database/api/v2 + description: Production + +security: + - PSKey: [] + +tags: + - name: Vulnerabilities + description: | + Feed and advisory-by-id lookups. + + - [`GET /latest`](/api-reference/threat-intelligence-extended/operations/listlatestvulnerabilities/) + — the 20 most recently added vulnerabilities. + - [`GET /vulnerability/{id}`](/api-reference/threat-intelligence-extended/operations/getvulnerabilitybyid/) + — detailed advisory payload for a single Patchstack id or PSID. + - name: Products + description: | + Match a single WordPress plugin, theme or core version against the + vulnerability database. + + - [`GET /product/{type}/{name}/{version}`](/api-reference/threat-intelligence-extended/operations/findproductvulnerabilities/) + — full advisory list for the product. + - [`GET /product/{type}/{name}/{version}/exists`](/api-reference/threat-intelligence-extended/operations/productvulnerabilityexists/) + — boolean-only variant for fast "is this vulnerable?" checks. + - name: Batch + description: | + Bulk endpoint for checking up to 50 products in a single request. Use + this when walking a list of installed plugins/themes — it's significantly + cheaper than issuing one request per product. + + - [`POST /batch`](/api-reference/threat-intelligence-extended/operations/batchproductcheck/) + — payload is a JSON array of up to 50 `{type, name, version, exists?}` + objects. Results are keyed by slug. + +paths: + /latest: + get: + tags: [Vulnerabilities] + summary: Latest vulnerabilities + description: | + Return the 20 most recently added vulnerabilities, ordered by + descending `created_at` (insertion time, not `disclosure_date`). + operationId: listLatestVulnerabilities + responses: + '200': + description: The 20 most recent vulnerabilities. + content: + application/json: + schema: + type: object + required: [vulnerabilities] + properties: + vulnerabilities: + type: array + items: + $ref: '#/components/schemas/ExtendedVulnerability' + '401': { $ref: '#/components/responses/Unauthorized' } + '403': { $ref: '#/components/responses/Forbidden' } + '429': { $ref: '#/components/responses/TooManyRequests' } + + /product/{type}/{name}/{version}: + get: + tags: [Products] + summary: Find vulnerabilities for a product + description: | + Match a specific WordPress plugin, theme or core version and return + every applicable advisory with the full Extended payload. + operationId: findProductVulnerabilities + parameters: + - $ref: '#/components/parameters/ProductType' + - $ref: '#/components/parameters/ProductName' + - $ref: '#/components/parameters/ProductVersion' + responses: + '200': + description: Matched advisories (possibly empty). + content: + application/json: + schema: + type: object + required: [vulnerabilities] + properties: + vulnerabilities: + type: array + items: + $ref: '#/components/schemas/ExtendedVulnerability' + '401': { $ref: '#/components/responses/Unauthorized' } + '403': { $ref: '#/components/responses/Forbidden' } + '404': { $ref: '#/components/responses/NotFound' } + '429': { $ref: '#/components/responses/TooManyRequests' } + + /product/{type}/{name}/{version}/exists: + get: + tags: [Products] + summary: Boolean exists check for a product + description: | + Boolean-only variant of the product lookup. Returns + `{ "vulnerable": true }` or `{ "vulnerable": false }` — cheap when you + only need to know whether an installed version is affected. + operationId: productVulnerabilityExists + parameters: + - $ref: '#/components/parameters/ProductType' + - $ref: '#/components/parameters/ProductName' + - $ref: '#/components/parameters/ProductVersion' + responses: + '200': + description: Boolean result. + content: + application/json: + schema: + type: object + required: [vulnerable] + properties: + vulnerable: + type: boolean + example: + vulnerable: true + '401': { $ref: '#/components/responses/Unauthorized' } + '403': { $ref: '#/components/responses/Forbidden' } + '429': { $ref: '#/components/responses/TooManyRequests' } + + /batch: + post: + tags: [Batch] + summary: Bulk product check + description: | + Check up to 50 products in a single request. Items with `exists: true` + return a boolean per slug; items with `exists: false` return the full + advisory list per slug. + + The response is keyed by `product_slug`, **not** by array index — + duplicate slugs in the request collapse. + operationId: batchProductCheck + requestBody: + required: true + content: + application/json: + schema: + type: array + maxItems: 50 + items: + $ref: '#/components/schemas/BatchItem' + examples: + existsOnly: + summary: Boolean-only across all items + value: + - { name: easy-digital-downloads1, version: "1.0.0", type: plugin, exists: true } + - { name: wordpress, version: "3.0.0", type: wordpress, exists: true } + mixed: + summary: Mix of full advisory list and boolean + value: + - { name: easy-digital-downloads1, version: "1.0.0", type: plugin, exists: false } + - { name: wordpress, version: "3.0.0", type: wordpress, exists: true } + responses: + '200': + description: Per-slug results. + content: + application/json: + schema: + type: object + required: [vulnerabilities] + properties: + vulnerabilities: + type: object + additionalProperties: + oneOf: + - type: boolean + - type: array + items: + $ref: '#/components/schemas/ExtendedVulnerability' + examples: + existsOnly: + summary: Boolean-only response + value: + vulnerabilities: + easy-digital-downloads1: true + wordpress: true + mixed: + summary: Mixed response + value: + vulnerabilities: + easy-digital-downloads1: + - id: 4532 + product_id: 1572 + title: "WordPress Easy Digital Downloads plugin <= 2.10.2 - Cross-Site Request Forgery (CSRF) vulnerability" + description: "Cross-Site Request Forgery (CSRF) vulnerability discovered by WPScan team in WordPress Easy Digital Downloads plugin (versions <= 2.10.2)." + disclosure_date: "2021-04-16 00:00:00" + disclosed_at: "2021-04-16T00:00:00+00:00" + created_at: "2021-04-19T04:43:04+00:00" + url: wordpress-easy-digital-downloads-plugin-2-10-2-cross-site-request-forgery-csrf-vulnerability + product_slug: easy-digital-downloads1 + product_name: "Easy Digital Downloads" + product_name_premium: null + product_type: Plugin + vuln_type: "Cross Site Request Forgery (CSRF)" + cvss_score: 6.5 + cve: [] + is_exploited: false + affected_in: "<= 2.10.2" + fixed_in: "2.10.3" + direct_url: "https://patchstack.com/database/vulnerability/easy-digital-downloads1/wordpress-easy-digital-downloads-plugin-2-10-2-cross-site-request-forgery-csrf-vulnerability" + wordpress: true + '401': { $ref: '#/components/responses/Unauthorized' } + '403': { $ref: '#/components/responses/Forbidden' } + '422': { $ref: '#/components/responses/UnprocessableEntity' } + '429': { $ref: '#/components/responses/TooManyRequests' } + + /vulnerability/{id}: + get: + tags: [Vulnerabilities] + summary: Find a vulnerability by id + description: | + Look up a single advisory by its numeric id or PSID. Returns a richer + shape than the list endpoints — includes CVSS vector, OWASP category, + external references, credits, and submitter info. + operationId: getVulnerabilityById + parameters: + - name: id + in: path + required: true + description: Numeric Patchstack id or PSID. + schema: + type: string + example: "4760" + responses: + '200': + description: Detailed advisory payload. + content: + application/json: + schema: + $ref: '#/components/schemas/VulnerabilityDetail' + '401': { $ref: '#/components/responses/Unauthorized' } + '403': { $ref: '#/components/responses/Forbidden' } + '404': { $ref: '#/components/responses/NotFound' } + '429': { $ref: '#/components/responses/TooManyRequests' } + +components: + securitySchemes: + PSKey: + type: apiKey + in: header + name: PSKey + description: | + API key issued by Patchstack. Extended access is activated on request + — contact . + + parameters: + ProductType: + name: type + in: path + required: true + description: Product ecosystem. + schema: + type: string + enum: [plugin, theme, wordpress] + example: plugin + ProductName: + name: name + in: path + required: true + description: | + WordPress plugin or theme slug. Use `wordpress` when `type=wordpress`. + Slugs are lowercase — normalize your own data before comparison. + schema: + type: string + example: tutor + ProductVersion: + name: version + in: path + required: true + description: Concrete version (e.g. `1.5.2`). + schema: + type: string + example: "1.5.2" + + responses: + Unauthorized: + description: Missing or invalid `PSKey` header. + Forbidden: + description: API key not authorised for the requested endpoint. + NotFound: + description: Unknown product/version/vulnerability id. + UnprocessableEntity: + description: Invalid request payload (e.g. batch with more than 50 items). + TooManyRequests: + description: Rate limit exceeded. + + schemas: + ExtendedVulnerability: + type: object + description: | + Flat per-item shape returned by the Extended tier. Superset of the + Standard shape — adds `description`, `vuln_type`, `cvss_score`, `cve`, + `is_exploited`, `patch_priority`, `affected_in`, and + `patched_in_ranges`. + required: + - id + - product_id + - title + - description + - disclosed_at + - created_at + - url + - product_slug + - product_name + - product_type + - vuln_type + - cve + - affected_in + - fixed_in + - direct_url + properties: + id: + type: integer + description: Stable Patchstack vulnerability id. + example: 7976 + product_id: + type: integer + description: Stable Patchstack product id. + example: 2175 + title: + type: string + description: Human-readable title including product name, affected version, and vulnerability type. + example: "WordPress File Upload plugin <= 4.16.2 - Contributor+ Path Traversal vulnerability leading to Remote Code Execution (RCE)" + description: + type: string + description: Short narrative summary of the advisory. + example: "Contributor+ Path Traversal vulnerability leading to Remote Code Execution (RCE) discovered by apple502j in WordPress File Upload plugin (versions <= 4.16.2)." + disclosure_date: + type: string + description: Disclosure date in `YYYY-MM-DD HH:MM:SS` form (legacy). + example: "2022-03-01 00:00:00" + disclosed_at: + type: string + format: date-time + description: Disclosure date in ISO 8601. + example: "2022-03-01T00:00:00+00:00" + created_at: + type: string + format: date-time + description: When the row was inserted into the Patchstack database (ISO 8601). Drives `/latest` windowing. + example: "2022-03-07T11:17:05+00:00" + url: + type: string + description: URL slug for the advisory. + example: wordpress-file-upload-plugin-4-16-2-contributor-path-traversal-vulnerability-leading-to-remote-code-execution-rce + product_slug: + type: string + description: Lowercase slug of the product. + example: wp-file-upload + product_name: + type: string + description: Display name of the product. + example: "WordPress File Upload" + product_name_premium: + type: string + nullable: true + description: Premium variant name when the author ships two plugins under the same slug. `null` in the common case. + example: null + product_type: + type: string + enum: [Plugin, Theme, WordPress] + description: Product ecosystem. + example: Plugin + vuln_type: + type: string + description: High-level vulnerability category (e.g. `SQL Injection`, `Cross Site Scripting (XSS)`). + example: Directory Traversal + cvss_score: + type: number + format: float + nullable: true + description: CVSS base score, 1.0–10.0. `null` for unclassified advisories. + example: 8.8 + cve: + type: array + description: CVE identifiers. An advisory can have zero, one, or multiple. + items: + type: string + example: ["2021-24962"] + is_exploited: + type: boolean + description: Whether exploitation has been observed in the wild. + example: false + patch_priority: + type: integer + nullable: true + minimum: 1 + description: | + Recommended patch urgency. + + - `1` — Low → patch within 30 days + - `2` — Medium → patch within 7 days + - `3+` — High → patch immediately + - `null` — unknown + example: 3 + affected_in: + type: string + description: | + Affected version range. Formats include `<= x.x.x`, `< x.x.x`, + `x.x.x-x.x.x`, `x.x.x,x.x.x`, or a single `x.x.x`. + example: "<= 4.16.2" + fixed_in: + type: string + description: First fixed version. Empty string when Patchstack has not yet recorded one. + example: "4.16.3" + patched_in_ranges: + type: array + description: | + For products that ship patches across multiple minor lines + (WordPress core, WooCommerce, Ninja Forms, …), each entry + describes a `from_version`–`to_version` range and its fix. + items: + type: object + required: [from_version, to_version, fixed_in] + properties: + from_version: + type: string + description: Starting version, inclusive. + example: "3.0" + to_version: + type: string + description: Ending version, inclusive. + example: "3.0.34.1" + fixed_in: + type: string + description: Version that contains the patch for this range. + example: "3.0.34.2" + direct_url: + type: string + format: uri + description: Public Patchstack vulnerability page. + example: "https://patchstack.com/database/vulnerability/wp-file-upload/wordpress-file-upload-plugin-4-16-2-contributor-path-traversal-vulnerability-leading-to-remote-code-execution-rce" + + BatchItem: + type: object + required: [name, version, type] + properties: + name: + type: string + description: Product slug (plugin/theme slug, or `wordpress`). + example: easy-digital-downloads1 + version: + type: string + description: Concrete version. + example: "1.0.0" + type: + type: string + enum: [plugin, theme, wordpress] + example: plugin + exists: + type: boolean + description: When `true`, return a boolean-only result for this item. + example: true + + VulnerabilityDetail: + type: object + description: Response shape for `GET /vulnerability/{id}`. + required: [vulnerability, product, type, cve, versions] + properties: + vulnerability: + type: object + required: [title, description, disclosed_at, created_at, is_exploited, url, direct_url] + properties: + title: + type: string + example: "WordPress Spam protection, AntiSpam, FireWall by CleanTalk plugin <= 5.153.3 - Unauthenticated Time-Based Blind SQL Injection (SQLi) vulnerability" + description: + type: string + example: "Unauthenticated Time-Based Blind SQL Injection (SQLi) vulnerability discovered by WordFence in WordPress Spam protection, AntiSpam, FireWall by CleanTalk plugin (versions <= 5.153.3)." + disclosure_date: + type: string + description: Disclosure date in `YYYY-MM-DD HH:MM:SS` form (legacy). + example: "2021-05-03 00:00:00" + disclosed_at: + type: string + format: date-time + example: "2021-05-03T00:00:00+00:00" + created_at: + type: string + format: date-time + example: "2021-09-28T14:17:02+00:00" + is_exploited: + type: boolean + example: true + url: + type: string + description: URL slug for the advisory. + example: wordpress-spam-protection-antispam-firewall-by-cleantalk-plugin-5-153-3-unauthenticated-time-based-blind-sql-injection-sqli-vulnerability + direct_url: + type: string + format: uri + example: "https://patchstack.com/database/vulnerability/cleantalk-spam-protect/wordpress-spam-protection-antispam-firewall-by-cleantalk-plugin-5-153-3-unauthenticated-time-based-blind-sql-injection-sqli-vulnerability" + product: + type: object + required: [name, slug, type] + properties: + name: + type: string + example: "Spam protection, AntiSpam, FireWall by CleanTalk" + slug: + type: string + example: cleantalk-spam-protect + type: + type: string + enum: [Plugin, Theme, WordPress] + example: Plugin + type: + type: string + description: Vulnerability category (e.g. `SQL Injection`). + example: SQL Injection + cvss: + type: object + nullable: true + properties: + score: + type: number + format: float + nullable: true + example: 7.5 + vector: + type: string + nullable: true + example: "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:N/A:N" + description: + type: string + nullable: true + example: "" + owasp: + type: string + description: "OWASP category (e.g. `A1: Injection`)." + example: "A1: Injection" + references_url: + type: array + description: External reference URLs with display titles. + items: + type: object + required: [url, title] + properties: + url: + type: string + format: uri + example: "https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2021-24295" + title: + type: string + example: CVE + cve: + type: array + items: + type: string + example: ["2021-24295"] + versions: + type: object + required: [affected_in, fixed_in] + properties: + affected_in: + type: string + example: "<= 5.153.3" + fixed_in: + type: string + example: "5.153.4" + versions_list: + type: string + nullable: true + description: Comma-separated list of specific affected versions, when applicable. + example: null + credit: + type: object + nullable: true + description: Discoverer of the vulnerability. + properties: + name: + type: string + example: WordFence + url: + type: string + format: uri + example: "https://twitter.com/wordfence" + submitter: + type: object + nullable: true + description: Submitter, when distinct from `credit`. + properties: + name: + type: string + example: h00die + url: + type: string + format: uri + example: "https://packetstormsecurity.com/files/author/7166/" diff --git a/public/schemas/threat-intel-standard.postman_collection.json b/public/schemas/threat-intel-standard.postman_collection.json new file mode 100644 index 0000000..9c90647 --- /dev/null +++ b/public/schemas/threat-intel-standard.postman_collection.json @@ -0,0 +1,741 @@ +{ + "item": [ + { + "name": "product/{type}/{name}/{version}", + "item": [ + { + "name": "Find vulnerabilities for a product", + "request": { + "name": "Find vulnerabilities for a product", + "description": { + "content": "Return every advisory that applies to a specific WordPress plugin,\ntheme or core version.\n", + "type": "text/plain" + }, + "url": { + "path": [ + "product", + ":type", + ":name", + ":version" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "disabled": false, + "type": "any", + "value": "plugin", + "key": "type", + "description": "(Required) Product ecosystem." + }, + { + "disabled": false, + "type": "any", + "value": "tutor", + "key": "name", + "description": "(Required) WordPress plugin or theme slug. Use `wordpress` when `type=wordpress`.\nSlugs are lowercase — normalize your own data before comparison.\n" + }, + { + "disabled": false, + "type": "any", + "value": "1.5.2", + "key": "version", + "description": "(Required) Concrete version (e.g. `1.5.2`)." + } + ] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "auth": null + }, + "response": [ + { + "name": "Matched advisories (possibly empty).", + "originalRequest": { + "url": { + "path": [ + "product", + ":type", + ":name", + ":version" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "disabled": false, + "type": "any", + "value": "plugin", + "key": "type", + "description": "(Required) Product ecosystem." + }, + { + "disabled": false, + "type": "any", + "value": "tutor", + "key": "name", + "description": "(Required) WordPress plugin or theme slug. Use `wordpress` when `type=wordpress`.\nSlugs are lowercase — normalize your own data before comparison.\n" + }, + { + "disabled": false, + "type": "any", + "value": "1.5.2", + "key": "version", + "description": "(Required) Concrete version (e.g. `1.5.2`)." + } + ] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"vulnerabilities\": [\n {\n \"id\": 4253,\n \"title\": \"WordPress Tutor LMS plugin <= 1.5.2 - Cross-Site Request Forgery (CSRF) vulnerability\",\n \"disclosed_at\": \"2020-02-04T00:00:00+00:00\",\n \"created_at\": \"2022-05-27T10:23:01+00:00\",\n \"product_slug\": \"tutor\",\n \"product_name\": \"Tutor LMS\",\n \"product_name_premium\": null,\n \"product_type\": \"Plugin\",\n \"fixed_in\": \"1.5.3\",\n \"direct_url\": \"https://patchstack.com/database/vulnerability/tutor/wordpress-tutor-lms-plugin-1-5-2-cross-site-request-forgery-csrf-vulnerability\"\n }\n ]\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "name": "Missing or invalid `PSKey` header.", + "originalRequest": { + "url": { + "path": [ + "product", + ":type", + ":name", + ":version" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "disabled": false, + "type": "any", + "value": "plugin", + "key": "type", + "description": "(Required) Product ecosystem." + }, + { + "disabled": false, + "type": "any", + "value": "tutor", + "key": "name", + "description": "(Required) WordPress plugin or theme slug. Use `wordpress` when `type=wordpress`.\nSlugs are lowercase — normalize your own data before comparison.\n" + }, + { + "disabled": false, + "type": "any", + "value": "1.5.2", + "key": "version", + "description": "(Required) Concrete version (e.g. `1.5.2`)." + } + ] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "GET", + "body": {} + }, + "status": "Unauthorized", + "code": 401, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + }, + { + "name": "API key not authorised for the requested endpoint.", + "originalRequest": { + "url": { + "path": [ + "product", + ":type", + ":name", + ":version" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "disabled": false, + "type": "any", + "value": "plugin", + "key": "type", + "description": "(Required) Product ecosystem." + }, + { + "disabled": false, + "type": "any", + "value": "tutor", + "key": "name", + "description": "(Required) WordPress plugin or theme slug. Use `wordpress` when `type=wordpress`.\nSlugs are lowercase — normalize your own data before comparison.\n" + }, + { + "disabled": false, + "type": "any", + "value": "1.5.2", + "key": "version", + "description": "(Required) Concrete version (e.g. `1.5.2`)." + } + ] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "GET", + "body": {} + }, + "status": "Forbidden", + "code": 403, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + }, + { + "name": "Unknown product/version combination.", + "originalRequest": { + "url": { + "path": [ + "product", + ":type", + ":name", + ":version" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "disabled": false, + "type": "any", + "value": "plugin", + "key": "type", + "description": "(Required) Product ecosystem." + }, + { + "disabled": false, + "type": "any", + "value": "tutor", + "key": "name", + "description": "(Required) WordPress plugin or theme slug. Use `wordpress` when `type=wordpress`.\nSlugs are lowercase — normalize your own data before comparison.\n" + }, + { + "disabled": false, + "type": "any", + "value": "1.5.2", + "key": "version", + "description": "(Required) Concrete version (e.g. `1.5.2`)." + } + ] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "GET", + "body": {} + }, + "status": "Not Found", + "code": 404, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + }, + { + "name": "Rate limit exceeded (5,000 requests / 24 hours).", + "originalRequest": { + "url": { + "path": [ + "product", + ":type", + ":name", + ":version" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "disabled": false, + "type": "any", + "value": "plugin", + "key": "type", + "description": "(Required) Product ecosystem." + }, + { + "disabled": false, + "type": "any", + "value": "tutor", + "key": "name", + "description": "(Required) WordPress plugin or theme slug. Use `wordpress` when `type=wordpress`.\nSlugs are lowercase — normalize your own data before comparison.\n" + }, + { + "disabled": false, + "type": "any", + "value": "1.5.2", + "key": "version", + "description": "(Required) Concrete version (e.g. `1.5.2`)." + } + ] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "GET", + "body": {} + }, + "status": "Too Many Requests", + "code": 429, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + }, + { + "name": "Boolean exists check for a product", + "request": { + "name": "Boolean exists check for a product", + "description": { + "content": "Boolean-only variant of the product lookup. Returns\n`{ \"vulnerable\": true }` or `{ \"vulnerable\": false }` without the\nadvisory payload — useful for lightweight checks and dashboard tiles\nwhere the advisory body isn't needed.\n", + "type": "text/plain" + }, + "url": { + "path": [ + "product", + ":type", + ":name", + ":version", + "exists" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "disabled": false, + "type": "any", + "value": "plugin", + "key": "type", + "description": "(Required) Product ecosystem." + }, + { + "disabled": false, + "type": "any", + "value": "tutor", + "key": "name", + "description": "(Required) WordPress plugin or theme slug. Use `wordpress` when `type=wordpress`.\nSlugs are lowercase — normalize your own data before comparison.\n" + }, + { + "disabled": false, + "type": "any", + "value": "1.5.2", + "key": "version", + "description": "(Required) Concrete version (e.g. `1.5.2`)." + } + ] + }, + "header": [ + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "auth": null + }, + "response": [ + { + "name": "Boolean result.", + "originalRequest": { + "url": { + "path": [ + "product", + ":type", + ":name", + ":version", + "exists" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "disabled": false, + "type": "any", + "value": "plugin", + "key": "type", + "description": "(Required) Product ecosystem." + }, + { + "disabled": false, + "type": "any", + "value": "tutor", + "key": "name", + "description": "(Required) WordPress plugin or theme slug. Use `wordpress` when `type=wordpress`.\nSlugs are lowercase — normalize your own data before comparison.\n" + }, + { + "disabled": false, + "type": "any", + "value": "1.5.2", + "key": "version", + "description": "(Required) Concrete version (e.g. `1.5.2`)." + } + ] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + }, + { + "key": "Accept", + "value": "application/json" + } + ], + "method": "GET", + "body": {} + }, + "status": "OK", + "code": 200, + "header": [ + { + "key": "Content-Type", + "value": "application/json" + } + ], + "body": "{\n \"vulnerable\": true\n}", + "cookie": [], + "_postman_previewlanguage": "json" + }, + { + "name": "Missing or invalid `PSKey` header.", + "originalRequest": { + "url": { + "path": [ + "product", + ":type", + ":name", + ":version", + "exists" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "disabled": false, + "type": "any", + "value": "plugin", + "key": "type", + "description": "(Required) Product ecosystem." + }, + { + "disabled": false, + "type": "any", + "value": "tutor", + "key": "name", + "description": "(Required) WordPress plugin or theme slug. Use `wordpress` when `type=wordpress`.\nSlugs are lowercase — normalize your own data before comparison.\n" + }, + { + "disabled": false, + "type": "any", + "value": "1.5.2", + "key": "version", + "description": "(Required) Concrete version (e.g. `1.5.2`)." + } + ] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "GET", + "body": {} + }, + "status": "Unauthorized", + "code": 401, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + }, + { + "name": "API key not authorised for the requested endpoint.", + "originalRequest": { + "url": { + "path": [ + "product", + ":type", + ":name", + ":version", + "exists" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "disabled": false, + "type": "any", + "value": "plugin", + "key": "type", + "description": "(Required) Product ecosystem." + }, + { + "disabled": false, + "type": "any", + "value": "tutor", + "key": "name", + "description": "(Required) WordPress plugin or theme slug. Use `wordpress` when `type=wordpress`.\nSlugs are lowercase — normalize your own data before comparison.\n" + }, + { + "disabled": false, + "type": "any", + "value": "1.5.2", + "key": "version", + "description": "(Required) Concrete version (e.g. `1.5.2`)." + } + ] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "GET", + "body": {} + }, + "status": "Forbidden", + "code": 403, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + }, + { + "name": "Rate limit exceeded (5,000 requests / 24 hours).", + "originalRequest": { + "url": { + "path": [ + "product", + ":type", + ":name", + ":version", + "exists" + ], + "host": [ + "{{baseUrl}}" + ], + "query": [], + "variable": [ + { + "disabled": false, + "type": "any", + "value": "plugin", + "key": "type", + "description": "(Required) Product ecosystem." + }, + { + "disabled": false, + "type": "any", + "value": "tutor", + "key": "name", + "description": "(Required) WordPress plugin or theme slug. Use `wordpress` when `type=wordpress`.\nSlugs are lowercase — normalize your own data before comparison.\n" + }, + { + "disabled": false, + "type": "any", + "value": "1.5.2", + "key": "version", + "description": "(Required) Concrete version (e.g. `1.5.2`)." + } + ] + }, + "header": [ + { + "description": { + "content": "Added as a part of security scheme: apikey", + "type": "text/plain" + }, + "key": "PSKey", + "value": "" + } + ], + "method": "GET", + "body": {} + }, + "status": "Too Many Requests", + "code": 429, + "header": [ + { + "key": "Content-Type", + "value": "text/plain" + } + ], + "body": "", + "cookie": [], + "_postman_previewlanguage": "text" + } + ], + "event": [], + "protocolProfileBehavior": { + "disableBodyPruning": true + } + } + ], + "event": [] + } + ], + "event": [], + "variable": [ + { + "type": "string", + "value": "https://patchstack.com/database/api/v2", + "key": "baseUrl" + } + ], + "auth": { + "type": "apikey", + "apikey": [ + { + "key": "key", + "value": "PSKey" + }, + { + "key": "value", + "value": "{{apiKey}}" + }, + { + "key": "in", + "value": "header" + } + ] + }, + "info": { + "name": "Patchstack Threat Intelligence API — Standard", + "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", + "description": { + "content": "The Standard Threat Intelligence API returns vulnerability information for\na single WordPress plugin, theme or core version. It's the entry-level tier\nof the v2 API — if you need bulk lookups, the latest-24h feed, or by-id\nadvisory lookup, use the [Extended tier](/api-solutions/threat-intelligence-api/extended/)\ninstead.\n\n## Authentication\n\nEvery request must include your API key in the `PSKey` HTTP request header.\nRequest a key via your [Patchstack App billing page](https://app.patchstack.com/billing/subscription).\n\n## Rate limiting\n\nStandard is limited to **5,000 requests per 24 hours**. Contact\n if you need an elevated quota or the\nExtended tier.\n\n## Caching\n\nResponses are JSON and cached until the Patchstack database updates, at\nwhich point the appropriate caches are cleared.\n\n## Errors\n\n| Status | Meaning |\n|---|---|\n| `401` | Missing or invalid `PSKey` header. |\n| `403` | API key not authorised for the requested endpoint. |\n| `404` | Unknown product/version combination. |\n| `429` | Rate limit exceeded. |\n| `500` | Server error — include the request id in any bug report. |\n\n## Related pages\n\n- Narrative guide with code samples: [Standard tier API](/api-solutions/threat-intelligence-api/standard/)\n- Field glossary: [API properties](/api-solutions/threat-intelligence-api/api-properties/)\n- OpenAPI spec (import into Postman / Insomnia / Bruno / Hoppscotch): \n- Postman collection (pre-imported): \n\nIntegration questions: .\n\n\nContact Support:\n Name: Patchstack\n Email: dave.jong@patchstack.com", + "type": "text/plain" + } + } +} \ No newline at end of file diff --git a/public/schemas/threat-intel-standard.yaml b/public/schemas/threat-intel-standard.yaml new file mode 100644 index 0000000..7465059 --- /dev/null +++ b/public/schemas/threat-intel-standard.yaml @@ -0,0 +1,261 @@ +openapi: 3.1.0 +info: + title: Patchstack Threat Intelligence API — Standard + version: v2 + summary: WordPress plugin, theme and core vulnerability lookups for a single product + version. + description: | + The Standard Threat Intelligence API returns vulnerability information for + a single WordPress plugin, theme or core version. It's the entry-level tier + of the v2 API — if you need bulk lookups, the latest-24h feed, or by-id + advisory lookup, use the [Extended tier](/api-solutions/threat-intelligence-api/extended/) + instead. + + ## Authentication + + Every request must include your API key in the `PSKey` HTTP request header. + Request a key via your [Patchstack App billing page](https://app.patchstack.com/billing/subscription). + + ## Rate limiting + + Standard is limited to **5,000 requests per 24 hours**. Contact + if you need an elevated quota or the + Extended tier. + + ## Caching + + Responses are JSON and cached until the Patchstack database updates, at + which point the appropriate caches are cleared. + + ## Errors + + | Status | Meaning | + |---|---| + | `401` | Missing or invalid `PSKey` header. | + | `403` | API key not authorised for the requested endpoint. | + | `404` | Unknown product/version combination. | + | `429` | Rate limit exceeded. | + | `500` | Server error — include the request id in any bug report. | + + ## Related pages + + - Narrative guide with code samples: [Standard tier API](/api-solutions/threat-intelligence-api/standard/) + - Field glossary: [API properties](/api-solutions/threat-intelligence-api/api-properties/) + - OpenAPI spec (import into Postman / Insomnia / Bruno / Hoppscotch): + - Postman collection (pre-imported): + + Integration questions: . + contact: + name: Patchstack + url: https://patchstack.com/for-hosts/ + email: dave.jong@patchstack.com + +servers: + - url: https://patchstack.com/database/api/v2 + description: Production + +security: + - PSKey: [] + +tags: + - name: Products + description: | + Match a specific WordPress plugin, theme or core version against the + vulnerability database and return every applicable advisory. + + - [`GET /product/{type}/{name}/{version}`](/api-reference/threat-intelligence-standard/operations/findproductvulnerabilities/) + — full advisory list for the product. + - [`GET /product/{type}/{name}/{version}/exists`](/api-reference/threat-intelligence-standard/operations/productvulnerabilityexists/) + — boolean-only variant for fast "is this vulnerable?" checks. + + `type` accepts `plugin`, `theme`, or `wordpress`. When `type=wordpress` + pass `wordpress` as the `name`. + +paths: + /product/{type}/{name}/{version}: + get: + tags: [Products] + summary: Find vulnerabilities for a product + description: | + Return every advisory that applies to a specific WordPress plugin, + theme or core version. + operationId: findProductVulnerabilities + parameters: + - $ref: '#/components/parameters/ProductType' + - $ref: '#/components/parameters/ProductName' + - $ref: '#/components/parameters/ProductVersion' + responses: + '200': + description: Matched advisories (possibly empty). + content: + application/json: + schema: + type: object + required: [vulnerabilities] + properties: + vulnerabilities: + type: array + items: + $ref: '#/components/schemas/StandardVulnerability' + example: + vulnerabilities: + - id: 4253 + title: "WordPress Tutor LMS plugin <= 1.5.2 - Cross-Site Request Forgery (CSRF) vulnerability" + disclosed_at: "2020-02-04T00:00:00+00:00" + created_at: "2022-05-27T10:23:01+00:00" + product_slug: tutor + product_name: "Tutor LMS" + product_name_premium: null + product_type: Plugin + fixed_in: "1.5.3" + direct_url: "https://patchstack.com/database/vulnerability/tutor/wordpress-tutor-lms-plugin-1-5-2-cross-site-request-forgery-csrf-vulnerability" + '401': { $ref: '#/components/responses/Unauthorized' } + '403': { $ref: '#/components/responses/Forbidden' } + '404': { $ref: '#/components/responses/NotFound' } + '429': { $ref: '#/components/responses/TooManyRequests' } + + /product/{type}/{name}/{version}/exists: + get: + tags: [Products] + summary: Boolean exists check for a product + description: | + Boolean-only variant of the product lookup. Returns + `{ "vulnerable": true }` or `{ "vulnerable": false }` without the + advisory payload — useful for lightweight checks and dashboard tiles + where the advisory body isn't needed. + operationId: productVulnerabilityExists + parameters: + - $ref: '#/components/parameters/ProductType' + - $ref: '#/components/parameters/ProductName' + - $ref: '#/components/parameters/ProductVersion' + responses: + '200': + description: Boolean result. + content: + application/json: + schema: + type: object + required: [vulnerable] + properties: + vulnerable: + type: boolean + example: + vulnerable: true + '401': { $ref: '#/components/responses/Unauthorized' } + '403': { $ref: '#/components/responses/Forbidden' } + '429': { $ref: '#/components/responses/TooManyRequests' } + +components: + securitySchemes: + PSKey: + type: apiKey + in: header + name: PSKey + description: | + API key issued by Patchstack. Request one from your + [Patchstack App billing page](https://app.patchstack.com/billing/subscription). + + parameters: + ProductType: + name: type + in: path + required: true + description: Product ecosystem. + schema: + type: string + enum: [plugin, theme, wordpress] + example: plugin + ProductName: + name: name + in: path + required: true + description: | + WordPress plugin or theme slug. Use `wordpress` when `type=wordpress`. + Slugs are lowercase — normalize your own data before comparison. + schema: + type: string + example: tutor + ProductVersion: + name: version + in: path + required: true + description: Concrete version (e.g. `1.5.2`). + schema: + type: string + example: "1.5.2" + + responses: + Unauthorized: + description: Missing or invalid `PSKey` header. + Forbidden: + description: API key not authorised for the requested endpoint. + NotFound: + description: Unknown product/version combination. + TooManyRequests: + description: Rate limit exceeded (5,000 requests / 24 hours). + + schemas: + StandardVulnerability: + type: object + description: | + Flat per-item shape returned by the Standard tier. For the richer shape + (with `description`, `cvss_score`, `cve`, `patched_in_ranges`, etc.), + see the [Extended tier](/api-reference/threat-intelligence-extended/). + required: + - id + - title + - disclosed_at + - created_at + - product_slug + - product_name + - product_type + - fixed_in + - direct_url + properties: + id: + type: integer + description: Stable Patchstack vulnerability id. + example: 4253 + title: + type: string + description: Human-readable title including product name, affected version, and vulnerability type. + example: "WordPress Tutor LMS plugin <= 1.5.2 - Cross-Site Request Forgery (CSRF) vulnerability" + disclosed_at: + type: string + format: date-time + description: When the vulnerability was publicly disclosed (ISO 8601). + example: "2020-02-04T00:00:00+00:00" + created_at: + type: string + format: date-time + description: When the row was inserted into the Patchstack database (ISO 8601). + example: "2022-05-27T10:23:01+00:00" + product_slug: + type: string + description: Lowercase slug of the product. + example: tutor + product_name: + type: string + description: Display name of the product. + example: "Tutor LMS" + product_name_premium: + type: string + nullable: true + description: | + Premium variant name when a plugin author ships two plugins under + the same slug. `null` in the common case. + product_type: + type: string + enum: [Plugin, Theme, WordPress] + description: Product ecosystem. + example: Plugin + fixed_in: + type: string + description: | + First version that contains the patch. Empty string when Patchstack + has not yet recorded a fixed version. + example: "1.5.3" + direct_url: + type: string + format: uri + description: Public Patchstack vulnerability page. + example: "https://patchstack.com/database/vulnerability/tutor/wordpress-tutor-lms-plugin-1-5-2-cross-site-request-forgery-csrf-vulnerability" diff --git a/src/content/docs/API solutions/Threat Intelligence API/beta.md b/src/content/docs/API solutions/Threat Intelligence API/beta.md index 5fe7371..74a968a 100644 --- a/src/content/docs/API solutions/Threat Intelligence API/beta.md +++ b/src/content/docs/API solutions/Threat Intelligence API/beta.md @@ -14,50 +14,11 @@ sidebar: _The Npm Dataset API (Beta) is a new generation of the Threat Intelligence API, currently available to **selected partners working directly with Patchstack**. It lives alongside the v2 API (Standard / Extended) and adds npm coverage, an optional full advisory body, a consistent nested response shape, and cursor pagination. If you'd like access to run an integration on Beta, [contact us](https://patchstack.com/for-hosts/)._ > **Interactive reference:** Every endpoint, parameter, request body and response shape is documented in the [Threat Intelligence API (Beta) reference](/api-reference/threat-intelligence-beta/). +> +> **Tooling (Postman, SDK, LLM):** spec URLs and import instructions for all three tiers live on [Overview → Using the APIs with your tools](/api-solutions/threat-intelligence-api/overview/#using-the-apis-with-your-tools). This page covers the concepts you need to use the API effectively — authentication, platforms, pagination, rate limiting, and migration from v2. Use it alongside the interactive reference. -## Use with Postman, Insomnia, Bruno or Hoppscotch - -We publish the API as an [OpenAPI 3.1 spec](https://docs.patchstack.com/schemas/threat-intel-beta.yaml) and a pre-built [Postman collection](https://docs.patchstack.com/schemas/threat-intel-beta.postman_collection.json). Every endpoint, parameter, request body and example is preconfigured — set your `PSKey` once and the whole collection authenticates. - -[Download the collection](/schemas/threat-intel-beta.postman_collection.json) and drag it into Postman/Insomnia/Bruno/Hoppscotch, or import it by URL from inside the tool. - -| Tool | How to import | -|---|---| -| **Postman** | `File → Import → Link` and paste the collection URL. | -| **Insomnia** | `Create → Import From → URL` → paste the OpenAPI URL. | -| **Bruno** | `Collection → Import → OpenAPI V3 Spec` → paste the OpenAPI URL. | -| **Hoppscotch** | `Collections → Import/Export → OpenAPI` → paste the OpenAPI URL. | - -**Authentication:** in Postman set the collection `Authorization` to **API Key**, key `PSKey`, value `{{PSKEY}}`, and add `PSKEY` as a collection variable with your real key as the **Current value** (leave Initial blank so it doesn't sync to teammates). Other tools work the same way — set `PSKey` as a collection header once. - -## Use with Claude Code or other LLM coding assistants - -Point your assistant at the spec. LLMs parse OpenAPI cleanly and will generate clients that match the real field names instead of hallucinating. - -- **Ad hoc:** paste the spec URL into your prompt. Example: *"Write a Python client for `https://docs.patchstack.com/schemas/threat-intel-beta.yaml`. I need cursor-mode iteration over `/all` for npm."* -- **In your repo:** download the spec to `docs/vendor/patchstack-threat-intel-beta.yaml` and reference it from your `CLAUDE.md` / `AGENTS.md`. Your assistant can then grep the YAML for specific fields without refetching. -- **Plain-text fallback:** for tools that don't parse YAML, our [`llms-full.txt`](/llms-full.txt) contains the full reference as flat markdown. - -## SDK generation - -Generate a client in any language from the same spec: - -```bash -# TypeScript -npx @openapitools/openapi-generator-cli generate \ - -i https://docs.patchstack.com/schemas/threat-intel-beta.yaml \ - -g typescript-fetch -o ./patchstack-client - -# Python -npx @openapitools/openapi-generator-cli generate \ - -i https://docs.patchstack.com/schemas/threat-intel-beta.yaml \ - -g python -o ./patchstack-client-py -``` - -Speakeasy and Fern also consume the same spec and produce more idiomatic SDKs if you need a polished client library. - > **Spec stability:** the Beta spec may change without a version bump while the API is in beta. Pin a commit of the YAML in production integrations, or wait for the GA release when we'll publish versioned URLs. ## Base URL @@ -146,10 +107,6 @@ curl 'https://patchstack.com/database/api/beta/product/npm/axios/0.21.4/exists' -H 'PSKey: ' ``` -### Postman / Insomnia / Bruno / Hoppscotch - -Import the OpenAPI spec directly from [`threat-intel-beta.yaml`](https://docs.patchstack.com/schemas/threat-intel-beta.yaml) — authentication, parameters and example payloads are preconfigured. Set the `PSKey` security value to your API key once and every request in the collection will use it. - ### Cursor iteration (JavaScript / Node) ```javascript diff --git a/src/content/docs/API solutions/Threat Intelligence API/extended.md b/src/content/docs/API solutions/Threat Intelligence API/extended.md index 732fe6b..a7d3988 100644 --- a/src/content/docs/API solutions/Threat Intelligence API/extended.md +++ b/src/content/docs/API solutions/Threat Intelligence API/extended.md @@ -1,541 +1,137 @@ --- title: "Extended tier API" -excerpt: "" +excerpt: "WordPress vulnerability intelligence with bulk lookups, latest-24h feed, and advisory-by-id details." hidden: false -metadata: +metadata: image: [] robots: "index" createdAt: "Mon Jul 25 2022 09:29:10 GMT+0000 (Coordinated Universal Time)" updatedAt: "Thu Jun 15 2023 11:25:44 GMT+0000 (Coordinated Universal Time)" sidebar: order: 2 + label: "Guide" --- -_The purpose of this document is to provide information about the Extended Threat Intelligence API functionality._ - -## API Usage - -### Information - -The base URL of the API is - -All responses are in the JSON format. For performance reasons, responses are cached until we update the database after which the appropriate caches are cleared. - -An API key is required. This API key should be present in the **PSKey HTTP request header**. You can request an API key by reaching out to us on this page: https://patchstack.com/for-hosts/ - -Explanation of the API response properties can be found here [here](/api-solutions/threat-intelligence-api/api-properties/). - -### Latest vulnerabilities - -**Description:** Retrieve the latest 20 vulnerabilities which have been added to the database. -**Endpoint:** /latest -**Method:** GET - -**Example response (trimmed)** - -```json -{ - "vulnerabilities": [ - { - "id": 7976, - "product_id": 2175, - "title": "WordPress File Upload plugin <= 4.16.2 - Contributor+ Path Traversal vulnerability leading to Remote Code Execution (RCE)", - "description": "Contributor+ Path Traversal vulnerability leading to Remote Code Execution (RCE) discovered by apple502j in WordPress File Upload plugin (versions <= 4.16.2).", - "disclosure_date": "2022-03-01 00:00:00", - "disclosed_at": "2022-03-01T00:00:00+00:00", - "created_at": "2022-03-07T11:17:05+00:00", - "url": "wordpress-file-upload-plugin-4-16-2-contributor-path-traversal-vulnerability-leading-to-remote-code-execution-rce", - "product_slug": "wp-file-upload", - "product_name": "WordPress File Upload", - "product_name_premium": null, - "product_type": "Plugin", - "vuln_type": "Directory Traversal", - "cvss_score": 8.8, - "cve": [ - "2021-24962" - ], - "is_exploited": false, - "patch_priority": 3, - "affected_in": "<= 4.16.2", - "fixed_in": "4.16.3", - "patched_in_ranges": [], - "direct_url": "https://patchstack.com/database/vulnerability/wp-file-upload/wordpress-file-upload-plugin-4-16-2-contributor-path-traversal-vulnerability-leading-to-remote-code-execution-rce" - }, - { - "id": 7957, - "product_id": 3808, - "title": "WordPress All in One Invite Codes plugin <= 1.0.12 - Sensitive Information Disclosure vulnerability", - "description": "Sensitive Information Disclosure vulnerability discovered in WordPress All in One Invite Codes plugin (versions <= 1.0.12).", - "disclosure_date": "2022-02-28 00:00:00", - "disclosed_at": "2022-02-28T00:00:00+00:00", - "created_at": "2022-03-03T13:25:05+00:00", - "url": "wordpress-all-in-one-invite-codes-plugin-1012-sensitive-information-disclosure-vulnerability", - "product_slug": "all-in-one-invite-codes", - "product_name": "All in One Invite Codes", - "product_name_premium": null, - "product_type": "Plugin", - "vuln_type": "Information Disclosure", - "cvss_score": 4.3, - "cve": [], - "is_exploited": false, - "patch_priority": 1, - "affected_in": "<= 1.0.12", - "fixed_in": "", - "patched_in_ranges": [], - "direct_url": "https://patchstack.com/database/vulnerability/all-in-one-invite-codes/wordpress-all-in-one-invite-codes-plugin-1012-sensitive-information-disclosure-vulnerability" - } - ] -} -``` +_The Extended Threat Intelligence API is a superset of the [Standard tier](/api-solutions/threat-intelligence-api/standard/). Extended has **custom pricing and is activated on request** — [contact us](https://patchstack.com/for-hosts/)._ -### Find vulnerability - -**Description:** Retrieve vulnerabilities of a specific plugin, theme or WordPress core version. -**Endpoint:** /product/TYPE/NAME/VERSION/EXISTS? -**Method:** GET - -**TYPE** = theme, plugin, wordpress -**NAME** = Slug of the theme, slug of the plugin, or “wordpress” in case TYPE is set to wordpress -**VERSION** = Version to check for vulnerabilities -**EXISTS** = Optional flag that will not return all vulnerabilities but only a boolean response whether or not there are vulnerabilities. This flag being present results in a faster response. - -**Example Response** - -```json -{ - "vulnerabilities": [ - { - "id": 4253, - "product_id": 2642, - "title": "WordPress Tutor LMS plugin <= 1.5.2 - Cross-Site Request Forgery (CSRF) vulnerability", - "description": "Cross-Site Request Forgery (CSRF) vulnerability found by Jinson Varghese Behanan in WordPress Tutor LMS plugin (versions <= 1.5.2).", - "disclosure_date": "2020-02-04 00:00:00", - "disclosed_at": "2020-02-04T00:00:00+00:00", - "created_at": "2021-01-08T13:50:05+00:00", - "url": "wordpress-tutor-lms-plugin-1-5-2-cross-site-request-forgery-csrf-vulnerability", - "product_slug": "tutor", - "product_name": "Tutor LMS", - "product_name_premium": null, - "product_type": "Plugin", - "vuln_type": "Cross Site Request Forgery (CSRF)", - "cvss_score": null, - "cve": [ - "2020-8615" - ], - "is_exploited": false, - "patch_priority": 1, - "affected_in": "<= 1.5.2", - "fixed_in": "1.5.3", - "direct_url": "https://patchstack.com/database/vulnerability/tutor/wordpress-tutor-lms-plugin-1-5-2-cross-site-request-forgery-csrf-vulnerability" - }, - { - "id": 4386, - "product_id": 2642, - "title": "WordPress Tutor LMS plugin <= 1.7.6 - Multiple Blind/Time-based SQL Injection (SQLi) vulnerabilities", - "description": "Multiple Blind/Time-based SQL Injection (SQLi) vulnerabilities were discovered by WordFence in the WordPress Tutor LMS plugin (versions <= 1.7.6).", - "disclosure_date": "2021-03-15 00:00:00", - "disclosed_at": "2021-03-15T00:00:00+00:00", - "created_at": "2021-06-07T10:12:03+00:00", - "url": "wordpress-tutor-lms-plugin-1-7-6-multiple-blind-time-based-sql-injection-sqli-vulnerabilities", - "product_slug": "tutor", - "product_name": "Tutor LMS", - "product_name_premium": null, - "product_type": "Plugin", - "vuln_type": "SQL Injection", - "cvss_score": 5.4, - "cve": [], - "is_exploited": false, - "patch_priority": 2, - "affected_in": "<= 1.7.6", - "fixed_in": "1.7.7", - "direct_url": "https://patchstack.com/database/vulnerability/tutor/wordpress-tutor-lms-plugin-1-7-6-multiple-blind-time-based-sql-injection-sqli-vulnerabilities" - }, - { - "id": 4387, - "product_id": 2642, - "title": "WordPress Tutor LMS plugin <= 1.8.2 - Multiple Union SQL Injection (SQLi) vulnerabilities", - "description": "Multiple Union SQL Injection (SQLi) vulnerabilities were discovered by WordFence in the WordPress Tutor LMS plugin (versions <= 1.8.2).", - "disclosure_date": "2021-03-15 00:00:00", - "disclosed_at": "2021-03-15T00:00:00+00:00", - "created_at": "2021-03-16T08:48:03+00:00", - "url": "wordpress-tutor-lms-plugin-1-8-2-multiple-union-sql-injection-sqli-vulnerabilities", - "product_slug": "tutor", - "product_name": "Tutor LMS", - "product_name_premium": null, - "product_type": "Plugin", - "vuln_type": "SQL Injection", - "cvss_score": null, - "cve": [], - "is_exploited": false, - "patch_priority": 2, - "affected_in": "<= 1.8.2", - "fixed_in": "1.8.3", - "direct_url": "https://patchstack.com/database/vulnerability/tutor/wordpress-tutor-lms-plugin-1-8-2-multiple-union-sql-injection-sqli-vulnerabilities" - }, - { - "id": 4388, - "product_id": 2642, - "title": "WordPress Tutor LMS plugin <= 1.7.6 - Unprotected AJAX Action to Privilege Escalation vulnerability", - "description": "Unprotected AJAX Action to Privilege Escalation vulnerability discovered by WordFence in WordPress Tutor LMS plugin (versions <= 1.7.6).", - "disclosure_date": "2021-03-15 00:00:00", - "disclosed_at": "2021-03-15T00:00:00+00:00", - "created_at": "2021-08-31T08:00:05+00:00", - "url": "wordpress-tutor-lms-plugin-1-7-6-unprotected-ajax-action-to-privilege-escalation-vulnerability", - "product_slug": "tutor", - "product_name": "Tutor LMS", - "product_name_premium": null, - "product_type": "Plugin", - "vuln_type": "Privilege Escalation", - "cvss_score": null, - "cve": [], - "is_exploited": false, - "patch_priority": 3, - "affected_in": "<= 1.7.6", - "fixed_in": "1.7.7", - "direct_url": "https://patchstack.com/database/vulnerability/tutor/wordpress-tutor-lms-plugin-1-7-6-unprotected-ajax-action-to-privilege-escalation-vulnerability" - }, - { - "id": 4549, - "product_id": 2642, - "title": "WordPress Tutor LMS plugin <= 1.8.7 - Authenticated Local File Inclusion vulnerability", - "description": "Authenticated Local File Inclusion vulnerability discovered by sasa in WordPress Tutor LMS plugin (versions <= 1.8.7)", - "disclosure_date": "2021-04-05 00:00:00", - "disclosed_at": "2021-04-05T00:00:00+00:00", - "created_at": "2021-04-19T09:28:03+00:00", - "url": "wordpress-tutor-lms-plugin-1-8-7-authenticated-local-file-inclusion-vulnerability", - "product_slug": "tutor", - "product_name": "Tutor LMS", - "product_name_premium": null, - "product_type": "Plugin", - "vuln_type": "Local File Inclusion", - "cvss_score": 4.9, - "cve": [ - "2021-24242" - ], - "is_exploited": false, - "patch_priority": 1, - "affected_in": "<= 1.8.7", - "fixed_in": "1.8.8", - "direct_url": "https://patchstack.com/database/vulnerability/tutor/wordpress-tutor-lms-plugin-1-8-7-authenticated-local-file-inclusion-vulnerability" - }, - { - "id": 5082, - "product_id": 2642, - "title": "WordPress Tutor LMS plugin <= 1.9.5 - Reflected Cross-Site Scripting (XSS) vulnerability", - "description": "Reflected Cross-Site Scripting (XSS) vulnerability discovered by WPScanTeam in WordPress Tutor LMS plugin (versions <= 1.9.5).", - "disclosure_date": "2021-08-09 00:00:00", - "disclosed_at": "2021-08-09T00:00:00+00:00", - "created_at": "2021-08-20T06:35:01+00:00", - "url": "wordpress-tutor-lms-plugin-1-9-5-reflected-cross-site-scripting-xss-vulnerability", - "product_slug": "tutor", - "product_name": "Tutor LMS", - "product_name_premium": null, - "product_type": "Plugin", - "vuln_type": "Cross Site Scripting (XSS)", - "cvss_score": 7.1, - "cve": [], - "is_exploited": false, - "patch_priority": 2, - "affected_in": "<= 1.9.5", - "fixed_in": "1.9.6", - "direct_url": "https://patchstack.com/database/vulnerability/tutor/wordpress-tutor-lms-plugin-1-9-5-reflected-cross-site-scripting-xss-vulnerability" - }, - { - "id": 5388, - "product_id": 2642, - "title": "WordPress Tutor LMS plugin <= 1.9.8 - Multiple Stored Cross-Site Scripting (XSS) vulnerabilities", - "description": "Multiple Stored Cross-Site Scripting (XSS) vulnerabilities were discovered by Shivam Rai in the WordPress Tutor LMS plugin (versions <= 1.9.8).", - "disclosure_date": "2021-09-20 00:00:00", - "disclosed_at": "2021-09-20T00:00:00+00:00", - "created_at": "2021-10-22T12:54:01+00:00", - "url": "wordpress-tutor-lms-plugin-1-9-8-multiple-stored-cross-site-scripting-xss-vulnerabilities", - "product_slug": "tutor", - "product_name": "Tutor LMS", - "product_name_premium": null, - "product_type": "Plugin", - "vuln_type": "Cross Site Scripting (XSS)", - "cvss_score": 6.9, - "cve": [ - "2021-24740" - ], - "is_exploited": false, - "patch_priority": 2, - "affected_in": "<= 1.9.8", - "fixed_in": "1.9.9", - "direct_url": "https://patchstack.com/database/vulnerability/tutor/wordpress-tutor-lms-plugin-1-9-8-multiple-stored-cross-site-scripting-xss-vulnerabilities" - } - ] -} -``` +> **Interactive reference:** Every endpoint, parameter, request body and response shape is documented in the [Threat Intelligence API (Extended) reference](/api-reference/threat-intelligence-extended/). +> +> **Tooling (Postman, SDK, LLM):** spec URLs and import instructions for all three tiers live on [Overview → Using the APIs with your tools](/api-solutions/threat-intelligence-api/overview/#using-the-apis-with-your-tools). -**Example Response** +This page covers the concepts you need to use the API effectively — authentication, rate limiting, errors, and code samples. Use it alongside the interactive reference. -```json -{ - "vulnerable": true -} -``` +## What Extended adds over Standard -### Bulk find vulnerability +| | Standard | Extended | +|---|---|---| +| Per-item payload | Flat, minimal | Flat, includes `description`, `vuln_type`, `cvss_score`, `cve`, `is_exploited`, `patch_priority`, `affected_in`, `patched_in_ranges` | +| `GET /product/{type}/{name}/{version}` | ✓ | ✓ | +| `GET /product/{type}/{name}/{version}/exists` | ✓ | ✓ | +| `GET /latest` — 20 most recent | — | ✓ | +| `POST /batch` — up to 50 products per request | — | ✓ | +| `GET /vulnerability/{id}` — advisory detail (CVSS vector, OWASP, references, credit) | — | ✓ | +| Rate limit | 5,000 / 24h | Custom, set per contract | -**Description:** Retrieve vulnerabilities in bulk of a number of plugins, themes or WordPress versions. -**Endpoint:** /batch -**Method:** POST -**Payload:** Raw JSON payload, same format as the individual vulnerability endpoint. This payload should contain no more than 50 objects. +## Base URL -**Payload Example 1** +``` +https://patchstack.com/database/api/v2/ +``` + +## Authentication -This payload example will determine if WooCommerce version 3.0.0 has vulnerabilities and if WordPress version 3.0.0 has vulnerabilities. It will also only return a boolean response. +Every request must include your API key in the **`PSKey`** HTTP request header. Extended access is activated on request — [contact us](https://patchstack.com/for-hosts/) to request a key. -```json -[ - {"name":"easy-digital-downloads1","version":"1.0.0","type":"plugin","exists":true}, - {"name":"wordpress","version":"3.0.0","type":"wordpress","exists":true} -] +``` +PSKey: ``` -**Example response 1** +## Response format -```json -{ - "vulnerabilities": { - "easy-digital-downloads1": true, - "wordpress": true - } -} -``` +All responses are JSON. Responses are cached until the Patchstack database updates, at which point the cache is cleared. -**Payload example 2** +Extended returns a **flat** per-item shape with more fields than Standard — see the [API properties](/api-solutions/threat-intelligence-api/api-properties/) glossary for field definitions. `GET /vulnerability/{id}` returns a richer, differently-shaped payload documented in the [reference](/api-reference/threat-intelligence-extended/). -This payload example will determine if WooCommerce version 3.0.0 has vulnerabilities and if WordPress version 3.0.0 has vulnerabilities. For WooCommerce it will return all vulnerabilities and for WordPress if it will return a boolean response. +## Batch lookups -```json -[ - {"name":"easy-digital-downloads1","version":"1.0.0","type":"plugin","exists":false}, - {"name":"wordpress","version":"3.0.0","type":"wordpress","exists":true} -] -``` +`POST /batch` accepts an array of up to 50 `{name, version, type, exists?}` items. The response is keyed by `product_slug`, not by array index — duplicate slugs in the request collapse. Per-item `exists: true` returns a boolean for that slug; `exists: false` (or omitted) returns the full advisory list. -**Example response 2** - -```json -{ - "vulnerabilities": { - "easy-digital-downloads1": [ - { - "id": 4532, - "product_id": 1572, - "title": "WordPress Easy Digital Downloads plugin <= 2.10.2 - Cross-Site Request Forgery (CSRF) vulnerability", - "description": "Cross-Site Request Forgery (CSRF) vulnerability discovered by WPScan team in WordPress Easy Digital Downloads plugin (versions <= 2.10.2).", - "disclosure_date": "2021-04-16 00:00:00", - "disclosed_at": "2021-04-16T00:00:00+00:00", - "created_at": "2021-04-19T04:43:04+00:00", - "url": "wordpress-easy-digital-downloads-plugin-2-10-2-cross-site-request-forgery-csrf-vulnerability", - "product_slug": "easy-digital-downloads1", - "product_name": "Easy Digital Downloads", - "product_name_premium": null, - "product_type": "Plugin", - "vuln_type": "Cross Site Request Forgery (CSRF)", - "cvss_score": 6.5, - "cve": [], - "is_exploited": false, - "affected_in": "<= 2.10.2", - "fixed_in": "2.10.3", - "direct_url": "https://patchstack.com/database/vulnerability/easy-digital-downloads1/wordpress-easy-digital-downloads-plugin-2-10-2-cross-site-request-forgery-csrf-vulnerability" - }, - { - "id": 5410, - "product_id": 1572, - "title": "WordPress Easy Digital Downloads plugin <= 2.11.2 - Authenticated Reflected Cross-Site Scripting (XSS) vulnerability", - "description": "Authenticated Reflected Cross-Site Scripting (XSS) vulnerability discovered by Thinkland Security Team in WordPress Easy Digital Downloads plugin (versions <= 2.11.2).", - "disclosure_date": "2021-10-21 00:00:00", - "disclosed_at": "2021-10-21T00:00:00+00:00", - "created_at": "2021-10-22T12:54:01+00:00", - "url": "wordpress-easy-digital-downloads-plugin-2-11-2-authenticated-reflected-cross-site-scripting-xss-vulnerability", - "product_slug": "easy-digital-downloads1", - "product_name": "Easy Digital Downloads", - "product_name_premium": null, - "product_type": "Plugin", - "vuln_type": "Cross Site Scripting (XSS)", - "cvss_score": 4.8, - "cve": [ - "2021-39354" - ], - "is_exploited": false, - "affected_in": "<= 2.11.2", - "fixed_in": "2.11.2.1", - "direct_url": "https://patchstack.com/database/vulnerability/easy-digital-downloads1/wordpress-easy-digital-downloads-plugin-2-11-2-authenticated-reflected-cross-site-scripting-xss-vulnerability" - } - ], - "wordpress": true - } -} -``` +## Rate limiting -### Find specific vulnerability by ID - -**Description:** Find a specific vulnerability by vulnerability id. -**Endpoint:** /vulnerability/ID -**Method:** GET - -**ID** = Numeric identifier or PSID of the vulnerability. - -**Example response 1** - -```json -{ - "vulnerability": { - "title": "WordPress Spam protection, AntiSpam, FireWall by CleanTalk plugin <= 5.153.3 - Unauthenticated Time-Based Blind SQL Injection (SQLi) vulnerability", - "description": "Unauthenticated Time-Based Blind SQL Injection (SQLi) vulnerability discovered by WordFence in WordPress Spam protection, AntiSpam, FireWall by CleanTalk plugin (versions <= 5.153.3).", - "disclosure_date": "2021-05-03 00:00:00", - "disclosed_at": "2021-05-03T00:00:00+00:00", - "created_at": "2021-09-28T14:17:02+00:00", - "is_exploited": true, - "url": "wordpress-spam-protection-antispam-firewall-by-cleantalk-plugin-5-153-3-unauthenticated-time-based-blind-sql-injection-sqli-vulnerability", - "direct_url": "https://patchstack.com/database/vulnerability/cleantalk-spam-protect/wordpress-spam-protection-antispam-firewall-by-cleantalk-plugin-5-153-3-unauthenticated-time-based-blind-sql-injection-sqli-vulnerability" - }, - "product": { - "name": "Spam protection, AntiSpam, FireWall by CleanTalk", - "slug": "cleantalk-spam-protect", - "type": "Plugin" - }, - "type": "SQL Injection", - "cvss": { - "score": 7.5, - "vector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:N/A:N", - "description": "" - }, - "owasp": "A1: Injection", - "references_url": [ - { - "url": "https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2021-24295", - "title": "CVE" - }, - { - "url": "https://www.wordfence.com/blog/2021/05/sql-injection-vulnerability-patched-in-cleantalk-antispam-plugin/", - "title": "Vulnerability details" - }, - { - "url": "https://wordpress.org/plugins/cleantalk-spam-protect/#developers", - "title": "Plugin changelog" - } - ], - "cve": [ - "2021-24295" - ], - "versions": { - "affected_in": "<= 5.153.3", - "fixed_in": "5.153.4" - }, - "versions_list": null, - "credit": { - "name": "WordFence", - "url": "https://twitter.com/wordfence" - }, - "submitter": null -} -``` +Custom, set per contract. Contact if you need a quota change. -**Example response 2** - -```json -{ - "vulnerability": { - "title": "WordPress Simple File List plugin <= 4.2.2 - Unauthenticated Arbitrary File Upload vulnerability leading to Remote Code Execution (RCE)", - "description": "Unauthenticated Arbitrary File Upload vulnerability leading to Remote Code Execution (RCE) discovered by h00die and coiffeur in WordPress Simple File List plugin (versions <= 4.2.2).", - "disclosure_date": "2020-04-27 00:00:00", - "disclosed_at": "2020-04-27T00:00:00+00:00", - "created_at": "2021-04-23T15:55:02+00:00", - "is_exploited": false, - "url": "wordpress-simple-file-list-plugin-4-2-2-unauthenticated-arbitrary-file-upload-vulnerability-leading-to-remote-code-execution-rce", - "direct_url": "https://patchstack.com/database/vulnerability/simple-file-list/wordpress-simple-file-list-plugin-4-2-2-unauthenticated-arbitrary-file-upload-vulnerability-leading-to-remote-code-execution-rce" - }, - "product": { - "name": "Simple File List", - "slug": "simple-file-list", - "type": "Plugin" - }, - "type": "SQL Injection", - "cvss": { - "score": 9.8, - "vector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H", - "description": "" - }, - "owasp": "A1: Injection", - "references_url": [ - { - "url": "https://packetstormsecurity.com/files/160221/", - "title": "Vulnerability details" - }, - { - "url": "https://wordpress.org/plugins/simple-file-list/#developers", - "title": "Plugin changelog" - } - ], - "cve": [], - "versions": { - "affected_in": "<= 4.2.2", - "fixed_in": "4.2.3" - }, - "versions_list": null, - "credit": { - "name": "coiffeur", - "url": "https://packetstormsecurity.com/files/author/14922/" - }, - "submitter": { - "name": "h00die", - "url": "https://packetstormsecurity.com/files/author/7166/" - } -} +## Errors + +| Status | Meaning | +|---|---| +| `401 Unauthorized` | Missing or invalid `PSKey` header. | +| `403 Forbidden` | API key not authorised for the requested endpoint. | +| `404 Not Found` | Unknown product/version or vulnerability id. | +| `422 Unprocessable Entity` | Invalid request payload (e.g. batch with more than 50 items). | +| `429 Too Many Requests` | Rate limit exceeded. | +| `500` | Server error — please include the request id in any bug report. | + +--- + +## Testing — curl one-liners + +```bash +# Latest 20 vulnerabilities +curl 'https://patchstack.com/database/api/v2/latest' \ + -H 'PSKey: ' + +# Full advisory list for a plugin version +curl 'https://patchstack.com/database/api/v2/product/plugin/tutor/1.5.2' \ + -H 'PSKey: ' + +# Boolean-only exists check +curl 'https://patchstack.com/database/api/v2/product/plugin/tutor/1.5.2/exists' \ + -H 'PSKey: ' + +# Batch — boolean-only across two products +curl -X POST 'https://patchstack.com/database/api/v2/batch' \ + -H 'PSKey: ' \ + -H 'Content-Type: application/json' \ + -d '[ + {"name":"easy-digital-downloads1","version":"1.0.0","type":"plugin","exists":true}, + {"name":"wordpress","version":"3.0.0","type":"wordpress","exists":true} + ]' + +# Advisory detail by id +curl 'https://patchstack.com/database/api/v2/vulnerability/4760' \ + -H 'PSKey: ' ``` -**Example response 3** - -```json -{ - "vulnerability": { - "title": "WordPress Redux Framework <= 4.1.23 - Cross-Site Request Forgery (CSRF) Nonce Validation Bypass vulnerability", - "description": "Cross-Site Request Forgery (CSRF) Nonce Validation Bypass vulnerability found by ErwanLR in WordPress Redux Framework (versions 4.1.22 - 4.1.23).", - "disclosure_date": "2020-12-15 00:00:00", - "disclosed_at": "2020-12-15T00:00:00+00:00", - "created_at": "2020-12-15T18:36:01+00:00", - "is_exploited": false, - "url": "wordpress-redux-framework-4-1-23-cross-site-request-forgery-csrf-nonce-validation-bypass-vulnerability", - "direct_url": "https://patchstack.com/database/vulnerability/redux-framework/wordpress-redux-framework-4-1-23-cross-site-request-forgery-csrf-nonce-validation-bypass-vulnerability" - }, - "product": { - "name": "Redux Framework", - "slug": "redux-framework", - "type": "Plugin" - }, - "type": "SQL Injection", - "cvss": null, - "owasp": "A1: Injection", - "references_url": [ - { - "url": "https://plugins.trac.wordpress.org/changeset/2437953/redux-framework/trunk/redux-core/inc/classes/class-redux-ajax-save.php?old=2405408", - "title": "Vulnerability details" - }, - { - "url": "https://github.com/reduxframework/redux-framework-4/blob/master/CHANGELOG.md", - "title": "Plugin changelog" - } - ], - "cve": [], - "versions": { - "affected_in": "<= 4.1.23", - "fixed_in": "4.1.24" - }, - "versions_list": "4.1.23, 4.1.22", - "credit": { - "name": "ErwanLR", - "url": "https://profiles.wordpress.org/erwanlr/" - }, - "submitter": null +## Batch walk (PHP) + +```php + 'easy-digital-downloads1', 'version' => '1.0.0', 'type' => 'plugin', 'exists' => false], + ['name' => 'wordpress', 'version' => '3.0.0', 'type' => 'wordpress', 'exists' => true], +]; + +$ch = curl_init('https://patchstack.com/database/api/v2/batch'); +curl_setopt_array($ch, [ + CURLOPT_RETURNTRANSFER => true, + CURLOPT_POST => true, + CURLOPT_HTTPHEADER => ['PSKey: '.$apiKey, 'Content-Type: application/json'], + CURLOPT_POSTFIELDS => json_encode($components), +]); +$response = json_decode(curl_exec($ch), true); +curl_close($ch); + +foreach ($response['vulnerabilities'] as $slug => $result) { + if (is_bool($result)) { + echo "{$slug}: ".($result ? 'vulnerable' : 'clear').PHP_EOL; + } else { + echo "{$slug}: ".count($result)." advisor".(count($result) === 1 ? 'y' : 'ies').PHP_EOL; + } } ``` -## More information about the Threat Intelligence API +## More information -You can find more information about Threat Intelligence API here: -https://patchstack.com/for-hosts/ +You can find more information about the Patchstack Threat Intelligence API on . If you have integration questions, email . diff --git a/src/content/docs/API solutions/Threat Intelligence API/overview.md b/src/content/docs/API solutions/Threat Intelligence API/overview.md index b6e0a04..71936c3 100644 --- a/src/content/docs/API solutions/Threat Intelligence API/overview.md +++ b/src/content/docs/API solutions/Threat Intelligence API/overview.md @@ -1,50 +1,92 @@ ---- -title: "Overview" -excerpt: "" -metadata: - image: [] - robots: "index" -createdAt: "Thu Jun 01 2023 12:04:17 GMT+0000 (Coordinated Universal Time)" -updatedAt: "Mon Jul 31 2023 12:13:26 GMT+0000 (Coordinated Universal Time)" -sidebar: - order: 1 - label: "Overview" - hidden: false ---- - -Patchstack publishes three ways to consume its vulnerability database. Standard and Extended are the stable tiers of the v2 API; the Npm Dataset API (Beta) is a new generation available to selected partners only. - -## Which API should I use? - -| | **Standard** | **Extended** | **Beta** | -|---|---|---|---| -| **Status** | Stable (v2) | Stable (v2) | Beta — selected partners only | -| **Access** | Purchase via [Patchstack App](https://app.patchstack.com/billing/subscription) | Custom pricing, activated on request — [contact us](https://patchstack.com/for-hosts/) | By invitation. If you're working with Patchstack on an integration, [get in touch](https://patchstack.com/for-hosts/) | -| **Rate limit** | 5,000 calls / 24 hours | Custom | Custom | -| **Ecosystems** | WordPress plugins, themes, core | WordPress plugins, themes, core | WordPress + **npm** | -| **Lookups** | Single plugin/theme/version | Single + bulk | Single + bulk | -| **Pagination** | Offset | Offset | Offset **and** cursor | -| **Response shape** | Flat | Flat | Nested (`product`, `cvss`, `cwe`, `version_info`…) | -| **Full advisory body** | No | Yes | Opt-in via `?include=details` | -| **OpenAPI spec / Postman collection** | — | — | [Yes](/api-solutions/threat-intelligence-api/beta/#use-with-postman-insomnia-bruno-or-hoppscotch) | - -**New integration?** If you have Beta access, use Beta — it's the direction we're heading, and Standard/Extended will eventually adopt the same shape. If not, start with Standard or Extended depending on your data needs. - -**Existing integration?** Standard and Extended remain supported; no migration is required. - ---- - -### Standard Threat Intelligence API -Fetch the latest vulnerability information for a single version of a particular plugin, theme or WordPress core. API is limited for 5000 calls / 24 hours. Access to this API can be purchased through the [Patchstack App](https://app.patchstack.com/billing/subscription). - -[Standard Threat Intelligence API Documentation](/api-solutions/threat-intelligence-api/standard/) - -### Extended Threat Intelligence API -Access everything included in the Standard tier, bulk-request data for multiple plugins with one API call, and have additional endpoints with more information about vulnerabilities. Extended tier has custom pricing and is activated on request only. For access to these API endpoints, please [contact us here](https://patchstack.com/for-hosts/). - -[Extended Threat Intelligence API Documentation](/api-solutions/threat-intelligence-api/extended/) - -### Beta Threat Intelligence API -A new generation of the Threat Intelligence API, currently available to **selected partners working directly with Patchstack**. Adds npm ecosystem coverage, an opt-in full advisory body (`?include=details`), a consistent nested response shape, and cursor-based pagination alongside the existing offset pagination. If you're already working with us on an integration and would like access, [contact us](https://patchstack.com/for-hosts/). - -[Beta Threat Intelligence API Documentation](/api-solutions/threat-intelligence-api/beta/) +--- +title: "Overview" +excerpt: "" +metadata: + image: [] + robots: "index" +createdAt: "Thu Jun 01 2023 12:04:17 GMT+0000 (Coordinated Universal Time)" +updatedAt: "Mon Jul 31 2023 12:13:26 GMT+0000 (Coordinated Universal Time)" +sidebar: + order: 1 + label: "Overview" + hidden: false +--- + +Patchstack publishes three tiers of the Threat Intelligence API. Each tier has a narrative **Guide** and an interactive **Reference** generated from its OpenAPI spec. All three specs use the same tooling for import, SDK generation, and LLM-assisted client writing — covered once in [Using the APIs with your tools](#using-the-apis-with-your-tools) below. + +## Standard Threat Intelligence API + +WordPress plugin, theme and core lookups for a single product + version. Flat per-item shape, 5,000 requests / 24 hours. Purchase access from the [Patchstack App](https://app.patchstack.com/billing/subscription). + +- [Guide](/api-solutions/threat-intelligence-api/standard/) · [Reference](/api-reference/threat-intelligence-standard/) · [OpenAPI](/schemas/threat-intel-standard.yaml) · [Postman](/schemas/threat-intel-standard.postman_collection.json) + +## Extended Threat Intelligence API + +Everything in Standard, plus bulk lookups (`POST /batch`, up to 50 products per request), the `/latest` rolling feed, advisory-by-id detail, and a richer per-item payload (`cvss_score`, `cve`, `is_exploited`, `patch_priority`, `patched_in_ranges`…). Custom pricing, activated on request — [contact us](https://patchstack.com/for-hosts/). + +- [Guide](/api-solutions/threat-intelligence-api/extended/) · [Reference](/api-reference/threat-intelligence-extended/) · [OpenAPI](/schemas/threat-intel-extended.yaml) · [Postman](/schemas/threat-intel-extended.postman_collection.json) + +## Npm Dataset API (Beta) + +A new generation of the API, currently available to **selected partners working directly with Patchstack**. Adds npm ecosystem coverage, an opt-in full advisory body (`?include=details`), a consistent nested response shape (`product`, `cvss`, `cwe`, `version_info`…), and cursor-based pagination alongside offset. If you're already working with us on an integration and would like access, [contact us](https://patchstack.com/for-hosts/). + +- [Guide](/api-solutions/threat-intelligence-api/beta/) · [Reference](/api-reference/threat-intelligence-beta/) · [OpenAPI](/schemas/threat-intel-beta.yaml) · [Postman](/schemas/threat-intel-beta.postman_collection.json) + +--- + +**New integration?** If you have Beta access, use Beta — it's the direction we're heading, and Standard/Extended will eventually adopt the same nested shape. Otherwise start with Standard or Extended depending on your data needs. + +**Existing integration?** Standard and Extended remain supported; no migration is required. See [API properties](/api-solutions/threat-intelligence-api/api-properties/) for v2 field definitions. + +--- + +## Using the APIs with your tools + +All three tiers ship the same three artefacts — pick whichever URL matches the tier you're integrating: + +| Tier | OpenAPI spec | Postman collection | +|---|---|---| +| Standard | [`threat-intel-standard.yaml`](/schemas/threat-intel-standard.yaml) | [`threat-intel-standard.postman_collection.json`](/schemas/threat-intel-standard.postman_collection.json) | +| Extended | [`threat-intel-extended.yaml`](/schemas/threat-intel-extended.yaml) | [`threat-intel-extended.postman_collection.json`](/schemas/threat-intel-extended.postman_collection.json) | +| Beta | [`threat-intel-beta.yaml`](/schemas/threat-intel-beta.yaml) | [`threat-intel-beta.postman_collection.json`](/schemas/threat-intel-beta.postman_collection.json) | + +### Postman, Insomnia, Bruno or Hoppscotch + +Every endpoint, parameter, request body and example is preconfigured. Download the Postman collection and drag it into your tool, or import by URL from inside the tool: + +| Tool | How to import | +|---|---| +| **Postman** | `File → Import → Link` and paste the collection URL. | +| **Insomnia** | `Create → Import From → URL` → paste the OpenAPI URL. | +| **Bruno** | `Collection → Import → OpenAPI V3 Spec` → paste the OpenAPI URL. | +| **Hoppscotch** | `Collections → Import/Export → OpenAPI` → paste the OpenAPI URL. | + +**Authentication:** in Postman set the collection `Authorization` to **API Key**, key `PSKey`, value `{{PSKEY}}`, and add `PSKEY` as a collection variable with your real key as the **Current value** (leave Initial blank so it doesn't sync to teammates). Other tools work the same way — set `PSKey` as a collection header once. + +### Claude Code and other LLM coding assistants + +Point your assistant at the spec. LLMs parse OpenAPI cleanly and will generate clients that match the real field names instead of hallucinating. + +- **Ad hoc:** paste the spec URL into your prompt. Example: *"Write a Python client for `https://docs.patchstack.com/schemas/threat-intel-extended.yaml`. I need a batch walker over a `package.json`-style list."* +- **In your repo:** download the spec to `docs/vendor/patchstack-threat-intel-.yaml` and reference it from your `CLAUDE.md` / `AGENTS.md`. Your assistant can then grep the YAML for specific fields without refetching. +- **Plain-text fallback:** for tools that don't parse YAML, our [`llms-full.txt`](/llms-full.txt) contains the full reference as flat markdown. + +### SDK generation + +Generate a client in any language from the same spec — swap the spec URL for the tier you want: + +```bash +# TypeScript (Extended tier shown) +npx @openapitools/openapi-generator-cli generate \ + -i https://docs.patchstack.com/schemas/threat-intel-extended.yaml \ + -g typescript-fetch -o ./patchstack-client + +# Python +npx @openapitools/openapi-generator-cli generate \ + -i https://docs.patchstack.com/schemas/threat-intel-extended.yaml \ + -g python -o ./patchstack-client-py +``` + +Speakeasy and Fern also consume the same spec and produce more idiomatic SDKs if you need a polished client library. + +> **Spec stability:** the Beta spec may change without a version bump while the API is in beta. Pin a commit of the YAML in production integrations, or wait for the GA release when we'll publish versioned URLs. Standard and Extended specs track the stable v2 surface. diff --git a/src/content/docs/API solutions/Threat Intelligence API/standard.md b/src/content/docs/API solutions/Threat Intelligence API/standard.md index 42acb36..5109537 100644 --- a/src/content/docs/API solutions/Threat Intelligence API/standard.md +++ b/src/content/docs/API solutions/Threat Intelligence API/standard.md @@ -1,77 +1,76 @@ --- title: "Standard tier API" -excerpt: "" -metadata: +excerpt: "Entry-level WordPress vulnerability lookup — single product + version, 5,000 requests per day." +metadata: image: [] robots: "index" createdAt: "Mon Jul 25 2022 09:28:24 GMT+0000 (Coordinated Universal Time)" updatedAt: "Wed May 10 2023 12:26:10 GMT+0000 (Coordinated Universal Time)" sidebar: order: 1 + label: "Guide" --- -_If you’re looking for an API that has a complete data coverage and could be used commercially, please look at the Extended Threat Intelligence API here._ - -## API Usage - -The Standard Threat Intelligence API is limited to 5000 requests per 24 hours. - -The base URL of the API is - -All responses are in JSON format. For performance reasons, responses are cached until we update the database after which the appropriate caches are cleared. - -An API key is required. This API key should be present in the _PSKey_ HTTP request header. You can request an API key by logging into your Patchstack App account and then by going to the Upgrades page . - -Explanation of the API response properties can be found here [here](/api-solutions/threat-intelligence-api/api-properties/). - -## Find Vulnerability - -**Description:** Retrieve vulnerabilities of a specific plugin, theme or WordPress core version. -**Endpoint:** /product/TYPE/NAME/VERSION/EXISTS? -**Method:** GET - -**TYPE** = theme, plugin, wordpress -**NAME** = Slug of the theme, slug of the plugin, or “wordpress” in case TYPE is set to wordpress -**VERSION** = Version to check for vulnerabilities -**EXISTS** = Optional flag that will not return all vulnerabilities but only a boolean response whether or not there are vulnerabilities. This flag being present results in a faster response. - -Example response (): - -```json -{ - "vulnerabilities": [ - { - "id": 4253, - "title": "WordPress Tutor LMS plugin <= 1.5.2 - Cross-Site Request Forgery (CSRF) vulnerability", - "disclosed_at": "2020-02-04T00:00:00+00:00", - "created_at": "2022-05-27T10:23:01+00:00", - "product_slug": "tutor", - "product_name": "Tutor LMS", - "product_name_premium": null, - "product_type": "Plugin", - "fixed_in": "1.5.3", - "direct_url": "https://patchstack.com/database/vulnerability/tutor/wordpress-tutor-lms-plugin-1-5-2-cross-site-request-forgery-csrf-vulnerability" - }, - { - "id": 4386, - "title": "WordPress Tutor LMS plugin <= 1.7.6 - Multiple Blind/Time-based SQL Injection (SQLi) vulnerabilities", - "disclosed_at": "2021-03-15T00:00:00+00:00", - "created_at": "2022-05-27T10:23:01+00:00", - "product_slug": "tutor", - "product_name": "Tutor LMS", - "product_name_premium": null, - "product_type": "Plugin", - "fixed_in": "1.7.7", - "direct_url": "https://patchstack.com/database/vulnerability/tutor/wordpress-tutor-lms-plugin-1-7-6-multiple-blind-time-based-sql-injection-sqli-vulnerabilities" - } - ] -} +_The Standard Threat Intelligence API is the entry-level tier of the v2 API. It returns every advisory that applies to a single WordPress plugin, theme or core version. If you need bulk lookups, the latest-24h feed, or advisory-by-id details, see the [Extended tier](/api-solutions/threat-intelligence-api/extended/)._ + +> **Interactive reference:** Every endpoint, parameter and response shape is documented in the [Threat Intelligence API (Standard) reference](/api-reference/threat-intelligence-standard/). +> +> **Tooling (Postman, SDK, LLM):** spec URLs and import instructions for all three tiers live on [Overview → Using the APIs with your tools](/api-solutions/threat-intelligence-api/overview/#using-the-apis-with-your-tools). + +This page covers the concepts you need to use the API effectively — authentication, rate limiting, errors, and code samples. Use it alongside the interactive reference. + +## Base URL + +``` +https://patchstack.com/database/api/v2/ ``` -Example response (): +## Authentication + +Every request must include your API key in the **`PSKey`** HTTP request header. You can request an API key from your [Patchstack App billing page](https://app.patchstack.com/billing/subscription). -```json -{ - "vulnerable": true -} ``` +PSKey: +``` + +## Response format + +All responses are JSON. Responses are cached until the Patchstack database updates, at which point the cache is cleared. + +The Standard tier returns a **flat** per-item shape. For the richer shape with `description`, `vuln_type`, `cvss_score`, `cve`, and `patched_in_ranges`, use the [Extended tier](/api-solutions/threat-intelligence-api/extended/). Field definitions live in [API properties](/api-solutions/threat-intelligence-api/api-properties/). + +## Rate limiting + +Standard is limited to **5,000 requests per 24 hours**. Contact if you need a higher quota or the Extended tier. + +## Errors + +| Status | Meaning | +|---|---| +| `401 Unauthorized` | Missing or invalid `PSKey` header. | +| `403 Forbidden` | API key not authorised for the requested endpoint. | +| `404 Not Found` | Unknown product/version combination. | +| `429 Too Many Requests` | Rate limit exceeded. | +| `500` | Server error — please include the request id in any bug report. | + +--- + +## Testing — curl one-liners + +```bash +# Full advisory list for a plugin version +curl 'https://patchstack.com/database/api/v2/product/plugin/tutor/1.5.2' \ + -H 'PSKey: ' + +# Boolean-only exists check (faster) +curl 'https://patchstack.com/database/api/v2/product/plugin/tutor/1.5.2/exists' \ + -H 'PSKey: ' + +# WordPress core +curl 'https://patchstack.com/database/api/v2/product/wordpress/wordpress/5.8.2' \ + -H 'PSKey: ' +``` + +## More information + +You can find more information about the Patchstack Threat Intelligence API on . If you have integration questions, email . diff --git a/src/content/docs/FAQ Troubleshooting/Technical/will-patchstack-plugin-help-my-site-pass-pci-dss-soc2-iso-127001-or-other-security-checks.md b/src/content/docs/FAQ Troubleshooting/Technical/will-patchstack-plugin-help-my-site-pass-pci-dss-soc2-iso-27001-or-other-security-checks.md similarity index 93% rename from src/content/docs/FAQ Troubleshooting/Technical/will-patchstack-plugin-help-my-site-pass-pci-dss-soc2-iso-127001-or-other-security-checks.md rename to src/content/docs/FAQ Troubleshooting/Technical/will-patchstack-plugin-help-my-site-pass-pci-dss-soc2-iso-27001-or-other-security-checks.md index 4052f62..ade320b 100644 --- a/src/content/docs/FAQ Troubleshooting/Technical/will-patchstack-plugin-help-my-site-pass-pci-dss-soc2-iso-127001-or-other-security-checks.md +++ b/src/content/docs/FAQ Troubleshooting/Technical/will-patchstack-plugin-help-my-site-pass-pci-dss-soc2-iso-27001-or-other-security-checks.md @@ -1,5 +1,5 @@ --- -title: "Will Patchstack plugin help my site pass PCI-DSS, SOC2, ISO 127001 or other security checks?" +title: "Will Patchstack plugin help my site pass PCI-DSS, SOC2, ISO 27001 or other security checks?" excerpt: "" hidden: false metadata: diff --git a/src/content/docs/Getting Started/start-using-patchstack.md b/src/content/docs/Getting Started/start-using-patchstack.md index b222215..33529c2 100644 --- a/src/content/docs/Getting Started/start-using-patchstack.md +++ b/src/content/docs/Getting Started/start-using-patchstack.md @@ -41,7 +41,7 @@ To add the first site: ### Step #3 — Review vulnerabilities -Patchstack shows your site for existing plugin & theme vulnerabilities. After that, check your dashboard to see a detailed breakdown of vulnerabilities by patch prioriy and severiy score. +Patchstack shows your site for existing plugin & theme vulnerabilities. After that, check your dashboard to see a detailed breakdown of vulnerabilities by patch priority and severity score. Take immediate action on the **High Priority** vulnerabilities. diff --git a/src/styles/custom.css b/src/styles/custom.css index f6a346d..59ea496 100644 --- a/src/styles/custom.css +++ b/src/styles/custom.css @@ -136,11 +136,3 @@ header button { .main-frame { margin-bottom: 30px; } - -/* Match sidebar group labels that carry a badge (e.g. Npm Dataset API (Beta) [New]) to the - weight/size of sibling leaf links, so the badge carries the emphasis - instead of the label doubling up. */ -.group-label .large:has(+ .sl-badge) { - font-size: var(--sl-text-sm); - font-weight: normal; -} From 6ff61ee9a062356fddabf9386d5c77d6cf01f18b Mon Sep 17 00:00:00 2001 From: Elliot Date: Tue, 28 Apr 2026 10:38:07 +0100 Subject: [PATCH 19/89] Threat Intelligence API: hide Standard, simplify Beta into one entry (#38) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Hide Standard Threat Intelligence API from sidebar Standard tier is no longer offered to new customers — enterprise customers all get Extended. Remove Standard API from the sidebar nav while keeping the guide page, OpenAPI reference, schema and Postman collection live at their existing URLs for legacy integrators. No endpoint documentation is lost: Standard's two endpoints are a strict subset of Extended. - Drop "Standard API" sidebar entry in astro.config.mjs (keep the starlightOpenAPI block so /api-reference/threat-intelligence-standard/ still generates). - Lead overview.md with Extended; drop the "Purchase access from billing" framing; flag Standard as legacy with link. - Replace the Standard tier card on the API solutions landing page with a single Threat Intelligence card pointing at the overview. - Point the upgrades page at the TI overview rather than Standard. - Add a legacy banner to standard.md so direct-URL visitors land on context. Co-Authored-By: Claude Opus 4.7 (1M context) * Promote Extended to "Threat Intelligence API"; nest Beta under it Drop the tier framing now that Standard is hidden. Extended becomes just "the Threat Intelligence API", and the npm/cursor/include=details endpoints are reframed as Beta features layered on top of it (same parent group, Beta-tagged subgroup) since they're the direction the stable API is heading. - astro.config.mjs: flatten the Extended wrapper so its Guide and Reference sit directly under "Threat Intelligence API"; rename "NPM standard API" → "Beta features" and keep the Beta badge. - overview.md: lead with the API and its endpoints; describe Beta as features (npm coverage, cursor pagination, include=details, nested shape) rather than a separate API. - extended.md: retitle to "Threat Intelligence API" with an endpoints-at-a-glance table; drop the "superset of Standard" framing. - beta.md: relabel as "Beta features"; tighten migration notes and rate-limit copy to reference the stable API. - standard.md: update the legacy banner to point at the renamed parent. URLs are unchanged — /extended/, /beta/ and the per-tier reference paths all still generate. Co-Authored-By: Claude Opus 4.7 (1M context) * Nest NPM (Beta) reference as a sub-category of Reference The previous "Beta features" group sat parallel to Reference and duplicated the same Vulnerabilities/Products/Batch tag names from a separate spec. That looked like duplication because, structurally, it was: the npm flavour reuses the same resource categories at a different base URL with a nested response shape. Reframe it as a sub-category inside Reference so the platform distinction is the organising axis. - astro.config.mjs: rename openapi sidebar labels — Extended group → "WordPress", Beta group → "NPM (Beta)"; wrap both inside a manual "Reference" parent so the sidebar reads Reference > {WordPress | NPM (Beta)} > tags. Drop the standalone "Beta features" wrapper. - beta.md: hide from sidebar (URL stays live); retitle as the NPM (Beta) integration guide and link to it from the overview. - overview.md: replace the multi-bullet "Beta features" section with an "NPM (Beta)" section that leads with npm coverage as the primary feature; add a Reference (WordPress) / Reference (NPM) split on the link rail; rename the tier table row. * Flatten Reference; surface only the Beta delta as a single page The WordPress/NPM split inside Reference still showed parallel Vulnerabilities/Products/Batch trees. In reality the Beta surface adds one new endpoint (GET /all) and a handful of optional parameters (?platform=npm, ?cursor=, ?include=details) plus a nested response shape — the rest of its operations are duplicates of the stable surface. Reframe accordingly: - astro.config.mjs: drop the Reference wrapper; put the Extended openapi group directly under "Threat Intelligence API" so its tags (Vulnerabilities/Products/Batch) sit at top level. Restore the Extended openapi sidebar label to "Reference". Keep the Beta openapi config (URLs still generate) but remove its sidebar group from nav. - beta.md: rewrite as a focused "Beta additions" page listing only what's new (table of additions, pagination details, scoped npm packages, errors, migration notes, code samples). Sidebar entry surfaces as a single page with a Beta badge. Links to the auto-generated reference for full schemas. - overview.md: collapse the NPM (Beta) section to one paragraph pointing at /beta/; rename the artefacts table row to "Beta additions"; clean the link rail. * Rename Beta page to "Beta API"; drop the sidebar Beta badge "Beta additions" framed the page as a delta-list. Partners arriving fresh expect to land on a page that calls itself the Beta API — that's the entry point, not a side-note. The badge was redundant once the label says "Beta" outright. * Surface /all and the full Beta reference in the sidebar The single-page Beta API entry hid the unique Beta endpoint (/all) and the auto-generated Beta reference TOC behind inline links only. Promote Beta API to a small sidebar group with three children: - Overview → beta.md narrative (sidebar label updated) - GET /all → the only net-new Beta operation - Full reference → /api-reference/threat-intelligence-beta/ TOC Also link the /all entry directly from the additions table on the Beta API Overview page so the new endpoint is reachable from the prose, not only the sidebar. * Rename Beta entry to "NPM features (Beta)" "Beta API" doesn't communicate scope — every API has a beta. The section's actual scope is npm-ecosystem coverage plus the supporting additions (/all, cursor pagination, ?include=details, nested shape) that make npm coverage workable. Use that as the label everywhere (sidebar group, openapi reference label, page title, overview prose, artefacts table) so the entry tells partners what they're getting. * Use a Beta badge on the NPM features sidebar group Match the badge treatment used on Pricing plans — split the inline "(Beta)" off the label into a sidebar badge so the visual weight of "NPM features" stands on its own and the Beta status reads as a tag. * Fix Beta spec metadata and base-URL inconsistency Three small accuracy fixes from a doc check: - threat-intel-beta.yaml: rename info.title from "— Beta" to "— NPM features" so the auto-rendered title no longer reads "Beta (beta)" with the version suffix appended. - threat-intel-beta.yaml: rename the lone server description from "Production" to "Beta" so the GET /all (and all other) operation pages tag the server correctly. - beta.md: correct the documented Base URL from https://vdp-api.patchstack.com/database/api/beta/ to https://patchstack.com/database/api/beta/, which is what the spec's server entry uses and what the curl one-liners on the same page already used. - threat-intel-beta.yaml: update the in-description "Related pages" link label to match the new sidebar entry. --------- Co-authored-by: Claude Opus 4.7 (1M context) --- astro.config.mjs | 25 ++---- .../threat-intel-beta.postman_collection.json | 4 +- public/schemas/threat-intel-beta.yaml | 6 +- .../Threat Intelligence API/beta.md | 87 +++++++------------ .../Threat Intelligence API/extended.md | 36 ++++---- .../Threat Intelligence API/overview.md | 44 ++++------ .../Threat Intelligence API/standard.md | 6 +- src/content/docs/API solutions/index.mdx | 23 +---- .../docs/Patchstack App/Upgrades/upgrades.md | 2 +- 9 files changed, 85 insertions(+), 148 deletions(-) diff --git a/astro.config.mjs b/astro.config.mjs index eb7302f..6b1350a 100644 --- a/astro.config.mjs +++ b/astro.config.mjs @@ -106,7 +106,7 @@ export default defineConfig({ { base: 'api-reference/threat-intelligence-beta', schema: './public/schemas/threat-intel-beta.yaml', - sidebar: { label: 'Reference', group: threatIntelBetaSidebarGroup }, + sidebar: { label: 'NPM features (Beta)', group: threatIntelBetaSidebarGroup, collapsed: true }, }, ]), ], @@ -165,29 +165,16 @@ export default defineConfig({ collapsed: true, items: [ { slug: 'api-solutions/threat-intelligence-api/overview' }, + { slug: 'api-solutions/threat-intelligence-api/extended' }, + threatIntelExtendedSidebarGroup, { - label: 'Standard API', - collapsed: true, - items: [ - { slug: 'api-solutions/threat-intelligence-api/standard' }, - threatIntelStandardSidebarGroup, - ], - }, - { - label: 'Extended API', - collapsed: true, - items: [ - { slug: 'api-solutions/threat-intelligence-api/extended' }, - threatIntelExtendedSidebarGroup, - ], - }, - { - label: 'NPM standard API', + label: 'NPM features', badge: { text: 'Beta', variant: 'tip' }, collapsed: true, items: [ { slug: 'api-solutions/threat-intelligence-api/beta' }, - threatIntelBetaSidebarGroup, + { label: 'GET /all (new)', link: '/api-reference/threat-intelligence-beta/operations/listallvulnerabilities/' }, + { label: 'Full reference', link: '/api-reference/threat-intelligence-beta/' }, ], }, { slug: 'api-solutions/threat-intelligence-api/api-properties' }, diff --git a/public/schemas/threat-intel-beta.postman_collection.json b/public/schemas/threat-intel-beta.postman_collection.json index 8a6d981..273db67 100644 --- a/public/schemas/threat-intel-beta.postman_collection.json +++ b/public/schemas/threat-intel-beta.postman_collection.json @@ -1772,10 +1772,10 @@ ] }, "info": { - "name": "Patchstack Threat Intelligence API — Beta", + "name": "Patchstack Threat Intelligence API — NPM features", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "description": { - "content": "The Beta endpoints live alongside the v2 API and add npm coverage, an optional\nfull advisory body, a consistent nested response shape, and cursor pagination.\nThey are the recommended endpoints for new integrations; v2 remains available\nfor backwards compatibility.\n\n## Authentication\n\nEvery request must include your API key in the `PSKey` HTTP request header.\nRequest a key via .\n\n## Platforms\n\nPass `?platform=npm` (or `?platform=wordpress` — the default) on list\nendpoints. Platform names are case-insensitive.\n\n## Pagination\n\n`/all` and `/latest` support two independent strategies, selected by which\nquery parameter you pass:\n\n- **Offset** (`?page=&per_page=`) — returns totals; easy to jump to a\n specific page; susceptible to row-shift when new rows land while paging.\n- **Cursor** (`?cursor=`) — stable under concurrent inserts, faster at\n depth, no `total` count. Bootstrap with an empty value: `?cursor=`.\n\n`cursor` and `page` are mutually exclusive; passing both returns `422`.\n\n## Including full advisory bodies\n\nPass `?include=details` on any list endpoint to add an `advisory_details`\nmarkdown field to each item.\n\n## Scoped npm packages\n\nnpm package slugs that include a `/` (e.g. `@scope/pkg`) conflict with the\nroute separator. URL-encode the `/` as `%2F`.\n\n## Rate limiting\n\nSame policy as the Extended Threat Intelligence API. Contact\n if you need an elevated quota.\n\n## Errors\n\n| Status | Meaning |\n|---|---|\n| `401` | Missing or invalid `PSKey` header. |\n| `403` | API key not authorised for the requested endpoint. |\n| `422` | Invalid parameter combination or value (e.g. `cursor` + `page`, invalid `platform`, `per_page > 500`). |\n| `429` | Rate limit exceeded. |\n| `500` | Server error — include the request id in any bug report. |\n\nA malformed cursor returns `200` with an empty page rather than an error:\n\n```json\n{ \"vulnerabilities\": [], \"cursor\": { \"next_cursor\": null, \"has_more\": false, \"per_page\": 100 } }\n```\n\n## Related pages\n\n- Narrative guide with code samples: [Beta tier API](/api-solutions/threat-intelligence-api/beta/)\n- OpenAPI spec (import into Postman / Insomnia / Bruno / Hoppscotch): \n- Postman collection (pre-imported): \n\nIntegration questions: .\n\n\nContact Support:\n Name: Patchstack\n Email: dave.jong@patchstack.com", + "content": "The Beta endpoints live alongside the v2 API and add npm coverage, an optional\nfull advisory body, a consistent nested response shape, and cursor pagination.\nThey are the recommended endpoints for new integrations; v2 remains available\nfor backwards compatibility.\n\n## Authentication\n\nEvery request must include your API key in the `PSKey` HTTP request header.\nRequest a key via .\n\n## Platforms\n\nPass `?platform=npm` (or `?platform=wordpress` — the default) on list\nendpoints. Platform names are case-insensitive.\n\n## Pagination\n\n`/all` and `/latest` support two independent strategies, selected by which\nquery parameter you pass:\n\n- **Offset** (`?page=&per_page=`) — returns totals; easy to jump to a\n specific page; susceptible to row-shift when new rows land while paging.\n- **Cursor** (`?cursor=`) — stable under concurrent inserts, faster at\n depth, no `total` count. Bootstrap with an empty value: `?cursor=`.\n\n`cursor` and `page` are mutually exclusive; passing both returns `422`.\n\n## Including full advisory bodies\n\nPass `?include=details` on any list endpoint to add an `advisory_details`\nmarkdown field to each item.\n\n## Scoped npm packages\n\nnpm package slugs that include a `/` (e.g. `@scope/pkg`) conflict with the\nroute separator. URL-encode the `/` as `%2F`.\n\n## Rate limiting\n\nSame policy as the Extended Threat Intelligence API. Contact\n if you need an elevated quota.\n\n## Errors\n\n| Status | Meaning |\n|---|---|\n| `401` | Missing or invalid `PSKey` header. |\n| `403` | API key not authorised for the requested endpoint. |\n| `422` | Invalid parameter combination or value (e.g. `cursor` + `page`, invalid `platform`, `per_page > 500`). |\n| `429` | Rate limit exceeded. |\n| `500` | Server error — include the request id in any bug report. |\n\nA malformed cursor returns `200` with an empty page rather than an error:\n\n```json\n{ \"vulnerabilities\": [], \"cursor\": { \"next_cursor\": null, \"has_more\": false, \"per_page\": 100 } }\n```\n\n## Related pages\n\n- Narrative guide with code samples: [NPM features (Beta)](/api-solutions/threat-intelligence-api/beta/)\n- OpenAPI spec (import into Postman / Insomnia / Bruno / Hoppscotch): \n- Postman collection (pre-imported): \n\nIntegration questions: .\n\n\nContact Support:\n Name: Patchstack\n Email: dave.jong@patchstack.com", "type": "text/plain" } } diff --git a/public/schemas/threat-intel-beta.yaml b/public/schemas/threat-intel-beta.yaml index 5b77a43..ce3e637 100644 --- a/public/schemas/threat-intel-beta.yaml +++ b/public/schemas/threat-intel-beta.yaml @@ -1,6 +1,6 @@ openapi: 3.1.0 info: - title: Patchstack Threat Intelligence API — Beta + title: Patchstack Threat Intelligence API — NPM features version: beta summary: npm + WordPress vulnerability intelligence with nested response shape and cursor pagination. description: | @@ -64,7 +64,7 @@ info: ## Related pages - - Narrative guide with code samples: [Beta tier API](/api-solutions/threat-intelligence-api/beta/) + - Narrative guide with code samples: [NPM features (Beta)](/api-solutions/threat-intelligence-api/beta/) - OpenAPI spec (import into Postman / Insomnia / Bruno / Hoppscotch): - Postman collection (pre-imported): @@ -76,7 +76,7 @@ info: servers: - url: https://patchstack.com/database/api/beta - description: Production + description: Beta security: - PSKey: [] diff --git a/src/content/docs/API solutions/Threat Intelligence API/beta.md b/src/content/docs/API solutions/Threat Intelligence API/beta.md index 74a968a..86a0fb2 100644 --- a/src/content/docs/API solutions/Threat Intelligence API/beta.md +++ b/src/content/docs/API solutions/Threat Intelligence API/beta.md @@ -1,6 +1,6 @@ --- -title: "Npm Dataset API (Beta)" -excerpt: "Beta vulnerability endpoints — npm support, Resource-based shape, offset and cursor pagination, include=details." +title: "NPM features (Beta)" +excerpt: "npm-ecosystem coverage and the supporting additions on top of the Threat Intelligence API — the /all endpoint, cursor pagination, ?include=details, and the nested response shape." hidden: false metadata: image: [] @@ -8,80 +8,69 @@ metadata: createdAt: "Tue Apr 21 2026 00:00:00 GMT+0000 (Coordinated Universal Time)" updatedAt: "Wed Apr 22 2026 00:00:00 GMT+0000 (Coordinated Universal Time)" sidebar: - label: "Guide" + order: 1 + label: "Overview" --- -_The Npm Dataset API (Beta) is a new generation of the Threat Intelligence API, currently available to **selected partners working directly with Patchstack**. It lives alongside the v2 API (Standard / Extended) and adds npm coverage, an optional full advisory body, a consistent nested response shape, and cursor pagination. If you'd like access to run an integration on Beta, [contact us](https://patchstack.com/for-hosts/)._ - -> **Interactive reference:** Every endpoint, parameter, request body and response shape is documented in the [Threat Intelligence API (Beta) reference](/api-reference/threat-intelligence-beta/). -> -> **Tooling (Postman, SDK, LLM):** spec URLs and import instructions for all three tiers live on [Overview → Using the APIs with your tools](/api-solutions/threat-intelligence-api/overview/#using-the-apis-with-your-tools). - -This page covers the concepts you need to use the API effectively — authentication, platforms, pagination, rate limiting, and migration from v2. Use it alongside the interactive reference. - -> **Spec stability:** the Beta spec may change without a version bump while the API is in beta. Pin a commit of the YAML in production integrations, or wait for the GA release when we'll publish versioned URLs. +_The Beta surface extends the Threat Intelligence API ahead of GA. It runs at a separate base URL, ships its own OpenAPI spec, and is available to **selected partners working directly with Patchstack**. The shared endpoints (`/latest`, `/product/{type}/{name}/{version}`, `/product/{type}/{name}/{version}/exists`, `/batch`) behave the same as the stable API but accept extra parameters and return a nested response shape. This page documents only what's new — for the full spec including npm-flavour examples, see the [auto-generated reference](/api-reference/threat-intelligence-beta/). [Contact us](https://patchstack.com/for-hosts/) if you'd like access._ ## Base URL ``` -https://vdp-api.patchstack.com/database/api/beta/ -``` - -## Authentication - -Every request must include your API key in the **`PSKey`** HTTP request header. You can request an API key by reaching out on . - -``` -PSKey: +https://patchstack.com/database/api/beta/ ``` -## Platforms +## What's new -Pass `?platform=npm` (or `?platform=wordpress` — the default) on list endpoints. Platform names are case-insensitive. +| Addition | Where it applies | +|---|---| +| [`GET /all`](/api-reference/threat-intelligence-beta/operations/listallvulnerabilities/) | New endpoint — cursor-paginated full listing of every advisory, scoped by `?platform=`. | +| `?platform=npm` | List endpoints (`/all`, `/latest`, `/product/...`). Default is `wordpress`; case-insensitive. | +| `?cursor=` | `/all` and `/latest` — cursor pagination alongside the existing `?page=&per_page=`. | +| `?include=details` | List endpoints — adds an `advisory_details` markdown field to each item (npm). | +| Nested response shape | All list endpoints — `product`, `cvss`, `cwe`, `version_info` objects in place of the v2 flat shape. | -## Response format +The full Beta schema (every endpoint, parameter, response example) lives in the [auto-generated reference](/api-reference/threat-intelligence-beta/). -All responses are JSON. Beta responses are cached until the database updates, at which point the cache is cleared. A single response shape is shared across all three list endpoints (`/all`, `/latest`, `/product/npm/...`) so clients can parse them interchangeably. +> **Spec stability:** the Beta spec may change without a version bump while the API is in beta. Pin a commit of the YAML in production integrations, or wait for the GA release when versioned URLs ship. ## Pagination -`/all` and `/latest` support **two independent pagination strategies**. Use whichever fits your client: +`/all` and `/latest` support **two independent strategies**. Use whichever fits your client: -- **Offset (`?page=&per_page=`)** — returns a `pagination` block with totals, `has_next_page`, `has_previous_page`, etc. Easy to jump to a specific page; slower at depth and susceptible to row-shift when new vulnerabilities land while you're paging. +- **Offset (`?page=&per_page=`)** — returns a `pagination` block with totals, `has_next_page`, `has_previous_page`, etc. Easy to jump to a specific page; slower at depth and susceptible to row-shift when new advisories land while you're paging. - **Cursor (`?cursor=`)** — returns a `cursor` block with `next_cursor`, `has_more`, `per_page`. Stable under concurrent inserts and faster at any depth. No `total` count (deliberately skipped to keep cursor mode fast). `cursor` and `page` are mutually exclusive; passing both returns `422 Unprocessable Entity`. To bootstrap cursor mode, send `?cursor=` with an empty value. -## Including full advisory bodies +When a cursor is malformed (invalid base64 or missing the `v1:` prefix), the endpoint returns `200` with an empty page: -Pass `?include=details` on any list endpoint to add an `advisory_details` markdown field to each item. Applies to npm results. +```json +{ + "vulnerabilities": [], + "cursor": { "next_cursor": null, "has_more": false, "per_page": 100 } +} +``` ## Scoped npm packages npm package slugs that include a `/` (e.g. `@scope/pkg`) conflict with the route separator. URL-encode the `/` as `%2F` or contact us for guidance on the encoding helper. -## Rate limiting - -Same policy as the Extended Threat Intelligence API — please contact if you need an elevated quota. - ## Errors +In addition to the [stable error codes](/api-solutions/threat-intelligence-api/extended/#errors), Beta returns: + | Status | Meaning | |---|---| -| `401 Unauthorized` | Missing or invalid `PSKey` header. | -| `403 Forbidden` | API key not authorised for the requested endpoint. | | `422 Unprocessable Entity` | Invalid parameter combination (e.g. `cursor` + `page`), invalid `platform`, or `per_page > 500`. | -| `429 Too Many Requests` | Rate limit exceeded. | -| `500` | Server error — please include the request id in any bug report. | -When a cursor is malformed (invalid base64 or missing the `v1:` prefix), the endpoint returns `200` with an empty page: +## Migration notes (stable v2 → beta) -```json -{ - "vulnerabilities": [], - "cursor": { "next_cursor": null, "has_more": false, "per_page": 100 } -} -``` +- Beta npm responses use **nested objects** (`product`, `cvss`, `cwe`, `capec`, `version_info`) whereas the v2 shape is flat. Update parsers accordingly. +- `ghsa_id` was renamed to `ghsa` at the top level. +- `direct_url` was renamed to `url` (the npm-flavoured shape exposes a single URL only). +- The `description` field was dropped for npm (the title already includes it). +- The response body always contains a `vulnerabilities` array, plus either `pagination` (offset mode) or `cursor` (cursor mode). --- @@ -161,16 +150,6 @@ do { } while ($response['cursor']['has_more'] ?? false); ``` ---- - -## Migration notes (v2 → beta) - -- Beta npm responses use **nested objects** (`product`, `cvss`, `cwe`, `capec`, `version_info`) whereas the v2 shape is flat. Update parsers accordingly. -- `ghsa_id` was renamed to `ghsa` at the top level. -- `direct_url` was renamed to `url` (the npm-flavoured shape exposes a single URL only). -- The `description` field was dropped for npm (the title already includes it). -- The response body always contains a `vulnerabilities` array, plus either `pagination` (offset mode) or `cursor` (cursor mode). - ## More information You can find more information about the Patchstack Threat Intelligence API on . If you have integration questions, email . diff --git a/src/content/docs/API solutions/Threat Intelligence API/extended.md b/src/content/docs/API solutions/Threat Intelligence API/extended.md index a7d3988..705efcd 100644 --- a/src/content/docs/API solutions/Threat Intelligence API/extended.md +++ b/src/content/docs/API solutions/Threat Intelligence API/extended.md @@ -1,6 +1,6 @@ --- -title: "Extended tier API" -excerpt: "WordPress vulnerability intelligence with bulk lookups, latest-24h feed, and advisory-by-id details." +title: "Threat Intelligence API" +excerpt: "WordPress vulnerability intelligence — single-product and bulk lookups, latest-24h feed, and advisory-by-id detail." hidden: false metadata: image: [] @@ -12,25 +12,25 @@ sidebar: label: "Guide" --- -_The Extended Threat Intelligence API is a superset of the [Standard tier](/api-solutions/threat-intelligence-api/standard/). Extended has **custom pricing and is activated on request** — [contact us](https://patchstack.com/for-hosts/)._ +_The Threat Intelligence API has **custom pricing and is activated on request** — [contact us](https://patchstack.com/for-hosts/)._ -> **Interactive reference:** Every endpoint, parameter, request body and response shape is documented in the [Threat Intelligence API (Extended) reference](/api-reference/threat-intelligence-extended/). +> **Interactive reference:** Every endpoint, parameter, request body and response shape is documented in the [Threat Intelligence API reference](/api-reference/threat-intelligence-extended/). > -> **Tooling (Postman, SDK, LLM):** spec URLs and import instructions for all three tiers live on [Overview → Using the APIs with your tools](/api-solutions/threat-intelligence-api/overview/#using-the-apis-with-your-tools). +> **Tooling (Postman, SDK, LLM):** spec URLs and import instructions live on [Overview → Using the API with your tools](/api-solutions/threat-intelligence-api/overview/#using-the-api-with-your-tools). This page covers the concepts you need to use the API effectively — authentication, rate limiting, errors, and code samples. Use it alongside the interactive reference. -## What Extended adds over Standard +## Endpoints at a glance -| | Standard | Extended | -|---|---|---| -| Per-item payload | Flat, minimal | Flat, includes `description`, `vuln_type`, `cvss_score`, `cve`, `is_exploited`, `patch_priority`, `affected_in`, `patched_in_ranges` | -| `GET /product/{type}/{name}/{version}` | ✓ | ✓ | -| `GET /product/{type}/{name}/{version}/exists` | ✓ | ✓ | -| `GET /latest` — 20 most recent | — | ✓ | -| `POST /batch` — up to 50 products per request | — | ✓ | -| `GET /vulnerability/{id}` — advisory detail (CVSS vector, OWASP, references, credit) | — | ✓ | -| Rate limit | 5,000 / 24h | Custom, set per contract | +| Endpoint | Purpose | +|---|---| +| `GET /product/{type}/{name}/{version}` | Advisory list for a single product + version. | +| `GET /product/{type}/{name}/{version}/exists` | Boolean-only exists check (faster). | +| `GET /latest` | The 20 most recent vulnerabilities. | +| `POST /batch` | Bulk lookup — up to 50 products per request. | +| `GET /vulnerability/{id}` | Advisory detail (CVSS vector, OWASP, references, credit). | + +Each per-item payload includes `description`, `vuln_type`, `cvss_score`, `cve`, `is_exploited`, `patch_priority`, `affected_in`, and `patched_in_ranges`. See [API properties](/api-solutions/threat-intelligence-api/api-properties/) for full field definitions. ## Base URL @@ -40,7 +40,7 @@ https://patchstack.com/database/api/v2/ ## Authentication -Every request must include your API key in the **`PSKey`** HTTP request header. Extended access is activated on request — [contact us](https://patchstack.com/for-hosts/) to request a key. +Every request must include your API key in the **`PSKey`** HTTP request header. Access is activated on request — [contact us](https://patchstack.com/for-hosts/) to request a key. ``` PSKey: @@ -48,9 +48,7 @@ PSKey: ## Response format -All responses are JSON. Responses are cached until the Patchstack database updates, at which point the cache is cleared. - -Extended returns a **flat** per-item shape with more fields than Standard — see the [API properties](/api-solutions/threat-intelligence-api/api-properties/) glossary for field definitions. `GET /vulnerability/{id}` returns a richer, differently-shaped payload documented in the [reference](/api-reference/threat-intelligence-extended/). +All responses are JSON. Responses are cached until the Patchstack database updates, at which point the cache is cleared. `GET /vulnerability/{id}` returns a richer, differently-shaped payload documented in the [reference](/api-reference/threat-intelligence-extended/). ## Batch lookups diff --git a/src/content/docs/API solutions/Threat Intelligence API/overview.md b/src/content/docs/API solutions/Threat Intelligence API/overview.md index 71936c3..380819a 100644 --- a/src/content/docs/API solutions/Threat Intelligence API/overview.md +++ b/src/content/docs/API solutions/Threat Intelligence API/overview.md @@ -12,43 +12,33 @@ sidebar: hidden: false --- -Patchstack publishes three tiers of the Threat Intelligence API. Each tier has a narrative **Guide** and an interactive **Reference** generated from its OpenAPI spec. All three specs use the same tooling for import, SDK generation, and LLM-assisted client writing — covered once in [Using the APIs with your tools](#using-the-apis-with-your-tools) below. +The Patchstack Threat Intelligence API exposes our vulnerability database for WordPress plugins, themes and core. It supports single-product lookups, bulk lookups (`POST /batch`, up to 50 products per request), the `/latest` rolling feed, advisory-by-id detail, and a per-item payload that includes `cvss_score`, `cve`, `is_exploited`, `patch_priority`, and `patched_in_ranges`. -## Standard Threat Intelligence API +Custom pricing, activated on request — [contact us](https://patchstack.com/for-hosts/). -WordPress plugin, theme and core lookups for a single product + version. Flat per-item shape, 5,000 requests / 24 hours. Purchase access from the [Patchstack App](https://app.patchstack.com/billing/subscription). +- [Guide](/api-solutions/threat-intelligence-api/extended/) · [Reference](/api-reference/threat-intelligence-extended/) · [OpenAPI](/schemas/threat-intel-extended.yaml) · [Postman](/schemas/threat-intel-extended.postman_collection.json) · [API properties](/api-solutions/threat-intelligence-api/api-properties/) -- [Guide](/api-solutions/threat-intelligence-api/standard/) · [Reference](/api-reference/threat-intelligence-standard/) · [OpenAPI](/schemas/threat-intel-standard.yaml) · [Postman](/schemas/threat-intel-standard.postman_collection.json) +## NPM features (Beta) -## Extended Threat Intelligence API +For partners covering JavaScript components, a Beta surface adds **npm-ecosystem coverage** alongside WordPress, available to **selected partners working directly with Patchstack**. Beyond npm itself it ships the supporting additions that make npm coverage workable at scale: the new `GET /all` endpoint, cursor pagination, `?include=details` for full advisory bodies, and a nested response shape the stable API will eventually adopt. Everything else (`/latest`, `/product/{type}/{name}/{version}`, `/batch`) is the same surface as the stable API. -Everything in Standard, plus bulk lookups (`POST /batch`, up to 50 products per request), the `/latest` rolling feed, advisory-by-id detail, and a richer per-item payload (`cvss_score`, `cve`, `is_exploited`, `patch_priority`, `patched_in_ranges`…). Custom pricing, activated on request — [contact us](https://patchstack.com/for-hosts/). - -- [Guide](/api-solutions/threat-intelligence-api/extended/) · [Reference](/api-reference/threat-intelligence-extended/) · [OpenAPI](/schemas/threat-intel-extended.yaml) · [Postman](/schemas/threat-intel-extended.postman_collection.json) - -## Npm Dataset API (Beta) - -A new generation of the API, currently available to **selected partners working directly with Patchstack**. Adds npm ecosystem coverage, an opt-in full advisory body (`?include=details`), a consistent nested response shape (`product`, `cvss`, `cwe`, `version_info`…), and cursor-based pagination alongside offset. If you're already working with us on an integration and would like access, [contact us](https://patchstack.com/for-hosts/). - -- [Guide](/api-solutions/threat-intelligence-api/beta/) · [Reference](/api-reference/threat-intelligence-beta/) · [OpenAPI](/schemas/threat-intel-beta.yaml) · [Postman](/schemas/threat-intel-beta.postman_collection.json) +See the [NPM features (Beta)](/api-solutions/threat-intelligence-api/beta/) page for the full delta — base URL, parameters, pagination, errors, and migration notes — and the [auto-generated reference](/api-reference/threat-intelligence-beta/) for the full schema. [Contact us](https://patchstack.com/for-hosts/) for access. --- -**New integration?** If you have Beta access, use Beta — it's the direction we're heading, and Standard/Extended will eventually adopt the same nested shape. Otherwise start with Standard or Extended depending on your data needs. - -**Existing integration?** Standard and Extended remain supported; no migration is required. See [API properties](/api-solutions/threat-intelligence-api/api-properties/) for v2 field definitions. +The legacy [Standard tier](/api-solutions/threat-intelligence-api/standard/) is no longer offered to new customers but remains documented for existing integrations — its endpoints are a strict subset of the current API. --- -## Using the APIs with your tools +## Using the API with your tools -All three tiers ship the same three artefacts — pick whichever URL matches the tier you're integrating: +The API ships with an OpenAPI spec and a generated Postman collection. Beta has its own spec — pick whichever you're integrating against: -| Tier | OpenAPI spec | Postman collection | +| | OpenAPI spec | Postman collection | |---|---|---| -| Standard | [`threat-intel-standard.yaml`](/schemas/threat-intel-standard.yaml) | [`threat-intel-standard.postman_collection.json`](/schemas/threat-intel-standard.postman_collection.json) | -| Extended | [`threat-intel-extended.yaml`](/schemas/threat-intel-extended.yaml) | [`threat-intel-extended.postman_collection.json`](/schemas/threat-intel-extended.postman_collection.json) | -| Beta | [`threat-intel-beta.yaml`](/schemas/threat-intel-beta.yaml) | [`threat-intel-beta.postman_collection.json`](/schemas/threat-intel-beta.postman_collection.json) | +| Threat Intelligence API | [`threat-intel-extended.yaml`](/schemas/threat-intel-extended.yaml) | [`threat-intel-extended.postman_collection.json`](/schemas/threat-intel-extended.postman_collection.json) | +| NPM features (Beta) | [`threat-intel-beta.yaml`](/schemas/threat-intel-beta.yaml) | [`threat-intel-beta.postman_collection.json`](/schemas/threat-intel-beta.postman_collection.json) | +| Standard *(legacy)* | [`threat-intel-standard.yaml`](/schemas/threat-intel-standard.yaml) | [`threat-intel-standard.postman_collection.json`](/schemas/threat-intel-standard.postman_collection.json) | ### Postman, Insomnia, Bruno or Hoppscotch @@ -68,15 +58,15 @@ Every endpoint, parameter, request body and example is preconfigured. Download t Point your assistant at the spec. LLMs parse OpenAPI cleanly and will generate clients that match the real field names instead of hallucinating. - **Ad hoc:** paste the spec URL into your prompt. Example: *"Write a Python client for `https://docs.patchstack.com/schemas/threat-intel-extended.yaml`. I need a batch walker over a `package.json`-style list."* -- **In your repo:** download the spec to `docs/vendor/patchstack-threat-intel-.yaml` and reference it from your `CLAUDE.md` / `AGENTS.md`. Your assistant can then grep the YAML for specific fields without refetching. +- **In your repo:** download the spec to `docs/vendor/patchstack-threat-intel.yaml` and reference it from your `CLAUDE.md` / `AGENTS.md`. Your assistant can then grep the YAML for specific fields without refetching. - **Plain-text fallback:** for tools that don't parse YAML, our [`llms-full.txt`](/llms-full.txt) contains the full reference as flat markdown. ### SDK generation -Generate a client in any language from the same spec — swap the spec URL for the tier you want: +Generate a client in any language from the spec: ```bash -# TypeScript (Extended tier shown) +# TypeScript npx @openapitools/openapi-generator-cli generate \ -i https://docs.patchstack.com/schemas/threat-intel-extended.yaml \ -g typescript-fetch -o ./patchstack-client @@ -89,4 +79,4 @@ npx @openapitools/openapi-generator-cli generate \ Speakeasy and Fern also consume the same spec and produce more idiomatic SDKs if you need a polished client library. -> **Spec stability:** the Beta spec may change without a version bump while the API is in beta. Pin a commit of the YAML in production integrations, or wait for the GA release when we'll publish versioned URLs. Standard and Extended specs track the stable v2 surface. +> **Spec stability:** the Beta spec may change without a version bump while the API is in beta. Pin a commit of the YAML in production integrations, or wait for the GA release when we'll publish versioned URLs. The stable spec tracks the v2 surface. diff --git a/src/content/docs/API solutions/Threat Intelligence API/standard.md b/src/content/docs/API solutions/Threat Intelligence API/standard.md index 5109537..5d855bd 100644 --- a/src/content/docs/API solutions/Threat Intelligence API/standard.md +++ b/src/content/docs/API solutions/Threat Intelligence API/standard.md @@ -11,7 +11,7 @@ sidebar: label: "Guide" --- -_The Standard Threat Intelligence API is the entry-level tier of the v2 API. It returns every advisory that applies to a single WordPress plugin, theme or core version. If you need bulk lookups, the latest-24h feed, or advisory-by-id details, see the [Extended tier](/api-solutions/threat-intelligence-api/extended/)._ +_The Standard Threat Intelligence API is **no longer offered to new customers**. New integrations should use the [Threat Intelligence API](/api-solutions/threat-intelligence-api/extended/), which is a strict superset — every endpoint and field documented here is available there. This page is preserved for existing Standard integrations._ > **Interactive reference:** Every endpoint, parameter and response shape is documented in the [Threat Intelligence API (Standard) reference](/api-reference/threat-intelligence-standard/). > @@ -27,7 +27,7 @@ https://patchstack.com/database/api/v2/ ## Authentication -Every request must include your API key in the **`PSKey`** HTTP request header. You can request an API key from your [Patchstack App billing page](https://app.patchstack.com/billing/subscription). +Every request must include your API key in the **`PSKey`** HTTP request header. Standard keys remain valid for existing customers. New keys are not issued — [contact us](https://patchstack.com/for-hosts/) about Extended. ``` PSKey: @@ -41,7 +41,7 @@ The Standard tier returns a **flat** per-item shape. For the richer shape with ` ## Rate limiting -Standard is limited to **5,000 requests per 24 hours**. Contact if you need a higher quota or the Extended tier. +Standard is limited to **5,000 requests per 24 hours**. Contact to move to Extended for a higher quota and additional endpoints. ## Errors diff --git a/src/content/docs/API solutions/index.mdx b/src/content/docs/API solutions/index.mdx index 64b7598..f5b0faf 100644 --- a/src/content/docs/API solutions/index.mdx +++ b/src/content/docs/API solutions/index.mdx @@ -25,28 +25,11 @@ This API has unlimited requests and can be used by all Developer plan users for -## Threat Intelligence API -Query our vulnerability database and retrieve information about all published vulnerabilities. Threat Intelligence API is available in two tiers: - -### Standard tier -Fetch the latest vulnerability information for a single version of a particular plugin, theme or WordPress core. API is limited for 5000 calls / 24 hours. - - - - Read more here - - - -### Extended tier -Access everything included in the Standard tier, bulk-request data for multiple plugins with one API call, and have additional endpoints with more information about vulnerabilities. Extended tier has custom pricing and is activated on request only. +## Threat Intelligence API +Query our vulnerability database and retrieve information about all published vulnerabilities. The Extended tier covers single-product lookups, bulk-request endpoints for multiple components in one call, the `/latest` rolling feed, and advisory-by-id detail. Custom pricing, activated on request. Date: Wed, 13 May 2026 16:45:55 +0100 Subject: [PATCH 20/89] Fix Threat Intelligence Beta base URL to vdp-api host (#39) Update the Beta API base URL from patchstack.com to vdp-api.patchstack.com across the docs page, OpenAPI spec, and Postman collection so the interactive reference and copy-paste examples hit the correct host. Co-authored-by: Claude Opus 4.7 --- .../threat-intel-beta.postman_collection.json | 2 +- public/schemas/threat-intel-beta.yaml | 2 +- .../API solutions/Threat Intelligence API/beta.md | 14 +++++++------- 3 files changed, 9 insertions(+), 9 deletions(-) diff --git a/public/schemas/threat-intel-beta.postman_collection.json b/public/schemas/threat-intel-beta.postman_collection.json index 273db67..bc4e655 100644 --- a/public/schemas/threat-intel-beta.postman_collection.json +++ b/public/schemas/threat-intel-beta.postman_collection.json @@ -1750,7 +1750,7 @@ "variable": [ { "type": "string", - "value": "https://patchstack.com/database/api/beta", + "value": "https://vdp-api.patchstack.com/database/api/beta", "key": "baseUrl" } ], diff --git a/public/schemas/threat-intel-beta.yaml b/public/schemas/threat-intel-beta.yaml index ce3e637..25012f5 100644 --- a/public/schemas/threat-intel-beta.yaml +++ b/public/schemas/threat-intel-beta.yaml @@ -75,7 +75,7 @@ info: email: dave.jong@patchstack.com servers: - - url: https://patchstack.com/database/api/beta + - url: https://vdp-api.patchstack.com/database/api/beta description: Beta security: diff --git a/src/content/docs/API solutions/Threat Intelligence API/beta.md b/src/content/docs/API solutions/Threat Intelligence API/beta.md index 86a0fb2..0a22682 100644 --- a/src/content/docs/API solutions/Threat Intelligence API/beta.md +++ b/src/content/docs/API solutions/Threat Intelligence API/beta.md @@ -17,7 +17,7 @@ _The Beta surface extends the Threat Intelligence API ahead of GA. It runs at a ## Base URL ``` -https://patchstack.com/database/api/beta/ +https://vdp-api.patchstack.com/database/api/beta/ ``` ## What's new @@ -80,19 +80,19 @@ In addition to the [stable error codes](/api-solutions/threat-intelligence-api/e ```bash # Latest 24h, npm -curl 'https://patchstack.com/database/api/beta/latest?platform=npm&per_page=10' \ +curl 'https://vdp-api.patchstack.com/database/api/beta/latest?platform=npm&per_page=10' \ -H 'PSKey: ' # Cursor pagination walk (bootstrap + follow) -curl 'https://patchstack.com/database/api/beta/all?platform=npm&per_page=50&cursor=' \ +curl 'https://vdp-api.patchstack.com/database/api/beta/all?platform=npm&per_page=50&cursor=' \ -H 'PSKey: ' # Check a specific npm package/version with full advisory text -curl 'https://patchstack.com/database/api/beta/product/npm/axios/0.21.4?include=details' \ +curl 'https://vdp-api.patchstack.com/database/api/beta/product/npm/axios/0.21.4?include=details' \ -H 'PSKey: ' # Boolean-only exists check -curl 'https://patchstack.com/database/api/beta/product/npm/axios/0.21.4/exists' \ +curl 'https://vdp-api.patchstack.com/database/api/beta/product/npm/axios/0.21.4/exists' \ -H 'PSKey: ' ``` @@ -100,7 +100,7 @@ curl 'https://patchstack.com/database/api/beta/product/npm/axios/0.21.4/exists' ```javascript async function* allVulnerabilities(apiKey, platform = 'npm', perPage = 100) { - const base = 'https://patchstack.com/database/api/beta/all'; + const base = 'https://vdp-api.patchstack.com/database/api/beta/all'; let cursor = ''; // empty = bootstrap cursor mode while (true) { @@ -131,7 +131,7 @@ $apiKey = getenv('PATCHSTACK_KEY'); $cursor = ''; do { - $url = 'https://patchstack.com/database/api/beta/all' + $url = 'https://vdp-api.patchstack.com/database/api/beta/all' .'?platform=npm&per_page=100&cursor='.urlencode($cursor); $ch = curl_init($url); From e0e37f5d822d1334473039fbaeaf50c37d55b235 Mon Sep 17 00:00:00 2001 From: Elliot Date: Tue, 19 May 2026 12:22:32 +0100 Subject: [PATCH 21/89] Clarify that siteid and oauth.id are independent fields (#41) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The partner integration guide previously showed `lastid` and `oauth.id` holding the same value in the /site/add response example, implying the two are equivalent. They are not — `siteid` identifies the site and is used in per-site API paths and the portal, while `oauth.id` is only meaningful as part of the plugin license key (which the response already returns pre-formatted as `apikey`). The two values coincided as a side-effect of how rows were inserted in our database, but a Pulse feature shipped on 13 May 2026 breaks that coincidence. Partners who stored `oauth.id` under the assumption it equalled the site identifier should reconcile via the existing /sites/list/basic endpoint. This commit: - Updates the /site/add response example to use distinct values and show the per-URL `sites` map alongside the legacy top-level fields. - Adds explicit field-purpose guidance under "Store in local datastore". - Adds a note callout about the implicit invariant and how to recover. - Adds two FAQ entries covering the field distinction and reconciliation. - Fixes the WP-CLI activation example so the apikey embeds oauth.id, not siteid. Co-authored-by: Claude Opus 4.7 --- .../App API/patchstack-integration.md | 49 ++++++++++++++++--- 1 file changed, 43 insertions(+), 6 deletions(-) diff --git a/src/content/docs/API solutions/App API/patchstack-integration.md b/src/content/docs/API solutions/App API/patchstack-integration.md index bb19027..628cc91 100644 --- a/src/content/docs/API solutions/App API/patchstack-integration.md +++ b/src/content/docs/API solutions/App API/patchstack-integration.md @@ -119,18 +119,38 @@ The response will look something like below. { "success": "Successfully added the site(s).", "count": 1, + "sites": { + "https://mywebsite.com": { + "siteid": 12345, + "oauth": { + "id": 12333, + "secret": "DOOs9DIyv2FMcURFtkB0eXOHMRhH7I2EsaNUb4aR", + "apikey": "DOOs9DIyv2FMcURFtkB0eXOHMRhH7I2EsaNUb4aR-12333" + } + } + }, "lastid": 12345, "oauth": { - "id": 12345, - "secret": "DOOs9DIyv2FMcURFtkB0eXOHMRhH7I2EsaNUb4aR" + "id": 12333, + "secret": "DOOs9DIyv2FMcURFtkB0eXOHMRhH7I2EsaNUb4aR", + "apikey": "DOOs9DIyv2FMcURFtkB0eXOHMRhH7I2EsaNUb4aR-12333" } } ``` +The top-level `lastid` and `oauth` fields refer to the **last** site in the batch and are kept for backwards compatibility. New integrations should read from the per-URL `sites` map. + ###### 3. Store in local datastore -It is now important to store the lastid and oauth properties into a datastore on your infrastructure. This allows you to know the site identifier of the website of the customer without having to query the Patchstack App API each time. This can then be used for most of our other API endpoints to fetch information for the site. +Store the `siteid` and `apikey` for each URL in a datastore on your infrastructure. This avoids having to query the Patchstack App API each time you need to identify a customer's site. + +- **`siteid`** is the canonical Patchstack site identifier. It is what the portal displays and what every per-site API endpoint expects in the URL (`/site/view/{siteid}`, `/site/{siteid}/delete`, `/download/wordpress/{siteid}`, etc.). Store this if you ever need to cross-reference your records against the Patchstack portal. +- **`apikey`** is the pre-formatted plugin license key (`-`). Pass it directly to the WordPress plugin during activation — you do not need to assemble it yourself. + +:::note[`siteid` and `oauth.id` are independent fields] +`siteid` identifies the site, `oauth.id` identifies the OAuth credential embedded in the plugin license key. They have always been independent fields with different purposes. Do not assume they are equal — for sites provisioned before 13 May 2026 the two values often coincided as a side-effect of how rows were inserted, but they may differ for any site provisioned since. -The API key that is used in the plugin, contains the format `oauth.secret-oauth.id`, for example in above response it would be `DOOs9DIyv2FMcURFtkB0eXOHMRhH7I2EsaNUb4aR-12345`. +If you previously stored `oauth.id` under the assumption it equalled the site identifier, call [`POST /monitor/sites/list/basic`](https://api.patchstack.com/app-api/documentation) to fetch `[{id, url}, …]` for every site on your account, match by URL, and update your stored values to the current `siteid`. +::: ### Step 3: Plugin deployment Now that you have the site identifier and plugin API key stored in your local datastore, you can start the flow of installing and activating the Patchstack plugin on the website. @@ -153,9 +173,9 @@ First we execute the command below to install and activate the Patchstack plugin `wp plugin install patchstack --activate` -Then we execute the command below to activate the connection to Patchstack. It is important to inject the plugin API key here we retrieved from step 2: +Then we execute the command below to activate the connection to Patchstack. It is important to inject the plugin API key (`apikey` from step 2) here: -`wp patchstack activate DOOs9DIyv2FMcURFtkB0eXOHMRhH7I2EsaNUb4aR-12345` +`wp patchstack activate DOOs9DIyv2FMcURFtkB0eXOHMRhH7I2EsaNUb4aR-12333` This command will return `The Patchstack plugin has been successfully connected.` if it succeeded. @@ -285,4 +305,21 @@ Which outputs the following: { "activated": true } +``` + +### What's the difference between `siteid` and `oauth.id`? Can I assume they're equal? +They are two independent fields with different purposes — do not assume they are equal. + +- **`siteid`** is the canonical Patchstack site identifier. It is what the portal displays and what every per-site API endpoint expects (e.g. `/site/view/{siteid}`, `/site/{siteid}/delete`, `/download/wordpress/{siteid}`). Store this for cross-referencing your records against the Patchstack portal. +- **`oauth.id`** is the OAuth credential identifier. Its only purpose is to form the plugin license key, which the `/site/add` response already returns pre-formatted as `apikey` (`-`). You never need to read `oauth.id` as a standalone value — just pass `apikey` to the plugin. + +For sites provisioned before 13 May 2026, `siteid` and `oauth.id` coincidentally held the same value because of how rows were inserted in our database. They may differ for any site provisioned since. If you previously stored `oauth.id` under the assumption it equalled the site identifier, see the [callout in step 2 of integration](#3-store-in-local-datastore) for how to reconcile your stored values. + +### How can I reconcile site IDs in my datastore against the Patchstack portal? +Call [`POST /monitor/sites/list/basic`](https://api.patchstack.com/app-api/documentation) with the same `UserToken` you use for `/site/add`. It returns `[{id, url}, …]` for every site on your account, where `id` is the current `siteid`. Match by URL and update your stored values. + +```bash +curl -X 'POST' \ + 'https://api.patchstack.com/monitor/sites/list/basic' \ + -H 'UserToken: ' \ ``` \ No newline at end of file From 758def972a59029276ec6b4582454d51b3991278 Mon Sep 17 00:00:00 2001 From: Renato Hysa Date: Wed, 10 Jun 2026 09:43:56 +0200 Subject: [PATCH 22/89] Remove duplicated IP address list from docs article (#43) * Remove duplicated IP address list from docs article The article rendered the full IP list (fetched from patchstack.com/ips-v4) as a bulleted list in addition to linking to the source. The rendered list could go stale and mismatch the live API. Keep only the link so the IP list lives in a single source of truth. * Reword IP whitelisting article and reposition IP list link * Link both IPv4 and IPv6 IP-list endpoints, drop unused Ips component --------- Co-authored-by: Claude --- src/components/Ips.astro | 13 ------------- .../list-of-ip-addresses-that-patchstack-uses.mdx | 8 +++++--- 2 files changed, 5 insertions(+), 16 deletions(-) delete mode 100644 src/components/Ips.astro diff --git a/src/components/Ips.astro b/src/components/Ips.astro deleted file mode 100644 index b69d63d..0000000 --- a/src/components/Ips.astro +++ /dev/null @@ -1,13 +0,0 @@ ---- -const response = await fetch("https://patchstack.com/ips-v4/"); -const ips = await response.text(); -const ipList = ips.split("\n").map(ip => ip.trim()).filter(ip => ip.length > 0); ---- -
          -{ipList.map(ip => ( -
        • {ip}
        • -))} -
        -

        -You can find the list of IP addresses that Patchstack uses at patchstack.com/ips-v4. -

        \ No newline at end of file diff --git a/src/content/docs/FAQ Troubleshooting/Technical/list-of-ip-addresses-that-patchstack-uses.mdx b/src/content/docs/FAQ Troubleshooting/Technical/list-of-ip-addresses-that-patchstack-uses.mdx index 7dfbd0c..4f10823 100644 --- a/src/content/docs/FAQ Troubleshooting/Technical/list-of-ip-addresses-that-patchstack-uses.mdx +++ b/src/content/docs/FAQ Troubleshooting/Technical/list-of-ip-addresses-that-patchstack-uses.mdx @@ -10,9 +10,11 @@ updatedAt: "Tue May 16 2023 14:17:00 GMT+0000 (Coordinated Universal Time)" sidebar: order: 7.3 --- -import Ips from '../../../../components/Ips.astro'; +Sometimes you need to whitelist our IP addresses in order to avoid your hosting provider or (secondary) firewall blocking our services. -Sometimes you need to whitelist these IP addresses in order to avoid your hosting provider or (secondary) firewall blocking our services. +You can use these two API endpoints to get the list of IP addresses that Patchstack uses: + +- [patchstack.com/ips-v4/](https://patchstack.com/ips-v4/) +- [patchstack.com/ips-v6/](https://patchstack.com/ips-v6/) Note that we may add and remove IP addresses at any time without notice. - From 226db1a4988a39fc52653c41d7c7b3b5dcbd7b58 Mon Sep 17 00:00:00 2001 From: Renato Hysa Date: Thu, 18 Jun 2026 09:27:09 +0200 Subject: [PATCH 23/89] Document GoDaddy staging domains in plugin API key FAQ (#45) --- ...-i-use-the-same-plugin-api-key-for-staging-environment.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/src/content/docs/FAQ Troubleshooting/Technical/can-i-use-the-same-plugin-api-key-for-staging-environment.md b/src/content/docs/FAQ Troubleshooting/Technical/can-i-use-the-same-plugin-api-key-for-staging-environment.md index a9d7737..0888ce7 100644 --- a/src/content/docs/FAQ Troubleshooting/Technical/can-i-use-the-same-plugin-api-key-for-staging-environment.md +++ b/src/content/docs/FAQ Troubleshooting/Technical/can-i-use-the-same-plugin-api-key-for-staging-environment.md @@ -34,7 +34,10 @@ Patchstack allows you to use the same plugin API key for the staging environment 'wpengine.com', 'wp-dv', 'optiserver.co.uk', -'azurewebsites.net' +'azurewebsites.net', +'.myftpupload.com', +'.mwp.accessdomain.com', +'store.godaddy.com' ``` ### How the staging and production site work with Patchstack? From 83932256f0a9753b7a85dab47b06e673295e7de9 Mon Sep 17 00:00:00 2001 From: Renato Hysa Date: Fri, 19 Jun 2026 10:29:04 +0200 Subject: [PATCH 24/89] Remove Joomla support from documentation (#46) - Replace the Joomla install guide with a deprecation notice and 301 redirect from the old install URL - Strip Joomla mentions from the homepage card, connector intro, add-a-site guide, and free-version FAQ - Delete the two Joomla install screenshots --- netlify.toml | 7 +++- ...hstack-connector-joomla-installation-1.png | Bin 30885 -> 0 bytes ...hstack-connector-joomla-installation-2.png | Bin 53300 -> 0 bytes .../does-patchstack-have-a-free-version.md | 5 +-- .../Patchstack App/Sites/adding-a-site.mdx | 2 +- .../how-to-install-on-joomla.mdx | 33 ------------------ .../Patchstack Connector/introduction.md | 5 ++- .../joomla-support-deprecated.mdx | 9 +++++ src/content/docs/index.mdx | 2 +- 9 files changed, 20 insertions(+), 43 deletions(-) delete mode 100644 src/assets/images/patchstack-connector-joomla-installation-1.png delete mode 100644 src/assets/images/patchstack-connector-joomla-installation-2.png delete mode 100644 src/content/docs/Patchstack Plugin/Patchstack Connector/how-to-install-on-joomla.mdx create mode 100644 src/content/docs/Patchstack Plugin/Patchstack Connector/joomla-support-deprecated.mdx diff --git a/netlify.toml b/netlify.toml index 16778d6..31a8faf 100644 --- a/netlify.toml +++ b/netlify.toml @@ -1031,4 +1031,9 @@ [[redirects]] from = "/patchstack-app/account-settings/team/" - to = "/patchstack-app/account-settings/seats/" \ No newline at end of file + to = "/patchstack-app/account-settings/seats/" + +[[redirects]] + from = "/patchstack-plugin/patchstack-connector/how-to-install-on-joomla/" + to = "/patchstack-plugin/patchstack-connector/joomla-support-deprecated/" + status = 301 \ No newline at end of file diff --git a/src/assets/images/patchstack-connector-joomla-installation-1.png b/src/assets/images/patchstack-connector-joomla-installation-1.png deleted file mode 100644 index 64a22df43f2a7d5e89dcb9256932f033377792e7..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 30885 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 rJ1?J8CCtCJZFW~Po_ diff --git a/src/content/docs/FAQ Troubleshooting/Pricing Plans/does-patchstack-have-a-free-version.md b/src/content/docs/FAQ Troubleshooting/Pricing Plans/does-patchstack-have-a-free-version.md index c041065..d0a5ade 100644 --- a/src/content/docs/FAQ Troubleshooting/Pricing Plans/does-patchstack-have-a-free-version.md +++ b/src/content/docs/FAQ Troubleshooting/Pricing Plans/does-patchstack-have-a-free-version.md @@ -25,7 +25,7 @@ Patchstack has a free version available. Free version of Patchstack detects vuln **What does Patchstack Personal (Free) version include?** **Detect security issues before hackers take over your website:** -
        • Detect the latest security vulnerabilities in your WordPress, Drupal or Joomla sites.
        • +
          • Detect the latest security vulnerabilities in your WordPress or Drupal sites.
          • Receive real-time alerts to email if any security vulnerabilities are found.
          • Have a central security dashboard for up to 3 websites (via the Patchstack App).
          @@ -35,9 +35,6 @@ The free version of Patchstack only detects and notifies you about the vulnerabi ### For WordPress To use a free version of Patchstack with WordPress, install the
          Patchstack plugin on your site first, and start the user registration flow from the plugin itself, after activating it on your WordPress. -### For Joomla -To use a free version of Patchstack with Joomla, you'll need to sign up for the Developer plan trial first. After that, you can downgrade your subscription from Developer plan to Personal plan (Free). Add your site to Patchstack App, and go through this tutorial to install the Patchstack connector to your Joomla site. - ### For Drupal To use a free version of Patchstack with Drupal, you'll need to sign up for the Developer plan trial first. After that, you can downgrade your subscription from Developer plan to Personal plan (Free). Add your site to Patchstack App, and go through this tutorial to install the Patchstack connector to your Drupal site. diff --git a/src/content/docs/Patchstack App/Sites/adding-a-site.mdx b/src/content/docs/Patchstack App/Sites/adding-a-site.mdx index 64193c9..5b4a202 100644 --- a/src/content/docs/Patchstack App/Sites/adding-a-site.mdx +++ b/src/content/docs/Patchstack App/Sites/adding-a-site.mdx @@ -18,7 +18,7 @@ Adding a site to Patchstack is relatively easy. Here is a simple guide on how to 2. Click on **+ Add new** button. ![](@images/patchstack-sites-add-new.png) 3. Type your domain name into the popup and choose your CMS: ![](@images/patchstack-add-first-site-dialogue.png) 4. Click on **Continue to plugin/connector sync**. -5. In case you chose WordPress, continue with the steps below. If you chose other CMS, check Joomla instructions or Drupal instructions +5. In case you chose WordPress, continue with the steps below. If you chose other CMS, check Drupal instructions 6. You will be taken to the next step, where you can follow the next instructions. ![](@images/patchstack-checking-sync-status.png) 7. Click **Download latest plugin** 8. Upload the plugin .zip file to your WordPress site by visiting /wp-admin > Plugins > Add New > Upload Plugin diff --git a/src/content/docs/Patchstack Plugin/Patchstack Connector/how-to-install-on-joomla.mdx b/src/content/docs/Patchstack Plugin/Patchstack Connector/how-to-install-on-joomla.mdx deleted file mode 100644 index 2bf885e..0000000 --- a/src/content/docs/Patchstack Plugin/Patchstack Connector/how-to-install-on-joomla.mdx +++ /dev/null @@ -1,33 +0,0 @@ ---- -title: "Joomla Installation" - -excerpt: "" -hidden: false -metadata: - robots: "index" -createdAt: "Wed Dec 21 2022 17:45:01 GMT+0000 (Coordinated Universal Time)" -updatedAt: "Wed May 10 2023 12:25:03 GMT+0000 (Coordinated Universal Time)" -sidebar: - order: 26 ---- -import { Steps } from '@astrojs/starlight/components'; - -## Requirements -- Joomla core version 4+ -- PHP 5.6+ - -## Installation -Follow these steps to install the Patchstack connector on your Joomla site. - - -1. Download the Joomla connector here. -2. Navigate to the administration area (**/administrator/**) on your site. -3. Navigate to System > Extensions ![](@images/patchstack-connector-joomla-installation-1.png) -4. On the extension installation page, drag and drop the downloaded .zip file of the connector into the page. -5. After installation, you will be redirected to the Patchstack connector configuration page. -6. On this page, enter the API key found on the page of your site in the Patchstack App. ![](@images/patchstack-connector-joomla-installation-2.png) -7. Click on the Save button. -8. After it has been saved, note that the API token is still present in the field. Visit your site in the Patchstack App to view its information and note that it connected to Patchstack. - - -If you need further help, don't hesitate to reach out to us via live chat at the bottom right corner! \ No newline at end of file diff --git a/src/content/docs/Patchstack Plugin/Patchstack Connector/introduction.md b/src/content/docs/Patchstack Plugin/Patchstack Connector/introduction.md index ac76803..4440865 100644 --- a/src/content/docs/Patchstack Plugin/Patchstack Connector/introduction.md +++ b/src/content/docs/Patchstack Plugin/Patchstack Connector/introduction.md @@ -11,9 +11,8 @@ updatedAt: "Wed May 10 2023 12:01:29 GMT+0000 (Coordinated Universal Time)" sidebar: order: 25 --- -The Patchstack connector is used to connect your Drupal or Joomla site to the Patchstack App. +The Patchstack connector is used to connect your Drupal site to the Patchstack App. For WordPress, the Patchstack plugin should be installed instead. - [WordPress Installation](/patchstack-plugin/plugin-introduction/) -- [Drupal Installation](/patchstack-plugin/patchstack-connector/how-to-install-on-drupal/) -- [Joomla Installation](/patchstack-plugin/patchstack-connector/how-to-install-on-joomla/) \ No newline at end of file +- [Drupal Installation](/patchstack-plugin/patchstack-connector/how-to-install-on-drupal/) \ No newline at end of file diff --git a/src/content/docs/Patchstack Plugin/Patchstack Connector/joomla-support-deprecated.mdx b/src/content/docs/Patchstack Plugin/Patchstack Connector/joomla-support-deprecated.mdx new file mode 100644 index 0000000..b314e4c --- /dev/null +++ b/src/content/docs/Patchstack Plugin/Patchstack Connector/joomla-support-deprecated.mdx @@ -0,0 +1,9 @@ +--- +title: "Joomla support deprecated" +sidebar: + hidden: true +--- + +Joomla support has been deprecated as of **June 18, 2026**. Patchstack now supports WordPress and Drupal. + +If you were previously using the Patchstack connector for Joomla, no further action is needed. If you have any questions, reach out to us via live chat at the bottom right corner. diff --git a/src/content/docs/index.mdx b/src/content/docs/index.mdx index 67e676c..3023c7f 100644 --- a/src/content/docs/index.mdx +++ b/src/content/docs/index.mdx @@ -21,7 +21,7 @@ import CardPS from '../../components/CardPS.astro'; - + From 98d176e8dc68e4182233e5ff652ca40c57c0487b Mon Sep 17 00:00:00 2001 From: Mario Tarosso Date: Wed, 24 Jun 2026 08:53:28 +0100 Subject: [PATCH 25/89] Rename CMS-specific labeling to "platform" in add-site docs (#47) Part of ENG-3134. The "All CMS" filter is being renamed to "All Platforms" across the SaaS app as scope expands beyond CMS platforms (npm, vibe-coded tools). Update docs.patchstack.com accordingly: the add-site step described "choose your CMS", but the app dialog already labels this selection "Platform". Reword the docs to match the live UI and the broader platform concept. Co-authored-by: Claude Opus 4.8 (1M context) --- src/content/docs/Patchstack App/Sites/adding-a-site.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/content/docs/Patchstack App/Sites/adding-a-site.mdx b/src/content/docs/Patchstack App/Sites/adding-a-site.mdx index 5b4a202..29c271d 100644 --- a/src/content/docs/Patchstack App/Sites/adding-a-site.mdx +++ b/src/content/docs/Patchstack App/Sites/adding-a-site.mdx @@ -16,9 +16,9 @@ Adding a site to Patchstack is relatively easy. Here is a simple guide on how to 1. Navigate to the **Sites** view in Patchstack App 2. Click on **+ Add new** button. ![](@images/patchstack-sites-add-new.png) -3. Type your domain name into the popup and choose your CMS: ![](@images/patchstack-add-first-site-dialogue.png) +3. Type your domain name into the popup and choose your platform: ![](@images/patchstack-add-first-site-dialogue.png) 4. Click on **Continue to plugin/connector sync**. -5. In case you chose WordPress, continue with the steps below. If you chose other CMS, check Drupal instructions +5. In case you chose WordPress, continue with the steps below. If you chose a different platform, check Drupal instructions 6. You will be taken to the next step, where you can follow the next instructions. ![](@images/patchstack-checking-sync-status.png) 7. Click **Download latest plugin** 8. Upload the plugin .zip file to your WordPress site by visiting /wp-admin > Plugins > Add New > Upload Plugin From c400c93b39107dfe5a8ef58ee1386eb361bd044b Mon Sep 17 00:00:00 2001 From: Renato Hysa Date: Thu, 2 Jul 2026 10:08:25 +0200 Subject: [PATCH 26/89] Document Community IP blocklist criteria and expiry (#48) Expand the Community IP Blocklist module docs with when an IP is added (25+ network-wide firewall hits in the trailing month), the whitelisting safeguards that prevent false positives, and the ~30-day expiry behaviour. Add a "Read more" link from the site protection overview to the detailed page. --- .../Protection/patchstack-modules.md | 17 +++++++++++++++++ .../Protection/app-protection-overview.md | 3 ++- 2 files changed, 19 insertions(+), 1 deletion(-) diff --git a/src/content/docs/Patchstack App/Protection/patchstack-modules.md b/src/content/docs/Patchstack App/Protection/patchstack-modules.md index ee276cd..d0a00d8 100644 --- a/src/content/docs/Patchstack App/Protection/patchstack-modules.md +++ b/src/content/docs/Patchstack App/Protection/patchstack-modules.md @@ -48,3 +48,20 @@ These protection rules could cause false positives with remote WordPress managem ### Community IP Blocklist Community IP blocklist blocks access to IP addresses which are known to exploit vulnerabilities. This module contributes threat data back to the Patchstack network. + +**When an IP is added** + +The blocklist is built from firewall activity across the entire Patchstack network, not from any single site. An IP address is added when it triggers Patchstack's firewall rules **25 or more times within the past month** across all protected sites. Because the list is shared, once an IP passes that threshold it is blocked on every site that has the Community IP blocklist module enabled. + +**Safeguards against false positives** + +To avoid blocking legitimate traffic, several categories of IP address are automatically excluded from the blocklist, including: + +- Private and reserved IP ranges +- Patchstack's own infrastructure and scanning IPs +- Major search engine crawlers (such as Google and Bing) +- Well-known content delivery networks and monitoring services + +**How long an IP stays on the list** + +Entries are not permanent. The blocklist is rebuilt regularly from recent activity, so an IP that stops triggering firewall rules automatically drops off once it no longer meets the threshold within the trailing one-month window — roughly **30 days** after its last malicious activity. diff --git a/src/content/docs/Patchstack App/Site Dashboard/Protection/app-protection-overview.md b/src/content/docs/Patchstack App/Site Dashboard/Protection/app-protection-overview.md index b8e3c7d..3ec0cfd 100644 --- a/src/content/docs/Patchstack App/Site Dashboard/Protection/app-protection-overview.md +++ b/src/content/docs/Patchstack App/Site Dashboard/Protection/app-protection-overview.md @@ -38,7 +38,8 @@ The **Advanced hardening** module applies additional security mechanics to the W ### Community IP blocklist -Community IP blocklist blocks access to IP addresses which are known to exploit vulnerabilities. This module contributes threat data back to the Patchstack network. +Community IP blocklist blocks access to IP addresses which are known to exploit vulnerabilities. This module contributes threat data back to the Patchstack network. +📖 Read more ## Activity section From f573485755234bf5cd85b3707df5628b35a6d80a Mon Sep 17 00:00:00 2001 From: Danilo Radovic Date: Tue, 7 Jul 2026 11:12:10 +0200 Subject: [PATCH 27/89] Document WooCommerce form support for CAPTCHA (ENG-2962) (#49) CAPTCHA now works for WooCommerce forms in addition to WordPress built-in forms. Update the CAPTCHA hardening page and the related FAQ so they no longer state support is limited to built-in forms. Co-authored-by: Claude Opus 4.8 (1M context) --- .../does-patchstack-work-with-other-captcha-plugins.md | 2 +- .../docs/Patchstack App/Site Dashboard/Hardening/captcha.md | 6 ++++-- 2 files changed, 5 insertions(+), 3 deletions(-) diff --git a/src/content/docs/FAQ Troubleshooting/Technical/does-patchstack-work-with-other-captcha-plugins.md b/src/content/docs/FAQ Troubleshooting/Technical/does-patchstack-work-with-other-captcha-plugins.md index 3586c08..23f483d 100644 --- a/src/content/docs/FAQ Troubleshooting/Technical/does-patchstack-work-with-other-captcha-plugins.md +++ b/src/content/docs/FAQ Troubleshooting/Technical/does-patchstack-work-with-other-captcha-plugins.md @@ -15,6 +15,6 @@ Patchstack plugin can add either Google ReCAPTCHA or Cloudflare Turnstile to you Patchstack, by default, has the captcha features turned off. You can pick to which pages you would like to add the capcha -- login, register, forgot password, and comments. -Note that Patchstack's captcha only works with WordPress's built-in forms and not for other plugins forms (like e-commerce registration forms). +Note that Patchstack's captcha works with WordPress's built-in forms and WooCommerce forms, but not with other plugins' forms. If you turn this feature on and have a different plugin installed that has the same kind of functionality, you may get locked out of your WordPress site. In this scenario, you'd have to delete either plugin to regain access to your site. diff --git a/src/content/docs/Patchstack App/Site Dashboard/Hardening/captcha.md b/src/content/docs/Patchstack App/Site Dashboard/Hardening/captcha.md index b5e796d..ef16717 100644 --- a/src/content/docs/Patchstack App/Site Dashboard/Hardening/captcha.md +++ b/src/content/docs/Patchstack App/Site Dashboard/Hardening/captcha.md @@ -24,13 +24,15 @@ Patchstack offers two captcha solutions: ![](@images/patchstack-captcha-setup.png) -Note that our captcha can only be used on the WordPress built-in forms - these are: +Our captcha can be used on the WordPress built-in forms as well as WooCommerce forms. The WordPress built-in forms are: * Commenting forms * Login form * Registration form * Password reset form -**NB!** Patchstack does not offer captcha integrations for other third-party plugins or themes (eg. WooCommerce, Contact Form 7). +In addition, captcha is supported on WooCommerce forms. + +**NB!** Patchstack does not offer captcha integrations for other third-party plugins or themes (eg. Contact Form 7). To activate captcha on your site, you will have to generate a public key and secret key first. The tutorials for creating captcha keys and integrating them with Patchstack can be found below. From fc04d684760514ccd76f2f70dfbf2d10509848b5 Mon Sep 17 00:00:00 2001 From: "claude[bot]" <209825114+claude[bot]@users.noreply.github.com> Date: Wed, 8 Jul 2026 10:27:33 +0100 Subject: [PATCH 28/89] docs: promote Threat Intelligence npm features out of beta (#50) Removes the "(Beta)" status designation from the Threat Intelligence API NPM features docs so the feature reads as a live, supported capability: - astro.config.mjs: sidebar label "NPM features (Beta)" -> "NPM features" and removed the "Beta" tip badge on the NPM features group. - beta.md: title -> "NPM features"; reworded beta/pre-GA status prose to neutral language and removed the "spec may change without a version bump while in beta" caveat. - overview.md: heading, link text and table label -> "NPM features"; reworded status prose; removed the beta spec-stability caveat. - threat-intel-beta.yaml: reworded info.description and related-page link, server display description "Beta" -> "NPM features", and info.version "beta" -> "1.0". Deliberately unchanged: the /beta/ page URL and slug, the api-reference/threat-intelligence-beta route, schema/collection filenames, and the live API endpoint path /database/api/beta/. Co-authored-by: Claude --- astro.config.mjs | 3 +-- public/schemas/threat-intel-beta.yaml | 8 ++++---- .../API solutions/Threat Intelligence API/beta.md | 14 ++++++-------- .../Threat Intelligence API/overview.md | 12 +++++------- 4 files changed, 16 insertions(+), 21 deletions(-) diff --git a/astro.config.mjs b/astro.config.mjs index 6b1350a..e346418 100644 --- a/astro.config.mjs +++ b/astro.config.mjs @@ -106,7 +106,7 @@ export default defineConfig({ { base: 'api-reference/threat-intelligence-beta', schema: './public/schemas/threat-intel-beta.yaml', - sidebar: { label: 'NPM features (Beta)', group: threatIntelBetaSidebarGroup, collapsed: true }, + sidebar: { label: 'NPM features', group: threatIntelBetaSidebarGroup, collapsed: true }, }, ]), ], @@ -169,7 +169,6 @@ export default defineConfig({ threatIntelExtendedSidebarGroup, { label: 'NPM features', - badge: { text: 'Beta', variant: 'tip' }, collapsed: true, items: [ { slug: 'api-solutions/threat-intelligence-api/beta' }, diff --git a/public/schemas/threat-intel-beta.yaml b/public/schemas/threat-intel-beta.yaml index 25012f5..88ae03d 100644 --- a/public/schemas/threat-intel-beta.yaml +++ b/public/schemas/threat-intel-beta.yaml @@ -1,10 +1,10 @@ openapi: 3.1.0 info: title: Patchstack Threat Intelligence API — NPM features - version: beta + version: '1.0' summary: npm + WordPress vulnerability intelligence with nested response shape and cursor pagination. description: | - The Beta endpoints live alongside the v2 API and add npm coverage, an optional + The npm endpoints live alongside the v2 API and add npm coverage, an optional full advisory body, a consistent nested response shape, and cursor pagination. They are the recommended endpoints for new integrations; v2 remains available for backwards compatibility. @@ -64,7 +64,7 @@ info: ## Related pages - - Narrative guide with code samples: [NPM features (Beta)](/api-solutions/threat-intelligence-api/beta/) + - Narrative guide with code samples: [NPM features](/api-solutions/threat-intelligence-api/beta/) - OpenAPI spec (import into Postman / Insomnia / Bruno / Hoppscotch): - Postman collection (pre-imported): @@ -76,7 +76,7 @@ info: servers: - url: https://vdp-api.patchstack.com/database/api/beta - description: Beta + description: NPM features security: - PSKey: [] diff --git a/src/content/docs/API solutions/Threat Intelligence API/beta.md b/src/content/docs/API solutions/Threat Intelligence API/beta.md index 0a22682..98bfda1 100644 --- a/src/content/docs/API solutions/Threat Intelligence API/beta.md +++ b/src/content/docs/API solutions/Threat Intelligence API/beta.md @@ -1,5 +1,5 @@ --- -title: "NPM features (Beta)" +title: "NPM features" excerpt: "npm-ecosystem coverage and the supporting additions on top of the Threat Intelligence API — the /all endpoint, cursor pagination, ?include=details, and the nested response shape." hidden: false metadata: @@ -12,7 +12,7 @@ sidebar: label: "Overview" --- -_The Beta surface extends the Threat Intelligence API ahead of GA. It runs at a separate base URL, ships its own OpenAPI spec, and is available to **selected partners working directly with Patchstack**. The shared endpoints (`/latest`, `/product/{type}/{name}/{version}`, `/product/{type}/{name}/{version}/exists`, `/batch`) behave the same as the stable API but accept extra parameters and return a nested response shape. This page documents only what's new — for the full spec including npm-flavour examples, see the [auto-generated reference](/api-reference/threat-intelligence-beta/). [Contact us](https://patchstack.com/for-hosts/) if you'd like access._ +_The npm features extend the Threat Intelligence API with npm-ecosystem coverage. They run at a separate base URL, ship their own OpenAPI spec, and are available to **selected partners working directly with Patchstack**. The shared endpoints (`/latest`, `/product/{type}/{name}/{version}`, `/product/{type}/{name}/{version}/exists`, `/batch`) behave the same as the stable API but accept extra parameters and return a nested response shape. This page documents only what's new — for the full spec including npm-flavour examples, see the [auto-generated reference](/api-reference/threat-intelligence-beta/). [Contact us](https://patchstack.com/for-hosts/) if you'd like access._ ## Base URL @@ -30,9 +30,7 @@ https://vdp-api.patchstack.com/database/api/beta/ | `?include=details` | List endpoints — adds an `advisory_details` markdown field to each item (npm). | | Nested response shape | All list endpoints — `product`, `cvss`, `cwe`, `version_info` objects in place of the v2 flat shape. | -The full Beta schema (every endpoint, parameter, response example) lives in the [auto-generated reference](/api-reference/threat-intelligence-beta/). - -> **Spec stability:** the Beta spec may change without a version bump while the API is in beta. Pin a commit of the YAML in production integrations, or wait for the GA release when versioned URLs ship. +The full npm-features schema (every endpoint, parameter, response example) lives in the [auto-generated reference](/api-reference/threat-intelligence-beta/). ## Pagination @@ -58,15 +56,15 @@ npm package slugs that include a `/` (e.g. `@scope/pkg`) conflict with the route ## Errors -In addition to the [stable error codes](/api-solutions/threat-intelligence-api/extended/#errors), Beta returns: +In addition to the [stable error codes](/api-solutions/threat-intelligence-api/extended/#errors), the npm endpoints return: | Status | Meaning | |---|---| | `422 Unprocessable Entity` | Invalid parameter combination (e.g. `cursor` + `page`), invalid `platform`, or `per_page > 500`. | -## Migration notes (stable v2 → beta) +## Migration notes (stable v2 → npm endpoints) -- Beta npm responses use **nested objects** (`product`, `cvss`, `cwe`, `capec`, `version_info`) whereas the v2 shape is flat. Update parsers accordingly. +- npm responses use **nested objects** (`product`, `cvss`, `cwe`, `capec`, `version_info`) whereas the v2 shape is flat. Update parsers accordingly. - `ghsa_id` was renamed to `ghsa` at the top level. - `direct_url` was renamed to `url` (the npm-flavoured shape exposes a single URL only). - The `description` field was dropped for npm (the title already includes it). diff --git a/src/content/docs/API solutions/Threat Intelligence API/overview.md b/src/content/docs/API solutions/Threat Intelligence API/overview.md index 380819a..3e6fcdd 100644 --- a/src/content/docs/API solutions/Threat Intelligence API/overview.md +++ b/src/content/docs/API solutions/Threat Intelligence API/overview.md @@ -18,11 +18,11 @@ Custom pricing, activated on request — [contact us](https://patchstack.com/for - [Guide](/api-solutions/threat-intelligence-api/extended/) · [Reference](/api-reference/threat-intelligence-extended/) · [OpenAPI](/schemas/threat-intel-extended.yaml) · [Postman](/schemas/threat-intel-extended.postman_collection.json) · [API properties](/api-solutions/threat-intelligence-api/api-properties/) -## NPM features (Beta) +## NPM features -For partners covering JavaScript components, a Beta surface adds **npm-ecosystem coverage** alongside WordPress, available to **selected partners working directly with Patchstack**. Beyond npm itself it ships the supporting additions that make npm coverage workable at scale: the new `GET /all` endpoint, cursor pagination, `?include=details` for full advisory bodies, and a nested response shape the stable API will eventually adopt. Everything else (`/latest`, `/product/{type}/{name}/{version}`, `/batch`) is the same surface as the stable API. +For partners covering JavaScript components, the npm features add **npm-ecosystem coverage** alongside WordPress, available to **selected partners working directly with Patchstack**. Beyond npm itself they ship the supporting additions that make npm coverage workable at scale: the new `GET /all` endpoint, cursor pagination, `?include=details` for full advisory bodies, and a nested response shape the stable API will eventually adopt. Everything else (`/latest`, `/product/{type}/{name}/{version}`, `/batch`) is the same surface as the stable API. -See the [NPM features (Beta)](/api-solutions/threat-intelligence-api/beta/) page for the full delta — base URL, parameters, pagination, errors, and migration notes — and the [auto-generated reference](/api-reference/threat-intelligence-beta/) for the full schema. [Contact us](https://patchstack.com/for-hosts/) for access. +See the [NPM features](/api-solutions/threat-intelligence-api/beta/) page for the full delta — base URL, parameters, pagination, errors, and migration notes — and the [auto-generated reference](/api-reference/threat-intelligence-beta/) for the full schema. [Contact us](https://patchstack.com/for-hosts/) for access. --- @@ -32,12 +32,12 @@ The legacy [Standard tier](/api-solutions/threat-intelligence-api/standard/) is ## Using the API with your tools -The API ships with an OpenAPI spec and a generated Postman collection. Beta has its own spec — pick whichever you're integrating against: +The API ships with an OpenAPI spec and a generated Postman collection. The npm features have their own spec — pick whichever you're integrating against: | | OpenAPI spec | Postman collection | |---|---|---| | Threat Intelligence API | [`threat-intel-extended.yaml`](/schemas/threat-intel-extended.yaml) | [`threat-intel-extended.postman_collection.json`](/schemas/threat-intel-extended.postman_collection.json) | -| NPM features (Beta) | [`threat-intel-beta.yaml`](/schemas/threat-intel-beta.yaml) | [`threat-intel-beta.postman_collection.json`](/schemas/threat-intel-beta.postman_collection.json) | +| NPM features | [`threat-intel-beta.yaml`](/schemas/threat-intel-beta.yaml) | [`threat-intel-beta.postman_collection.json`](/schemas/threat-intel-beta.postman_collection.json) | | Standard *(legacy)* | [`threat-intel-standard.yaml`](/schemas/threat-intel-standard.yaml) | [`threat-intel-standard.postman_collection.json`](/schemas/threat-intel-standard.postman_collection.json) | ### Postman, Insomnia, Bruno or Hoppscotch @@ -78,5 +78,3 @@ npx @openapitools/openapi-generator-cli generate \ ``` Speakeasy and Fern also consume the same spec and produce more idiomatic SDKs if you need a polished client library. - -> **Spec stability:** the Beta spec may change without a version bump while the API is in beta. Pin a commit of the YAML in production integrations, or wait for the GA release when we'll publish versioned URLs. The stable spec tracks the v2 surface. From b04ff56a5f421386d320d51655fedefe2f3c0d38 Mon Sep 17 00:00:00 2001 From: "claude[bot]" <209825114+claude[bot]@users.noreply.github.com> Date: Wed, 8 Jul 2026 10:27:52 +0100 Subject: [PATCH 29/89] docs(App API): bulk provisioning, delete endpoint, limits & site lifecycle (#51) * docs(app-api): document bulk provisioning, delete endpoint, limits & site lifecycle - Add a Bulk provisioning subsection showing the urls array form (up to 100 sites per /site/add) and reconciling results by URL. - Add a Rate limits & quotas note (max 100 URLs per /site/add and /site/exists; /sites/list pagination vs /sites/list/basic full list) with a reviewer TODO for the unverified request-rate limit. - Document the delete endpoint with the correct verified path and method (DELETE|POST /site/delete/{siteid}) plus a curl example and batch delete. - Fix incorrect /site/{siteid}/delete references in prose. - Document the destructive site lifecycle: no paused state; re-adding a deleted site issues new credentials. - Note what the App API does not manage (trials/subscriptions/billing). - Add a legacy deprecation callout to the Hosting API page. Co-Authored-By: Claude Opus 4.8 (1M context) Claude-Session: https://claude.ai/code/session_01Wfaar2urX8t8vVEPHmguev * docs(app-api): finalize rate-limit note per reviewer answers Replace the reviewer-only HTML-comment TODO about request-rate limits with a published note: the App API does not currently enforce a per-key request-rate limit on authenticated calls, with guidance to batch considerately at scale (e.g. the urls array on /site/add). No number invented. Delete-path and legacy /hosting questions resolved in the PR description; no doc-body changes needed for those. Co-Authored-By: Claude Opus 4.8 (1M context) Claude-Session: https://claude.ai/code/session_01Wfaar2urX8t8vVEPHmguev * docs(app-api): note best-effort plugin removal on site delete, recommend WP-CLI --------- Co-authored-by: Claude --- .../App API/patchstack-app-api.md | 4 + .../App API/patchstack-integration.md | 81 ++++++++++++++++++- src/content/docs/partners/hosting-api.md | 4 + 3 files changed, 87 insertions(+), 2 deletions(-) diff --git a/src/content/docs/API solutions/App API/patchstack-app-api.md b/src/content/docs/API solutions/App API/patchstack-app-api.md index 834af31..6f68a43 100644 --- a/src/content/docs/API solutions/App API/patchstack-app-api.md +++ b/src/content/docs/API solutions/App API/patchstack-app-api.md @@ -11,6 +11,10 @@ _Patchstack App API is available for the Developer and Enterprise plan users_ Patchstack App API enables users to run all the Patchstack App account actions remotely over an API. It allows you to access protection logs, generate security reports, manage site settings, add new sites, create custom rules, and much more. +:::note[What the App API does not manage] +The App API manages **sites and their security** on your Patchstack account — provisioning, plugin connection, protection, reporting and site settings. It does **not** manage trials, subscriptions, plan changes or billing for your own end customers. If you are reselling Patchstack (for example through WHMCS), run trials, subscriptions and invoicing in your own billing system and use the App API purely to provision and manage the underlying sites. Your Patchstack account's own subscription is handled separately in the Patchstack app UI. +::: + ### Documentation and endpoints Find all the Patchstack App API endpoints with examples from the documentation here: https://api.patchstack.com/app-api/documentation diff --git a/src/content/docs/API solutions/App API/patchstack-integration.md b/src/content/docs/API solutions/App API/patchstack-integration.md index 628cc91..5312c57 100644 --- a/src/content/docs/API solutions/App API/patchstack-integration.md +++ b/src/content/docs/API solutions/App API/patchstack-integration.md @@ -44,6 +44,14 @@ To minimize API calls and reduce latency when displaying site information to you All Patchstack API endpoints return standard HTTP status codes. Your integration should handle these appropriately to ensure reliability and provide meaningful feedback to users. E.g. handle status codes 200, 401, 422, 500. +#### Rate limits & quotas +- **Sites per request** — `POST /site/add` and `POST /site/exists` accept between 1 and **100 URLs** per call in the `urls` array. Split larger batches across multiple requests. +- **Listing sites** — `POST /sites/list` is paginated (`page`, `per_page`, default 20 per page); page through it when rendering large accounts. `POST /sites/list/basic` is *not* paginated — it returns the full `[{id, url}, …]` array for the account in one response, which is what makes it convenient for reconciliation. + +:::note[No per-key request-rate limit] +The App API does not currently enforce a per-key request-rate limit on authenticated calls. Even so, when provisioning at large scale, batch your requests considerately rather than issuing one call per site — for example, pass multiple URLs in the `urls` array on `/site/add` (and `/site/exists`) instead of looping a separate request per site. +::: + ## Flow of integration & plugin Patchstack works by assigning an API key to a site that has been added to the Patchstack App. This API key is then used in the WordPress plugin to activate the connection to Patchstack. @@ -140,10 +148,48 @@ The response will look something like below. The top-level `lastid` and `oauth` fields refer to the **last** site in the batch and are kept for backwards compatibility. New integrations should read from the per-URL `sites` map. +###### Bulk provisioning +The `urls` parameter is an **array**, so you can provision up to **100 sites in a single `/site/add` call** rather than looping one request per site. Pass every URL in the array and the response returns one entry per URL under the `sites` map, keyed by the exact URL you sent: + +```bash +curl -X 'POST' \ + 'https://api.patchstack.com/monitor/site/add' \ + -H 'UserToken: ' \ + -H 'Content-Type: application/json' \ + -d '{ + "urls": [ + "https://site1.com", + "https://site2.com" + ], + "cms_id": 1 +}' +``` + +```json +{ + "success": "Successfully added the site(s).", + "count": 2, + "sites": { + "https://site1.com": { + "siteid": 12345, + "oauth": { "id": 12333, "secret": "…", "apikey": "…-12333" } + }, + "https://site2.com": { + "siteid": 12346, + "oauth": { "id": 12334, "secret": "…", "apikey": "…-12334" } + } + }, + "lastid": 12346, + "oauth": { "id": 12334, "secret": "…", "apikey": "…-12334" } +} +``` + +Reconcile the results **by URL**: iterate the `sites` map and match each key back to the record on your side, rather than relying on array order or the top-level `lastid`. The `/site/exists` endpoint accepts the same `urls` array (up to 100) so you can pre-check a whole batch in one call before adding it. If you need to re-fetch the `{siteid, url}` mapping for every site on the account later, call [`POST /monitor/sites/list/basic`](https://api.patchstack.com/app-api/documentation) and match by URL. + ###### 3. Store in local datastore Store the `siteid` and `apikey` for each URL in a datastore on your infrastructure. This avoids having to query the Patchstack App API each time you need to identify a customer's site. -- **`siteid`** is the canonical Patchstack site identifier. It is what the portal displays and what every per-site API endpoint expects in the URL (`/site/view/{siteid}`, `/site/{siteid}/delete`, `/download/wordpress/{siteid}`, etc.). Store this if you ever need to cross-reference your records against the Patchstack portal. +- **`siteid`** is the canonical Patchstack site identifier. It is what the portal displays and what every per-site API endpoint expects in the URL (`/site/view/{siteid}`, `/site/delete/{siteid}`, `/download/wordpress/{siteid}`, etc.). Store this if you ever need to cross-reference your records against the Patchstack portal. - **`apikey`** is the pre-formatted plugin license key (`-`). Pass it directly to the WordPress plugin during activation — you do not need to assemble it yourself. :::note[`siteid` and `oauth.id` are independent fields] @@ -243,6 +289,37 @@ Simply plug it in your own environment and give customers deeper insights into t [Click here for integration and more information](/api-solutions/app-api/patchstack-iframe/) +## Site lifecycle: removing & re-adding sites + +###### Removing a site +To remove a site from the account — for example when a customer cancels or you clean up a never-activated site — call the delete endpoint with the `siteid` you stored in step 2. The path is `/site/delete/{siteid}` and it accepts both `DELETE` and `POST`. + +```bash +curl -X 'DELETE' \ + 'https://api.patchstack.com/monitor/site/delete/12345' \ + -H 'UserToken: ' \ + -H 'Content-Type: application/json' +``` + +```json +{ + "success": "Successfully deleted the site." +} +``` + +To also uninstall the Patchstack plugin from the remote WordPress site as part of the deletion, send `{"delete": true}` in the request body. To remove several sites at once, call `DELETE /site/delete` with a body of `{"sites": [12345, 12346]}`. + +:::caution[Plugin removal on site deletion] +Deleting a site with the `delete` flag also attempts to remove the Patchstack plugin from the connected WordPress site. This remote removal is best-effort and may not complete if the site connection is unstable, or if the plugin has already been deactivated or disconnected (but not deleted). For reliable removal, manage the plugin directly on the site with WP-CLI (for example `wp plugin delete patchstack`) rather than relying on the remote deletion. +::: + +:::caution[Deleting a site is destructive and permanent] +There is **no paused or suspended state** in Patchstack. Deleting a site removes it and its data, and it stops counting toward your plan. If you later re-add the same URL with `/site/add`, Patchstack provisions a **brand-new site** with **new `siteid` and new OAuth credentials** (a new plugin `apikey`) — the previous credentials are not restored. Any integration that "suspends" and "resumes" a site must therefore delete on suspend and re-provision + re-activate the plugin on resume, then overwrite the stored `siteid`/`apikey` with the new values. +::: + +###### Cleaning up never-activated sites +A site that was provisioned but whose plugin never connected will report `{"activated": false}` from [`GET /site/plugin/installed/{siteid}`](https://api.patchstack.com/app-api/documentation#/Sites/d932033c445ab06e5fd2dcb6ea8eead3). Combine that check with the delete endpoint above to periodically prune sites that were added but never came online. See the [FAQ](#how-to-determine-if-a-site-has-been-activated-and-is-connected) for the difference between the `plugin/installed` and `state` checks. + ## Noteworthy API endpoints The list below are noteworthy API endpoints that might be interesting to our partners. @@ -310,7 +387,7 @@ Which outputs the following: ### What's the difference between `siteid` and `oauth.id`? Can I assume they're equal? They are two independent fields with different purposes — do not assume they are equal. -- **`siteid`** is the canonical Patchstack site identifier. It is what the portal displays and what every per-site API endpoint expects (e.g. `/site/view/{siteid}`, `/site/{siteid}/delete`, `/download/wordpress/{siteid}`). Store this for cross-referencing your records against the Patchstack portal. +- **`siteid`** is the canonical Patchstack site identifier. It is what the portal displays and what every per-site API endpoint expects (e.g. `/site/view/{siteid}`, `/site/delete/{siteid}`, `/download/wordpress/{siteid}`). Store this for cross-referencing your records against the Patchstack portal. - **`oauth.id`** is the OAuth credential identifier. Its only purpose is to form the plugin license key, which the `/site/add` response already returns pre-formatted as `apikey` (`-`). You never need to read `oauth.id` as a standalone value — just pass `apikey` to the plugin. For sites provisioned before 13 May 2026, `siteid` and `oauth.id` coincidentally held the same value because of how rows were inserted in our database. They may differ for any site provisioned since. If you previously stored `oauth.id` under the assumption it equalled the site identifier, see the [callout in step 2 of integration](#3-store-in-local-datastore) for how to reconcile your stored values. diff --git a/src/content/docs/partners/hosting-api.md b/src/content/docs/partners/hosting-api.md index 66d1dea..7fe00f5 100644 --- a/src/content/docs/partners/hosting-api.md +++ b/src/content/docs/partners/hosting-api.md @@ -11,6 +11,10 @@ updatedAt: "Mon Jul 31 2023 12:13:26 GMT+0000 (Coordinated Universal Time)" --- # Hosting API Documentation +:::caution[Legacy API — use the App API instead] +The Hosting API (`api.patchstack.com/hosting/`, `HostToken` authentication) is a legacy integration and is no longer the recommended way to integrate with Patchstack. New integrations should use the [Patchstack App API](/api-solutions/app-api/patchstack-app-api/) (`api.patchstack.com/monitor/`, `UserToken` authentication), which is actively maintained and documented. This page is kept for reference for existing Hosting API integrations only. +::: + ## Introduction The information below describes the API URL’s, payloads and authentication necessary to communicate with our API. A special authentication key will have to be supplied in each request (that will be created specifically for the hosting provider) against an endpoint. From e23e8705b5cf5aa6c9062dd3180d0ecd98045ad2 Mon Sep 17 00:00:00 2001 From: "claude[bot]" <209825114+claude[bot]@users.noreply.github.com> Date: Fri, 10 Jul 2026 11:35:11 +0100 Subject: [PATCH 30/89] docs(partners): add WHMCS local setup guide (#57) * docs(partners): add WHMCS local setup guide Port the WHMCS local setup walkthrough (Docker/PHP 8.3/MySQL) into the docs as a new page under partners/. Sanitized from a Notion export: removed a hardcoded WHMCS origin IP, fixed malformed links, converted Notion callouts to Starlight asides, added a caution about local-dev credentials, and cross-linked the App API docs. Co-Authored-By: Claude Opus 4.8 (1M context) Claude-Session: https://claude.ai/code/session_01Wfaar2urX8t8vVEPHmguev * docs(app-api): link WHMCS setup guide from the integration page * docs(whmcs): replace with correct WHMCS module setup guide Co-Authored-By: Claude Opus 4.8 (1M context) Claude-Session: https://claude.ai/code/session_01Wfaar2urX8t8vVEPHmguev --------- Co-authored-by: Claude --- .../App API/patchstack-integration.md | 4 + src/content/docs/partners/whmcs-setup.md | 341 ++++++++++++++++++ 2 files changed, 345 insertions(+) create mode 100644 src/content/docs/partners/whmcs-setup.md diff --git a/src/content/docs/API solutions/App API/patchstack-integration.md b/src/content/docs/API solutions/App API/patchstack-integration.md index 5312c57..ac261c2 100644 --- a/src/content/docs/API solutions/App API/patchstack-integration.md +++ b/src/content/docs/API solutions/App API/patchstack-integration.md @@ -81,6 +81,10 @@ It's also important to set the `Content-Type` HTTP header to `application/json` ### Step 2: Site provisioning When the site should be added to Patchstack depends on your use-case scenario. If they require protection immediately then you can execute this flow the moment the website environment (the WordPress site) has been created on the infrastructure. If you upsell Patchstack then this flow can be launched upon purchase or opt-in. +:::tip[Using WHMCS?] +If you provision Patchstack through WHMCS, the Patchstack WHMCS module handles this flow for you. See the [WHMCS setup guide](/partners/whmcs-setup/). +::: + ###### 1. Determine if the site already exists in Patchstack This step is essential as it's possible that a site may be protected already or added to Patchstack. For this, the `/site/exists` API endpoint can be utilized; it will check if a site with the given URL has already been added to Patchstack before you attempt to actually add the site to Patchstack. diff --git a/src/content/docs/partners/whmcs-setup.md b/src/content/docs/partners/whmcs-setup.md new file mode 100644 index 0000000..9240282 --- /dev/null +++ b/src/content/docs/partners/whmcs-setup.md @@ -0,0 +1,341 @@ +--- +title: "WHMCS Module Setup" +description: "Configure the Patchstack WHMCS provisioning module so you can sell WordPress security as an automated, billing-driven product from your existing WHMCS catalog." +--- + +:::note[tl;dr] +Patchstack for WHMCS is a fully automated provisioning module that lets you sell +WordPress security as a managed service directly from your existing WHMCS billing +platform. Add it to your product catalog and customers get Patchstack protection +activated automatically when they purchase it — no custom development, no manual +provisioning. Suspensions, reactivations, and cancellations all follow the billing +lifecycle automatically. + +- Turn WordPress security into a billable product you sell through your existing WHMCS catalog — no custom development, no manual provisioning. +- Every lifecycle event (create, suspend, unsuspend, terminate) is driven by WHMCS billing. Support overhead stays near zero because the module handles provisioning, plugin installation, credential management, and retry-on-failure automatically. +- Scales from 10 to 10,000 customers across any number of cPanel servers. Customers self-serve from their client area (status, SSO to the Patchstack dashboard, manual-install fallback for external hosting). +::: + +:::tip[Standing up a local environment first?] +If you want to test the module locally before configuring a production WHMCS, +follow your local WHMCS development setup guide to get a working install, then +return here to configure Patchstack. +::: + +- **Prerequisites:** WHMCS 8.0+, PHP 7.3+, `cURL` extension enabled, a Patchstack **Developer or Enterprise** plan (required for App API access), SSH access with WP-CLI installed on each cPanel server you want to auto-deploy to. + +## Technical integration + +The module is a standard WHMCS provisioning module (`modules/servers/patchstack`) +plus optional hooks. It plugs into the four WHMCS module commands — Create, +Suspend, Unsuspend, Terminate — so every billing event drives a corresponding +action against the [Patchstack App API](/api-solutions/app-api/patchstack-app-api/). +On Create it registers the customer's site, stores OAuth credentials, and (if +enabled) SSH-deploys the Patchstack plugin to the correct WordPress installation. +Suspend/Unsuspend toggle protection state. Terminate removes the site from +Patchstack when the service is cancelled. For how the underlying provisioning API +works, see the [Patchstack integration guide](/api-solutions/app-api/patchstack-integration/). + +Multi-server support is built around WHMCS's own server management. You configure +**one** Patchstack API server record (carrying only your App API token) and point +the Patchstack product at it via a Server Group. Your existing cPanel servers are +used as-is: when a customer buys Patchstack, the module looks up the customer's +active hosting service, identifies which cPanel server it lives on, and reads SSH +credentials from that server record. Two servers or two hundred — there's no +per-server product configuration. + +The client area covers five explicit states from "just ordered" to "protected", +including the two edge cases the module handles without support intervention: +multiple WordPress installs on one account (customer picks which one), and +external hosting with no SSH access (customer gets a one-click pre-configured +plugin download). Once a site has pinged Patchstack at least once, the client area +exposes a single-sign-on link into the Patchstack dashboard — no second password +to manage. + +:::caution[Admin URLs are placeholders] +Replace `https://your-whmcs.example.com/admin/` throughout with your own WHMCS +admin URL. Paths below are relative to `/admin/` on your WHMCS install. +::: + +## Configure Patchstack — hosting-provider walkthrough + +The manual steps a hosting provider takes inside WHMCS to wire up **Patchstack +Protection**, end to end. Every step is meant to be run against your real WHMCS +admin UI, with the values captured as you go. + +:::note +Assumes WHMCS is already installed and running, and requires a Patchstack +**Developer** or **Enterprise** subscription (App API access). +::: + +--- + +## Step 1 — Get your Patchstack App API Token + +1. Log in to the [Patchstack Dashboard](https://app.patchstack.com/). +2. Navigate to [**Settings → Integrations**](https://app.patchstack.com/settings/integrations). +3. Click **Generate Token** (or copy your existing App API token). +4. **Copy the token somewhere safe now** — you enter it as the server **Access Hash** + in Step 3. Once you navigate away, you may not be able to view the same token again. + +For details on the token (`UserToken`) and what it authorizes, see the +[Patchstack App API](/api-solutions/app-api/patchstack-app-api/) documentation. + +--- + +## Step 2 — Activate Payments (Bank Transfer) + +1. Open **Settings → Apps & Integrations** (`https://your-whmcs.example.com/admin/index.php?rp=/admin/apps`). +2. Click **Browse**. +3. Go to the **Payments** section. +4. Find and click **Bank Transfer**. +5. Click to activate it. +6. Save changes. + +--- + +## Step 3 — Configure the Patchstack API Server + +This server record stores only your Patchstack App API token — it does **not** +represent a cPanel server. + +1. Navigate to **Setup → Products/Services → Servers** (`https://your-whmcs.example.com/admin/configservers.php`). +2. Click **Add New Server**, then **Go to Advanced Mode**. +3. Configure: + +| Field | Value | +| --- | --- | +| Name | `Patchstack API` | +| Hostname | `api.patchstack.com` | +| Module | `Patchstack Protection` | +| Access Hash | your App API token (from Step 1) | + +4. Click **Test Connection** to verify, then **Save**. + +:::note +Leave the **IP Address** field blank. If the test fails, confirm the hostname is +`api.patchstack.com` and the token is valid. +::: + +--- + +## Step 4 — Create a Server Group + +1. Navigate to **Setup → Products/Services → Servers** (`https://your-whmcs.example.com/admin/configservers.php`). +2. Click **Create New Group**. +3. Name it `Patchstack Protection Group`. +4. Add your Patchstack API server into the group, then **Save**. + +--- + +## Step 5 — Configure cPanel Servers for SSH + +The module reads SSH credentials directly from each cPanel **server record** (not +from the product). For each cPanel server in your infrastructure: + +1. Navigate to **Setup → Products/Services → Servers** (`https://your-whmcs.example.com/admin/configservers.php`). +2. Open an existing cPanel server (or add one) and set: + +| Field | Value / notes | +| --- | --- | +| Module | `cPanel` | +| Hostname / IP Address | the server's IP (enter the IP, not a hostname) | +| Username | `root` | +| Password | SSH password — for password auth; leave blank if using a key | +| API Token | SSH **private key (PEM)** — for key auth; leave blank if using a password | + +:::note +WHMCS labels the last field "API Token" for cPanel servers; the module stores the +SSH private key there and auto-detects key auth when the value starts with `-----BEGIN`. +::: + +:::caution[Handle SSH credentials securely] +Enter root passwords and private keys straight into the WHMCS server record. Never +commit them to a repository, paste them into plaintext files, or share them outside +your secrets manager. +::: + +3. **Save**, and repeat for each cPanel server. + +--- + +## Step 6 — Create a Product Group + +1. Navigate to **Setup → Products/Services → Products/Services** (`https://your-whmcs.example.com/admin/configproducts.php`). +2. Click **Create a New Group** and configure: + +| Field | Value | +| --- | --- | +| Product Group Name | `Patchstack Protection Product Group` | +| Order Form Template | `Standard Cart` | +| Available Payment Gateways | `Bank Transfer` | + +3. **Save**. + +--- + +## Step 7 — Create the Patchstack Product + +1. Navigate to **Setup → Products/Services → Products/Services** (`https://your-whmcs.example.com/admin/configproducts.php`). +2. Click **Create a New Product**: + +| Field | Value | +| --- | --- | +| Product Type | `Other` | +| Product Group | `Patchstack Protection Product Group` | +| Product Name | `Patchstack Protection` | +| Module | `Patchstack Protection` | +| Create as Hidden | `Unchecked` | + +3. Click **Continue**, then configure the tabs: + - **Details** — Require Domain: **Checked** + - **Pricing** — Payment Type: `Free` *(for testing; set real pricing in production)* + - **Module Settings** — Server Group: `Patchstack Protection Group` · Auto Deploy Plugin: **Checked** · "Automatically setup the product as soon as the first payment is received": **Selected** +4. Click **Save Changes**. + +--- + +## Step 8 — Custom Fields (automatic) + +1. Open the **Custom Fields** tab. +2. Click **Save Changes** — the module creates the required custom fields on save; + they appear in the tab afterward. + +--- + +## Testing a full order end to end + +Place a test order end to end to confirm the module provisions correctly. This +assumes you've completed Steps 1–8 above and have access to a cPanel/WHM test +server. Throughout this section, replace `` with your test +server's IP and `` with a domain that resolves to it (for +example, an `nip.io` wildcard domain). + +### Test Step 1 — Create a cPanel Server Group and Hosting Product + +In production the hosting provider already has cPanel hosting products and server +groups in WHMCS. In a test environment you create them to simulate this. + +**Create the server group** + +1. Navigate to **Setup → Products/Services → Servers** (`https://your-whmcs.example.com/admin/configservers.php`). +2. Click **Create New Group**. +3. Name it `Hosting Servers`. +4. Add the cPanel test server into the group, then **Save**. + +**Create the product group and product** + +1. Navigate to **Setup → Products/Services → Products/Services** (`https://your-whmcs.example.com/admin/configproducts.php`). +2. Click **Create a New Group**, name it `Hosting`, and **Save**. +3. Click **Create a New Product** and configure: + +| Field | Value | +| --- | --- | +| Product Type | `Shared Hosting` | +| Product Group | `Hosting` | +| Product Name | `cPanel Hosting` | +| Module | `cPanel` | +| Create as Hidden | `Checked` | + +4. Click **Continue**, then **Save Changes**. +5. The product reloads — open the **Module Settings** tab and configure: + +| Field | Value | +| --- | --- | +| Server Group | `Hosting Servers` | +| Module Settings | Automatically setup the product when you manually accept a pending order | + +6. Click **Save Changes**. + +:::note +The **Server Group** field is only selectable after the product has been saved +once. If it's greyed out on first creation, save, then re-open Module Settings. +::: + +### Test Step 2 — Order cPanel Hosting (WHMCS auto-provisions) + +WHMCS creates the cPanel account automatically when the order is accepted, just as +in production. The cPanel username is stored on the service record automatically — +no manual entry needed. + +1. Navigate to **Clients** (`https://your-whmcs.example.com/admin/clients.php`) and click the test client. +2. Click **Add New Order**. +3. Select the **cPanel Hosting** product. +4. Set the domain to `wpsite.`. +5. Leave **Order Status** as `Pending`. +6. Click **Submit Order**. +7. Navigate to **Orders** (`https://your-whmcs.example.com/admin/orders.php`), check the order, and click **Accept Order**. + +WHMCS calls WHM to create the cPanel account and records the username on the hosting +service automatically. + +:::note +If the order fails with "reserved username", the subdomain maps to a username +reserved on that cPanel server. Cancel and retry with a different subdomain +(e.g. `wpsite2.`). Use the same domain for all subsequent steps. +::: + +:::caution +If creation fails with **"The domain … already exists in the userdata" (XID …)**, +a cPanel account using that domain is left over from an earlier attempt — WHMCS +provisioning creates a *new* account and won't reuse an existing one. Either +terminate the leftover account in WHM (**Account Information → List Accounts** → +find the domain → **Terminate an Account**) and re-run **Module Commands → Create**, +or change the service **Domain** to a fresh subdomain (e.g. `wpsite2.`) +and create again — then use that domain for all later steps. +::: + +Next, install WordPress on the provisioned cPanel account (via WHM/cPanel), then +return here for the next step. + +### Test Step 3 — Order Patchstack Protection + +1. Navigate to the Patchstack Protection store page (`https://your-whmcs.example.com/index.php?rp=/store/patchstack-protection-group`). +2. Click **Order Now** for the Patchstack Protection product. +3. Click **I will use my existing domain and update my nameservers**. +4. Enter a placeholder domain such as `example.com` (WHMCS may not allow your + `nip.io` test domain at checkout — we correct it in the next step). +5. Click **Checkout** and complete the order. + +### Test Step 4 — Correct the Domain + +1. Navigate to **Clients** (`https://your-whmcs.example.com/admin/clients.php`) and open the test client. +2. Go to the **Products/Services** tab and select the Patchstack order. +3. Update the **Domain** field to `wpsite.`. +4. Click **Save Changes**. + +### Test Step 5 — Accept Order + +1. Navigate to **Orders** (`https://your-whmcs.example.com/admin/orders.php`). +2. Check the order. +3. Click **Accept Order**. + +If **Auto Deploy Plugin** is enabled, the module attempts SSH deployment +automatically. Check **Utilities → Logs → Module Log** filtered by `patchstack` to +see the deployment result. + +:::caution +If accept fails with **"This UserToken has expired"**, the App API token in the +Patchstack API server's **Access Hash** (Step 3) is no longer valid — it hit its +expiry, or a newer token superseded it (regenerating a token invalidates older +ones). Generate a fresh token at +[Settings → Integrations](https://app.patchstack.com/settings/integrations), update +the **Access Hash** on the `Patchstack API` server, click **Test Connection** to +confirm it's valid, then re-accept the order. +::: + +:::caution +If accept dies on a WHMCS **"Oops"** page (Display Errors off) and the container log +shows **`Class "phpseclib3\Net\SSH2" not found`**, the module's `vendor/` directory +isn't installed. Install the module's Composer dependencies once, then use **Retry +Deployment** on the service. +::: + +## Further information + +- [Patchstack App dashboard](https://app.patchstack.com/) — log in to manage the App API token and review provisioned sites. +- [Patchstack App → Settings → Integrations](https://app.patchstack.com/settings/integrations) — generate or rotate the App API token. +- [Patchstack App API](/api-solutions/app-api/patchstack-app-api/) — the provisioning API the module calls under the hood. +- [Patchstack integration guide](/api-solutions/app-api/patchstack-integration/) — how site provisioning and the plugin lifecycle work end to end. +- [WHMCS Server Management documentation](https://docs.whmcs.com/Servers) — official WHMCS guide for the underlying server-record infrastructure this module relies on. +- **Module support.** For technical questions about the module itself, contact `support@patchstack.com`. From ba9262b2bd1e98f8f3c7507eb31407eb747b873e Mon Sep 17 00:00:00 2001 From: "claude[bot]" <209825114+claude[bot]@users.noreply.github.com> Date: Fri, 10 Jul 2026 11:40:00 +0100 Subject: [PATCH 31/89] docs: move Threat Intelligence npm docs off /beta URL with redirect (#58) * docs: move Threat Intelligence npm docs off /beta URL with redirect Rename the Threat Intelligence NPM features page from /api-solutions/threat-intelligence-api/beta/ to /api-solutions/threat-intelligence-api/npm-features/ and the OpenAPI reference route from threat-intelligence-beta to threat-intelligence-npm. Rename the spec/collection files and update sidebar config and internal links accordingly. Add 301 redirects from the old URLs so existing links keep working. The live API endpoint path /database/api/beta is left unchanged. Co-Authored-By: Claude Opus 4.8 (1M context) Claude-Session: https://claude.ai/code/session_01Wpv66nBJCH8vBkNhNw8NbW * docs: point Threat Intelligence API at /database/api/npm, note /beta legacy alias The hub backend adds /database/api/npm as the canonical Threat Intelligence API base path while keeping /database/api/beta as a permanent legacy alias. Update the documented base URL and all curl/code examples to /database/api/npm, regenerate the Postman collection, and add a note that /beta still works and returns identical responses so existing integrations don't need to change. --------- Co-authored-by: Claude --- astro.config.mjs | 18 +++++++------- netlify.toml | 15 ++++++++++++ ... threat-intel-npm.postman_collection.json} | 4 ++-- ...-intel-beta.yaml => threat-intel-npm.yaml} | 20 ++++++++-------- .../{beta.md => npm-features.md} | 24 +++++++++++-------- .../Threat Intelligence API/overview.md | 4 ++-- 6 files changed, 52 insertions(+), 33 deletions(-) rename public/schemas/{threat-intel-beta.postman_collection.json => threat-intel-npm.postman_collection.json} (95%) rename public/schemas/{threat-intel-beta.yaml => threat-intel-npm.yaml} (96%) rename src/content/docs/API solutions/Threat Intelligence API/{beta.md => npm-features.md} (83%) diff --git a/astro.config.mjs b/astro.config.mjs index e346418..fd83287 100644 --- a/astro.config.mjs +++ b/astro.config.mjs @@ -8,7 +8,7 @@ import Converter from 'openapi-to-postmanv2' const threatIntelStandardSidebarGroup = createOpenAPISidebarGroup(); const threatIntelExtendedSidebarGroup = createOpenAPISidebarGroup(); -const threatIntelBetaSidebarGroup = createOpenAPISidebarGroup(); +const threatIntelNpmSidebarGroup = createOpenAPISidebarGroup(); const site_url = process.env.URL; @@ -25,8 +25,8 @@ const postmanCollections = [ output: './public/schemas/threat-intel-extended.postman_collection.json', }, { - openapi: './public/schemas/threat-intel-beta.yaml', - output: './public/schemas/threat-intel-beta.postman_collection.json', + openapi: './public/schemas/threat-intel-npm.yaml', + output: './public/schemas/threat-intel-npm.postman_collection.json', }, ]; @@ -104,9 +104,9 @@ export default defineConfig({ sidebar: { label: 'Reference', group: threatIntelExtendedSidebarGroup }, }, { - base: 'api-reference/threat-intelligence-beta', - schema: './public/schemas/threat-intel-beta.yaml', - sidebar: { label: 'NPM features', group: threatIntelBetaSidebarGroup, collapsed: true }, + base: 'api-reference/threat-intelligence-npm', + schema: './public/schemas/threat-intel-npm.yaml', + sidebar: { label: 'NPM features', group: threatIntelNpmSidebarGroup, collapsed: true }, }, ]), ], @@ -171,9 +171,9 @@ export default defineConfig({ label: 'NPM features', collapsed: true, items: [ - { slug: 'api-solutions/threat-intelligence-api/beta' }, - { label: 'GET /all (new)', link: '/api-reference/threat-intelligence-beta/operations/listallvulnerabilities/' }, - { label: 'Full reference', link: '/api-reference/threat-intelligence-beta/' }, + { slug: 'api-solutions/threat-intelligence-api/npm-features' }, + { label: 'GET /all (new)', link: '/api-reference/threat-intelligence-npm/operations/listallvulnerabilities/' }, + { label: 'Full reference', link: '/api-reference/threat-intelligence-npm/' }, ], }, { slug: 'api-solutions/threat-intelligence-api/api-properties' }, diff --git a/netlify.toml b/netlify.toml index 31a8faf..184785b 100644 --- a/netlify.toml +++ b/netlify.toml @@ -1028,6 +1028,21 @@ from = "/api-solutions/threat-intelligence-api/enterprise/" to = "/api-solutions/threat-intelligence-api/extended/" +[[redirects]] + from = "/api-solutions/threat-intelligence-api/beta/" + to = "/api-solutions/threat-intelligence-api/npm-features/" + status = 301 + +[[redirects]] + from = "/api-reference/threat-intelligence-beta/" + to = "/api-reference/threat-intelligence-npm/" + status = 301 + +[[redirects]] + from = "/api-reference/threat-intelligence-beta/*" + to = "/api-reference/threat-intelligence-npm/:splat" + status = 301 + [[redirects]] from = "/patchstack-app/account-settings/team/" diff --git a/public/schemas/threat-intel-beta.postman_collection.json b/public/schemas/threat-intel-npm.postman_collection.json similarity index 95% rename from public/schemas/threat-intel-beta.postman_collection.json rename to public/schemas/threat-intel-npm.postman_collection.json index bc4e655..900b5c6 100644 --- a/public/schemas/threat-intel-beta.postman_collection.json +++ b/public/schemas/threat-intel-npm.postman_collection.json @@ -1750,7 +1750,7 @@ "variable": [ { "type": "string", - "value": "https://vdp-api.patchstack.com/database/api/beta", + "value": "https://vdp-api.patchstack.com/database/api/npm", "key": "baseUrl" } ], @@ -1775,7 +1775,7 @@ "name": "Patchstack Threat Intelligence API — NPM features", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "description": { - "content": "The Beta endpoints live alongside the v2 API and add npm coverage, an optional\nfull advisory body, a consistent nested response shape, and cursor pagination.\nThey are the recommended endpoints for new integrations; v2 remains available\nfor backwards compatibility.\n\n## Authentication\n\nEvery request must include your API key in the `PSKey` HTTP request header.\nRequest a key via .\n\n## Platforms\n\nPass `?platform=npm` (or `?platform=wordpress` — the default) on list\nendpoints. Platform names are case-insensitive.\n\n## Pagination\n\n`/all` and `/latest` support two independent strategies, selected by which\nquery parameter you pass:\n\n- **Offset** (`?page=&per_page=`) — returns totals; easy to jump to a\n specific page; susceptible to row-shift when new rows land while paging.\n- **Cursor** (`?cursor=`) — stable under concurrent inserts, faster at\n depth, no `total` count. Bootstrap with an empty value: `?cursor=`.\n\n`cursor` and `page` are mutually exclusive; passing both returns `422`.\n\n## Including full advisory bodies\n\nPass `?include=details` on any list endpoint to add an `advisory_details`\nmarkdown field to each item.\n\n## Scoped npm packages\n\nnpm package slugs that include a `/` (e.g. `@scope/pkg`) conflict with the\nroute separator. URL-encode the `/` as `%2F`.\n\n## Rate limiting\n\nSame policy as the Extended Threat Intelligence API. Contact\n if you need an elevated quota.\n\n## Errors\n\n| Status | Meaning |\n|---|---|\n| `401` | Missing or invalid `PSKey` header. |\n| `403` | API key not authorised for the requested endpoint. |\n| `422` | Invalid parameter combination or value (e.g. `cursor` + `page`, invalid `platform`, `per_page > 500`). |\n| `429` | Rate limit exceeded. |\n| `500` | Server error — include the request id in any bug report. |\n\nA malformed cursor returns `200` with an empty page rather than an error:\n\n```json\n{ \"vulnerabilities\": [], \"cursor\": { \"next_cursor\": null, \"has_more\": false, \"per_page\": 100 } }\n```\n\n## Related pages\n\n- Narrative guide with code samples: [NPM features (Beta)](/api-solutions/threat-intelligence-api/beta/)\n- OpenAPI spec (import into Postman / Insomnia / Bruno / Hoppscotch): \n- Postman collection (pre-imported): \n\nIntegration questions: .\n\n\nContact Support:\n Name: Patchstack\n Email: dave.jong@patchstack.com", + "content": "The npm endpoints live alongside the v2 API and add npm coverage, an optional\nfull advisory body, a consistent nested response shape, and cursor pagination.\nThey are the recommended endpoints for new integrations; v2 remains available\nfor backwards compatibility.\n\n## Authentication\n\nEvery request must include your API key in the `PSKey` HTTP request header.\nRequest a key via .\n\n## Platforms\n\nPass `?platform=npm` (or `?platform=wordpress` — the default) on list\nendpoints. Platform names are case-insensitive.\n\n## Pagination\n\n`/all` and `/latest` support two independent strategies, selected by which\nquery parameter you pass:\n\n- **Offset** (`?page=&per_page=`) — returns totals; easy to jump to a\n specific page; susceptible to row-shift when new rows land while paging.\n- **Cursor** (`?cursor=`) — stable under concurrent inserts, faster at\n depth, no `total` count. Bootstrap with an empty value: `?cursor=`.\n\n`cursor` and `page` are mutually exclusive; passing both returns `422`.\n\n## Including full advisory bodies\n\nPass `?include=details` on any list endpoint to add an `advisory_details`\nmarkdown field to each item.\n\n## Scoped npm packages\n\nnpm package slugs that include a `/` (e.g. `@scope/pkg`) conflict with the\nroute separator. URL-encode the `/` as `%2F`.\n\n## Rate limiting\n\nSame policy as the Extended Threat Intelligence API. Contact\n if you need an elevated quota.\n\n## Errors\n\n| Status | Meaning |\n|---|---|\n| `401` | Missing or invalid `PSKey` header. |\n| `403` | API key not authorised for the requested endpoint. |\n| `422` | Invalid parameter combination or value (e.g. `cursor` + `page`, invalid `platform`, `per_page > 500`). |\n| `429` | Rate limit exceeded. |\n| `500` | Server error — include the request id in any bug report. |\n\nA malformed cursor returns `200` with an empty page rather than an error:\n\n```json\n{ \"vulnerabilities\": [], \"cursor\": { \"next_cursor\": null, \"has_more\": false, \"per_page\": 100 } }\n```\n\n## Related pages\n\n- Narrative guide with code samples: [NPM features](/api-solutions/threat-intelligence-api/npm-features/)\n- OpenAPI spec (import into Postman / Insomnia / Bruno / Hoppscotch): \n- Postman collection (pre-imported): \n\nIntegration questions: .\n\n\nContact Support:\n Name: Patchstack\n Email: dave.jong@patchstack.com", "type": "text/plain" } } diff --git a/public/schemas/threat-intel-beta.yaml b/public/schemas/threat-intel-npm.yaml similarity index 96% rename from public/schemas/threat-intel-beta.yaml rename to public/schemas/threat-intel-npm.yaml index 88ae03d..e458f59 100644 --- a/public/schemas/threat-intel-beta.yaml +++ b/public/schemas/threat-intel-npm.yaml @@ -64,9 +64,9 @@ info: ## Related pages - - Narrative guide with code samples: [NPM features](/api-solutions/threat-intelligence-api/beta/) - - OpenAPI spec (import into Postman / Insomnia / Bruno / Hoppscotch): - - Postman collection (pre-imported): + - Narrative guide with code samples: [NPM features](/api-solutions/threat-intelligence-api/npm-features/) + - OpenAPI spec (import into Postman / Insomnia / Bruno / Hoppscotch): + - Postman collection (pre-imported): Integration questions: . contact: @@ -75,8 +75,8 @@ info: email: dave.jong@patchstack.com servers: - - url: https://vdp-api.patchstack.com/database/api/beta - description: NPM features + - url: https://vdp-api.patchstack.com/database/api/npm + description: NPM features. The previous base URL https://vdp-api.patchstack.com/database/api/beta continues to work as a permanent legacy alias and returns identical responses. security: - PSKey: [] @@ -87,9 +87,9 @@ tags: Listing endpoints that return published vulnerabilities for a platform, ordered by descending `id`. - - [`GET /all`](/api-reference/threat-intelligence-beta/operations/listallvulnerabilities/) + - [`GET /all`](/api-reference/threat-intelligence-npm/operations/listallvulnerabilities/) — every published vulnerability for the platform, paginated. - - [`GET /latest`](/api-reference/threat-intelligence-beta/operations/listlatestvulnerabilities/) + - [`GET /latest`](/api-reference/threat-intelligence-npm/operations/listlatestvulnerabilities/) — vulnerabilities whose row was inserted in the last 24 hours (filter is on `created_at`, not `disclosure_date`). @@ -100,10 +100,10 @@ tags: Match a specific product + version against the vulnerability database and return every applicable advisory. - - [`GET /product/{type}/{name}/{version}`](/api-reference/threat-intelligence-beta/operations/findproductvulnerabilities/) + - [`GET /product/{type}/{name}/{version}`](/api-reference/threat-intelligence-npm/operations/findproductvulnerabilities/) — full advisory list for the product. Use `version=*` to return every advisory for the product regardless of version. - - [`GET /product/{type}/{name}/{version}/exists`](/api-reference/threat-intelligence-beta/operations/productvulnerabilityexists/) + - [`GET /product/{type}/{name}/{version}/exists`](/api-reference/threat-intelligence-npm/operations/productvulnerabilityexists/) — boolean-only variant for fast "is this vulnerable?" checks. `type` accepts `npm`, `plugin`, `theme`, or `wordpress`. For scoped npm @@ -115,7 +115,7 @@ tags: of installed WordPress plugins) — it's significantly cheaper than issuing one request per product. - - [`POST /batch`](/api-reference/threat-intelligence-beta/operations/batchproductcheck/) + - [`POST /batch`](/api-reference/threat-intelligence-npm/operations/batchproductcheck/) — payload is a JSON array of up to 50 `{type, name, version, exists?}` objects. Per-item results are returned in request order. diff --git a/src/content/docs/API solutions/Threat Intelligence API/beta.md b/src/content/docs/API solutions/Threat Intelligence API/npm-features.md similarity index 83% rename from src/content/docs/API solutions/Threat Intelligence API/beta.md rename to src/content/docs/API solutions/Threat Intelligence API/npm-features.md index 98bfda1..24bd781 100644 --- a/src/content/docs/API solutions/Threat Intelligence API/beta.md +++ b/src/content/docs/API solutions/Threat Intelligence API/npm-features.md @@ -12,25 +12,29 @@ sidebar: label: "Overview" --- -_The npm features extend the Threat Intelligence API with npm-ecosystem coverage. They run at a separate base URL, ship their own OpenAPI spec, and are available to **selected partners working directly with Patchstack**. The shared endpoints (`/latest`, `/product/{type}/{name}/{version}`, `/product/{type}/{name}/{version}/exists`, `/batch`) behave the same as the stable API but accept extra parameters and return a nested response shape. This page documents only what's new — for the full spec including npm-flavour examples, see the [auto-generated reference](/api-reference/threat-intelligence-beta/). [Contact us](https://patchstack.com/for-hosts/) if you'd like access._ +_The npm features extend the Threat Intelligence API with npm-ecosystem coverage. They run at a separate base URL, ship their own OpenAPI spec, and are available to **selected partners working directly with Patchstack**. The shared endpoints (`/latest`, `/product/{type}/{name}/{version}`, `/product/{type}/{name}/{version}/exists`, `/batch`) behave the same as the stable API but accept extra parameters and return a nested response shape. This page documents only what's new — for the full spec including npm-flavour examples, see the [auto-generated reference](/api-reference/threat-intelligence-npm/). [Contact us](https://patchstack.com/for-hosts/) if you'd like access._ ## Base URL ``` -https://vdp-api.patchstack.com/database/api/beta/ +https://vdp-api.patchstack.com/database/api/npm/ ``` +:::note +The previous base URL `https://vdp-api.patchstack.com/database/api/beta/` remains supported as a permanent legacy alias and returns identical responses, so existing integrations don't need to change immediately. +::: + ## What's new | Addition | Where it applies | |---|---| -| [`GET /all`](/api-reference/threat-intelligence-beta/operations/listallvulnerabilities/) | New endpoint — cursor-paginated full listing of every advisory, scoped by `?platform=`. | +| [`GET /all`](/api-reference/threat-intelligence-npm/operations/listallvulnerabilities/) | New endpoint — cursor-paginated full listing of every advisory, scoped by `?platform=`. | | `?platform=npm` | List endpoints (`/all`, `/latest`, `/product/...`). Default is `wordpress`; case-insensitive. | | `?cursor=` | `/all` and `/latest` — cursor pagination alongside the existing `?page=&per_page=`. | | `?include=details` | List endpoints — adds an `advisory_details` markdown field to each item (npm). | | Nested response shape | All list endpoints — `product`, `cvss`, `cwe`, `version_info` objects in place of the v2 flat shape. | -The full npm-features schema (every endpoint, parameter, response example) lives in the [auto-generated reference](/api-reference/threat-intelligence-beta/). +The full npm-features schema (every endpoint, parameter, response example) lives in the [auto-generated reference](/api-reference/threat-intelligence-npm/). ## Pagination @@ -78,19 +82,19 @@ In addition to the [stable error codes](/api-solutions/threat-intelligence-api/e ```bash # Latest 24h, npm -curl 'https://vdp-api.patchstack.com/database/api/beta/latest?platform=npm&per_page=10' \ +curl 'https://vdp-api.patchstack.com/database/api/npm/latest?platform=npm&per_page=10' \ -H 'PSKey: ' # Cursor pagination walk (bootstrap + follow) -curl 'https://vdp-api.patchstack.com/database/api/beta/all?platform=npm&per_page=50&cursor=' \ +curl 'https://vdp-api.patchstack.com/database/api/npm/all?platform=npm&per_page=50&cursor=' \ -H 'PSKey: ' # Check a specific npm package/version with full advisory text -curl 'https://vdp-api.patchstack.com/database/api/beta/product/npm/axios/0.21.4?include=details' \ +curl 'https://vdp-api.patchstack.com/database/api/npm/product/npm/axios/0.21.4?include=details' \ -H 'PSKey: ' # Boolean-only exists check -curl 'https://vdp-api.patchstack.com/database/api/beta/product/npm/axios/0.21.4/exists' \ +curl 'https://vdp-api.patchstack.com/database/api/npm/product/npm/axios/0.21.4/exists' \ -H 'PSKey: ' ``` @@ -98,7 +102,7 @@ curl 'https://vdp-api.patchstack.com/database/api/beta/product/npm/axios/0.21.4/ ```javascript async function* allVulnerabilities(apiKey, platform = 'npm', perPage = 100) { - const base = 'https://vdp-api.patchstack.com/database/api/beta/all'; + const base = 'https://vdp-api.patchstack.com/database/api/npm/all'; let cursor = ''; // empty = bootstrap cursor mode while (true) { @@ -129,7 +133,7 @@ $apiKey = getenv('PATCHSTACK_KEY'); $cursor = ''; do { - $url = 'https://vdp-api.patchstack.com/database/api/beta/all' + $url = 'https://vdp-api.patchstack.com/database/api/npm/all' .'?platform=npm&per_page=100&cursor='.urlencode($cursor); $ch = curl_init($url); diff --git a/src/content/docs/API solutions/Threat Intelligence API/overview.md b/src/content/docs/API solutions/Threat Intelligence API/overview.md index 3e6fcdd..85219a3 100644 --- a/src/content/docs/API solutions/Threat Intelligence API/overview.md +++ b/src/content/docs/API solutions/Threat Intelligence API/overview.md @@ -22,7 +22,7 @@ Custom pricing, activated on request — [contact us](https://patchstack.com/for For partners covering JavaScript components, the npm features add **npm-ecosystem coverage** alongside WordPress, available to **selected partners working directly with Patchstack**. Beyond npm itself they ship the supporting additions that make npm coverage workable at scale: the new `GET /all` endpoint, cursor pagination, `?include=details` for full advisory bodies, and a nested response shape the stable API will eventually adopt. Everything else (`/latest`, `/product/{type}/{name}/{version}`, `/batch`) is the same surface as the stable API. -See the [NPM features](/api-solutions/threat-intelligence-api/beta/) page for the full delta — base URL, parameters, pagination, errors, and migration notes — and the [auto-generated reference](/api-reference/threat-intelligence-beta/) for the full schema. [Contact us](https://patchstack.com/for-hosts/) for access. +See the [NPM features](/api-solutions/threat-intelligence-api/npm-features/) page for the full delta — base URL, parameters, pagination, errors, and migration notes — and the [auto-generated reference](/api-reference/threat-intelligence-npm/) for the full schema. [Contact us](https://patchstack.com/for-hosts/) for access. --- @@ -37,7 +37,7 @@ The API ships with an OpenAPI spec and a generated Postman collection. The npm f | | OpenAPI spec | Postman collection | |---|---|---| | Threat Intelligence API | [`threat-intel-extended.yaml`](/schemas/threat-intel-extended.yaml) | [`threat-intel-extended.postman_collection.json`](/schemas/threat-intel-extended.postman_collection.json) | -| NPM features | [`threat-intel-beta.yaml`](/schemas/threat-intel-beta.yaml) | [`threat-intel-beta.postman_collection.json`](/schemas/threat-intel-beta.postman_collection.json) | +| NPM features | [`threat-intel-npm.yaml`](/schemas/threat-intel-npm.yaml) | [`threat-intel-npm.postman_collection.json`](/schemas/threat-intel-npm.postman_collection.json) | | Standard *(legacy)* | [`threat-intel-standard.yaml`](/schemas/threat-intel-standard.yaml) | [`threat-intel-standard.postman_collection.json`](/schemas/threat-intel-standard.postman_collection.json) | ### Postman, Insomnia, Bruno or Hoppscotch From 44570b9b36179a05793bcbd0bbfcd98a9696a343 Mon Sep 17 00:00:00 2001 From: "claude[bot]" <209825114+claude[bot]@users.noreply.github.com> Date: Tue, 14 Jul 2026 10:10:46 +0200 Subject: [PATCH 32/89] Deprecate automatic updates documentation (ENG-3288) (#59) * docs: deprecate automatic updates documentation (ENG-3288) The automatic updates feature has been deprecated and the old Software > Automatic updates page (app.patchstack.com/software/updates) now returns a 404, but the docs still pointed users there. - automatic-updates.md: add deprecation callout at the top, reword the availability line to past tense, remove the broken app link, and reframe the how-to instructions as historical. - start-using-patchstack.md: replace the "enable auto-updates" step sub-items with a deprecation note. - site-software.mdx: remove the "enable auto-updates" action bullet and add a deprecation note. * docs: remove automatic updates feature from documentation (ENG-3288) Fully remove the deprecated automatic-updates page instead of keeping it with a deprecation notice: - Delete Patchstack App/Software/automatic-updates.md - Repoint /docs/automatic-updates redirect and add 301 redirects from the old /patchstack-app/software/automatic-updates URL to the Software overview page - Remove auto-update mentions and deprecation callouts from the getting started guide and the site software page * docs: remove remaining automatic-updates mentions (ENG-3288) --------- Co-authored-by: Claude --- netlify.toml | 12 ++++- ...-plugin-api-key-for-staging-environment.md | 2 +- .../Getting Started/start-using-patchstack.md | 4 +- .../Site Dashboard/site-software.mdx | 4 -- .../Software/automatic-updates.md | 50 ------------------- .../Patchstack App/Software/software-logs.mdx | 2 +- 6 files changed, 14 insertions(+), 60 deletions(-) delete mode 100644 src/content/docs/Patchstack App/Software/automatic-updates.md diff --git a/netlify.toml b/netlify.toml index 184785b..7c2c03e 100644 --- a/netlify.toml +++ b/netlify.toml @@ -454,7 +454,17 @@ [[redirects]] from = "/docs/automatic-updates" - to = "/patchstack-app/software/automatic-updates/" + to = "/patchstack-app/software/software-overview/" + +[[redirects]] + from = "/patchstack-app/software/automatic-updates/" + to = "/patchstack-app/software/software-overview/" + status = 301 + +[[redirects]] + from = "/patchstack-app/software/automatic-updates" + to = "/patchstack-app/software/software-overview/" + status = 301 [[redirects]] from = "/docs/protection-overview" diff --git a/src/content/docs/FAQ Troubleshooting/Technical/can-i-use-the-same-plugin-api-key-for-staging-environment.md b/src/content/docs/FAQ Troubleshooting/Technical/can-i-use-the-same-plugin-api-key-for-staging-environment.md index 0888ce7..7cc18af 100644 --- a/src/content/docs/FAQ Troubleshooting/Technical/can-i-use-the-same-plugin-api-key-for-staging-environment.md +++ b/src/content/docs/FAQ Troubleshooting/Technical/can-i-use-the-same-plugin-api-key-for-staging-environment.md @@ -45,7 +45,7 @@ Patchstack will work normally with your live site, if you share the same API key Some things to keep in mind: - Your production (live) site receives all the real-time protection rules - All custom hardening rules set in Patchstack App are also synced normally -- All the features that Patchstack offers, will work on your live site (like auto-updates, custom rules, etc) +- All the features that Patchstack offers, will work on your live site (like custom rules, etc) - On the staging site however, only the API key license check will work. Other features and firewall rules are not synced to the staging site - We recommend turning on the server level protection for your staging site (e.g. htaccess and htpasswd) diff --git a/src/content/docs/Getting Started/start-using-patchstack.md b/src/content/docs/Getting Started/start-using-patchstack.md index 33529c2..1618cab 100644 --- a/src/content/docs/Getting Started/start-using-patchstack.md +++ b/src/content/docs/Getting Started/start-using-patchstack.md @@ -50,9 +50,7 @@ Take immediate action on the **High Priority** vulnerabilities. ### Step #4 — Check your software for updates -Check the status of your plugins and themes. Apply the necessary updates, and decide whether you’d like to: -1. Auto-update only vulnerable software; or -2. Auto-update all software (plugins, themes and/or WordPress core versions) +Check the status of your plugins and themes and apply the necessary updates. [Learn more](/patchstack-app/site-dashboard/site-software/) diff --git a/src/content/docs/Patchstack App/Site Dashboard/site-software.mdx b/src/content/docs/Patchstack App/Site Dashboard/site-software.mdx index c798d01..36b9275 100644 --- a/src/content/docs/Patchstack App/Site Dashboard/site-software.mdx +++ b/src/content/docs/Patchstack App/Site Dashboard/site-software.mdx @@ -23,16 +23,12 @@ On the this software subpage, you can also manage the software components of you The following actions are available only for WordPress CMS: -- Enable auto-updates for: - - Only vulnerable software - - All core, themes, and plugins - Have an overview of software your site is using and see all your software versions - See if any of the software is found vulnerable or outdated - Update, activate, deactivate, or delete the existing plugins/themes - Update all your software with one click - Force resynchronization between Patchstack App and your site if something looks out of sync - ### To perform any actions with specific plugins or themes on your site, follow the steps below: 1. Check the checkboxes of your plugins or themes (at the left side of the table row) diff --git a/src/content/docs/Patchstack App/Software/automatic-updates.md b/src/content/docs/Patchstack App/Software/automatic-updates.md deleted file mode 100644 index 1ac35db..0000000 --- a/src/content/docs/Patchstack App/Software/automatic-updates.md +++ /dev/null @@ -1,50 +0,0 @@ ---- -title: "Automatic updates" - -excerpt: "Update your software automatically" -hidden: false -metadata: - image: [] - robots: "index" -createdAt: "Mon Jul 25 2022 09:06:05 GMT+0000 (Coordinated Universal Time)" -updatedAt: "Mon Nov 13 2023 15:30:24 GMT+0000 (Coordinated Universal Time)" -sidebar: - order: 4.2 ---- -_Automatic updates feature is available for all Patchstack users._ -**_This feature is available for WordPress sites only._** - -Navigate to the automatic updates page by visiting **Software** > **Automatic updates**, or click here: [https://app.patchstack.com/software/updates](https://app.patchstack.com/software/updates) - -On the **Automatic updates** subpage, you can see which of your sites have auto-updates enabled. You can turn automatic updates for each of your sites on / off. -Patchstack also has an option to only auto-update such software that has any vulnerabilities detected. - -For each site, you have the following options: - -
          1. Auto-update only vulnerable components (recommended) - - this option includes core versions, plugins and themes
          2. -
          3. Auto-update WordPress core (whenever update is available)
          4. -
          5. Auto-update plugins (whenever update is available)
          6. -
          7. Auto-update themes (whenever update is available)
          8. -
          - -![](@images/patchstack-software-automatic-updates.png) - -## Turning on the auto-updates - -To turn on the **auto-updates** feature, click the **Change** button of the corresponding site in the table. -You will be shown a popup, which lets you toggle auto-updates for: -* Only vulnerable software versions -* For all WordPress core versions (whenever update is available) -* For all plugin versions (whenever update is available) -* For all theme versions (whenever update is available) - -To activate any of the options, toggle the buttons. (see the image below). - -![](@images/patchstack-software-auto-update-settings.png) - -> ❗️ Note that auto-updating won't work for some of the premium plugins or themes as these may not use standard updating mechanisms (for example some software requires a separate licnese checking call) - -> ‼️ Note that updating software could potentially break your site, but for security reasons, it is recommended to still auto-update at least your vulnerable software components. - -After toggling the buttons, click **Update**. diff --git a/src/content/docs/Patchstack App/Software/software-logs.mdx b/src/content/docs/Patchstack App/Software/software-logs.mdx index a5bf8ca..1fb660d 100644 --- a/src/content/docs/Patchstack App/Software/software-logs.mdx +++ b/src/content/docs/Patchstack App/Software/software-logs.mdx @@ -24,5 +24,5 @@ As seen on the screenshot below, it shows that the user has updated three plugin ![](@images/patchstack-software-logs.png) \ No newline at end of file From 69151c56bc6f4f690163f59262633c0d35111055 Mon Sep 17 00:00:00 2001 From: "claude[bot]" <209825114+claude[bot]@users.noreply.github.com> Date: Tue, 14 Jul 2026 11:02:27 +0200 Subject: [PATCH 33/89] docs: clarify hardening settings and security header behavior (ENG-3233) (#60) Claude-Session: https://claude.ai/code/session_019Mhse3fPrXqfYBYMACmPwT Co-authored-by: Claude --- ...to-add-security-headers-with-patchstack.md | 2 + .../Hardening/app-hardening-htaccess.md | 2 +- ...ardening-and-security-headers-explained.md | 46 +++++++++++++++++++ 3 files changed, 49 insertions(+), 1 deletion(-) create mode 100644 src/content/docs/Patchstack App/Site Dashboard/Hardening/hardening-and-security-headers-explained.md diff --git a/src/content/docs/FAQ Troubleshooting/Technical/how-to-add-security-headers-with-patchstack.md b/src/content/docs/FAQ Troubleshooting/Technical/how-to-add-security-headers-with-patchstack.md index 4be61ff..85d06d6 100644 --- a/src/content/docs/FAQ Troubleshooting/Technical/how-to-add-security-headers-with-patchstack.md +++ b/src/content/docs/FAQ Troubleshooting/Technical/how-to-add-security-headers-with-patchstack.md @@ -13,6 +13,8 @@ sidebar: --- If you have the Patchstack plugin installed, we will automatically try to inject the security headers into the response. +Because these headers can be injected into the HTTP response at runtime, they may not appear in your `.htaccess` file even when they are active. To confirm which headers are being sent, check the live response (for example with [securityheaders.com](https://securityheaders.com/)) instead of reading `.htaccess`. Avoid adding the same headers both automatically and manually, or you may end up with duplicate headers. For how these settings relate to each other, see [How hardening and security headers work](/patchstack-app/site-dashboard/hardening/hardening-and-security-headers-explained/). + If this does not work, perhaps due to an aggressive caching plugin or caching/proxy server, you may have to manually add the .htaccess rules below to your .htaccess file. ## Adding the security headers automatically diff --git a/src/content/docs/Patchstack App/Site Dashboard/Hardening/app-hardening-htaccess.md b/src/content/docs/Patchstack App/Site Dashboard/Hardening/app-hardening-htaccess.md index b3de0f7..af98260 100644 --- a/src/content/docs/Patchstack App/Site Dashboard/Hardening/app-hardening-htaccess.md +++ b/src/content/docs/Patchstack App/Site Dashboard/Hardening/app-hardening-htaccess.md @@ -25,7 +25,7 @@ On the **.htaccess features** block you can modify some of your site settings an Settings you can manage on this page:
            -
          • Add security headers - toggle this, and Patchstack adds basic security headers to your .htaccess file
          • +
          • Add security headers - toggle this, and Patchstack adds a standard set of security headers to your site. Depending on your environment these may be written to your .htaccess file or injected into the HTTP response, so they will not always appear in .htaccess. See How hardening and security headers work for details.
          • Prevent default WordPress file access - this feature blocks access to such files as license.txt, readme.html and wp-config-sample.php files
          • Block access to debug.log file - check this if you want to block access to debug.log file that WordPress creates when debug logging is enabled
          • Disable index views - disables directory indexing and file listings
          • diff --git a/src/content/docs/Patchstack App/Site Dashboard/Hardening/hardening-and-security-headers-explained.md b/src/content/docs/Patchstack App/Site Dashboard/Hardening/hardening-and-security-headers-explained.md new file mode 100644 index 0000000..04782b1 --- /dev/null +++ b/src/content/docs/Patchstack App/Site Dashboard/Hardening/hardening-and-security-headers-explained.md @@ -0,0 +1,46 @@ +--- +title: "How hardening and security headers work" +excerpt: "" +hidden: false +sidebar: + order: 3.33 + label: "How it works" +--- + +Patchstack uses the word "hardening" in more than one place, and security headers can be delivered in more than one way. This page explains how these settings relate to each other, so you know what a given toggle does and does not change. + +## "Advanced Hardening" vs the per-site Hardening tab + +These are two different things that share a name: + +- **Advanced Hardening** is a managed firewall module under **Protection**. It contains protection rules that Patchstack maintains and updates for you (for example, blocking risky file uploads or suspicious `wp-config.php` requests). It is enabled or disabled as part of the firewall. See [Patchstack modules](/patchstack-app/protection/patchstack-modules/). +- The per-site **Hardening** tab (**Sites** > **yourdomain.com** > **Hardening**) holds settings you configure yourself for a single site: the [General hardening](/patchstack-app/site-dashboard/hardening/app-hardening-general/) options and the [.htaccess features](/patchstack-app/site-dashboard/hardening/app-hardening-htaccess/), including **Add security headers**. + +Turning the firewall (and Advanced Hardening) off does not clear your per-site Hardening settings. As noted in the [firewall settings](/patchstack-app/site-dashboard/protection/app-protection-additional-settings/), when the firewall is disabled other security measures such as IP bans and `.htaccess` rules remain active. + +## Per-site settings apply independently + +Hardening and security-header settings are stored per site. Changing them on one site does not change them on another, and there is no single switch that turns off every site's per-site hardening at once. If you disable a higher-level toggle and still see headers or `.htaccess` rules on a site, open that site's own **Hardening** tab: the per-site setting is still on and applying independently. + +## Where security headers live: `.htaccess` vs the HTTP response + +When **Add security headers** is on, Patchstack adds a standard set of headers (such as `X-Content-Type-Options`, `X-Frame-Options`, `Referrer-Policy` and `Strict-Transport-Security`). Depending on your environment, these can be delivered either by rules written to `.htaccess` or by injection into the HTTP response at runtime. + +Because of this, **active security headers may not appear in your `.htaccess` file** — and that does not mean they are missing. To confirm which headers are actually being sent, inspect the live HTTP response (for example with [securityheaders.com](https://securityheaders.com/)) rather than reading the `.htaccess` file. + +If you also add the same headers manually (in `.htaccess`, in your nginx config, or through another plugin) while Patchstack is sending them, you can end up with **duplicate headers**. To avoid that, keep only one source for each header: either the **Add security headers** toggle or your own manual rules, not both. See [How to add security headers with Patchstack](/faq-troubleshooting/technical/how-to-add-security-headers-with-patchstack/). + +## What "Disable .htaccess features" does and does not do + +The **Disable .htaccess features** option (the `disable_htaccess` plugin option, or the `PS_DISABLE_HTACCESS` constant in `wp-config.php`) stops Patchstack from writing its rules to `.htaccess`. + +It does: + +- Stop Patchstack from writing new `.htaccess` rules. + +It does not: + +- Remove `.htaccess` rules Patchstack already wrote. You must remove those manually. +- Disable protections that do not rely on `.htaccess`, such as the firewall, virtual patches, or security headers delivered by runtime injection. + +See [WP constants](/patchstack-plugin/wp-constants/) and [WP options](/patchstack-plugin/wp-options/) for the plugin-side equivalents. From 01549018cb1656c13d6e0696947ed9aa746b1d46 Mon Sep 17 00:00:00 2001 From: Elliot Date: Wed, 15 Jul 2026 10:31:41 +0200 Subject: [PATCH 34/89] Add @patchstack/connect (JS/Node) install page; link it from npm API docs (#61) * docs: add @patchstack/connect install page for JS/Node projects docs.patchstack.com described npm coverage only as a partner-level, host-applied integration; a security-reviewing AI agent read that as contradicting the self-install connector and concluded the npm package was counterfeit (see patchstack/connect#67). Adds an official page for @patchstack/connect under Installing Patchstack and a note on the npm Threat Intelligence page distinguishing the two paths. Co-Authored-By: Claude Fable 5 * docs: point connector page at GETTING-STARTED and the guide CLI install.txt is being removed from patchstack.com (patchstack-website#350); the package's guide CLI and repo docs are the versioned sources of truth. Co-Authored-By: Claude Fable 5 * docs(connect): document setup command, widget details, protect disclosure, data handling, uninstall Extends the JS/Node install page to match the published CLI (v0.3.16): setup as the recommended bounded flow, the disclosure widget's script URL and opt-out, an explicit note that setup never runs the opt-in protect command, a Security and data handling section, and an uninstall path. Co-Authored-By: Claude Fable 5 --------- Co-authored-by: Claude Fable 5 --- .../Threat Intelligence API/npm-features.md | 4 + .../installing-on-javascript-node-projects.md | 91 +++++++++++++++++++ 2 files changed, 95 insertions(+) create mode 100644 src/content/docs/Getting Started/Installing Patchstack/installing-on-javascript-node-projects.md diff --git a/src/content/docs/API solutions/Threat Intelligence API/npm-features.md b/src/content/docs/API solutions/Threat Intelligence API/npm-features.md index 24bd781..3915c73 100644 --- a/src/content/docs/API solutions/Threat Intelligence API/npm-features.md +++ b/src/content/docs/API solutions/Threat Intelligence API/npm-features.md @@ -14,6 +14,10 @@ sidebar: _The npm features extend the Threat Intelligence API with npm-ecosystem coverage. They run at a separate base URL, ship their own OpenAPI spec, and are available to **selected partners working directly with Patchstack**. The shared endpoints (`/latest`, `/product/{type}/{name}/{version}`, `/product/{type}/{name}/{version}/exists`, `/batch`) behave the same as the stable API but accept extra parameters and return a nested response shape. This page documents only what's new — for the full spec including npm-flavour examples, see the [auto-generated reference](/api-reference/threat-intelligence-npm/). [Contact us](https://patchstack.com/for-hosts/) if you'd like access._ +:::note +This partner API is not the only way to get npm vulnerability coverage. Developers can monitor their own JS/Node projects directly with [`@patchstack/connect`](/getting-started/installing-patchstack/installing-on-javascript-node-projects/), Patchstack's official self-install npm connector — no partner agreement needed. +::: + ## Base URL ``` diff --git a/src/content/docs/Getting Started/Installing Patchstack/installing-on-javascript-node-projects.md b/src/content/docs/Getting Started/Installing Patchstack/installing-on-javascript-node-projects.md new file mode 100644 index 0000000..a985d1f --- /dev/null +++ b/src/content/docs/Getting Started/Installing Patchstack/installing-on-javascript-node-projects.md @@ -0,0 +1,91 @@ +--- +title: "Installing on JavaScript / Node.js projects" +excerpt: "Connect any JS/Node project to Patchstack vulnerability monitoring with the official @patchstack/connect npm package." +hidden: false +createdAt: "Tue Jul 14 2026 00:00:00 GMT+0000 (Coordinated Universal Time)" +updatedAt: "Wed Jul 15 2026 00:00:00 GMT+0000 (Coordinated Universal Time)" +sidebar: + order: 7.3 + label: "JavaScript / Node.js projects" +--- + +Patchstack monitors JavaScript and Node.js applications — not only WordPress sites — through [`@patchstack/connect`](https://www.npmjs.com/package/@patchstack/connect), the official Patchstack connector package, maintained and published by Patchstack on npm under the `@patchstack` organization. + +- **npm:** https://www.npmjs.com/package/@patchstack/connect +- **Source (MIT-licensed):** https://github.com/patchstack/connect +- **Setup guide:** https://github.com/patchstack/connect/blob/main/GETTING-STARTED.md + +## What it does + +The connector reads the project's dependency lockfile (`package-lock.json`, `pnpm-lock.yaml`, or `yarn.lock`; bun projects are detected via `node_modules/`) and reports package names and versions to Patchstack, which matches them against its vulnerability database and notifies you when a dependency needs patching. It works with any framework — Next.js, Vite, Nuxt, Remix, SvelteKit, TanStack Start, plain Node — and with npm, pnpm, yarn, and bun. + +It sends dependency names and versions only: no source code, no environment variable values, no file paths, no git history. + +## Install + +No signup, dashboard step, or UUID is needed up front. Install the package as a development dependency, then run `setup`: + +```bash +npm install --save-dev @patchstack/connect # or: pnpm add -D / yarn add -D / bun add -d +npx --no-install patchstack-connect setup +``` + +`setup` applies a bounded, idempotent set of changes and nothing else: + +1. **Scans the lockfile and sends the dependency manifest** (package names and versions) to Patchstack. +2. **Provisions a Patchstack site** on the first run and writes its UUID to `.patchstackrc.json` (commit this file); later runs reuse the existing site instead of creating a duplicate. +3. **Manages the disclosure-widget tag** in the project's root HTML shell (the first of `index.html`, `public/index.html`, or `src/app.html` that exists) — see the widget section below. +4. **Adds production build integration to `package.json`:** `scan` runs before the build and `mark-build` after it, via `prebuild`/`postbuild` lifecycle hooks (or a direct build chain on bun, which skips npm-style hooks). Existing build commands are preserved, dev scripts are untouched, and `setup` never runs the build itself. +5. **Prints a status checklist** of anything that still needs a manual step, such as framework-specific widget placement. + +`setup` ends by printing a **dashboard link**. The CLI never opens the link and never asks for Patchstack credentials — open it in your browser and sign in to see the vulnerability reports. The site is monitored either way; connecting it to an account is what makes the reports visible to you. + +`setup` never runs the `protect` command (see below). + +### Manual alternative + +The same pieces can be applied individually: `npx @patchstack/connect scan` performs steps 1–3, and the build hooks can be added by hand: + +```jsonc +{ + "scripts": { + "prebuild": "patchstack-connect scan", + "postbuild": "patchstack-connect mark-build" + } +} +``` + +Run `npx @patchstack/connect guide` at any time for a project-aware checklist of what is present and what is missing, with commands tailored to the project. `npx @patchstack/connect status` re-prints the site UUID and dashboard link. + +## The disclosure widget + +The connector installs Patchstack's **vulnerability disclosure widget** — a floating "Report a vulnerability" button — so anyone who spots an issue can report it straight to you. The widget is a single script tag loading `https://cdn.patchstack.com/patchstack-widget.js`, configured with the site UUID (which is public by design — it ships in client-side HTML and is not a secret). A pre-existing manually placed widget tag is left untouched, and `mark-build` ensures the tag in build output (`dist/`, `build/`, `out/`, `.output/public`) without ever editing source. + +Frameworks without a static HTML shell need a one-line placement in the root layout; `guide` prints the exact snippet for the detected framework, and the [widget reference](https://cdn.patchstack.com/llm.html) covers additional patterns. + +To run without the widget, set `"widget": false` in `.patchstackrc.json` — this disables all widget management; otherwise the next scan re-adds the tag. + +## The `protect` command + +The package also ships an **opt-in** `protect` command: a runtime exploit guard, currently for TanStack Start + Supabase applications, which patches the app's Supabase client to route traffic through a same-origin guard. It modifies application code and runs **only** when explicitly invoked — `setup`, `scan`, `guide`, `status`, and `mark-build` never invoke it. If you don't run `protect`, no application code is changed beyond the widget tag and `package.json` scripts described above. + +## Security and data handling + +- **Data sent to Patchstack:** dependency package names and versions from the lockfile, plus a build fingerprint from `mark-build`. No source code, environment variable values, file paths, or git history is transmitted. +- **Files written locally:** `.patchstackrc.json` (site UUID and settings), the widget script tag in the root HTML shell, and the `scan`/`mark-build` entries in `package.json` scripts. `mark-build` additionally stamps build output, never source. +- **External resources:** the widget script is loaded in the browser from `https://cdn.patchstack.com/patchstack-widget.js`. The CLI itself downloads and executes nothing from a URL. +- **Dashboard link:** printed to the terminal only; the CLI never opens it and never asks for credentials. + +## Uninstalling + +1. Note the site UUID from `.patchstackrc.json` before deleting anything — it identifies the site in the dashboard. +2. Remove the widget tag (and any `PatchstackWidget.init(...)` call) from the layout or HTML shell. +3. Remove the `patchstack-connect scan` / `patchstack-connect mark-build` parts from `package.json` scripts, keeping any chained commands. +4. Uninstall with the manager matching the lockfile: `npm uninstall` / `pnpm remove` / `yarn remove` / `bun remove` `@patchstack/connect`. +5. Delete `.patchstackrc.json` and any `PATCHSTACK_SITE_UUID` environment variables. + +Reporting stops immediately. Local removal does not delete the site record on Patchstack's side: an unclaimed site is an anonymous record that stops receiving reports; a claimed site can be removed in the dashboard at https://app.patchstack.com. + +## How this relates to host-level npm protection + +Hosting partners can enable npm vulnerability intelligence for the sites they host through the partner-level [Threat Intelligence API npm features](/api-solutions/threat-intelligence-api/npm-features/). That integration is applied by the host at the infrastructure level. `@patchstack/connect` is the complementary self-service path: developers install it directly into their own projects, whether or not their host is a Patchstack partner. Both feed the same vulnerability database. From 922e402b6c3ea2ddeecd2297e6765fdd8c3f9cdd Mon Sep 17 00:00:00 2001 From: patchstackdave <87758879+patchstackdave@users.noreply.github.com> Date: Tue, 28 Jul 2026 12:46:10 +0200 Subject: [PATCH 35/89] Added changelog for 2.3.7 (#62) --- src/content/docs/Patchstack Plugin/plugin-changelog.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/src/content/docs/Patchstack Plugin/plugin-changelog.md b/src/content/docs/Patchstack Plugin/plugin-changelog.md index 7b2c8df..d80b990 100644 --- a/src/content/docs/Patchstack Plugin/plugin-changelog.md +++ b/src/content/docs/Patchstack Plugin/plugin-changelog.md @@ -8,6 +8,16 @@ updatedAt: "Wed Jan 17 2024 10:39:45 GMT+0000 (Coordinated Universal Time)" sidebar: order: 8 --- +July 28th, 2026 + +
              +
            • Version 2.3.7
            • +
            • Added: Last sync timestamp to plugin settings page
            • +
            • Fixed: Normalize stored option value types
            • +
            • Fixed: Several PHP 8 related errors
            • +
            • Fixed: About a dozen edge-case scenario bugs
            • +
            + April 22nd, 2026
              From 1976a0028653c046925b8d200f32d50d5a5392d1 Mon Sep 17 00:00:00 2001 From: Mario Tarosso Date: Mon, 24 Aug 2026 11:38:13 +0100 Subject: [PATCH 36/89] [feat] ENG-3083 - Sync public docs with Hub and SaaS product changes (#63) Align seats/roles, Outdated filter, subscription lifecycle, Enterprise seats, Joomla removal, and npm matched_range docs with the last 27 days of product work. Co-authored-by: Cursor --- public/schemas/threat-intel-npm.yaml | 31 +++++++++++++++++-- .../Threat Intelligence API/npm-features.md | 17 +++++++++- .../docs/Getting Started/pricing-plans.md | 4 +-- .../Patchstack App/Account settings/seats.md | 31 +++++++++++++------ .../Reports/scheduling-reports.md | 4 ++- .../docs/Patchstack App/Sites/policy.mdx | 4 +-- .../Patchstack App/Sites/removing-a-site.mdx | 8 +++-- .../Software/software-overview.md | 8 ++--- .../docs/Patchstack App/Upgrades/seats.md | 17 +++------- src/content/docs/Patchstack App/dashboard.mdx | 12 ++++--- .../Patchstack Connector/introduction.md | 6 ++-- .../joomla-support-deprecated.mdx | 4 ++- 12 files changed, 102 insertions(+), 44 deletions(-) diff --git a/public/schemas/threat-intel-npm.yaml b/public/schemas/threat-intel-npm.yaml index e458f59..f0ea046 100644 --- a/public/schemas/threat-intel-npm.yaml +++ b/public/schemas/threat-intel-npm.yaml @@ -221,7 +221,11 @@ paths: summary: Find vulnerabilities for a product description: | Match a specific product + version against the vulnerability database - and return every applicable advisory. + and return every applicable advisory. For npm advisories with multiple + affected spans, every span is considered (not only the lowest). Each + matched advisory includes `matched_range` with the span that matched + the installed version and that span's own `fixed_in` — prefer this over + the collapsed top-level `fixed_in` when advising an upgrade. npm package slugs that include a `/` (e.g. `@scope/pkg`) conflict with the route separator. URL-encode the `/` as `%2F`. @@ -526,7 +530,7 @@ components: description: Affected version range (e.g. `<= 2026.3.28`). fixed: type: string - description: First fixed version. + description: Highest fixed version across every affected span (compatibility field — prefer `matched_range.fixed_in` on product lookups). patched_ranges: type: array description: Structured list of patch ranges for advisories with multiple patch ranges. @@ -536,6 +540,29 @@ components: from_version: { type: string } to_version: { type: string } fixed_in: { type: string } + matched_range: + type: object + description: | + Present on product/`batch` lookups when the installed version matched an affected span. + Prefer `matched_range.fixed_in` for user-facing upgrade advice; top-level `fixed_in` is the highest fix across all spans. + properties: + from_version: + type: string + nullable: true + description: Lower bound of the matched span. + to_version: + type: string + nullable: true + description: Upper bound of the matched span. + to_bound: + type: string + nullable: true + description: How to read `to_version` — `exclusive`, `inclusive`, `last-affected`, or null when unrecorded. + enum: [exclusive, inclusive, last-affected] + fixed_in: + type: string + nullable: true + description: Fix for this span only. Null when the advisory never fixed this line. example: id: 46500 title: "NPM: OpenClaw: ..." diff --git a/src/content/docs/API solutions/Threat Intelligence API/npm-features.md b/src/content/docs/API solutions/Threat Intelligence API/npm-features.md index 3915c73..1bf807b 100644 --- a/src/content/docs/API solutions/Threat Intelligence API/npm-features.md +++ b/src/content/docs/API solutions/Threat Intelligence API/npm-features.md @@ -6,7 +6,7 @@ metadata: image: [] robots: "index" createdAt: "Tue Apr 21 2026 00:00:00 GMT+0000 (Coordinated Universal Time)" -updatedAt: "Wed Apr 22 2026 00:00:00 GMT+0000 (Coordinated Universal Time)" +updatedAt: "Mon Aug 24 2026 00:00:00 GMT+0000 (Coordinated Universal Time)" sidebar: order: 1 label: "Overview" @@ -78,6 +78,21 @@ In addition to the [stable error codes](/api-solutions/threat-intelligence-api/e - The `description` field was dropped for npm (the title already includes it). - The response body always contains a `vulnerabilities` array, plus either `pagination` (offset mode) or `cursor` (cursor mode). +## Multi-span advisories and the fix to show + +Many npm advisories affect several majors at once. Product lookups (`GET /product/...` and `/batch`) now match the installed version against **every** affected span, not only the lowest one. + +When a version matches, the advisory includes a `matched_range` object beside the existing top-level `fixed_in`: + +| Field | Meaning | +|---|---| +| `matched_range.from_version` | Lower bound of the span that matched the installed version (nullable). | +| `matched_range.to_version` | Upper bound of that span (nullable). | +| `matched_range.to_bound` | How to read `to_version`: `exclusive`, `inclusive`, `last-affected`, or `null` when unrecorded. | +| `matched_range.fixed_in` | The fix for **this** span. Use this when telling a user what to upgrade to. `null` means that span was never fixed. | + +Top-level `fixed_in` / `version_info.fixed` remain the **highest** fix across every span, for backwards compatibility. Prefer `matched_range.fixed_in` for user-facing upgrade advice so a site on `next@13` is not told to jump to a later major. + --- ## Testing diff --git a/src/content/docs/Getting Started/pricing-plans.md b/src/content/docs/Getting Started/pricing-plans.md index 7494823..6fe5411 100644 --- a/src/content/docs/Getting Started/pricing-plans.md +++ b/src/content/docs/Getting Started/pricing-plans.md @@ -4,7 +4,7 @@ title: "Pricing plans" excerpt: "" hidden: false createdAt: "Mon Jul 25 2022 08:58:18 GMT+0000 (Coordinated Universal Time)" -updatedAt: "Sun Jan 14 2024 16:22:28 GMT+0000 (Coordinated Universal Time)" +updatedAt: "Mon Aug 24 2026 00:00:00 GMT+0000 (Coordinated Universal Time)" sidebar: order: 3 badge: @@ -34,7 +34,7 @@ On this plan, by default you can protect up to 25 sites, but it can be extended Best for businesses that require advanced security or maintain high-profile websites. The Enterprise plan offers compliance and security at scale. -The Enterprise plan includes unlimited websites and unlimited team seats. It also includes a signed **Service Level Agreement (SLA)**, a **Data Processing Agreement (DPA)**, **custom billing options**, and **Enterprise-level support**. +The Enterprise plan includes unlimited websites and **unlimited team seats** (there is no seat-invite cap). It also includes a signed **Service Level Agreement (SLA)**, a **Data Processing Agreement (DPA)**, **custom billing options**, and **Enterprise-level support**. ### Enterprise plan pricing diff --git a/src/content/docs/Patchstack App/Account settings/seats.md b/src/content/docs/Patchstack App/Account settings/seats.md index 4bcc78f..d6c5408 100644 --- a/src/content/docs/Patchstack App/Account settings/seats.md +++ b/src/content/docs/Patchstack App/Account settings/seats.md @@ -7,7 +7,7 @@ metadata: image: [] robots: "index" createdAt: "Mon Jul 25 2022 09:21:53 GMT+0000 (Coordinated Universal Time)" -updatedAt: "Thu May 25 2023 12:55:11 GMT+0000 (Coordinated Universal Time)" +updatedAt: "Mon Aug 24 2026 00:00:00 GMT+0000 (Coordinated Universal Time)" sidebar: order: 9.4 --- @@ -18,13 +18,26 @@ To manage your seats and team settings, click on your name on Patchstack App (at On the **Seats** page you can manage the seats. The seat management feature allows you to add sub-users to your account to which you can assign specific permissions and/or sites. When you add a new user, they will receive an email with a link to activate their account. -Available roles +Enterprise plans include **unlimited team seats** (there is no invite cap). -
              1. Owner: Full control of all users and sites of all users, only 1 owner can exist.
              2. -
              3. Admin: Full control of all users and sites of all users, but cannot alter owners or other admins.
              4. -
              5. Manager: Full control of all sites of all users, cannot modify users.
              6. -
              7. Member: Read and write access to sites assigned to this user, cannot modify users or delete sites.
              8. -
              9. Independent: An account that is isolated from the others, only the owner can access its sites. This role can be useful in case you want to have a Patchstack account that inherits the subscription type of the owner but needs to be completely protected from other isolated accounts.
              +## Available roles + +Roles are **two groups, not one ladder**. Owner / Admin / Manager / Operator are positions *within* your account. Customer is a separate, isolated account that sits under yours. + +**Roles in this account** + +1. **Owner** — Full control of all sites and users. Only one owner can exist. +2. **Admin** — Full control of sites and lower-level users. Cannot alter the owner or other admins. +3. **Manager** — Full control of all sites. Cannot modify users. +4. **Operator** — Editing access only to sites assigned to them. Cannot modify users, cannot delete sites, and cannot add new sites. + +**Separate accounts** + +5. **Customer** — An isolated account that inherits your subscription type. The Customer owns and manages their own site(s). Sites you **assign** to a Customer are view-only for them. Customers cannot add sites on your plan. + +:::note[API / stored values] +Integrations that call the team API still send the historical stored values: `member` for Operator and `independent` for Customer. The Patchstack App UI shows the labels above. +::: In order to attach a site to a user, go to **Site** > **Action button** > **Attach To User**. @@ -42,9 +55,9 @@ Note that you can **only add email addresses** that have **not yet registered** After adding the user, you can see the added user in the table below. An invitation will be sent to that email asking to register an account on Patchstack App. -### Attaching a "Member" seat user to sites +### Attaching an Operator seat user to sites -If you assigned a user the "Member" role, you can choose which sites you want to attach this user. +If you assigned a user the **Operator** role, you can choose which sites you want to attach this user. For that, scroll down to the **Sites** table. You can see all your sites in this view. Click on **Action** and **Attach to user** on the corresponding site. diff --git a/src/content/docs/Patchstack App/Reports/scheduling-reports.md b/src/content/docs/Patchstack App/Reports/scheduling-reports.md index 3380a74..894f7c9 100644 --- a/src/content/docs/Patchstack App/Reports/scheduling-reports.md +++ b/src/content/docs/Patchstack App/Reports/scheduling-reports.md @@ -7,7 +7,7 @@ metadata: image: [] robots: "index" createdAt: "Tue Mar 07 2023 11:15:15 GMT+0000 (Coordinated Universal Time)" -updatedAt: "Thu May 25 2023 11:50:46 GMT+0000 (Coordinated Universal Time)" +updatedAt: "Mon Aug 24 2026 00:00:00 GMT+0000 (Coordinated Universal Time)" sidebar: order: 6.2 --- @@ -30,6 +30,8 @@ Reports will be available for downloading on the Reports page. 5. If you are on an **Enterprise plan**, you can also customize some report settings and upload your customer's logo, which will be shown on the reports. 6. Having finished with customizing, click **Create**. +New schedules are **active by default** (they start generating on the next weekly or monthly run). You can pause or edit a schedule later from the **Scheduled reports** tab. + Note that reports are generated at specific times: - Weekly reports are generated every Monday, 02:00 UTC time - Monthly reports are generated every month on 1st, 03:00 UTC time diff --git a/src/content/docs/Patchstack App/Sites/policy.mdx b/src/content/docs/Patchstack App/Sites/policy.mdx index 18385e7..571e390 100644 --- a/src/content/docs/Patchstack App/Sites/policy.mdx +++ b/src/content/docs/Patchstack App/Sites/policy.mdx @@ -3,7 +3,7 @@ title: "Policy" excerpt: "Default site policy" hidden: false createdAt: "Mon Jul 25 2022 09:03:10 GMT+0000 (Coordinated Universal Time)" -updatedAt: "Wed Dec 20 2023 13:36:16 GMT+0000 (Coordinated Universal Time)" +updatedAt: "Mon Aug 24 2026 00:00:00 GMT+0000 (Coordinated Universal Time)" sidebar: order: 4 --- @@ -49,7 +49,7 @@ By default, a lot of the Patchstack hardening features are opt-in which means we ``` ## Considerations -- For team accounts, the leader's policy will always apply, except for "independent" seats as their policy will be applied instead. +- For team accounts, the owner's policy will always apply, except for **Customer** seats — those use the Customer's own policy instead. - The policy can also be programmatically set through the [Patchstack App API](/api-solutions/app-api/patchstack-app-api/). - The policy will only be applied during the first activation of the WordPress plugin. - This avoids overwriting settings that were manually configured in the past. \ No newline at end of file diff --git a/src/content/docs/Patchstack App/Sites/removing-a-site.mdx b/src/content/docs/Patchstack App/Sites/removing-a-site.mdx index 1dac150..a54cea0 100644 --- a/src/content/docs/Patchstack App/Sites/removing-a-site.mdx +++ b/src/content/docs/Patchstack App/Sites/removing-a-site.mdx @@ -4,15 +4,19 @@ title: "Removing a site" excerpt: "" hidden: false createdAt: "Wed Aug 03 2022 11:23:18 GMT+0000 (Coordinated Universal Time)" -updatedAt: "Tue Jan 02 2024 14:19:02 GMT+0000 (Coordinated Universal Time)" +updatedAt: "Mon Aug 24 2026 00:00:00 GMT+0000 (Coordinated Universal Time)" sidebar: order: 2.2 --- -import { Steps } from '@astrojs/starlight/components'; +import { Aside, Steps } from '@astrojs/starlight/components'; Sites can be removed from the **Sites** page in Patchstack App.\ https://app.patchstack.com/sites + + ## Removing a single site To remove one site from Patchstack App, follow these steps: diff --git a/src/content/docs/Patchstack App/Software/software-overview.md b/src/content/docs/Patchstack App/Software/software-overview.md index 4f25d68..f3881f3 100644 --- a/src/content/docs/Patchstack App/Software/software-overview.md +++ b/src/content/docs/Patchstack App/Software/software-overview.md @@ -7,7 +7,7 @@ metadata: image: [] robots: "index" createdAt: "Mon Jul 25 2022 09:05:51 GMT+0000 (Coordinated Universal Time)" -updatedAt: "Mon Nov 13 2023 15:28:43 GMT+0000 (Coordinated Universal Time)" +updatedAt: "Mon Aug 24 2026 00:00:00 GMT+0000 (Coordinated Universal Time)" sidebar: order: 4 --- @@ -17,8 +17,8 @@ Navigate to the software overview page by clicking **Software** from the navigat [https://app.patchstack.com/software/overview](https://app.patchstack.com/software/overview) On the **Software** overview page, you can see the general overview, that shows all the components (plugins, themes, CMS core version, PHP and MySQL versions) that each of your sites use. -The table on this page shows, which of the components are vulnerable and which ones have updates available. -Plugins and themes that are grayed out, are currently deactivated on the website, or cannot be updated via third party apps like Patchstack (like premium licensed software, which use non-standard updating mechanisms). +The table on this page shows which components are vulnerable and which are **outdated** (a newer release exists). +Plugins and themes that are grayed out are currently deactivated on the website, or cannot be updated via third party apps like Patchstack (like premium licensed software, which use non-standard updating mechanisms). ![](@images/patchstack-software.png) @@ -26,4 +26,4 @@ Plugins and themes that are grayed out, are currently deactivated on the website You can update your software on that page. Keep in mind to backup your files and databases before doing that. If you wish to update components individually, you can select those one by one by clicking on the checkbox on the left column. After that, click on **Action** > **Update**. -Your software versions should start updating on your WordPress sites immediately. \ No newline at end of file +Your software versions should start updating on your WordPress sites immediately. diff --git a/src/content/docs/Patchstack App/Upgrades/seats.md b/src/content/docs/Patchstack App/Upgrades/seats.md index df36283..bf956e5 100644 --- a/src/content/docs/Patchstack App/Upgrades/seats.md +++ b/src/content/docs/Patchstack App/Upgrades/seats.md @@ -7,7 +7,7 @@ metadata: image: [] robots: "index" createdAt: "Mon Jul 25 2022 09:07:03 GMT+0000 (Coordinated Universal Time)" -updatedAt: "Thu May 25 2023 13:56:53 GMT+0000 (Coordinated Universal Time)" +updatedAt: "Mon Aug 24 2026 00:00:00 GMT+0000 (Coordinated Universal Time)" sidebar: order: 8.2 --- @@ -22,22 +22,13 @@ To view available plan upgrades, navigate to **Upgrades** in Patchstack App, or Enable this upgrade by clicking on the **Manage** button at the top right corner of this module on the Upgrades page. -- Developer plan comes with 3 free seats included by default. -- Enterprise plan comes with 5 free seats included by default. - -The cost for an extra seat is $24 / month. +- **Developer** plan comes with 3 free seats included by default. Extra seats can be purchased for **$24 / month** each. +- **Enterprise** plan includes **unlimited team seats** — there is no seat-invite cap and no per-seat purchase path. ![](@images/patchstack-upgrades-seats.png) - - - - - - - ### Managing the seat accounts You can manage the seat accounts by navigating to your account settings (click on your name at the bottom left corner) and click on Seats from the top menu. -The help article about how to manage the seat accounts can be [found here.](/patchstack-app/account-settings/team/) +The help article about how to manage the seat accounts can be [found here.](/patchstack-app/account-settings/seats/) diff --git a/src/content/docs/Patchstack App/dashboard.mdx b/src/content/docs/Patchstack App/dashboard.mdx index 3766c9d..cecbc4e 100644 --- a/src/content/docs/Patchstack App/dashboard.mdx +++ b/src/content/docs/Patchstack App/dashboard.mdx @@ -4,7 +4,7 @@ title: "Dashboard" excerpt: "" hidden: false createdAt: "Wed Oct 18 2023 12:41:44 GMT+0000 (Coordinated Universal Time)" -updatedAt: "Tue Dec 12 2023 12:31:21 GMT+0000 (Coordinated Universal Time)" +updatedAt: "Mon Aug 24 2026 00:00:00 GMT+0000 (Coordinated Universal Time)" sidebar: order: 1 --- @@ -38,13 +38,15 @@ You can use the search bar on the dashboard page, to find current vulnerabilitie ![](@images/patchstack-filters.png) -There are three main filters for vulnerability searching on the dashboard: +There are four main filters for vulnerability searching on the dashboard: 1. **Priority filter** - find vulnerabilities by patch priority. You can filter by high, medium and low patch priority vulnerabilities. 2. **Severity filter** - find vulnerabilities by CVSS severity score. You can filter by critical, high, medium, low severity. -3. **Exploited** - filter out the vulnerabilities that are know to be exploited. +3. **Exploited** - filter out the vulnerabilities that are known to be exploited. + +4. **Outdated** - show vulnerabilities where a patched release exists, so the installed version is behind the fix. (This filter was previously labelled "Fix available".) @@ -79,8 +81,8 @@ There are several icons shown on each vulnerability row. Below is a list of what
              - **Update available** - This plugin has an update available. It is recommended to do this immediately as new software versions usually come with patched code (in case it is found vulnerable). + **Outdated (update available)** + This software has a patched release available — the installed version is behind the fix. It is recommended to update immediately. In vulnerability lists and filters this state is labelled **Outdated**.
              diff --git a/src/content/docs/Patchstack Plugin/Patchstack Connector/introduction.md b/src/content/docs/Patchstack Plugin/Patchstack Connector/introduction.md index 4440865..527d654 100644 --- a/src/content/docs/Patchstack Plugin/Patchstack Connector/introduction.md +++ b/src/content/docs/Patchstack Plugin/Patchstack Connector/introduction.md @@ -7,12 +7,14 @@ metadata: image: [] robots: "index" createdAt: "Tue Aug 30 2022 12:07:02 GMT+0000 (Coordinated Universal Time)" -updatedAt: "Wed May 10 2023 12:01:29 GMT+0000 (Coordinated Universal Time)" +updatedAt: "Mon Aug 24 2026 00:00:00 GMT+0000 (Coordinated Universal Time)" sidebar: order: 25 --- The Patchstack connector is used to connect your Drupal site to the Patchstack App. For WordPress, the Patchstack plugin should be installed instead. +Joomla is no longer supported (connector deprecated June 2026; removed from the vulnerability database and VDP search August 2026). See [Joomla support deprecated](/patchstack-plugin/patchstack-connector/joomla-support-deprecated/). + - [WordPress Installation](/patchstack-plugin/plugin-introduction/) -- [Drupal Installation](/patchstack-plugin/patchstack-connector/how-to-install-on-drupal/) \ No newline at end of file +- [Drupal Installation](/patchstack-plugin/patchstack-connector/how-to-install-on-drupal/) diff --git a/src/content/docs/Patchstack Plugin/Patchstack Connector/joomla-support-deprecated.mdx b/src/content/docs/Patchstack Plugin/Patchstack Connector/joomla-support-deprecated.mdx index b314e4c..2cea474 100644 --- a/src/content/docs/Patchstack Plugin/Patchstack Connector/joomla-support-deprecated.mdx +++ b/src/content/docs/Patchstack Plugin/Patchstack Connector/joomla-support-deprecated.mdx @@ -4,6 +4,8 @@ sidebar: hidden: true --- -Joomla support has been deprecated as of **June 18, 2026**. Patchstack now supports WordPress and Drupal. +Joomla support has been deprecated as of **June 18, 2026**. Patchstack App and the Patchstack connector support **WordPress** and **Drupal** only. + +As of **August 2026**, Joomla is also removed from the public vulnerability database search, VDP platform filters, and related partner tooling. Existing Joomla catalog entries were purged; new Joomla sites and products are not accepted. If you were previously using the Patchstack connector for Joomla, no further action is needed. If you have any questions, reach out to us via live chat at the bottom right corner. From 938565c3800fa0f9827f4435b58de0d3f2ca88ce Mon Sep 17 00:00:00 2001 From: Mario Tarosso Date: Thu, 27 Aug 2026 09:10:03 +0100 Subject: [PATCH 37/89] Document what a Pulse site looks like in the app (#66) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The app docs describe a WordPress site throughout. A JavaScript or Node.js app monitored with @patchstack/connect has had its own tabs in the dashboard for months — Packages, Deploy history, Attack surface — and not one of them was written down anywhere. A customer looking at a reachability verdict or an empty attack-surface tab had nothing to read. Four pages under Patchstack App/Pulse: - Overview: how a site gets there without an add-site flow, which tabs exist and which are WordPress-only, and why "last scan" and "last synced" are two different timestamps rather than one that disagrees with itself. - Packages: the npm inventory, and the reachability ladder. This one carries the most weight, because the two verdicts that could be misread as an all-clear are the two that are not: "not imported" only speaks for the app's own imports, and "unknown" means the inventory could not answer. Both say so plainly. - Deploy history: what a build added, removed and moved, why the first build reads as a baseline, and why environments are diffed separately. - Attack surface: that it is empty until `map --upload` is run explicitly, what proven and unproven links mean, and that rule detections are the evidence behind a rule that has not started blocking yet. Two existing pages assumed WordPress and now say otherwise: adding a site points JS/Node readers at the connector and notes they do not need that flow at all, and the Software page points them at Packages. Co-authored-by: Claude Opus 5 (1M context) --- .../Patchstack App/Pulse/attack-surface.md | 52 +++++++++++++++ .../Patchstack App/Pulse/deploy-history.md | 49 ++++++++++++++ .../docs/Patchstack App/Pulse/packages.md | 46 +++++++++++++ .../Patchstack App/Pulse/pulse-overview.md | 64 +++++++++++++++++++ .../Site Dashboard/site-software.mdx | 4 ++ .../Patchstack App/Sites/adding-a-site.mdx | 4 +- 6 files changed, 218 insertions(+), 1 deletion(-) create mode 100644 src/content/docs/Patchstack App/Pulse/attack-surface.md create mode 100644 src/content/docs/Patchstack App/Pulse/deploy-history.md create mode 100644 src/content/docs/Patchstack App/Pulse/packages.md create mode 100644 src/content/docs/Patchstack App/Pulse/pulse-overview.md diff --git a/src/content/docs/Patchstack App/Pulse/attack-surface.md b/src/content/docs/Patchstack App/Pulse/attack-surface.md new file mode 100644 index 0000000..d18e469 --- /dev/null +++ b/src/content/docs/Patchstack App/Pulse/attack-surface.md @@ -0,0 +1,52 @@ +--- +title: "Attack surface" +excerpt: "A map of a Pulse app's entry points, the inputs they read and where those inputs can reach — and what Patchstack does with it." +hidden: false +createdAt: "Thu Aug 27 2026 00:00:00 GMT+0000 (Coordinated Universal Time)" +updatedAt: "Thu Aug 27 2026 00:00:00 GMT+0000 (Coordinated Universal Time)" +sidebar: + order: 4 + label: "Attack surface" +--- + +The **Attack surface** tab describes the shape of your application: its entry points, the inputs each one reads, the sensitive operations those inputs can reach, and which of those links Patchstack could actually prove. + +It is the input to two things you see elsewhere — the reachability verdicts on [Packages](/patchstack-app/pulse/packages/), and the protection rules Patchstack can pin to a specific place in your app rather than applying broadly. + +## Uploading a map + +This tab is empty until you upload a map. Unlike the dependency scan, it is not part of `setup` and never runs on its own — it sends a structural description of your app, so it is an explicit choice: + +```bash +npx @patchstack/connect map --upload +``` + +Run it at build time, in the environment you want described. Without `--upload` the command prints the map as JSON instead, so you can see exactly what would be sent before sending anything. + +The analysis uses your project's own TypeScript and reads source only. No source code leaves the machine — what is uploaded is the structure it found: routes, input names, the kinds of operation reachable from them. + +## Revisions + +Maps are kept as revisions. Uploading an identical map updates the current revision's timestamp; uploading a changed one is stored alongside the previous. The header shows which revision you are reading, the framework and analyser that produced it, when it was first reported, and when it was last seen unchanged. + +## What the map claims, and what it does not + +This is best-effort static analysis. It reports the surface it **detected**, and it is explicit about its own gaps rather than presenting a partial picture as a complete one: + +- Links between an input and a sensitive operation are marked **proven** or **unproven**. A proven link is one the analyser traced; an unproven one is a suspicion it could not establish. +- **Analysis coverage** and **analyser notes** record what could not be modelled — dynamic property access, computed `require`, reflection, and similar patterns that no amount of parsing resolves. +- A dependency inventory that could not be completed says **"This inventory is incomplete"** rather than quietly reporting fewer dependencies. + +That last point is what keeps the [reachability verdicts](/patchstack-app/pulse/packages/#reachability) honest. "Not imported" is only claimed against an inventory known to be complete; otherwise the verdict is "unknown". + +## Rule readiness and addressability + +**Rule readiness** shows how much of the surface is described precisely enough for Patchstack to generate a protection rule aimed at one endpoint, rather than a broad rule applied to the whole app. + +**Addressability** is the underlying question: can this entry point be named in a way a rule can match at runtime? An entry point the analyser found but cannot address is still shown — it just cannot be individually protected yet, and the tab says what would settle it. + +## Rule detections + +The same tab shows what the [runtime guard](/getting-started/installing-patchstack/installing-on-javascript-node-projects/) has matched: every rule that fired, including matches it allowed through rather than blocked. + +Detections that were not blocked are the useful part. A newly generated rule starts in detect-only mode, and these entries are the evidence used to decide whether it should start blocking — so you can see what a rule would have done before it does it. diff --git a/src/content/docs/Patchstack App/Pulse/deploy-history.md b/src/content/docs/Patchstack App/Pulse/deploy-history.md new file mode 100644 index 0000000..243c4ca --- /dev/null +++ b/src/content/docs/Patchstack App/Pulse/deploy-history.md @@ -0,0 +1,49 @@ +--- +title: "Deploy history" +excerpt: "A per-build changelog of what each deploy added, removed or moved in a Pulse app's dependencies." +hidden: false +createdAt: "Thu Aug 27 2026 00:00:00 GMT+0000 (Coordinated Universal Time)" +updatedAt: "Thu Aug 27 2026 00:00:00 GMT+0000 (Coordinated Universal Time)" +sidebar: + order: 3 + label: "Deploy history" +--- + +**Deploy history** turns the manifests your builds report into a changelog: for each build, what it added, what it removed, what changed version, and whether anything it brought in was already known to be vulnerable. + +The [Packages](/patchstack-app/pulse/packages/) tab answers "what is installed now". It cannot answer "when did this arrive" — which is the question that matters when an app's dependencies were chosen by an AI coding tool rather than picked deliberately. + +## Reading a build + +Each entry shows the packages that build changed, grouped three ways: + +- **Added** — packages that were not installed before this build. +- **Changed** — packages whose version moved. Marked *upgraded*, *downgraded*, or *mixed*. Mixed means the set of installed versions moved without going one direction: a version was added alongside an existing one, or two versions swapped for two others. +- **Removed** — packages that were installed before this build and are not now. + +Two entries look different on purpose: + +- **The first recorded build** is shown as a baseline, not as several hundred additions. An initial scan would otherwise bury every real change beneath it. +- **A build that changed nothing** says so. Patchstack records a build whenever the reported package set differs from the one before it, so a build with no dependency change is a meaningful, quiet entry rather than a missing one. + +## Vulnerability notes + +Only the versions a build *introduced* are checked against vulnerability data — the additions, plus the landing versions of any change. + +Packages that were already installed are the Packages tab's job. Re-flagging them here would turn a changelog into a second, noisier copy of that list. + +So a build annotated with a vulnerability is telling you something specific: this deploy is what brought the problem in. + +## Environments + +Builds are grouped by environment, and a build is only ever compared against the build before it **in the same environment**. + +This matters if you scan from more than one place. Production and sandbox builds interleave freely in time, so diffing across them would report your sandbox package set as production churn and vice versa. Keeping the lineages separate is what makes the diff mean anything. + +With no environment selected, the view follows the site's most recent build, so an app that only ever scans from a sandbox still gets a real timeline. + +You can set the environment a scan reports as with `PATCHSTACK_ENVIRONMENT`, or `environment` in `.patchstackrc.json`. It defaults to `production`. + +## When it is empty + +"No builds recorded yet" means the app has not reported a package manifest. Run a build, or run `npx @patchstack/connect scan` directly, and the first entry appears as a baseline. diff --git a/src/content/docs/Patchstack App/Pulse/packages.md b/src/content/docs/Patchstack App/Pulse/packages.md new file mode 100644 index 0000000..77b467c --- /dev/null +++ b/src/content/docs/Patchstack App/Pulse/packages.md @@ -0,0 +1,46 @@ +--- +title: "Packages" +excerpt: "The npm packages a Pulse app has installed, which are vulnerable, and how close each vulnerability is to code the app runs." +hidden: false +createdAt: "Thu Aug 27 2026 00:00:00 GMT+0000 (Coordinated Universal Time)" +updatedAt: "Thu Aug 27 2026 00:00:00 GMT+0000 (Coordinated Universal Time)" +sidebar: + order: 2 + label: "Packages" +--- + +The **Packages** tab lists every npm package the app has installed, with its version and whether Patchstack knows of a vulnerability in it. It answers "what is installed right now" — for "when did this arrive", see [Deploy history](/patchstack-app/pulse/deploy-history/). + +The list comes from the dependency manifest the connector sends during your build, so it includes transitive dependencies, not only the ones named in your `package.json`. + +## Reachability + +A modern app installs hundreds of packages it never calls. A vulnerability in one of those is not the same problem as a vulnerability in a package your request handlers use directly, and treating them alike buries the second under the first. + +If you have uploaded an [attack-surface map](/patchstack-app/pulse/attack-surface/), Patchstack labels each finding with how close it is to code your app actually runs: + +| Verdict | What it means | +|---------|---------------| +| **Reachable** | A path through your code reaches this package at a point Patchstack can model, on evidence strong enough to generate a protection rule pinned to that location. | +| **API called** | Your app calls one of this package's functions. Package-level, not advisory-level: it means you use the package, not necessarily the vulnerable function. | +| **Imported** | Your app imports the package. Nothing is claimed about whether the vulnerable code is reached — usually there is no model of it, so Patchstack did not look. | +| **Not imported** | The package is absent from a complete inventory of what your app imports. It arrived as somebody else's dependency. | +| **Unknown** | No map has been uploaded, or the map is too old or too incomplete to answer. | + +Read these as a prioritisation order, not a verdict on exploitability. + +**"Not imported" is not an all-clear.** It is the only negative verdict here, and it still only says your own code does not import the package — a framework you do use can call it on your behalf. Treat it as "look at this last", not "ignore this". + +**"Unknown" is deliberately distinct from "not imported".** Absence is only evidence when the inventory is known to be complete. When Patchstack cannot tell, it says so rather than guessing in your favour. + +One limitation worth knowing: the dependency manifest and the attack-surface map are uploaded separately, and nothing currently ties them to the same build. A verdict is computed against the most recent map Patchstack holds, which may describe an older build than the manifest that produced the finding. Each verdict records which map revision answered it. + +## Acting on a vulnerable package + +Upgrading the package is the fix. Patchstack shows the versions that resolve the advisory so you can pick a target. + +Where an upgrade is not immediately possible, the [runtime guard](/getting-started/installing-patchstack/installing-on-javascript-node-projects/) can block attempts to exploit the vulnerability in the meantime. That is a stopgap that buys you time, not a substitute for the upgrade. + +## Why a package can appear twice + +npm allows the same package to be installed at more than one version at once, when two dependencies need incompatible versions. When that happens the package appears once per installed version, because the vulnerability status of each version is genuinely different. diff --git a/src/content/docs/Patchstack App/Pulse/pulse-overview.md b/src/content/docs/Patchstack App/Pulse/pulse-overview.md new file mode 100644 index 0000000..7f0570e --- /dev/null +++ b/src/content/docs/Patchstack App/Pulse/pulse-overview.md @@ -0,0 +1,64 @@ +--- +title: "Pulse sites overview" +excerpt: "How JavaScript and Node.js apps appear in the Patchstack App, and how they differ from WordPress sites." +hidden: false +createdAt: "Thu Aug 27 2026 00:00:00 GMT+0000 (Coordinated Universal Time)" +updatedAt: "Thu Aug 27 2026 00:00:00 GMT+0000 (Coordinated Universal Time)" +sidebar: + order: 1 + label: "Pulse overview" +--- + +**Pulse** is how Patchstack monitors JavaScript and Node.js applications. Where a WordPress site is monitored by the Patchstack plugin running inside WordPress, a Pulse site is monitored by [`@patchstack/connect`](/getting-started/installing-patchstack/installing-on-javascript-node-projects/), an npm package that runs during your build. + +That difference in mechanism is why a Pulse site's dashboard does not look like a WordPress site's. This page explains what you get instead. + +## Getting a site into the dashboard + +Install the connector in your project and run `setup`. The first scan creates the site for you — there is no "add site" step to do first, and no API key to paste. + +The site starts out **unclaimed**: it is being monitored, but it is not attached to anyone's account, so nobody can see its reports. `setup` prints a dashboard link. Open it, sign in, and the site attaches to your account. If you lose the link, `npx @patchstack/connect status` prints it again. + +An unclaimed site that nobody ever claims is cleaned up after a reminder period, so claim it while you are thinking about it. + +## What the tabs show + +A Pulse site gets a smaller set of tabs than a WordPress site, because several of them describe things only WordPress has. + +| Tab | What it tells you | +|-----|-------------------| +| **Overview** | The vulnerabilities found in this app's dependencies, and whether the app is connected and reporting. | +| **[Packages](/patchstack-app/pulse/packages/)** | Every npm package the app has installed, which are vulnerable, and how close each vulnerability is to code the app actually runs. | +| **[Deploy history](/patchstack-app/pulse/deploy-history/)** | What each build changed about the installed packages, and whether it brought in anything already known to be vulnerable. | +| **[Attack surface](/patchstack-app/pulse/attack-surface/)** | The app's entry points, the inputs they read, and where those inputs can reach. Populated only if you run `map --upload`. | +| **Protection** | Rules protecting the app's vulnerable packages at runtime, and what they have matched. | +| **Settings** | Site name, group, and removal. | + +Hardening, Activity, and Users are WordPress-only and do not appear. Reports currently cover WordPress sites; a Pulse site's security-report page hides the sections that do not apply. + +## Connected, scanned, and synced + +The site header shows two different timestamps, and they answer different questions: + +- **Last scan** — when the connector last sent a dependency manifest. This moves when you build or install dependencies. +- **Last synced** — when Patchstack last had any contact with the site at all. + +They differ because Patchstack learns about a Pulse site from more than one signal. The connector reports at build time. The disclosure widget in your served pages checks in when a visitor loads the site, which is how Patchstack knows the app is actually live and running the build you last reported. Patchstack also re-fetches the published page on a schedule to confirm the widget is still there. + +An app that builds rarely but gets traffic will show an old scan time and a recent sync. That is normal, not a fault. + +Because the widget check-in runs in a public page, Patchstack treats it as corroboration rather than proof — a site's connection status is derived from what can be verified, not from the check-in alone. + +## Protection + +Reporting your dependencies tells you what is vulnerable. The **runtime guard** installed by `setup` is what stops those vulnerabilities being exploited while you upgrade — the JavaScript equivalent of the virtual patching Patchstack applies to WordPress sites. + +The guard fetches the rules Patchstack generated for the vulnerable packages this site actually has, and reports every rule that matched, including matches it allowed through. A new rule starts in detect-only mode and begins blocking once the evidence justifies it, so protection does not arrive as a wall of false positives. + +Runtime protection on a production Pulse app is a paid feature. See [The runtime guard](/getting-started/installing-patchstack/installing-on-javascript-node-projects/) for what `setup` installs and which frameworks are wired automatically. + +## Removing a site + +Run `npx @patchstack/connect uninstall` in the project before deleting anything locally — it needs the site's credential, so it has to run while that credential still exists. A claimed site is flagged for you to confirm in the dashboard; an unclaimed one is deleted outright. + +If you remove the package without that step, Patchstack finds out the next time it re-checks the published page, and the site is marked disconnected rather than removed. The full checklist is in [Uninstalling](/getting-started/installing-patchstack/installing-on-javascript-node-projects/#uninstalling). diff --git a/src/content/docs/Patchstack App/Site Dashboard/site-software.mdx b/src/content/docs/Patchstack App/Site Dashboard/site-software.mdx index 36b9275..f81aaec 100644 --- a/src/content/docs/Patchstack App/Site Dashboard/site-software.mdx +++ b/src/content/docs/Patchstack App/Site Dashboard/site-software.mdx @@ -20,6 +20,10 @@ To see an overview of all your site's software, navigate to **Sites** > **yourdo On the this software subpage, you can also manage the software components of your WordPress site. + + The following actions are available only for WordPress CMS: diff --git a/src/content/docs/Patchstack App/Sites/adding-a-site.mdx b/src/content/docs/Patchstack App/Sites/adding-a-site.mdx index 29c271d..8d87a2e 100644 --- a/src/content/docs/Patchstack App/Sites/adding-a-site.mdx +++ b/src/content/docs/Patchstack App/Sites/adding-a-site.mdx @@ -18,10 +18,12 @@ Adding a site to Patchstack is relatively easy. Here is a simple guide on how to 2. Click on **+ Add new** button. ![](@images/patchstack-sites-add-new.png) 3. Type your domain name into the popup and choose your platform: ![](@images/patchstack-add-first-site-dialogue.png) 4. Click on **Continue to plugin/connector sync**. -5. In case you chose WordPress, continue with the steps below. If you chose a different platform, check Drupal instructions +5. In case you chose WordPress, continue with the steps below. For other platforms, follow the guide for the one you picked: Drupal instructions, or JavaScript / Node.js instructions 6. You will be taken to the next step, where you can follow the next instructions. ![](@images/patchstack-checking-sync-status.png) 7. Click **Download latest plugin** 8. Upload the plugin .zip file to your WordPress site by visiting /wp-admin > Plugins > Add New > Upload Plugin 9. Activate the plugin
              +**JavaScript and Node.js projects do not need this flow.** Installing [`@patchstack/connect`](/getting-started/installing-patchstack/installing-on-javascript-node-projects/) and running `setup` creates the site for you on its first scan, then prints a link that attaches it to your account. See [Pulse sites overview](/patchstack-app/pulse/pulse-overview/) for what those sites look like in the app. + If you need further help, don't hesitate to reach out to us via live chat at the bottom right corner! \ No newline at end of file From 90e6c77e6771de6c217698078073a3bd99b93d1a Mon Sep 17 00:00:00 2001 From: Mario Tarosso Date: Mon, 7 Sep 2026 11:23:45 +0100 Subject: [PATCH 38/89] [ENG-3802] Add JS/Node troubleshooting page for the widget and connector (#70) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The widget's Common Issues tab is being removed (ENG-3802). Its content moves here, where it has room to work and — crucially — can be read by someone whose widget never appeared. The tab could not solve its own primary use case: the answer to "my widget is not visible" was behind the widget. That case now leads the page, starting with the two facts you cannot learn from inside a widget you cannot see — the visitor button is off by default, and #patchstack opens the owner log-in on a live build. The four builder prompts carry over verbatim; the per-platform context is lifted out of the 4x4 matrix into one snippet you prepend. Co-authored-by: Claude Opus 5 --- .../installing-on-javascript-node-projects.md | 6 + ...oubleshooting-javascript-node-projects.mdx | 212 ++++++++++++++++++ 2 files changed, 218 insertions(+) create mode 100644 src/content/docs/Getting Started/Installing Patchstack/troubleshooting-javascript-node-projects.mdx diff --git a/src/content/docs/Getting Started/Installing Patchstack/installing-on-javascript-node-projects.md b/src/content/docs/Getting Started/Installing Patchstack/installing-on-javascript-node-projects.md index a985d1f..a593393 100644 --- a/src/content/docs/Getting Started/Installing Patchstack/installing-on-javascript-node-projects.md +++ b/src/content/docs/Getting Started/Installing Patchstack/installing-on-javascript-node-projects.md @@ -65,6 +65,8 @@ Frameworks without a static HTML shell need a one-line placement in the root lay To run without the widget, set `"widget": false` in `.patchstackrc.json` — this disables all widget management; otherwise the next scan re-adds the tag. +The floating button is **hidden by default**: it appears only when the widget is told to show it, via `data-report-form="true"` on the script tag or the widget's own Settings. To reach your dashboard while the button is hidden, open any page of your site with `#patchstack` appended to the URL. See [Troubleshooting JS / Node.js](/getting-started/installing-patchstack/troubleshooting-javascript-node-projects/) if the widget still does not appear. + ## The `protect` command The package also ships an **opt-in** `protect` command: a runtime exploit guard, currently for TanStack Start + Supabase applications, which patches the app's Supabase client to route traffic through a same-origin guard. It modifies application code and runs **only** when explicitly invoked — `setup`, `scan`, `guide`, `status`, and `mark-build` never invoke it. If you don't run `protect`, no application code is changed beyond the widget tag and `package.json` scripts described above. @@ -86,6 +88,10 @@ The package also ships an **opt-in** `protect` command: a runtime exploit guard, Reporting stops immediately. Local removal does not delete the site record on Patchstack's side: an unclaimed site is an anonymous record that stops receiving reports; a claimed site can be removed in the dashboard at https://app.patchstack.com. +## Troubleshooting + +A widget that never appears, a published site serving an old build, a broken config file, or a connector stuck on an old version are all covered — with copy-paste prompts for AI site builders — in [Troubleshooting JavaScript / Node.js projects](/getting-started/installing-patchstack/troubleshooting-javascript-node-projects/). + ## How this relates to host-level npm protection Hosting partners can enable npm vulnerability intelligence for the sites they host through the partner-level [Threat Intelligence API npm features](/api-solutions/threat-intelligence-api/npm-features/). That integration is applied by the host at the infrastructure level. `@patchstack/connect` is the complementary self-service path: developers install it directly into their own projects, whether or not their host is a Patchstack partner. Both feed the same vulnerability database. diff --git a/src/content/docs/Getting Started/Installing Patchstack/troubleshooting-javascript-node-projects.mdx b/src/content/docs/Getting Started/Installing Patchstack/troubleshooting-javascript-node-projects.mdx new file mode 100644 index 0000000..228899a --- /dev/null +++ b/src/content/docs/Getting Started/Installing Patchstack/troubleshooting-javascript-node-projects.mdx @@ -0,0 +1,212 @@ +--- +title: "Troubleshooting JavaScript / Node.js projects" +excerpt: "Fix a disclosure widget that never appears, a published build that serves an old integration, a broken config file, or an outdated @patchstack/connect — including prompts to paste into an AI site builder." +hidden: false +createdAt: "Mon Sep 07 2026 00:00:00 GMT+0000 (Coordinated Universal Time)" +updatedAt: "Mon Sep 07 2026 00:00:00 GMT+0000 (Coordinated Universal Time)" +sidebar: + order: 7.4 + label: "Troubleshooting JS / Node.js" +--- + +import { Steps, Aside } from '@astrojs/starlight/components'; + +This page covers the problems that come up after connecting a JavaScript or Node.js project with [`@patchstack/connect`](/getting-started/installing-patchstack/installing-on-javascript-node-projects/): a disclosure widget that never appears, a published site still serving an old integration, a build that broke after a config change, and a connector stuck on an old version. + +Every section ends with a **prompt you can paste into your site builder's AI chat**. The prompts are deliberately explicit about proving the result, because builder assistants otherwise tend to report the version they remember, or stop after editing one file. + + + +## Tell your builder what project this is + +AI builders differ in which package manager they use and which controls they expose. Prepend the snippet for your platform to any prompt below. + +**Lovable** + +```text +This is a Lovable project. Inspect the existing lockfile before installing +anything. Lovable projects often use Bun; if bun.lock or bun.lockb exists, use +Bun and do not create a package-lock.json beside it. +``` + +**GoDaddy Airo** + +```text +This is a GoDaddy Airo project. Make the changes in the project workspace and +use its existing package manager. If Airo does not expose the required install +or build control, tell me exactly which step is unavailable instead of +reporting that the task is complete. +``` + +**Hostinger Horizons** + +```text +This is a Hostinger Horizons project. Use its existing package manager and allow +the dependency install and full production build to finish before checking the +result; do not treat a slow build as a failed one. +``` + +**Anything else, or not sure** + +```text +First identify this project's package manager from its lockfile and use that +same package manager for every command. Do not create a second lockfile. +``` + +## The widget is not visible on my site + +The floating **Report a vulnerability** button is hidden by default. If you installed the connector and never saw it, that is usually the reason rather than a broken install — work through these in order. + + + +1. **Turn the public form on.** The visitor-facing button only appears when the widget is told to show it, either through the script tag: + + ```html + + ``` + + or from **Settings → Reporting → Display vulnerability reporting form** inside the widget itself. + +2. **Open the widget as the site owner.** You do not need the public button to reach your own dashboard. Load any page of your site with `#patchstack` appended to the URL: + + ```text + https://your-site.com/#patchstack + ``` + + That reveals the owner log-in even on a live production build, and it works from any device or network. `?patchstack` in the query string does the same thing. + +3. **Check the script tag actually shipped.** View source on the published page (not the builder preview) and confirm there is exactly one script loading `https://cdn.patchstack.com/patchstack-widget.js`, with `data-site-uuid` set to the UUID from your committed `.patchstackrc.json`. + +4. **Check the site UUID is a literal value.** The UUID must be written into the HTML. Reading it from `VITE_*`, `NEXT_PUBLIC_*`, or another environment-only variable that is not defined at build time leaves the attribute empty and the widget silent. The site UUID is public by design — it ships in client-side HTML and is not a secret. + +5. **Check the widget was not disabled.** `"widget": false` in `.patchstackrc.json` turns off all widget management, and the next `scan` will not re-add the tag. + +6. **Check the browser console.** A Content Security Policy that omits `cdn.patchstack.com` from `script-src`, or a content blocker, will stop the script from loading. Both show up as an error on the live page. + + + + + +### Prompt: widget missing after publish + +Use this when the widget works in the builder preview but is absent from the published site. + +```text +Please diagnose why the Patchstack widget works in preview but is missing from +the published site. + +1. Use the latest @patchstack/connect release from npm. +2. Confirm the root page contains exactly one connector-managed script from + https://cdn.patchstack.com/patchstack-widget.js with data-site-uuid set from + the public .patchstackrc.json value. +3. Do not read the site UUID from VITE_*, NEXT_PUBLIC_*, or another + environment-only variable. +4. Run the connector setup/scan flow and the complete production build, + including mark-build where the project scripts require it. +5. Inspect the generated production output — not only source files — and verify + that the widget script and window.__PATCHSTACK_PROD__ marker are present. +6. Publish that verified output, then check the live page and browser console + for the first concrete error. + +Please make the fix and show the production evidence. Thank you. +``` + +## The published widget still looks outdated + +Your source can be correct while the builder or CDN is still serving an older artifact. Confirm the live URL — not the preview — is loading the current script, and compare the version the widget reports in each. + +The widget shows its version in the owner dashboard. If preview and live disagree, the deployment is stale, not the code. + +```text +Please verify that the published site is actually serving the newest Patchstack +integration rather than an older build artifact. + +1. Confirm @patchstack/connect matches the current npm registry version, + including releases from the last 24 hours. +2. Confirm the site loads the Patchstack CDN script rather than a copied local + patchstack-widget.js file. +3. Run a clean production build through the project's normal build command and + wait for it to finish. +4. Republish the new output and invalidate only the relevant builder/deployment + cache if the platform exposes that control. +5. On the live URL, inspect the Network response for patchstack-widget.js and + the version shown by the widget. Compare that with preview and report both + values. + +Please do not stop at a source-code check; verify the live deployment. +Thank you. +``` + +## Is this the latest connector version? + +Site builders often resolve `@patchstack/connect` from cached package metadata and land on an older release. Check what npm actually has: + +```bash +npm view @patchstack/connect version +``` + +Then compare it against what is installed. If they differ, install `@patchstack/connect@latest` with the package manager that matches your lockfile. + +```text +Please update @patchstack/connect from the official npm registry. Use the +latest version available right now, including a release published within the +last 24 hours. Please do not rely on a remembered or cached version. + +1. Query npm for the current dist-tag with: npm view @patchstack/connect version. +2. Install @patchstack/connect@latest as a regular dependency with the package + manager already used by this project. +3. Confirm the exact installed version using the package manager and + @patchstack/connect --version. +4. Run the project's complete production build. +5. Tell me the registry version, installed version, files changed, and final + build result. Do not say it is current unless the two versions match. + +Please make the changes and verify them. Thank you. +``` + +## The build broke after a config update + +The connector uses two config files with different jobs, and mixing them up breaks the build: + +| File | Commit it? | Holds | +|------|-----------|-------| +| `.patchstackrc.json` | Yes | The public `siteUuid` and non-secret settings such as `widget` | +| `.patchstackrc.local.json` | No — gitignore it | `apiKey` only | + +The API key can also come from the `PATCHSTACK_API_KEY` environment variable. Never import it into browser code and never move it into the public config. + +```text +Please diagnose and fix the Patchstack build after the config-file update. + +1. Update @patchstack/connect to the latest npm version first, even if it was + released within the last 24 hours. +2. Search the entire project for .patchstackrc.json and + .patchstackrc.local.json, including build scripts and generated integration + code. +3. Keep the public siteUuid and non-secret settings in committed + .patchstackrc.json. +4. Keep apiKey only in gitignored .patchstackrc.local.json or + PATCHSTACK_API_KEY. Never import that secret into browser code or move it + into the public config. +5. Fix any stale code path that still expects the credential only in + .patchstackrc.json, while preserving the site UUID. +6. Run Patchstack status, scan, and the complete production build. Report the + root cause, exact files changed, and build output. + +Please complete and verify the fix. Thank you. +``` + +## Still stuck? + +- `npx @patchstack/connect guide` prints a project-aware checklist of what is present and what is missing. +- `npx @patchstack/connect status` re-prints the site UUID and dashboard link. +- [Pulse sites overview](/patchstack-app/pulse/pulse-overview/) explains what a connected site looks like in the Patchstack App, including how to tell whether it is reporting. From 5c0dd7809e8003d1cd4371b78a313be2719f8a5a Mon Sep 17 00:00:00 2001 From: Mario Tarosso Date: Mon, 7 Sep 2026 11:52:17 +0100 Subject: [PATCH 39/89] Match the tidied-up Pulse site header (#71) The site page now carries one timestamp, Last scan, with the last contact time in its tooltip when the two are far enough apart to be worth naming. The Overview tab's own description was also out of date: connection state moved to the header, and the tab now leads with whether protection is active. Co-authored-by: Claude Opus 5 (1M context) --- .../docs/Patchstack App/Pulse/pulse-overview.md | 11 ++++------- 1 file changed, 4 insertions(+), 7 deletions(-) diff --git a/src/content/docs/Patchstack App/Pulse/pulse-overview.md b/src/content/docs/Patchstack App/Pulse/pulse-overview.md index 7f0570e..f806426 100644 --- a/src/content/docs/Patchstack App/Pulse/pulse-overview.md +++ b/src/content/docs/Patchstack App/Pulse/pulse-overview.md @@ -27,7 +27,7 @@ A Pulse site gets a smaller set of tabs than a WordPress site, because several o | Tab | What it tells you | |-----|-------------------| -| **Overview** | The vulnerabilities found in this app's dependencies, and whether the app is connected and reporting. | +| **Overview** | Whether protection is active, the vulnerabilities found in this app's dependencies, and how many packages are installed. | | **[Packages](/patchstack-app/pulse/packages/)** | Every npm package the app has installed, which are vulnerable, and how close each vulnerability is to code the app actually runs. | | **[Deploy history](/patchstack-app/pulse/deploy-history/)** | What each build changed about the installed packages, and whether it brought in anything already known to be vulnerable. | | **[Attack surface](/patchstack-app/pulse/attack-surface/)** | The app's entry points, the inputs they read, and where those inputs can reach. Populated only if you run `map --upload`. | @@ -38,14 +38,11 @@ Hardening, Activity, and Users are WordPress-only and do not appear. Reports cur ## Connected, scanned, and synced -The site header shows two different timestamps, and they answer different questions: +The site header shows **Last scan** — when the connector last sent a dependency manifest. This moves when you build or install dependencies, and it is how old the package data on the page is. -- **Last scan** — when the connector last sent a dependency manifest. This moves when you build or install dependencies. -- **Last synced** — when Patchstack last had any contact with the site at all. +Hover it and Patchstack also tells you when it last had any contact with the site, whenever that is much more recent than the scan. The two differ because Patchstack learns about a Pulse site from more than one signal. The connector reports at build time. The disclosure widget in your served pages checks in when a visitor loads the site, which is how Patchstack knows the app is actually live and running the build you last reported. Patchstack also re-fetches the published page on a schedule to confirm the widget is still there. -They differ because Patchstack learns about a Pulse site from more than one signal. The connector reports at build time. The disclosure widget in your served pages checks in when a visitor loads the site, which is how Patchstack knows the app is actually live and running the build you last reported. Patchstack also re-fetches the published page on a schedule to confirm the widget is still there. - -An app that builds rarely but gets traffic will show an old scan time and a recent sync. That is normal, not a fault. +An app that builds rarely but gets traffic will show an old scan time and recent contact. That is normal, not a fault. Because the widget check-in runs in a public page, Patchstack treats it as corroboration rather than proof — a site's connection status is derived from what can be verified, not from the check-in alone. From d2a4ebfd5be7a3f437dec4eb51bec314e1844e83 Mon Sep 17 00:00:00 2001 From: Danilo Radovic Date: Mon, 7 Sep 2026 14:37:38 +0200 Subject: [PATCH 40/89] Point report downloads at the Download action in the row (#72) The Reports table no longer has a download-icon column on the left. Each report row now ends with a Download action, so describe that instead. --- src/content/docs/Patchstack App/Reports/generating-reports.md | 4 ++-- src/content/docs/Patchstack App/Reports/reports-overview.md | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/src/content/docs/Patchstack App/Reports/generating-reports.md b/src/content/docs/Patchstack App/Reports/generating-reports.md index 6b4d516..5f41bc1 100644 --- a/src/content/docs/Patchstack App/Reports/generating-reports.md +++ b/src/content/docs/Patchstack App/Reports/generating-reports.md @@ -20,7 +20,7 @@ To view and generate the Patchstack security reports, navigate to **Reports** li 1. Go to the **Reports** page in the Patchstack App 2. Click on the **Site** dropdown and choose your site 3. Click the green **Generate** button -4. The report is generated and you can download it, by clicking the download icon in the table below +4. The report is generated and you can download it by clicking **Download** at the right end of its row in the table below Read more about the **[Snapshot reports](/patchstack-app/reports/snapshot-report/)** here. @@ -33,6 +33,6 @@ _This feature is only for the Developer and Enterprise plan users_ 3. From the second dropdown choose **Developer report** 4. From the third dropdown, select the timeframe for which you want your report 5. Click the green **Generate** button -6. The report will be generated in a few minutes. Once ready, you can download it by clicking the download icon in the table below. +6. The report will be generated in a few minutes. Once ready, you can download it by clicking **Download** at the right end of its row in the table below. Read more about the **[Developer reports](/patchstack-app/reports/developer-report/)** here. diff --git a/src/content/docs/Patchstack App/Reports/reports-overview.md b/src/content/docs/Patchstack App/Reports/reports-overview.md index a0eb24b..d08abcb 100644 --- a/src/content/docs/Patchstack App/Reports/reports-overview.md +++ b/src/content/docs/Patchstack App/Reports/reports-overview.md @@ -26,6 +26,6 @@ Patchstack has 2 different types of reports available: This is a periodic security report about the situation on the website, with security suggestions and improvements. Developer report generation is available for the Developer and Enterprise plan users only. Developer reports can be scheduled to be auto-generated monthly, or weekly. On the **Reports** page you can view and download all the previously generated PDF reports. -To download a report, click on the download icon that is located at the left side of the table. +To download a report, click **Download** at the right end of its row. To view and manage your scheduled reports, click on **Scheduled reports** tab. Note that report scheduling is for the Developer and Enterprise plan users. From 92e02f33929c2aa4f1e6109992d24610f9f9804e Mon Sep 17 00:00:00 2001 From: Mario Tarosso Date: Tue, 8 Sep 2026 09:18:36 +0100 Subject: [PATCH 41/89] Document the Pulse deploy status (#74) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Building and deploying are separate events, and the app now says which build is actually serving traffic. Adds a section to the Pulse overview covering every state the header can show, how quickly each updates, and why the first build Patchstack sees is left undated — plus a short note on the Deploy history page, where the newest entry in the list is not automatically the live one. Companion to the SaaS change. Co-authored-by: Claude Opus 5 --- .../Patchstack App/Pulse/deploy-history.md | 8 ++++++ .../Patchstack App/Pulse/pulse-overview.md | 26 +++++++++++++++++++ 2 files changed, 34 insertions(+) diff --git a/src/content/docs/Patchstack App/Pulse/deploy-history.md b/src/content/docs/Patchstack App/Pulse/deploy-history.md index 243c4ca..4e7dca6 100644 --- a/src/content/docs/Patchstack App/Pulse/deploy-history.md +++ b/src/content/docs/Patchstack App/Pulse/deploy-history.md @@ -34,6 +34,14 @@ Packages that were already installed are the Packages tab's job. Re-flagging the So a build annotated with a vulnerability is telling you something specific: this deploy is what brought the problem in. +## Which build is live + +The page header carries the same deploy status as the site header: which of the builds below is the one serving traffic right now. The list is a record of builds, and the newest entry in it is not automatically the live one. + +Where a newer build was scanned but never shipped, the page says so directly — the timeline alone cannot, because a build that never went out looks exactly like one that did. See [when the site was last deployed](/patchstack-app/pulse/pulse-overview/#when-the-site-was-last-deployed). + +The status describes production only, so it is hidden while you are looking at the sandbox lineage. + ## Environments Builds are grouped by environment, and a build is only ever compared against the build before it **in the same environment**. diff --git a/src/content/docs/Patchstack App/Pulse/pulse-overview.md b/src/content/docs/Patchstack App/Pulse/pulse-overview.md index f806426..846b11b 100644 --- a/src/content/docs/Patchstack App/Pulse/pulse-overview.md +++ b/src/content/docs/Patchstack App/Pulse/pulse-overview.md @@ -46,6 +46,32 @@ An app that builds rarely but gets traffic will show an old scan time and recent Because the widget check-in runs in a public page, Patchstack treats it as corroboration rather than proof — a site's connection status is derived from what can be verified, not from the check-in alone. +## When the site was last deployed + +Beside those timestamps, a Pulse site's header carries a **deploy status**. Building and deploying are separate events, and Patchstack tracks them separately. + +The connector's `mark-build` step stamps each build's fingerprint into the HTML it publishes. Patchstack reads that fingerprint back off the live site — from the widget when a visitor loads a page, and from its own scheduled fetch of the published page — and compares it against the builds you have reported. That comparison is what the status says out loud: + +| Status | What it means | +|--------|---------------| +| **Deployed \** | The build serving traffic is the one Patchstack scanned. | +| **Last build \** | The same, except nobody has seen this app change build since Patchstack started watching. The time shown is when the build ran, not when it went live. | +| **Needs deploying** | A newer build was scanned, but the live site is still serving an older one. Deploy to put it live. | +| **Deployed without Patchstack** | The live site is running a build Patchstack never scanned — the build ran without the connector. Run the build again with `@patchstack/connect` so its packages get checked. | +| **Sandbox only** | Builds have been reported, but only from a sandbox. Nothing has gone to production yet. | +| **Build environment** | This site is a build environment rather than a live one. Deploys are tracked on the production site it belongs to. | +| **Deploy state unknown** | Nothing current names the live build — usually a site with no traffic that Patchstack also cannot fetch. | + +**Needs deploying** is the one worth acting on. The vulnerabilities Patchstack lists are the ones in the build it scanned; if that build never shipped, neither did the fixes in it. + +The status also appears in the disclosure widget's owner panel, under the sync line — useful, because you are standing on the live site when you read it there. + +### How quickly it updates + +A deploy shows up as soon as something sees it. A site with traffic reports within the hour, from the first visitor to load a page on the new build. A site without traffic waits for the scheduled fetch of the published page, which runs daily for production sites. + +Patchstack only dates a deploy it actually witnessed — one known build handing over to another. The first build it ever sees is left undated, because an app that has been live for months would otherwise read as deployed today. + ## Protection Reporting your dependencies tells you what is vulnerable. The **runtime guard** installed by `setup` is what stops those vulnerabilities being exploited while you upgrade — the JavaScript equivalent of the virtual patching Patchstack applies to WordPress sites. From 512cb6a4a32196797b8aa3dc3e4b0b6617ea71d2 Mon Sep 17 00:00:00 2001 From: Renato Hysa Date: Tue, 8 Sep 2026 11:47:16 +0200 Subject: [PATCH 42/89] Refresh the Seats upgrade screenshot and document what happens when seats run out (#68) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Refresh the Seats upgrade screenshot and say what happens when seats run out The Upgrades page screenshot still showed the older Seats card. The app now puts the Manage button back at the top right of that card -- which is what this page has always told people to click -- alongside the Developer plan's Buy action, and labels the read-only figure "Seats used" so it is not mistaken for a cap. The seat-management page explained how to add a seat user but not what happens once every seat is taken. Developer accounts can now buy the seat as part of the invite and are shown the resulting monthly charge before confirming; plans that include no seat users are sent to the Upgrades page instead. Enterprise never reaches either, its seats being unlimited. * Say Enterprise seat counts are agreed with sales, not unlimited The page claimed unlimited Enterprise seats in two places: the sentence added by this PR, and a bolder pre-existing one. Neither is true — the number is a term of the customer's agreement. Nothing enforces a cap in the app today, so the refusal sentence keeps saying Enterprise does not hit it, but points at the agreement rather than an entitlement. --- .../images/patchstack-upgrades-seats.png | Bin 58510 -> 47349 bytes .../Patchstack App/Account settings/seats.md | 15 ++++++++++++++- 2 files changed, 14 insertions(+), 1 deletion(-) diff --git a/src/assets/images/patchstack-upgrades-seats.png b/src/assets/images/patchstack-upgrades-seats.png index 04997b26caeae53cc98b4c85e999784e2411ab1c..ae38dbeeafd27d2be596c1699d08bf99e0c5b818 100644 GIT binary patch literal 47349 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 QJ|U2nkQdK+qWAiL0b~I?jsO4v literal 58510 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 diff --git a/src/content/docs/Patchstack App/Account settings/seats.md b/src/content/docs/Patchstack App/Account settings/seats.md index d6c5408..72d0c05 100644 --- a/src/content/docs/Patchstack App/Account settings/seats.md +++ b/src/content/docs/Patchstack App/Account settings/seats.md @@ -18,7 +18,7 @@ To manage your seats and team settings, click on your name on Patchstack App (at On the **Seats** page you can manage the seats. The seat management feature allows you to add sub-users to your account to which you can assign specific permissions and/or sites. When you add a new user, they will receive an email with a link to activate their account. -Enterprise plans include **unlimited team seats** (there is no invite cap). +On the **Enterprise** plan the number of seats is **custom** — it is whatever your agreement with our sales team covers, not a fixed number set by the plan. ## Available roles @@ -55,6 +55,19 @@ Note that you can **only add email addresses** that have **not yet registered** After adding the user, you can see the added user in the table below. An invitation will be sent to that email asking to register an account on Patchstack App. +### When your seats are full + +If every seat on your plan is already taken, the invite is refused and the panel tells you why. + +- On the **Developer** plan you can buy the seat as part of the invite. The panel states the charge + before you commit — for example _"Your next monthly additional seat (2→3) charge will be $72."_ — + and the button reads **Invite additional user for $24/mo**. Confirming adds the seat to your + subscription and sends the invite together. +- On plans that do not include seat users, no purchase can lift the refusal. The panel shows + **Manage your subscription** instead, which takes you to the Upgrades page to change plan. + +Enterprise plans do not hit this refusal, because their seat count comes from the agreement rather than a plan limit. If you need more seats than you agreed, speak to your account contact. + ### Attaching an Operator seat user to sites If you assigned a user the **Operator** role, you can choose which sites you want to attach this user. From 0b1c9e56159ade3aa0998d2c17fc3cc6053697ce Mon Sep 17 00:00:00 2001 From: Renato Hysa Date: Wed, 9 Sep 2026 09:42:38 +0200 Subject: [PATCH 43/89] Embed the WHMCS setup screencast on the WHMCS Module Setup page (#78) Adds the public Drive recording (steps-for-hosting-providers.mp4) directly under the tl;dr: a sentence with an open-in-Drive link plus the Drive player in the site's existing 16:9 responsive-iframe container, mirroring the first-site tutorial video. ENG-3740 --- src/content/docs/partners/whmcs-setup.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/src/content/docs/partners/whmcs-setup.md b/src/content/docs/partners/whmcs-setup.md index 9240282..c8892fb 100644 --- a/src/content/docs/partners/whmcs-setup.md +++ b/src/content/docs/partners/whmcs-setup.md @@ -16,6 +16,12 @@ lifecycle automatically. - Scales from 10 to 10,000 customers across any number of cPanel servers. Customers self-serve from their client area (status, SSO to the Patchstack dashboard, manual-install fallback for external hosting). ::: +Prefer to watch first? The 12-minute screencast below walks through the hosting-provider steps on this page. You can also open it in Google Drive. + +

              + +
              + :::tip[Standing up a local environment first?] If you want to test the module locally before configuring a production WHMCS, follow your local WHMCS development setup guide to get a working install, then From 64a3a4ce54a1a802d3a83b956e6ab334f71bd5e2 Mon Sep 17 00:00:00 2001 From: "claude[bot]" <209825114+claude[bot]@users.noreply.github.com> Date: Wed, 9 Sep 2026 11:32:42 +0100 Subject: [PATCH 44/89] Clarify that a Customer seat creates a new Patchstack account (#79) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Clarify that a Customer seat creates a new Patchstack account The Customer entry sat under a "Separate accounts" heading and said the Customer "owns and manages their own site(s)" and that sites you assign are view-only. Read on its own, that describes the end state of the account rather than how it comes into being, and readers took it to mean that a Customer must already be a registered Patchstack user whom you then link to your account. The opposite is true: the invite creates a brand new account, and an email address that already has a Patchstack account is rejected. The Customer entry now says the account is created by your invitation and that the person must not already have a Patchstack account, the "Separate accounts" label explains that these accounts sit outside your own rather than being pre-existing users you link, and the existing "not yet registered" note now states that it applies to every role, Customer included. Co-Authored-By: Claude Opus 5 (1M context) Claude-Session: https://claude.ai/code/session_01EMiZnK34A3J5w3a5EDzG6Y * Drop the "Separate accounts" grouping from the roles list The Available roles section split the five roles into "Roles in this account" and "Separate accounts", which restarted the numbering and gave the Customer role its own heading. That framing was the thing readers tripped over: it read as though a Customer were an outside account you attach rather than one your invitation creates. The five roles are now a single numbered list with a plain lead-in, and every fact that lived in the grouping copy moved into the Customer entry itself — the invitation creates the account, the invitee must not already have a Patchstack account, it inherits your subscription type, it is not part of your own account where permissions are concerned, the Customer owns and manages their own sites, assigned sites are view-only, and Customers cannot add sites on your plan. The "not yet registered" note and the API stored values note are unchanged. Co-Authored-By: Claude Opus 5 (1M context) Claude-Session: https://claude.ai/code/session_01EMiZnK34A3J5w3a5EDzG6Y --------- Co-authored-by: Claude --- .../docs/Patchstack App/Account settings/seats.md | 11 +++-------- 1 file changed, 3 insertions(+), 8 deletions(-) diff --git a/src/content/docs/Patchstack App/Account settings/seats.md b/src/content/docs/Patchstack App/Account settings/seats.md index 72d0c05..86a3c55 100644 --- a/src/content/docs/Patchstack App/Account settings/seats.md +++ b/src/content/docs/Patchstack App/Account settings/seats.md @@ -22,18 +22,13 @@ On the **Enterprise** plan the number of seats is **custom** — it is whatever ## Available roles -Roles are **two groups, not one ladder**. Owner / Admin / Manager / Operator are positions *within* your account. Customer is a separate, isolated account that sits under yours. - -**Roles in this account** +Every seat user you add has one of the following roles. 1. **Owner** — Full control of all sites and users. Only one owner can exist. 2. **Admin** — Full control of sites and lower-level users. Cannot alter the owner or other admins. 3. **Manager** — Full control of all sites. Cannot modify users. 4. **Operator** — Editing access only to sites assigned to them. Cannot modify users, cannot delete sites, and cannot add new sites. - -**Separate accounts** - -5. **Customer** — An isolated account that inherits your subscription type. The Customer owns and manages their own site(s). Sites you **assign** to a Customer are view-only for them. Customers cannot add sites on your plan. +5. **Customer** — A new Patchstack account that your invitation creates, so the person you invite must **not already have a Patchstack account**. It inherits your subscription type, and it is not part of your own account where permissions are concerned. The Customer owns and manages their own site(s). Sites you **assign** to a Customer are view-only for them. Customers cannot add sites on your plan. :::note[API / stored values] Integrations that call the team API still send the historical stored values: `member` for Operator and `independent` for Customer. The Patchstack App UI shows the labels above. @@ -48,7 +43,7 @@ In order to attach a site to a user, go to **Site** > **Action button** > **Atta To add a seat user, click on **Add seat user**. Add a name, email address and role of the seat user. -Note that you can **only add email addresses** that have **not yet registered** in Patchstack. +Note that you can **only add email addresses** that have **not yet registered** in Patchstack. This applies to every role, including Customer — the invitation always creates a brand new Patchstack account. ![](@images/7bc1fea-small-Patchstack_adding_seat_user.png) From b9d15df3c26e068d34e8be6920426c24e4dbee17 Mon Sep 17 00:00:00 2001 From: Mario Tarosso Date: Thu, 10 Sep 2026 11:21:05 +0100 Subject: [PATCH 45/89] [ENG-3861] Describe the automatic connection option and the widget's Continue with Patchstack (#82) * Describe the automatic connection option and the widget's Continue with Patchstack Co-Authored-By: Claude Fable 5.1 * Describe the widget's Continue as entry as shown only on a detected session Co-Authored-By: Claude Fable 5.1 * Describe Continue with Patchstack as always offered, named where the browser allows Co-Authored-By: Claude Fable 5.1 --------- Co-authored-by: Claude Fable 5.1 --- .../installing-on-javascript-node-projects.md | 15 +++++++++++++++ .../docs/Patchstack App/Pulse/pulse-overview.md | 2 ++ .../docs/Patchstack App/Sites/adding-a-site.mdx | 2 +- 3 files changed, 18 insertions(+), 1 deletion(-) diff --git a/src/content/docs/Getting Started/Installing Patchstack/installing-on-javascript-node-projects.md b/src/content/docs/Getting Started/Installing Patchstack/installing-on-javascript-node-projects.md index a593393..1f38135 100644 --- a/src/content/docs/Getting Started/Installing Patchstack/installing-on-javascript-node-projects.md +++ b/src/content/docs/Getting Started/Installing Patchstack/installing-on-javascript-node-projects.md @@ -40,6 +40,17 @@ npx --no-install patchstack-connect setup `setup` ends by printing a **dashboard link**. The CLI never opens the link and never asks for Patchstack credentials — open it in your browser and sign in to see the vulnerability reports. The site is monitored either way; connecting it to an account is what makes the reports visible to you. +### Connecting straight to your account + +If you start from the app — **Sites → Add new → AI-assisted** — and tick **Connect this website to my account automatically**, the message it gives you to paste into your assistant carries a **claim token** for your account, and the assistant runs `setup` with it: + +```bash +npx @patchstack/connect setup --claim-token +# or: PATCHSTACK_CLAIM_TOKEN= npx @patchstack/connect setup +``` + +The site is then created already attached to your account, `setup` prints your dashboard link for it, and the app's **Connect website** panel picks the site up on its own. The token names your account, not the project: it is never written to `.patchstackrc.json` or the credential file, and it stops working after a day. An expired or unrecognised token does not break the install — the site is created unattached, exactly as it would be without one, and `setup` prints the dashboard link to connect it by hand. + `setup` never runs the `protect` command (see below). ### Manual alternative @@ -67,6 +78,10 @@ To run without the widget, set `"widget": false` in `.patchstackrc.json` — thi The floating button is **hidden by default**: it appears only when the widget is told to show it, via `data-report-form="true"` on the script tag or the widget's own Settings. To reach your dashboard while the button is hidden, open any page of your site with `#patchstack` appended to the URL. See [Troubleshooting JS / Node.js](/getting-started/installing-patchstack/troubleshooting-javascript-node-projects/) if the widget still does not appear. +### Signing in to the widget on your site + +The widget's sign-in form leads with **Continue with Patchstack**: one click signs you in with the account you are already signed in to at app.patchstack.com — no password, no provider round trip, and it works for SSO and two-factor accounts too. In Chrome and Edge the button already names your account ("Continue as …"); Safari and Firefox do not let the widget see that, so there it is unnamed but works the same way. If you are not signed in to app.patchstack.com in that browser, the widget says so and the e-mail, Google, GitHub and LinkedIn options are right underneath. + ## The `protect` command The package also ships an **opt-in** `protect` command: a runtime exploit guard, currently for TanStack Start + Supabase applications, which patches the app's Supabase client to route traffic through a same-origin guard. It modifies application code and runs **only** when explicitly invoked — `setup`, `scan`, `guide`, `status`, and `mark-build` never invoke it. If you don't run `protect`, no application code is changed beyond the widget tag and `package.json` scripts described above. diff --git a/src/content/docs/Patchstack App/Pulse/pulse-overview.md b/src/content/docs/Patchstack App/Pulse/pulse-overview.md index 846b11b..66971de 100644 --- a/src/content/docs/Patchstack App/Pulse/pulse-overview.md +++ b/src/content/docs/Patchstack App/Pulse/pulse-overview.md @@ -19,6 +19,8 @@ Install the connector in your project and run `setup`. The first scan creates th The site starts out **unclaimed**: it is being monitored, but it is not attached to anyone's account, so nobody can see its reports. `setup` prints a dashboard link. Open it, sign in, and the site attaches to your account. If you lose the link, `npx @patchstack/connect status` prints it again. +Starting from the app can skip that step: tick **Connect this website to my account automatically** under **Sites → Add new → AI-assisted** and the message it gives you carries a token for your account, so a site created with it is attached from its first scan and shows up in the app on its own. See [Connecting straight to your account](/getting-started/installing-patchstack/installing-on-javascript-node-projects/#connecting-straight-to-your-account). + An unclaimed site that nobody ever claims is cleaned up after a reminder period, so claim it while you are thinking about it. ## What the tabs show diff --git a/src/content/docs/Patchstack App/Sites/adding-a-site.mdx b/src/content/docs/Patchstack App/Sites/adding-a-site.mdx index 8d87a2e..72a581f 100644 --- a/src/content/docs/Patchstack App/Sites/adding-a-site.mdx +++ b/src/content/docs/Patchstack App/Sites/adding-a-site.mdx @@ -24,6 +24,6 @@ Adding a site to Patchstack is relatively easy. Here is a simple guide on how to 8. Upload the plugin .zip file to your WordPress site by visiting /wp-admin > Plugins > Add New > Upload Plugin 9. Activate the plugin -**JavaScript and Node.js projects do not need this flow.** Installing [`@patchstack/connect`](/getting-started/installing-patchstack/installing-on-javascript-node-projects/) and running `setup` creates the site for you on its first scan, then prints a link that attaches it to your account. See [Pulse sites overview](/patchstack-app/pulse/pulse-overview/) for what those sites look like in the app. +**JavaScript and Node.js projects do not need this flow.** Pick **AI-assisted** instead and copy the message the app shows you into the assistant that built your website. The assistant installs [`@patchstack/connect`](/getting-started/installing-patchstack/installing-on-javascript-node-projects/) and hands you back a link; paste it into the same panel to attach the site to your account. Tick **Connect this website to my account automatically** before copying and the message carries a one-day key for your account instead: the site is then created already attached to you, and the panel notices it by itself with nothing to paste. If the assistant still hands you a link (a message copied yesterday no longer connects), the paste field works as before. See [Pulse sites overview](/patchstack-app/pulse/pulse-overview/) for what those sites look like in the app. If you need further help, don't hesitate to reach out to us via live chat at the bottom right corner! \ No newline at end of file From c0e89c0eb72424f0e60f8ff3e26447f4ce658eb5 Mon Sep 17 00:00:00 2001 From: Mario Tarosso Date: Fri, 11 Sep 2026 08:14:32 +0100 Subject: [PATCH 46/89] Describe the Pulse Status tab, local scans, hosting and platform moves (#83) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Describe the application status card, the local environment, and when protection is not offered The Pulse overview now opens with where the app is in its life — configured locally, sandbox only, deployed, needs deploying — with the environment it last reported from, four evidence-graded stages, the next step, and the signals behind the verdict. Scans on a developer's machine report as `local` rather than defaulting to `production`, and a static site is told runtime protection does not apply instead of being offered it. Ref PF-19 Co-Authored-By: Claude Fable 5.1 * Put the application status on its own tab The status card and the protection-availability verdict live on a Status tab now, with the header chip as their short form, so the Overview stays a dashboard. Ref PF-19 Co-Authored-By: Claude Fable 5.1 * Describe hosting detection and platform moves Ref PF-19 Co-Authored-By: Claude Fable 5.1 --------- Co-authored-by: Claude Fable 5.1 --- .../Patchstack App/Pulse/deploy-history.md | 2 +- .../Patchstack App/Pulse/pulse-overview.md | 31 +++++++++++++++++++ 2 files changed, 32 insertions(+), 1 deletion(-) diff --git a/src/content/docs/Patchstack App/Pulse/deploy-history.md b/src/content/docs/Patchstack App/Pulse/deploy-history.md index 4e7dca6..d1198ca 100644 --- a/src/content/docs/Patchstack App/Pulse/deploy-history.md +++ b/src/content/docs/Patchstack App/Pulse/deploy-history.md @@ -50,7 +50,7 @@ This matters if you scan from more than one place. Production and sandbox builds With no environment selected, the view follows the site's most recent build, so an app that only ever scans from a sandbox still gets a real timeline. -You can set the environment a scan reports as with `PATCHSTACK_ENVIRONMENT`, or `environment` in `.patchstackrc.json`. It defaults to `production`. +You can set the environment a scan reports as with `PATCHSTACK_ENVIRONMENT`, or `environment` in `.patchstackrc.json`. When nothing sets it, the scan reports where it ran: a build on your hosting platform or in CI reports `production`, and a scan on a developer's machine reports `local`. Local builds are kept as their own lineage too, so the packages you tried on a laptop never show up as production churn. ## When it is empty diff --git a/src/content/docs/Patchstack App/Pulse/pulse-overview.md b/src/content/docs/Patchstack App/Pulse/pulse-overview.md index 66971de..477239e 100644 --- a/src/content/docs/Patchstack App/Pulse/pulse-overview.md +++ b/src/content/docs/Patchstack App/Pulse/pulse-overview.md @@ -38,6 +38,28 @@ A Pulse site gets a smaller set of tabs than a WordPress site, because several o Hardening, Activity, and Users are WordPress-only and do not appear. Reports currently cover WordPress sites; a Pulse site's security-report page hides the sections that do not apply. +## Application status + +The **Status** tab shows where the app is in its life, from set up to protected, and what that verdict rests on. The chip beside the site name is its short form and links to it, so the Overview stays a dashboard. + +The headline is one of: + +- **Configured locally** — Patchstack is set up in the app's working tree and its packages were scanned on a developer's machine. Nothing has been deployed with it yet. This is what a fresh `setup` produces, and it is not a connected site: nothing is live. +- **Sandbox only** — builds have been reported from a hosted builder's sandbox, and nothing has gone to production. +- **Not deployed yet** — the app was added but no build has reported at all. +- **Needs deploying** — a newer build has been scanned than the one the live site is serving. +- **Deployed** — the live site is running a build Patchstack scanned. The date is when the build was seen to change on the live site; where nothing has changed under observation, it is the build time, labelled as such. +- **Deployed without Patchstack** — the live site is running a build that was never scanned. Run the build again with `@patchstack/connect` installed. +- **Deploy state unknown** — production builds exist, but nothing current says which one is live. + +Next to the headline, **Reporting from** names the environment Patchstack last heard from — *local machine*, *sandbox*, or *production*. **Built with** names the builder when one was recognised, and **Hosted on** names the platform serving the site (Netlify, Vercel, Cloudflare, DigitalOcean, AWS, GitHub Pages and others), as read from the build's own environment and confirmed from the live page's response headers. The four stages below them (**Configured**, **Deployed**, **Monitoring**, **Protection**) are each graded from what was actually observed, with its timestamp. A stage is not ticked because a later one is: an app can be live without a production scan, and the card says so. + +Every status that is not the finished one names the next step. For a locally configured app that is: add `PATCHSTACK_API_KEY` to the hosting platform's environment, commit the generated changes, and deploy. Expand **What this is based on** to see every signal behind the verdict — a scan on a developer machine, a production build, the widget checking in from the live site, Patchstack's own fetch of the page — with where each came from and when. + +When a site moves — hosting from Netlify to Vercel, or builder from Lovable to GoDaddy — the move is recorded with both ends, the date and which witness saw it, and listed on the tab. The current platform alone would never say the site had changed. + +A deploy that was scanned before it went out, but not by the build that shipped it, still reads as **Deployed**: the build's fingerprint in the served page proves it. The next step then asks you to add `PATCHSTACK_API_KEY` to the hosting environment, so every future deploy reports its own build rather than relying on a scan made elsewhere. + ## Connected, scanned, and synced The site header shows **Last scan** — when the connector last sent a dependency manifest. This moves when you build or install dependencies, and it is how old the package data on the page is. @@ -82,6 +104,15 @@ The guard fetches the rules Patchstack generated for the vulnerable packages thi Runtime protection on a production Pulse app is a paid feature. See [The runtime guard](/getting-started/installing-patchstack/installing-on-javascript-node-projects/) for what `setup` installs and which frameworks are wired automatically. +### When protection is not offered + +The guard screens requests, so it needs a request path to sit on. Some apps have none, and the Status tab and the Protection card say so instead of offering protection: + +- **Not available for this app** — the app builds a static site (Eleventy, Gatsby, Docusaurus, VitePress, a SvelteKit site with the static adapter, and similar) and nothing in it receives a request. Dependency monitoring and the disclosure widget still apply; runtime protection does not. `setup` installs nothing for it on such a project, and `protect --check` reports the capability as not applicable rather than as failing. Protection becomes available if the app later gains a server or edge request path. +- **Deploy first** — the app has not been deployed with Patchstack yet. Protection is verified against a live site, so deploy, then enable it. + +The card names what the verdict is based on: the attack-surface map's analysis of the source where the app has reported one, otherwise the packages in its newest build. + ## Removing a site Run `npx @patchstack/connect uninstall` in the project before deleting anything locally — it needs the site's credential, so it has to run while that credential still exists. A claimed site is flagged for you to confirm in the dashboard; an unclaimed one is deleted outright. From a4448e57f82332ee29c116d6fb6bc2a67f9839a5 Mon Sep 17 00:00:00 2001 From: Renato Hysa Date: Fri, 11 Sep 2026 10:30:42 +0200 Subject: [PATCH 47/89] [ENG-3672] Explain and fix a Patchstack widget that appears twice (#80) Adds an "I see two Patchstack widgets" section to the JavaScript / Node.js troubleshooting page: where the second copy comes from (a hand-added tag, a same-site page shown in an