hibp 15.2.1 → 16.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/API.md +433 -126
- package/CHANGELOG.md +52 -0
- package/MIGRATION.md +7 -5
- package/README.md +53 -27
- package/dist/browser/hibp.module.js +2 -2
- package/dist/esm/api/base-fetch.d.ts +9 -5
- package/dist/esm/api/base-fetch.js +17 -10
- package/dist/esm/api/base-fetch.js.map +1 -1
- package/dist/esm/api/haveibeenpwned/fetch-from-api.d.ts +1 -1
- package/dist/esm/api/haveibeenpwned/fetch-from-api.js +62 -44
- package/dist/esm/api/haveibeenpwned/fetch-from-api.js.map +1 -1
- package/dist/esm/api/haveibeenpwned/package-info.d.ts +1 -1
- package/dist/esm/api/haveibeenpwned/package-info.js +1 -1
- package/dist/esm/api/haveibeenpwned/post-to-api.d.ts +1 -0
- package/dist/esm/api/haveibeenpwned/post-to-api.js +23 -0
- package/dist/esm/api/haveibeenpwned/post-to-api.js.map +1 -0
- package/dist/esm/api/haveibeenpwned/responses.d.ts +0 -10
- package/dist/esm/api/haveibeenpwned/responses.js +5 -36
- package/dist/esm/api/haveibeenpwned/responses.js.map +1 -1
- package/dist/esm/api/haveibeenpwned/types.d.ts +22 -2
- package/dist/esm/api/haveibeenpwned/types.js +0 -3
- package/dist/esm/api/haveibeenpwned/types.js.map +1 -1
- package/dist/esm/api/pwnedpasswords/fetch-from-api.js +5 -28
- package/dist/esm/api/pwnedpasswords/fetch-from-api.js.map +1 -1
- package/dist/esm/api/pwnedpasswords/responses.d.ts +0 -6
- package/dist/esm/api/pwnedpasswords/responses.js +1 -7
- package/dist/esm/api/pwnedpasswords/responses.js.map +1 -1
- package/dist/esm/breach.d.ts +12 -5
- package/dist/esm/breach.js +8 -1
- package/dist/esm/breach.js.map +1 -1
- package/dist/esm/breached-account-range.d.ts +73 -0
- package/dist/esm/breached-account-range.js +60 -0
- package/dist/esm/breached-account-range.js.map +1 -0
- package/dist/esm/breached-account.d.ts +56 -45
- package/dist/esm/breached-account.js +4 -76
- package/dist/esm/breached-account.js.map +1 -1
- package/dist/esm/breached-domain.d.ts +7 -8
- package/dist/esm/breached-domain.js +2 -3
- package/dist/esm/breached-domain.js.map +1 -1
- package/dist/esm/breaches.d.ts +14 -7
- package/dist/esm/breaches.js +10 -5
- package/dist/esm/breaches.js.map +1 -1
- package/dist/esm/data-class-descriptions.d.ts +55 -0
- package/dist/esm/data-class-descriptions.js +39 -0
- package/dist/esm/data-class-descriptions.js.map +1 -0
- package/dist/esm/data-classes.d.ts +4 -4
- package/dist/esm/data-classes.js +2 -2
- package/dist/esm/data-classes.js.map +1 -1
- package/dist/esm/generate-dns-token.d.ts +67 -0
- package/dist/esm/generate-dns-token.js +49 -0
- package/dist/esm/generate-dns-token.js.map +1 -0
- package/dist/esm/hibp.d.ts +28 -18
- package/dist/esm/hibp.js +22 -28
- package/dist/esm/hibp.js.map +1 -1
- package/dist/esm/latest-breach.d.ts +5 -5
- package/dist/esm/latest-breach.js +2 -2
- package/dist/esm/latest-breach.js.map +1 -1
- package/dist/esm/paste-account.d.ts +13 -13
- package/dist/esm/paste-account.js +8 -8
- package/dist/esm/paste-account.js.map +1 -1
- package/dist/esm/pwned-password-range.d.ts +6 -6
- package/dist/esm/pwned-password-range.js +4 -6
- package/dist/esm/pwned-password-range.js.map +1 -1
- package/dist/esm/pwned-password.d.ts +5 -5
- package/dist/esm/pwned-password.js +12 -7
- package/dist/esm/pwned-password.js.map +1 -1
- package/dist/esm/search.d.ts +57 -40
- package/dist/esm/search.js +5 -74
- package/dist/esm/search.js.map +1 -1
- package/dist/esm/send-email.d.ts +69 -0
- package/dist/esm/send-email.js +49 -0
- package/dist/esm/send-email.js.map +1 -0
- package/dist/esm/stealer-logs-by-email-domain.d.ts +13 -14
- package/dist/esm/stealer-logs-by-email-domain.js +8 -9
- package/dist/esm/stealer-logs-by-email-domain.js.map +1 -1
- package/dist/esm/stealer-logs-by-email.d.ts +9 -10
- package/dist/esm/stealer-logs-by-email.js +5 -6
- package/dist/esm/stealer-logs-by-email.js.map +1 -1
- package/dist/esm/stealer-logs-by-website-domain.d.ts +9 -10
- package/dist/esm/stealer-logs-by-website-domain.js +5 -6
- package/dist/esm/stealer-logs-by-website-domain.js.map +1 -1
- package/dist/esm/subscribed-domains.d.ts +7 -8
- package/dist/esm/subscribed-domains.js +4 -5
- package/dist/esm/subscribed-domains.js.map +1 -1
- package/dist/esm/subscription-status.d.ts +16 -11
- package/dist/esm/subscription-status.js +13 -8
- package/dist/esm/subscription-status.js.map +1 -1
- package/dist/esm/verify-dns-token.d.ts +60 -0
- package/dist/esm/verify-dns-token.js +41 -0
- package/dist/esm/verify-dns-token.js.map +1 -0
- package/package.json +55 -56
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,57 @@
|
|
|
1
1
|
# Change Log
|
|
2
2
|
|
|
3
|
+
## 16.0.1
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- [#648](https://github.com/wKovacs64/hibp/pull/648) [`0deb503`](https://github.com/wKovacs64/hibp/commit/0deb503540d765e7a6368bd09b0739323fea25f0) Thanks [@wKovacs64](https://github.com/wKovacs64)! - Accept `undefined` for every optional option property, so consumers using `exactOptionalPropertyTypes` can pass possibly-unset values, such as `{ domain }` where `domain` is `string | undefined`, without conditional spreads. hibp treats `undefined` the same as an omitted option.
|
|
8
|
+
|
|
9
|
+
- [#645](https://github.com/wKovacs64/hibp/pull/645) [`7617801`](https://github.com/wKovacs64/hibp/commit/7617801e5391b5060e90fb1a28b2f85069f15048) Thanks [@wKovacs64](https://github.com/wKovacs64)! - `breaches()`, `subscribedDomains()`, and `subscriptionStatus()` reject on HTTP 404 instead of resolving `null`, which their return types exclude. haveibeenpwned.com does not send 404 for these endpoints, so this only affects responses from elsewhere, such as a proxy at a custom `baseUrl`.
|
|
10
|
+
|
|
11
|
+
## 16.0.0
|
|
12
|
+
|
|
13
|
+
### Major Changes
|
|
14
|
+
|
|
15
|
+
- [#637](https://github.com/wKovacs64/hibp/pull/637) [`d65fda6`](https://github.com/wKovacs64/hibp/commit/d65fda6f9b0703aa622324ed76760b4bbf0a5a80) Thanks [@wKovacs64](https://github.com/wKovacs64)! - Drop support for Node.js 20, which is [end-of-life](https://nodejs.org/en/about/previous-releases). The minimum Node.js version is now 22.12.0, the first Node.js 22 release that can `require()` ESM without a flag. Upgrade Node.js, or keep using hibp 15.x if you can't.
|
|
16
|
+
|
|
17
|
+
- [#625](https://github.com/wKovacs64/hibp/pull/625) [`c55048e`](https://github.com/wKovacs64/hibp/commit/c55048e82227cb3850269d5602882e3d35c60a9f) Thanks [@wKovacs64](https://github.com/wKovacs64)! - Correct `breachedAccount()` and `search().breaches` types to reflect truncation. Default and `truncate: true` searches expose only `Name`; `truncate: false` exposes full `Breach` objects. Dynamic boolean options allow either result shape. Both preserve `null`.
|
|
18
|
+
|
|
19
|
+
TypeScript consumers accessing full-only fields such as `Title` or `DataClasses` must pass `truncate: false` or narrow dynamic results. Runtime requests and responses are unchanged.
|
|
20
|
+
|
|
21
|
+
- [#624](https://github.com/wKovacs64/hibp/pull/624) [`8517b19`](https://github.com/wKovacs64/hibp/commit/8517b19819a2005da8de8c7a535152ddff83a440) Thanks [@wKovacs64](https://github.com/wKovacs64)! - Correct `Paste.Title` to an optional string and `Paste.Date` to `string | null`, matching the [haveibeenpwned.com paste model](https://haveibeenpwned.com/API/v3#PasteModel).
|
|
22
|
+
|
|
23
|
+
TypeScript consumers of `Paste`, `pasteAccount()`, and `search()` must handle absent titles and null dates before using them as strings. This can introduce compile errors with strict null checks; HTTP response handling is unchanged.
|
|
24
|
+
|
|
25
|
+
### Minor Changes
|
|
26
|
+
|
|
27
|
+
- [#619](https://github.com/wKovacs64/hibp/pull/619) [`9bf2740`](https://github.com/wKovacs64/hibp/commit/9bf27402f53aba1864228005e088f09aafcb95ed) Thanks [@wKovacs64](https://github.com/wKovacs64)! - Add `dataClassDescriptions` and the `DataClassDescription` type with lowercase `name` and `description` fields matching haveibeenpwned.com's live response.
|
|
28
|
+
|
|
29
|
+
- [#626](https://github.com/wKovacs64/hibp/pull/626) [`d47a032`](https://github.com/wKovacs64/hibp/commit/d47a03208b72c0750f1a2f74e8fad262a8059f1e) Thanks [@wKovacs64](https://github.com/wKovacs64)! - Add `sendEmail` and the `EmailAlias` type for domain verification approval emails.
|
|
30
|
+
|
|
31
|
+
- [#620](https://github.com/wKovacs64/hibp/pull/620) [`87f02b6`](https://github.com/wKovacs64/hibp/commit/87f02b6616e703804145dd90ec821da8e7bd989f) Thanks [@wKovacs64](https://github.com/wKovacs64)! - Add `breachedAccountRange` for six-character SHA-1 email hash prefixes, returning `hashSuffix` and `websites` results. Requires a Pro or High RPM subscription; callers must discard unrelated results per haveibeenpwned.com's terms of use.
|
|
32
|
+
|
|
33
|
+
- [#623](https://github.com/wKovacs64/hibp/pull/623) [`a451599`](https://github.com/wKovacs64/hibp/commit/a4515993bc0c3ca4828b4c91cde0e204767f344e) Thanks [@wKovacs64](https://github.com/wKovacs64)! - Add `generateDnsToken` and `verifyDnsToken` for domain verification through DNS.
|
|
34
|
+
|
|
35
|
+
- [#618](https://github.com/wKovacs64/hibp/pull/618) [`1df8169`](https://github.com/wKovacs64/hibp/commit/1df816999c3b0af19bcbd8ca7dca4631a4ca4e1b) Thanks [@wKovacs64](https://github.com/wKovacs64)! - Add the `isSpamList` option to `breaches()`: `true` selects spam-list breaches, `false` selects non-spam-list breaches, and omission applies no spam-list filter. Can be combined with `domain`.
|
|
36
|
+
|
|
37
|
+
### Patch Changes
|
|
38
|
+
|
|
39
|
+
- [#621](https://github.com/wKovacs64/hibp/pull/621) [`cc059b1`](https://github.com/wKovacs64/hibp/commit/cc059b183c586a4762f7bb59fc757d28077a7ec4) Thanks [@wKovacs64](https://github.com/wKovacs64)! - Complete the exported `Breach` type with required `IsStealerLog: boolean`,
|
|
40
|
+
`Attribution: string | null`, and `DisclosureUrl: string | null` fields, matching
|
|
41
|
+
[haveibeenpwned.com's live responses](https://haveibeenpwned.com/api/v3/breaches).
|
|
42
|
+
|
|
43
|
+
TypeScript consumers constructing `Breach` objects, including mocks and fixtures,
|
|
44
|
+
must supply these fields. Handle null when reading attribution or disclosure URLs.
|
|
45
|
+
The SDK continues returning the upstream response without transforming it.
|
|
46
|
+
|
|
47
|
+
- [#622](https://github.com/wKovacs64/hibp/pull/622) [`70c08fb`](https://github.com/wKovacs64/hibp/commit/70c08fbe4a805e5e0e929f219dbc47450f3ddd1d) Thanks [@wKovacs64](https://github.com/wKovacs64)! - Complete `SubscriptionStatus` with the [documented haveibeenpwned.com fields](https://haveibeenpwned.com/API/v3#SubscriptionStatus): `MaxBreachedDomains` (`number | null`), `IncludesBulkDomainAdd`, `IncludesAutoSubdomainVerification`, `IncludesCustomerDomains`, and `IncludesKAnon` (`boolean`). These fields are required, so TypeScript consumers constructing subscription status objects, including mocks and fixtures, must supply them. A `null` domain limit means unlimited domains. Runtime response handling is unchanged.
|
|
48
|
+
|
|
49
|
+
- [#636](https://github.com/wKovacs64/hibp/pull/636) [`99e437b`](https://github.com/wKovacs64/hibp/commit/99e437b40ca0380cbe0c2a14abe74117eabfba4f) Thanks [@wKovacs64](https://github.com/wKovacs64)! - Send the default `hibp <version>` User-Agent in every non-browser runtime. The SDK skipped it whenever a global `navigator` existed, which Node.js 21+, Bun, Deno, and Cloudflare Workers all define. Those requests went out with the runtime's User-Agent (e.g. `node`), or none at all on Cloudflare Workers. Browser pages and workers still send their own User-Agent, because setting one triggers a CORS preflight that haveibeenpwned.com rejects.
|
|
50
|
+
|
|
51
|
+
- [#635](https://github.com/wKovacs64/hibp/pull/635) [`f165d82`](https://github.com/wKovacs64/hibp/commit/f165d82983fd1be04c73277f2f4093599ac7dcfc) Thanks [@wKovacs64](https://github.com/wKovacs64)! - Document which HIBP plans (Core, Pro, High RPM) include each key-requiring function.
|
|
52
|
+
|
|
53
|
+
- [#633](https://github.com/wKovacs64/hibp/pull/633) [`5b645a5`](https://github.com/wKovacs64/hibp/commit/5b645a58b25fbb3b89da93a7e7a6b10feec60595) Thanks [@wKovacs64](https://github.com/wKovacs64)! - GET operations reject a 401 with the JSON body's `message` as `error.message` (e.g. `Access denied due to missing hibp-api-key.`) instead of the raw JSON body, matching domain verification POST operations. Plain-text 401 bodies are still used as-is, and an empty 401 body rejects with the HTTP status (e.g. `401 Unauthorized`). A 429 without a JSON body now rejects with `RateLimitError` carrying the HTTP status as its message, instead of `SyntaxError`.
|
|
54
|
+
|
|
3
55
|
## 15.2.1
|
|
4
56
|
|
|
5
57
|
### Patch Changes
|
package/MIGRATION.md
CHANGED
|
@@ -113,15 +113,15 @@
|
|
|
113
113
|
|
|
114
114
|
```javascript
|
|
115
115
|
// 4.x
|
|
116
|
-
import hibp from
|
|
116
|
+
import hibp from "hibp";
|
|
117
117
|
hibp.breachedAccount(/* ... */).then(/* ... */);
|
|
118
118
|
|
|
119
119
|
// 5.x (upgrade option 1, one-liner quick fix)
|
|
120
|
-
import * as hibp from
|
|
120
|
+
import * as hibp from "hibp";
|
|
121
121
|
hibp.breachedAccount(/* ... */).then(/* ... */);
|
|
122
122
|
|
|
123
123
|
// 5.x (upgrade option 2, more explicit but requires more code changes)
|
|
124
|
-
import { breachedAccount } from
|
|
124
|
+
import { breachedAccount } from "hibp";
|
|
125
125
|
breachedAccount(/* ... */).then(/* ... */);
|
|
126
126
|
```
|
|
127
127
|
|
|
@@ -183,13 +183,15 @@
|
|
|
183
183
|
1.0.8 (old):
|
|
184
184
|
|
|
185
185
|
```javascript
|
|
186
|
-
hibp.breachedAccount(account,
|
|
186
|
+
hibp.breachedAccount(account, "adobe.com", true).then(/* ... */);
|
|
187
187
|
```
|
|
188
188
|
|
|
189
189
|
2.0.0 (new):
|
|
190
190
|
|
|
191
191
|
```javascript
|
|
192
|
-
hibp
|
|
192
|
+
hibp
|
|
193
|
+
.breachedAccount(account, { domain: "adobe.com", truncate: true })
|
|
194
|
+
.then(/* ... */);
|
|
193
195
|
```
|
|
194
196
|
|
|
195
197
|
This change was made to make the API more expressive and reduce ambiguity. See the API
|
package/README.md
CHANGED
|
@@ -13,7 +13,6 @@
|
|
|
13
13
|
_An unofficial TypeScript SDK for [Troy Hunt][troy]'s [Have I been pwned?][haveibeenpwned] service._
|
|
14
14
|
|
|
15
15
|
[![npm Version][npm-image]][npm-url] [![Build Status][ci-image]][ci-url]
|
|
16
|
-
[![Code Coverage][coverage-image]][coverage-url]
|
|
17
16
|
[](#contributors-)
|
|
18
17
|
|
|
19
18
|
## Installation
|
|
@@ -28,78 +27,105 @@ In [Deno][deno]:
|
|
|
28
27
|
|
|
29
28
|
```ts
|
|
30
29
|
// Replace x.y.z with the desired hibp version
|
|
31
|
-
import * as hibp from
|
|
30
|
+
import * as hibp from "npm:hibp@x.y.z";
|
|
32
31
|
```
|
|
33
32
|
|
|
34
33
|
See the [browser](#using-in-the-browser) section below for information on how to use it in the
|
|
35
34
|
browser.
|
|
36
35
|
|
|
37
|
-
## Features
|
|
36
|
+
## Features
|
|
37
|
+
|
|
38
|
+
- All queries return a Promise
|
|
39
|
+
- Provide your own `AbortSignal` to cancel in-flight requests
|
|
40
|
+
- Available server-side (e.g., Node.js) and client-side (browser)
|
|
41
|
+
- Written in TypeScript, so all modules come fully typed
|
|
42
|
+
|
|
43
|
+
API features are grouped by the [HIBP plans][hibp-plans] whose [API key][get-api-key] unlocks
|
|
44
|
+
them.
|
|
45
|
+
|
|
46
|
+
#### No API key
|
|
38
47
|
|
|
39
48
|
- Get the most recently added breach
|
|
40
49
|
- Get a single breach event
|
|
41
|
-
- Get all breaches for an account 🔑
|
|
42
|
-
- Get all breached email addresses for a domain 🔑
|
|
43
50
|
- Get all breach events in the system
|
|
44
51
|
- Get all data classes
|
|
45
|
-
- Get
|
|
52
|
+
- Get data class names and descriptions
|
|
46
53
|
- [Securely][search-by-range] check a password to see if it has been exposed in a data breach
|
|
47
54
|
- Check a SHA-1 or NTLM prefix to see if it has been exposed in a data breach
|
|
48
|
-
|
|
49
|
-
-
|
|
50
|
-
|
|
51
|
-
- Get all
|
|
52
|
-
- Get all
|
|
53
|
-
-
|
|
54
|
-
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
55
|
+
|
|
56
|
+
#### ![Core][core-plan] / ![Pro][pro-plan] / ![High RPM][high-rpm-plan]
|
|
57
|
+
|
|
58
|
+
- Get all breaches for an account
|
|
59
|
+
- Get all pastes for an account
|
|
60
|
+
- Search for an account in both breaches and pastes at the same time
|
|
61
|
+
- Get your subscription status, domain limits, and plan capabilities
|
|
62
|
+
|
|
63
|
+
#### ![Core][core-plan] / ![Pro][pro-plan]
|
|
64
|
+
|
|
65
|
+
- Get all breached email addresses for a domain
|
|
66
|
+
- Get all subscribed domains
|
|
67
|
+
|
|
68
|
+
#### ![Pro][pro-plan] / ![High RPM][high-rpm-plan]
|
|
69
|
+
|
|
70
|
+
- Search breaches by a six-character SHA-1 email prefix
|
|
71
|
+
|
|
72
|
+
#### ![Pro][pro-plan]
|
|
73
|
+
|
|
74
|
+
- Get all stealer log domains for an email address
|
|
75
|
+
- Get all stealer log email aliases for an email domain
|
|
76
|
+
- Get all stealer log email addresses for a website domain
|
|
77
|
+
- Generate and verify DNS domain verification tokens
|
|
78
|
+
- Request domain verification approval emails
|
|
58
79
|
|
|
59
80
|
## Usage
|
|
60
81
|
|
|
61
82
|
```typescript
|
|
62
83
|
// import individual modules as needed
|
|
63
|
-
import { dataClasses, search } from
|
|
84
|
+
import { dataClasses, search } from "hibp";
|
|
64
85
|
|
|
65
86
|
// or, import all modules into a local namespace
|
|
66
|
-
import * as hibp from
|
|
87
|
+
import * as hibp from "hibp";
|
|
67
88
|
```
|
|
68
89
|
|
|
69
90
|
The following modules are available:
|
|
70
91
|
|
|
71
92
|
- [breach](API.md#breach)
|
|
72
93
|
- [breachedAccount](API.md#breachedaccount)
|
|
94
|
+
- [breachedAccountRange](API.md#breachedaccountrange)
|
|
73
95
|
- [breachedDomain](API.md#breacheddomain)
|
|
74
96
|
- [breaches](API.md#breaches)
|
|
75
97
|
- [dataClasses](API.md#dataclasses)
|
|
98
|
+
- [dataClassDescriptions](API.md#dataclassdescriptions)
|
|
99
|
+
- [generateDnsToken](API.md#generatednstoken)
|
|
76
100
|
- [latestBreach](API.md#latestbreach)
|
|
77
101
|
- [pasteAccount](API.md#pasteaccount)
|
|
78
102
|
- [pwnedPassword](API.md#pwnedpassword)
|
|
79
103
|
- [pwnedPasswordRange](API.md#pwnedpasswordrange)
|
|
80
104
|
- [search](API.md#search)
|
|
105
|
+
- [sendEmail](API.md#sendemail)
|
|
81
106
|
- [stealerLogsByEmail](API.md#stealerlogsbyemail)
|
|
82
107
|
- [stealerLogsByEmailDomain](API.md#stealerlogsbyemaildomain)
|
|
83
108
|
- [stealerLogsByWebsiteDomain](API.md#stealerlogsbywebsitedomain)
|
|
84
109
|
- [subscribedDomains](API.md#subscribeddomains)
|
|
85
110
|
- [subscriptionStatus](API.md#subscriptionstatus)
|
|
111
|
+
- [verifyDnsToken](API.md#verifydnstoken)
|
|
86
112
|
|
|
87
113
|
Please see the [API reference](API.md) for more detailed usage information and examples.
|
|
88
114
|
|
|
89
115
|
#### Quick-Start Example
|
|
90
116
|
|
|
91
117
|
```javascript
|
|
92
|
-
import { search } from
|
|
118
|
+
import { search } from "hibp";
|
|
93
119
|
|
|
94
120
|
async function main() {
|
|
95
121
|
try {
|
|
96
|
-
const data = await search(
|
|
122
|
+
const data = await search("someAccountOrEmail", { apiKey: "my-api-key" });
|
|
97
123
|
if (data.breaches || data.pastes) {
|
|
98
124
|
// Bummer...
|
|
99
125
|
console.log(data);
|
|
100
126
|
} else {
|
|
101
127
|
// Phew! We're clear.
|
|
102
|
-
console.log(
|
|
128
|
+
console.log("Good news — no pwnage found!");
|
|
103
129
|
}
|
|
104
130
|
} catch (err) {
|
|
105
131
|
// Something went wrong.
|
|
@@ -140,7 +166,7 @@ You have a couple of options for using this library in a browser environment:
|
|
|
140
166
|
```html
|
|
141
167
|
<script type="module">
|
|
142
168
|
// Replace x.y.z with the desired hibp version ↓ ↓ ↓
|
|
143
|
-
import { dataClasses } from
|
|
169
|
+
import { dataClasses } from "https://unpkg.com/hibp@x.y.z/dist/browser/hibp.module.js";
|
|
144
170
|
|
|
145
171
|
const logDataClasses = async () => {
|
|
146
172
|
console.table(await dataClasses());
|
|
@@ -178,17 +204,17 @@ This module is distributed under the [MIT License][license].
|
|
|
178
204
|
|
|
179
205
|
[npm-image]: https://img.shields.io/npm/v/hibp.svg?style=flat-square
|
|
180
206
|
[npm-url]: https://www.npmjs.com/package/hibp
|
|
181
|
-
[ci-image]:
|
|
182
|
-
https://img.shields.io/github/actions/workflow/status/wKovacs64/hibp/ci.yml?logo=github&style=flat-square
|
|
207
|
+
[ci-image]: https://img.shields.io/github/actions/workflow/status/wKovacs64/hibp/ci.yml?logo=github&style=flat-square
|
|
183
208
|
[ci-url]: https://github.com/wKovacs64/hibp/actions?query=workflow%3Aci
|
|
184
|
-
[coverage-image]: https://img.shields.io/codecov/c/github/wKovacs64/hibp/main.svg?style=flat-square
|
|
185
|
-
[coverage-url]: https://codecov.io/gh/wKovacs64/hibp/branch/main
|
|
186
209
|
[deno]: https://deno.com/
|
|
187
210
|
[troy]: https://www.troyhunt.com
|
|
188
211
|
[haveibeenpwned]: https://haveibeenpwned.com
|
|
189
212
|
[haveibeenpwned-rate-limiting]: https://haveibeenpwned.com/API/v3#RateLimiting
|
|
190
213
|
[search-by-range]: https://haveibeenpwned.com/API/v2#SearchingPwnedPasswordsByRange
|
|
191
|
-
[
|
|
214
|
+
[hibp-plans]: https://haveibeenpwned.com/Subscription
|
|
215
|
+
[core-plan]: https://img.shields.io/badge/Core-3c9f43?style=flat-square
|
|
216
|
+
[pro-plan]: https://img.shields.io/badge/Pro-187dbd?style=flat-square
|
|
217
|
+
[high-rpm-plan]: https://img.shields.io/badge/High%20RPM-ef4444?style=flat-square
|
|
192
218
|
[get-api-key]: https://haveibeenpwned.com/API/Key
|
|
193
219
|
[unpkg]: https://unpkg.com
|
|
194
220
|
[caniuse-esm]: https://caniuse.com/#feat=es6-module
|
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
var
|
|
2
|
-
`).filter(Boolean).reduce((
|
|
1
|
+
var T="hibp",M="16.0.1";async function h({baseUrl:e,endpoint:t,headers:n,timeoutMs:r,signal:s,userAgent:i,queryParams:o,method:a,body:u}){let c={method:a??"GET",body:u??null,headers:K(i,n),signal:F(r,s)},p=k(e,t,o);return fetch(p,c)}function k(e,t,n){let r=e.replace(/\/$/g,""),s=t.startsWith("/")?t:`/${t}`,i=new URL(`${r}${s}`);if(n)for(let[o,a]of Object.entries(n))i.searchParams.set(o,a);return i.toString()}function K(e,t){let n={...t};return e?n["User-Agent"]=e:$()||(n["User-Agent"]=`${T} ${M}`),n}function F(e,t){let n=[];return e!==void 0&&e!==0&&!Number.isNaN(e)&&n.push(AbortSignal.timeout(e)),t&&n.push(t),n.length===0?null:n.length===1?n[0]:AbortSignal.any(n)}function $(){return typeof document<"u"||"importScripts"in globalThis}var P={status:400,statusText:"Bad request \u2014 the account does not comply with an acceptable format."},O={status:401},b={status:403,statusText:"Forbidden - access denied."},S={status:404,statusText:"Not found."},A={status:429};var f=class extends Error{retryAfterSeconds;constructor(t,n,r){super(n,r),this.name=this.constructor.name,this.retryAfterSeconds=t===null?void 0:Number.parseInt(t,10)}};async function x(e){return await e.json()}function D(e){return`Request blocked, contact haveibeenpwned.com if this continues (Ray ID: ${e})`}function y({status:e,statusText:t}){return`${e} ${t}`.trim()}function w(e){try{let t=JSON.parse(e);if(L(t)&&t.message.trim())return t.message}catch{return}}function L(e){return typeof e=="object"&&e!==null&&"message"in e&&typeof e.message=="string"}function R(e,t={},n){let{apiKey:r,baseUrl:s="https://haveibeenpwned.com/api/v3",timeoutMs:i,signal:o,userAgent:a}=t,u={};return r&&(u["HIBP-API-Key"]=r),n&&(u["Content-Type"]="application/json"),h({baseUrl:s,endpoint:e,headers:u,timeoutMs:i,signal:o,userAgent:a,method:n?"POST":void 0,body:n&&JSON.stringify(n)})}async function d(e,t={}){let n=await R(e,t);if(n.ok)return x(n);switch(n.status){case P.status:throw new Error(P.statusText);case O.status:{let r=await n.text();throw new Error(w(r)??(r.trim()?r:y(n)))}case b.status:{let r=n.headers.get("cf-ray");throw r?new Error(D(r)):new Error(b.statusText)}case S.status:return null;case A.status:{let r=w(await n.text())??y(n),s=n.headers.get("retry-after");throw new f(s,r)}default:throw new Error(n.statusText)}}async function g(e,t={}){let n=await d(e,t);if(n===null)throw new Error(S.statusText);return n}function j(e,t={}){return d(`/breach/${encodeURIComponent(e)}`,t)}function E(e,t={}){let{apiKey:n,domain:r,includeUnverified:s=!0,timeoutMs:i,signal:o,truncate:a=!0,baseUrl:u,userAgent:c}=t,p=`/breachedaccount/${encodeURIComponent(e)}?`,m=[];return r&&m.push(`domain=${encodeURIComponent(r)}`),s||m.push("includeUnverified=false"),a||m.push("truncateResponse=false"),d(`${p}${m.join("&")}`,{apiKey:n,baseUrl:u,timeoutMs:i,signal:o,userAgent:c})}function _(e,t={}){let{apiKey:n,baseUrl:r,timeoutMs:s,signal:i,userAgent:o}=t;return d(`/breachedaccount/range/${encodeURIComponent(e)}`,{apiKey:n,baseUrl:r,timeoutMs:s,signal:i,userAgent:o})}function q(e,t={}){let{apiKey:n,baseUrl:r,timeoutMs:s,signal:i,userAgent:o}=t,a=`/breacheddomain/${encodeURIComponent(e)}`;return d(a,{apiKey:n,baseUrl:r,timeoutMs:s,signal:i,userAgent:o})}function H(e={}){let{domain:t,isSpamList:n,baseUrl:r,timeoutMs:s,signal:i,userAgent:o}=e,a="/breaches?",u=[];return t&&u.push(`domain=${encodeURIComponent(t)}`),n!==void 0&&u.push(`isSpamList=${n}`),g(`${a}${u.join("&")}`,{baseUrl:r,timeoutMs:s,signal:i,userAgent:o})}function W(e={}){return d("/dataclasses",e)}function Q(e={}){return d("/dataclasses/descriptions",e)}async function l(e,t,n){let r=await R(e,n,t);if(r.ok)return r;let{headers:s,status:i}=r,o=await r.text(),a=s.get("cf-ray"),u=/^text\/plain\b/i.test(s.get("content-type")??""),c=w(o)??(i===b.status&&a?D(a):void 0)??(u&&o.trim()?o:void 0)??y(r);throw i===A.status?new f(s.get("retry-after"),c):new Error(c)}async function G(e,t={}){let n=await l("/domainVerification/generateDnsToken",{DomainName:e},t);return x(n)}function V(e={}){return d("/latestbreach",e)}function B(e,t={}){return d(`/pasteaccount/${encodeURIComponent(e)}`,t)}var N={status:400,body:"The hash prefix was not in a valid format"};async function I(e,t={}){let{baseUrl:n="https://api.pwnedpasswords.com",timeoutMs:r,signal:s,userAgent:i,addPadding:o=!1,mode:a="sha1"}=t,u={};o&&(u["Add-Padding"]="true");let c=await h({baseUrl:n,endpoint:e,headers:u,timeoutMs:r,signal:s,userAgent:i,queryParams:{mode:a}});if(c.ok)return c.text();if(c.status===N.status){let p=await c.text();throw new Error(p)}throw new Error(c.statusText)}async function U(e,t={}){let{baseUrl:n,timeoutMs:r,signal:s,userAgent:i,addPadding:o=!1,mode:a="sha1"}=t;return(await I(`/range/${encodeURIComponent(e)}`,{baseUrl:n,timeoutMs:r,signal:s,userAgent:i,addPadding:o,mode:a})).split(`
|
|
2
|
+
`).filter(Boolean).reduce((p,m)=>{let[v,C]=m.split(":");return p[v]=Number.parseInt(C,10),p},{})}async function J(e,t={}){let[n,r]=await Y(e),i=(await U(n,t))[r];return i===void 0||Number.isNaN(i)?0:i}async function Y(e){let t=Z()?.subtle;if(t){let n=new TextEncoder().encode(e),r=await t.digest("SHA-1",n),i=Array.from(new Uint8Array(r)).map(o=>o.toString(16).padStart(2,"0")).join("").toUpperCase();return[i.slice(0,5),i.slice(5)]}throw new Error("The Web Crypto API is not available in this environment.")}function Z(){return globalThis.crypto}var z=/^.+@.+$/;async function X(e,t={}){let{apiKey:n,domain:r,truncate:s=!0,baseUrl:i,timeoutMs:o,signal:a,userAgent:u}=t,[c,p]=await Promise.all([E(e,{apiKey:n,domain:r,truncate:s,baseUrl:i,timeoutMs:o,signal:a,userAgent:u}),z.test(e)?B(e,{apiKey:n,baseUrl:i,timeoutMs:o,signal:a,userAgent:u}):null]);return{breaches:c,pastes:p}}async function ee(e,t,n={}){await l("/domainVerification/sendEmail",{DomainName:e,EmailAlias:t},n)}function ne(e,t={}){let{apiKey:n,baseUrl:r,timeoutMs:s,signal:i,userAgent:o}=t,a=`/stealerlogsbyemail/${encodeURIComponent(e)}`;return d(a,{apiKey:n,baseUrl:r,timeoutMs:s,signal:i,userAgent:o})}function te(e,t={}){let{apiKey:n,baseUrl:r,timeoutMs:s,signal:i,userAgent:o}=t,a=`/stealerlogsbyemaildomain/${encodeURIComponent(e)}`;return d(a,{apiKey:n,baseUrl:r,timeoutMs:s,signal:i,userAgent:o})}function re(e,t={}){let{apiKey:n,baseUrl:r,timeoutMs:s,signal:i,userAgent:o}=t,a=`/stealerlogsbywebsitedomain/${encodeURIComponent(e)}`;return d(a,{apiKey:n,baseUrl:r,timeoutMs:s,signal:i,userAgent:o})}function ie(e={}){let{apiKey:t,baseUrl:n,timeoutMs:r,signal:s,userAgent:i}=e;return g("/subscribeddomains",{apiKey:t,baseUrl:n,timeoutMs:r,signal:s,userAgent:i})}async function se(e={}){return g("/subscription/status",e)}async function oe(e,t={}){await l("/domainVerification/verifyDnsToken",{DomainName:e},t)}export{f as RateLimitError,j as breach,E as breachedAccount,_ as breachedAccountRange,q as breachedDomain,H as breaches,Q as dataClassDescriptions,W as dataClasses,G as generateDnsToken,V as latestBreach,B as pasteAccount,J as pwnedPassword,U as pwnedPasswordRange,X as search,ee as sendEmail,ne as stealerLogsByEmail,te as stealerLogsByEmailDomain,re as stealerLogsByWebsiteDomain,ie as subscribedDomains,se as subscriptionStatus,oe as verifyDnsToken};
|
|
@@ -1,11 +1,15 @@
|
|
|
1
|
-
export declare function baseFetch({ baseUrl, endpoint, headers, timeoutMs, signal, userAgent, queryParams, }: {
|
|
1
|
+
export declare function baseFetch({ baseUrl, endpoint, headers, timeoutMs, signal, userAgent, queryParams, method, body, }: {
|
|
2
2
|
baseUrl: string;
|
|
3
3
|
endpoint: string;
|
|
4
4
|
headers?: Record<string, string>;
|
|
5
|
-
timeoutMs?: number;
|
|
6
|
-
signal?: AbortSignal;
|
|
7
|
-
userAgent?: string;
|
|
5
|
+
timeoutMs?: number | undefined;
|
|
6
|
+
signal?: AbortSignal | undefined;
|
|
7
|
+
userAgent?: string | undefined;
|
|
8
8
|
queryParams?: Record<string, string>;
|
|
9
|
+
method?: "POST" | undefined;
|
|
10
|
+
body?: string | undefined;
|
|
9
11
|
}): Promise<Response>;
|
|
10
12
|
export declare function buildUrl(baseUrl: string, endpoint: string, queryParams?: Record<string, string>): string;
|
|
11
|
-
export declare function buildHeaders(userAgent?: string, extra?: Record<string, string>):
|
|
13
|
+
export declare function buildHeaders(userAgent?: string, extra?: Record<string, string>): {
|
|
14
|
+
[x: string]: string;
|
|
15
|
+
};
|
|
@@ -1,7 +1,8 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
export async function baseFetch({ baseUrl, endpoint, headers, timeoutMs, signal, userAgent, queryParams, }) {
|
|
1
|
+
import { PACKAGE_NAME, PACKAGE_VERSION, } from "./haveibeenpwned/package-info.js";
|
|
2
|
+
export async function baseFetch({ baseUrl, endpoint, headers, timeoutMs, signal, userAgent, queryParams, method, body, }) {
|
|
4
3
|
const requestInit = {
|
|
4
|
+
method: method ?? "GET",
|
|
5
|
+
body: body ?? null,
|
|
5
6
|
headers: buildHeaders(userAgent, headers),
|
|
6
7
|
signal: buildSignal(timeoutMs, signal),
|
|
7
8
|
};
|
|
@@ -9,8 +10,10 @@ export async function baseFetch({ baseUrl, endpoint, headers, timeoutMs, signal,
|
|
|
9
10
|
return fetch(url, requestInit);
|
|
10
11
|
}
|
|
11
12
|
export function buildUrl(baseUrl, endpoint, queryParams) {
|
|
12
|
-
const base = baseUrl.replace(/\/$/g,
|
|
13
|
-
const normalizedEndpoint = endpoint.startsWith(
|
|
13
|
+
const base = baseUrl.replace(/\/$/g, "");
|
|
14
|
+
const normalizedEndpoint = endpoint.startsWith("/")
|
|
15
|
+
? endpoint
|
|
16
|
+
: `/${endpoint}`;
|
|
14
17
|
const url = new URL(`${base}${normalizedEndpoint}`);
|
|
15
18
|
if (queryParams) {
|
|
16
19
|
for (const [key, value] of Object.entries(queryParams)) {
|
|
@@ -22,23 +25,27 @@ export function buildUrl(baseUrl, endpoint, queryParams) {
|
|
|
22
25
|
export function buildHeaders(userAgent, extra) {
|
|
23
26
|
const headers = { ...extra };
|
|
24
27
|
if (userAgent) {
|
|
25
|
-
headers[
|
|
28
|
+
headers["User-Agent"] = userAgent;
|
|
26
29
|
}
|
|
27
|
-
else if (
|
|
28
|
-
headers[
|
|
30
|
+
else if (!isBrowser()) {
|
|
31
|
+
headers["User-Agent"] = `${PACKAGE_NAME} ${PACKAGE_VERSION}`;
|
|
29
32
|
}
|
|
30
33
|
return headers;
|
|
31
34
|
}
|
|
32
35
|
function buildSignal(timeoutMs, signal) {
|
|
33
36
|
const signals = [];
|
|
34
|
-
if (timeoutMs)
|
|
37
|
+
if (timeoutMs !== undefined && timeoutMs !== 0 && !Number.isNaN(timeoutMs)) {
|
|
35
38
|
signals.push(AbortSignal.timeout(timeoutMs));
|
|
39
|
+
}
|
|
36
40
|
if (signal)
|
|
37
41
|
signals.push(signal);
|
|
38
42
|
if (signals.length === 0)
|
|
39
|
-
return
|
|
43
|
+
return null;
|
|
40
44
|
if (signals.length === 1)
|
|
41
45
|
return signals[0];
|
|
42
46
|
return AbortSignal.any(signals);
|
|
43
47
|
}
|
|
48
|
+
function isBrowser() {
|
|
49
|
+
return typeof document !== "undefined" || "importScripts" in globalThis;
|
|
50
|
+
}
|
|
44
51
|
//# sourceMappingURL=base-fetch.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"base-fetch.js","sourceRoot":"","sources":["../../../src/api/base-fetch.ts"],"names":[],"mappings":"AAAA,
|
|
1
|
+
{"version":3,"file":"base-fetch.js","sourceRoot":"","sources":["../../../src/api/base-fetch.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,eAAe,GAChB,MAAM,kCAAkC,CAAC;AAE1C,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,EAC9B,OAAO,EACP,QAAQ,EACR,OAAO,EACP,SAAS,EACT,MAAM,EACN,SAAS,EACT,WAAW,EACX,MAAM,EACN,IAAI,GAWL;IACC,MAAM,WAAW,GAAgB;QAC/B,MAAM,EAAE,MAAM,IAAI,KAAK;QACvB,IAAI,EAAE,IAAI,IAAI,IAAI;QAClB,OAAO,EAAE,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC;QACzC,MAAM,EAAE,WAAW,CAAC,SAAS,EAAE,MAAM,CAAC;KACvC,CAAC;IAEF,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;IAErD,OAAO,KAAK,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,QAAQ,CACtB,OAAe,EACf,QAAgB,EAChB,WAAoC;IAEpC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAEzC,MAAM,kBAAkB,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC;QACjD,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,IAAI,QAAQ,EAAE,CAAC;IAEnB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,IAAI,GAAG,kBAAkB,EAAE,CAAC,CAAC;IAEpD,IAAI,WAAW,EAAE,CAAC;QAChB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;YACvD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,SAAkB,EAClB,KAA8B;IAE9B,MAAM,OAAO,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;IAE7B,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC;IACpC,CAAC;SAAM,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;QACxB,OAAO,CAAC,YAAY,CAAC,GAAG,GAAG,YAAY,IAAI,eAAe,EAAE,CAAC;IAC/D,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,WAAW,CAClB,SAAkB,EAClB,MAAoB;IAEpB,MAAM,OAAO,GAAkB,EAAE,CAAC;IAElC,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3E,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,MAAM;QAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEjC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEtC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC;IAE5C,OAAO,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,OAAO,QAAQ,KAAK,WAAW,IAAI,eAAe,IAAI,UAAU,CAAC;AAC1E,CAAC"}
|
|
@@ -12,5 +12,5 @@ export declare class RateLimitError extends Error {
|
|
|
12
12
|
* should never happen.
|
|
13
13
|
*/
|
|
14
14
|
retryAfterSeconds: number | undefined;
|
|
15
|
-
constructor(retryAfter: ReturnType<Headers[
|
|
15
|
+
constructor(retryAfter: ReturnType<Headers["get"]>, message: string | undefined, options?: ErrorOptions);
|
|
16
16
|
}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { baseFetch } from
|
|
2
|
-
import { BAD_REQUEST, UNAUTHORIZED, FORBIDDEN, NOT_FOUND, TOO_MANY_REQUESTS } from
|
|
1
|
+
import { baseFetch } from "../base-fetch.js";
|
|
2
|
+
import { BAD_REQUEST, UNAUTHORIZED, FORBIDDEN, NOT_FOUND, TOO_MANY_REQUESTS, } from "./responses.js";
|
|
3
3
|
/**
|
|
4
4
|
* Custom error thrown when the haveibeenpwned.com API responds with 429 Too
|
|
5
5
|
* Many Requests. See the `retryAfterSeconds` property for the number of seconds
|
|
@@ -18,65 +18,76 @@ export class RateLimitError extends Error {
|
|
|
18
18
|
super(message, options);
|
|
19
19
|
this.name = this.constructor.name;
|
|
20
20
|
this.retryAfterSeconds =
|
|
21
|
-
|
|
21
|
+
retryAfter === null ? undefined : Number.parseInt(retryAfter, 10);
|
|
22
22
|
}
|
|
23
23
|
}
|
|
24
|
-
|
|
24
|
+
/** @internal */
|
|
25
|
+
export async function readJson(response) {
|
|
26
|
+
// SAFETY: haveibeenpwned.com documents each endpoint's response shape
|
|
27
|
+
return (await response.json());
|
|
28
|
+
}
|
|
29
|
+
/** @internal */
|
|
30
|
+
export function blockedWithRayId(rayId) {
|
|
25
31
|
return `Request blocked, contact haveibeenpwned.com if this continues (Ray ID: ${rayId})`;
|
|
26
32
|
}
|
|
27
|
-
/**
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
* Error
|
|
54
|
-
*/
|
|
55
|
-
export async function fetchFromApi(endpoint, options = {}) {
|
|
56
|
-
const { apiKey, baseUrl = 'https://haveibeenpwned.com/api/v3', timeoutMs, signal, userAgent, } = options;
|
|
33
|
+
/** @internal */
|
|
34
|
+
export function statusLine({ status, statusText }) {
|
|
35
|
+
return `${status} ${statusText}`.trim();
|
|
36
|
+
}
|
|
37
|
+
/** @internal */
|
|
38
|
+
export function jsonMessage(text) {
|
|
39
|
+
try {
|
|
40
|
+
const error = JSON.parse(text);
|
|
41
|
+
if (hasStringMessage(error) && error.message.trim()) {
|
|
42
|
+
return error.message;
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
catch {
|
|
46
|
+
return undefined;
|
|
47
|
+
}
|
|
48
|
+
return undefined;
|
|
49
|
+
}
|
|
50
|
+
function hasStringMessage(value) {
|
|
51
|
+
return (typeof value === "object" &&
|
|
52
|
+
value !== null &&
|
|
53
|
+
"message" in value &&
|
|
54
|
+
typeof value.message === "string");
|
|
55
|
+
}
|
|
56
|
+
/** @internal */
|
|
57
|
+
export function requestApi(endpoint, options = {}, body) {
|
|
58
|
+
const { apiKey, baseUrl = "https://haveibeenpwned.com/api/v3", timeoutMs, signal, userAgent, } = options;
|
|
57
59
|
const headers = {};
|
|
58
60
|
if (apiKey)
|
|
59
|
-
headers[
|
|
60
|
-
|
|
61
|
+
headers["HIBP-API-Key"] = apiKey;
|
|
62
|
+
if (body)
|
|
63
|
+
headers["Content-Type"] = "application/json";
|
|
64
|
+
return baseFetch({
|
|
61
65
|
baseUrl,
|
|
62
66
|
endpoint,
|
|
63
67
|
headers,
|
|
64
68
|
timeoutMs,
|
|
65
69
|
signal,
|
|
66
70
|
userAgent,
|
|
71
|
+
method: body ? "POST" : undefined,
|
|
72
|
+
body: body && JSON.stringify(body),
|
|
67
73
|
});
|
|
68
|
-
|
|
69
|
-
|
|
74
|
+
}
|
|
75
|
+
/** @internal */
|
|
76
|
+
export async function fetchFromApi(endpoint, options = {}) {
|
|
77
|
+
const response = await requestApi(endpoint, options);
|
|
78
|
+
if (response.ok) {
|
|
79
|
+
return readJson(response);
|
|
80
|
+
}
|
|
70
81
|
switch (response.status) {
|
|
71
82
|
case BAD_REQUEST.status: {
|
|
72
83
|
throw new Error(BAD_REQUEST.statusText);
|
|
73
84
|
}
|
|
74
85
|
case UNAUTHORIZED.status: {
|
|
75
|
-
const
|
|
76
|
-
throw new Error(
|
|
86
|
+
const text = await response.text();
|
|
87
|
+
throw new Error(jsonMessage(text) ?? (text.trim() ? text : statusLine(response)));
|
|
77
88
|
}
|
|
78
89
|
case FORBIDDEN.status: {
|
|
79
|
-
const rayId = response.headers.get(
|
|
90
|
+
const rayId = response.headers.get("cf-ray");
|
|
80
91
|
if (rayId)
|
|
81
92
|
throw new Error(blockedWithRayId(rayId));
|
|
82
93
|
throw new Error(FORBIDDEN.statusText);
|
|
@@ -85,13 +96,20 @@ export async function fetchFromApi(endpoint, options = {}) {
|
|
|
85
96
|
return null;
|
|
86
97
|
}
|
|
87
98
|
case TOO_MANY_REQUESTS.status: {
|
|
88
|
-
const
|
|
89
|
-
const retryAfter = response.headers.get(
|
|
90
|
-
throw new RateLimitError(retryAfter,
|
|
99
|
+
const message = jsonMessage(await response.text()) ?? statusLine(response);
|
|
100
|
+
const retryAfter = response.headers.get("retry-after");
|
|
101
|
+
throw new RateLimitError(retryAfter, message);
|
|
91
102
|
}
|
|
92
103
|
default: {
|
|
93
104
|
throw new Error(response.statusText);
|
|
94
105
|
}
|
|
95
106
|
}
|
|
96
107
|
}
|
|
108
|
+
/** @internal */
|
|
109
|
+
export async function fetchRequiredFromApi(endpoint, options = {}) {
|
|
110
|
+
const data = await fetchFromApi(endpoint, options);
|
|
111
|
+
if (data === null)
|
|
112
|
+
throw new Error(NOT_FOUND.statusText);
|
|
113
|
+
return data;
|
|
114
|
+
}
|
|
97
115
|
//# sourceMappingURL=fetch-from-api.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"fetch-from-api.js","sourceRoot":"","sources":["../../../../src/api/haveibeenpwned/fetch-from-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,
|
|
1
|
+
{"version":3,"file":"fetch-from-api.js","sourceRoot":"","sources":["../../../../src/api/haveibeenpwned/fetch-from-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EACL,WAAW,EACX,YAAY,EACZ,SAAS,EACT,SAAS,EACT,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAExB;;;;;;GAMG;AACH,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC;;;;OAIG;IACI,iBAAiB,CAAqB;IAE7C,YACE,UAAsC,EACtC,OAA2B,EAC3B,OAAsB;QAEtB,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,IAAI,CAAC,iBAAiB;YACpB,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACtE,CAAC;CACF;AAED,gBAAgB;AAChB,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAO,QAAkB;IACrD,sEAAsE;IACtE,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAS,CAAC;AACzC,CAAC;AAED,gBAAgB;AAChB,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,0EAA0E,KAAK,GAAG,CAAC;AAC5F,CAAC;AAED,gBAAgB;AAChB,MAAM,UAAU,UAAU,CAAC,EAAE,MAAM,EAAE,UAAU,EAAY;IACzD,OAAO,GAAG,MAAM,IAAI,UAAU,EAAE,CAAC,IAAI,EAAE,CAAC;AAC1C,CAAC;AAED,gBAAgB;AAChB,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,IAAI,CAAC;QACH,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAExC,IAAI,gBAAgB,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YACpD,OAAO,KAAK,CAAC,OAAO,CAAC;QACvB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,SAAS,IAAI,KAAK;QAClB,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CAClC,CAAC;AACJ,CAAC;AAWD,gBAAgB;AAChB,MAAM,UAAU,UAAU,CACxB,QAAgB,EAChB,OAAO,GAAe,EAAE,EACxB,IAA6B;IAE7B,MAAM,EACJ,MAAM,EACN,OAAO,GAAG,mCAAmC,EAC7C,SAAS,EACT,MAAM,EACN,SAAS,GACV,GAAG,OAAO,CAAC;IAEZ,MAAM,OAAO,GAA2B,EAAE,CAAC;IAE3C,IAAI,MAAM;QAAE,OAAO,CAAC,cAAc,CAAC,GAAG,MAAM,CAAC;IAE7C,IAAI,IAAI;QAAE,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;IAEvD,OAAO,SAAS,CAAC;QACf,OAAO;QACP,QAAQ;QACR,OAAO;QACP,SAAS;QACT,MAAM;QACN,SAAS;QACT,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;QACjC,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;KACnC,CAAC,CAAC;AACL,CAAC;AAED,gBAAgB;AAChB,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAgB,EAChB,OAAO,GAAe,EAAE;IAExB,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAErD,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;QAChB,OAAO,QAAQ,CAAO,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC;QACxB,KAAK,WAAW,CAAC,MAAM,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;QAC1C,CAAC;QAED,KAAK,YAAY,CAAC,MAAM,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CACb,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CACjE,CAAC;QACJ,CAAC;QAED,KAAK,SAAS,CAAC,MAAM,EAAE,CAAC;YACtB,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAE7C,IAAI,KAAK;gBAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC;YACpD,MAAM,IAAI,KAAK,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACxC,CAAC;QAED,KAAK,SAAS,CAAC,MAAM,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,KAAK,iBAAiB,CAAC,MAAM,EAAE,CAAC;YAC9B,MAAM,OAAO,GACX,WAAW,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC;YAE7D,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YACvD,MAAM,IAAI,cAAc,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAChD,CAAC;QAED,SAAS,CAAC;YACR,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;AACH,CAAC;AAED,gBAAgB;AAChB,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,QAAgB,EAChB,OAAO,GAAe,EAAE;IAExB,MAAM,IAAI,GAAG,MAAM,YAAY,CAAO,QAAQ,EAAE,OAAO,CAAC,CAAC;IAEzD,IAAI,IAAI,KAAK,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAEzD,OAAO,IAAI,CAAC;AACd,CAAC"}
|
|
@@ -1,2 +1,2 @@
|
|
|
1
1
|
export declare const PACKAGE_NAME = "hibp";
|
|
2
|
-
export declare const PACKAGE_VERSION = "
|
|
2
|
+
export declare const PACKAGE_VERSION = "16.0.1";
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import { blockedWithRayId, jsonMessage, RateLimitError, requestApi, statusLine, } from "./fetch-from-api.js";
|
|
2
|
+
import { FORBIDDEN, TOO_MANY_REQUESTS } from "./responses.js";
|
|
3
|
+
/** @internal */
|
|
4
|
+
export async function postToApi(endpoint, body, options) {
|
|
5
|
+
const response = await requestApi(endpoint, options, body);
|
|
6
|
+
if (response.ok)
|
|
7
|
+
return response;
|
|
8
|
+
const { headers, status } = response;
|
|
9
|
+
const text = await response.text();
|
|
10
|
+
const rayId = headers.get("cf-ray");
|
|
11
|
+
const isPlainText = /^text\/plain\b/i.test(headers.get("content-type") ?? "");
|
|
12
|
+
const message = jsonMessage(text) ??
|
|
13
|
+
(status === FORBIDDEN.status && rayId
|
|
14
|
+
? blockedWithRayId(rayId)
|
|
15
|
+
: undefined) ??
|
|
16
|
+
(isPlainText && text.trim() ? text : undefined) ??
|
|
17
|
+
statusLine(response);
|
|
18
|
+
if (status === TOO_MANY_REQUESTS.status) {
|
|
19
|
+
throw new RateLimitError(headers.get("retry-after"), message);
|
|
20
|
+
}
|
|
21
|
+
throw new Error(message);
|
|
22
|
+
}
|
|
23
|
+
//# sourceMappingURL=post-to-api.js.map
|