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.
Files changed (91) hide show
  1. package/API.md +433 -126
  2. package/CHANGELOG.md +52 -0
  3. package/MIGRATION.md +7 -5
  4. package/README.md +53 -27
  5. package/dist/browser/hibp.module.js +2 -2
  6. package/dist/esm/api/base-fetch.d.ts +9 -5
  7. package/dist/esm/api/base-fetch.js +17 -10
  8. package/dist/esm/api/base-fetch.js.map +1 -1
  9. package/dist/esm/api/haveibeenpwned/fetch-from-api.d.ts +1 -1
  10. package/dist/esm/api/haveibeenpwned/fetch-from-api.js +62 -44
  11. package/dist/esm/api/haveibeenpwned/fetch-from-api.js.map +1 -1
  12. package/dist/esm/api/haveibeenpwned/package-info.d.ts +1 -1
  13. package/dist/esm/api/haveibeenpwned/package-info.js +1 -1
  14. package/dist/esm/api/haveibeenpwned/post-to-api.d.ts +1 -0
  15. package/dist/esm/api/haveibeenpwned/post-to-api.js +23 -0
  16. package/dist/esm/api/haveibeenpwned/post-to-api.js.map +1 -0
  17. package/dist/esm/api/haveibeenpwned/responses.d.ts +0 -10
  18. package/dist/esm/api/haveibeenpwned/responses.js +5 -36
  19. package/dist/esm/api/haveibeenpwned/responses.js.map +1 -1
  20. package/dist/esm/api/haveibeenpwned/types.d.ts +22 -2
  21. package/dist/esm/api/haveibeenpwned/types.js +0 -3
  22. package/dist/esm/api/haveibeenpwned/types.js.map +1 -1
  23. package/dist/esm/api/pwnedpasswords/fetch-from-api.js +5 -28
  24. package/dist/esm/api/pwnedpasswords/fetch-from-api.js.map +1 -1
  25. package/dist/esm/api/pwnedpasswords/responses.d.ts +0 -6
  26. package/dist/esm/api/pwnedpasswords/responses.js +1 -7
  27. package/dist/esm/api/pwnedpasswords/responses.js.map +1 -1
  28. package/dist/esm/breach.d.ts +12 -5
  29. package/dist/esm/breach.js +8 -1
  30. package/dist/esm/breach.js.map +1 -1
  31. package/dist/esm/breached-account-range.d.ts +73 -0
  32. package/dist/esm/breached-account-range.js +60 -0
  33. package/dist/esm/breached-account-range.js.map +1 -0
  34. package/dist/esm/breached-account.d.ts +56 -45
  35. package/dist/esm/breached-account.js +4 -76
  36. package/dist/esm/breached-account.js.map +1 -1
  37. package/dist/esm/breached-domain.d.ts +7 -8
  38. package/dist/esm/breached-domain.js +2 -3
  39. package/dist/esm/breached-domain.js.map +1 -1
  40. package/dist/esm/breaches.d.ts +14 -7
  41. package/dist/esm/breaches.js +10 -5
  42. package/dist/esm/breaches.js.map +1 -1
  43. package/dist/esm/data-class-descriptions.d.ts +55 -0
  44. package/dist/esm/data-class-descriptions.js +39 -0
  45. package/dist/esm/data-class-descriptions.js.map +1 -0
  46. package/dist/esm/data-classes.d.ts +4 -4
  47. package/dist/esm/data-classes.js +2 -2
  48. package/dist/esm/data-classes.js.map +1 -1
  49. package/dist/esm/generate-dns-token.d.ts +67 -0
  50. package/dist/esm/generate-dns-token.js +49 -0
  51. package/dist/esm/generate-dns-token.js.map +1 -0
  52. package/dist/esm/hibp.d.ts +28 -18
  53. package/dist/esm/hibp.js +22 -28
  54. package/dist/esm/hibp.js.map +1 -1
  55. package/dist/esm/latest-breach.d.ts +5 -5
  56. package/dist/esm/latest-breach.js +2 -2
  57. package/dist/esm/latest-breach.js.map +1 -1
  58. package/dist/esm/paste-account.d.ts +13 -13
  59. package/dist/esm/paste-account.js +8 -8
  60. package/dist/esm/paste-account.js.map +1 -1
  61. package/dist/esm/pwned-password-range.d.ts +6 -6
  62. package/dist/esm/pwned-password-range.js +4 -6
  63. package/dist/esm/pwned-password-range.js.map +1 -1
  64. package/dist/esm/pwned-password.d.ts +5 -5
  65. package/dist/esm/pwned-password.js +12 -7
  66. package/dist/esm/pwned-password.js.map +1 -1
  67. package/dist/esm/search.d.ts +57 -40
  68. package/dist/esm/search.js +5 -74
  69. package/dist/esm/search.js.map +1 -1
  70. package/dist/esm/send-email.d.ts +69 -0
  71. package/dist/esm/send-email.js +49 -0
  72. package/dist/esm/send-email.js.map +1 -0
  73. package/dist/esm/stealer-logs-by-email-domain.d.ts +13 -14
  74. package/dist/esm/stealer-logs-by-email-domain.js +8 -9
  75. package/dist/esm/stealer-logs-by-email-domain.js.map +1 -1
  76. package/dist/esm/stealer-logs-by-email.d.ts +9 -10
  77. package/dist/esm/stealer-logs-by-email.js +5 -6
  78. package/dist/esm/stealer-logs-by-email.js.map +1 -1
  79. package/dist/esm/stealer-logs-by-website-domain.d.ts +9 -10
  80. package/dist/esm/stealer-logs-by-website-domain.js +5 -6
  81. package/dist/esm/stealer-logs-by-website-domain.js.map +1 -1
  82. package/dist/esm/subscribed-domains.d.ts +7 -8
  83. package/dist/esm/subscribed-domains.js +4 -5
  84. package/dist/esm/subscribed-domains.js.map +1 -1
  85. package/dist/esm/subscription-status.d.ts +16 -11
  86. package/dist/esm/subscription-status.js +13 -8
  87. package/dist/esm/subscription-status.js.map +1 -1
  88. package/dist/esm/verify-dns-token.d.ts +60 -0
  89. package/dist/esm/verify-dns-token.js +41 -0
  90. package/dist/esm/verify-dns-token.js.map +1 -0
  91. 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 'hibp';
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 'hibp';
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 'hibp';
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, 'adobe.com', true).then(/* ... */);
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.breachedAccount(account, { domain: 'adobe.com', truncate: true }).then(/* ... */);
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
  [![All Contributors](https://img.shields.io/github/all-contributors/wKovacs64/hibp?style=flat-square)](#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 'npm:hibp@x.y.z';
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 (🔑 = [requires][api-key-blog-post] an [API key][get-api-key])
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 all pastes for an account 🔑
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
- - Search for an account in both breaches and pastes at the same time 🔑
49
- - Get all stealer log domains for an email address 🔑
50
- - Get all stealer log email aliases for an email domain 🔑
51
- - Get all stealer log email addresses for a website domain 🔑
52
- - Get all subscribed domains 🔑
53
- - Get your subscription status 🔑
54
- - All queries return a Promise
55
- - Provide your own `AbortSignal` to cancel in-flight requests
56
- - Available server-side (e.g., Node.js) and client-side (browser)
57
- - Written in TypeScript, so all modules come fully typed
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 'hibp';
84
+ import { dataClasses, search } from "hibp";
64
85
 
65
86
  // or, import all modules into a local namespace
66
- import * as hibp from 'hibp';
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 'hibp';
118
+ import { search } from "hibp";
93
119
 
94
120
  async function main() {
95
121
  try {
96
- const data = await search('someAccountOrEmail', { apiKey: 'my-api-key' });
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('Good news — no pwnage found!');
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 'https://unpkg.com/hibp@x.y.z/dist/browser/hibp.module.js';
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
- [api-key-blog-post]: https://www.troyhunt.com/authentication-and-the-have-i-been-pwned-api/
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 w="hibp",P="15.2.1";async function g({baseUrl:e,endpoint:t,headers:r,timeoutMs:s,signal:n,userAgent:o,queryParams:a}){let i={headers:I(o,r),signal:v(s,n)},c=M(e,t,a);return fetch(c,i)}function M(e,t,r){let s=e.replace(/\/$/g,""),n=t.startsWith("/")?t:`/${t}`,o=new URL(`${s}${n}`);if(r)for(let[a,i]of Object.entries(r))o.searchParams.set(a,i);return o.toString()}function I(e,t){let r={...t};return e?r["User-Agent"]=e:typeof navigator>"u"&&(r["User-Agent"]=`${w} ${P}`),r}function v(e,t){let r=[];if(e&&r.push(AbortSignal.timeout(e)),t&&r.push(t),r.length!==0)return r.length===1?r[0]:AbortSignal.any(r)}var b={status:400,statusText:"Bad request \u2014 the account does not comply with an acceptable format."},S={status:401,body:`Your request to the API couldn't be authorised. Check you have the right value in the "hibp-api-key" header, refer to the documentation for more: https://haveibeenpwned.com/API/v3#Authorisation`},f={status:403,statusText:"Forbidden - access denied."};var U={status:404},x={headers:new Map([["retry-after","2"]]),status:429,body:{statusCode:429,message:"Rate limit is exceeded. Try again in 2 seconds."}};var d=class extends Error{retryAfterSeconds;constructor(t,r,s){super(r,s),this.name=this.constructor.name,this.retryAfterSeconds=typeof t=="string"?Number.parseInt(t,10):void 0}};function K(e){return`Request blocked, contact haveibeenpwned.com if this continues (Ray ID: ${e})`}async function m(e,t={}){let{apiKey:r,baseUrl:s="https://haveibeenpwned.com/api/v3",timeoutMs:n,signal:o,userAgent:a}=t,i={};r&&(i["HIBP-API-Key"]=r);let c=await g({baseUrl:s,endpoint:e,headers:i,timeoutMs:n,signal:o,userAgent:a});if(c.ok)return c.json();switch(c.status){case b.status:throw new Error(b.statusText);case S.status:{let p=await c.text();throw new Error(p)}case f.status:{let p=c.headers.get("cf-ray");throw p?new Error(K(p)):new Error(f.statusText)}case U.status:return null;case x.status:{let p=await c.json(),u=c.headers.get("retry-after");throw new d(u,p.message)}default:throw new Error(c.statusText)}}function C(e,t={}){return m(`/breach/${encodeURIComponent(e)}`,t)}function h(e,t={}){let{apiKey:r,domain:s,includeUnverified:n=!0,timeoutMs:o,signal:a,truncate:i=!0,baseUrl:c,userAgent:p}=t,u=`/breachedaccount/${encodeURIComponent(e)}?`,l=[];return s&&l.push(`domain=${encodeURIComponent(s)}`),n||l.push("includeUnverified=false"),i||l.push("truncateResponse=false"),m(`${u}${l.join("&")}`,{apiKey:r,baseUrl:c,timeoutMs:o,signal:a,userAgent:p})}function T(e,t={}){let{apiKey:r,baseUrl:s,timeoutMs:n,signal:o,userAgent:a}=t,i=`/breacheddomain/${encodeURIComponent(e)}`;return m(i,{apiKey:r,baseUrl:s,timeoutMs:n,signal:o,userAgent:a})}function F(e={}){let{domain:t,baseUrl:r,timeoutMs:s,signal:n,userAgent:o}=e,a="/breaches?",i=[];return t&&i.push(`domain=${encodeURIComponent(t)}`),m(`${a}${i.join("&")}`,{baseUrl:r,timeoutMs:s,signal:n,userAgent:o})}function $(e={}){return m("/dataclasses",e)}function j(e={}){return m("/latestbreach",e)}function y(e,t={}){return m(`/pasteaccount/${encodeURIComponent(e)}`,t)}var E={status:400,body:"The hash prefix was not in a valid format"};async function B(e,t={}){let{baseUrl:r="https://api.pwnedpasswords.com",timeoutMs:s,signal:n,userAgent:o,addPadding:a=!1,mode:i="sha1"}=t,c={};a&&(c["Add-Padding"]="true");let p=await g({baseUrl:r,endpoint:e,headers:c,timeoutMs:s,signal:n,userAgent:o,queryParams:{mode:i}});if(p.ok)return p.text();if(p.status===E.status){let u=await p.text();throw new Error(u)}throw new Error(p.statusText)}async function A(e,t={}){let{baseUrl:r,timeoutMs:s,signal:n,userAgent:o,addPadding:a=!1,mode:i="sha1"}=t;return(await B(`/range/${encodeURIComponent(e)}`,{baseUrl:r,timeoutMs:s,signal:n,userAgent:o,addPadding:a,mode:i})).split(`
2
- `).filter(Boolean).reduce((u,l)=>{let[R,D]=l.split(":");return u[R]=Number.parseInt(D,10),u},{})}async function L(e,t={}){let[r,s]=await O(e);return(await A(r,t))[s]||0}async function O(e){if(typeof crypto=="object"&&crypto.subtle){let t=new TextEncoder().encode(e),r=await crypto.subtle.digest("SHA-1",t),n=Array.from(new Uint8Array(r)).map(o=>o.toString(16).padStart(2,"0")).join("").toUpperCase();return[n.slice(0,5),n.slice(5)]}throw new Error("The Web Crypto API is not available in this environment.")}async function N(e,t={}){let{apiKey:r,domain:s,truncate:n=!0,baseUrl:o,timeoutMs:a,signal:i,userAgent:c}=t,[p,u]=await Promise.all([h(e,{apiKey:r,domain:s,truncate:n,baseUrl:o,timeoutMs:a,signal:i,userAgent:c}),/^.+@.+$/.test(e)?y(e,{apiKey:r,baseUrl:o,timeoutMs:a,signal:i,userAgent:c}):null]);return{breaches:p,pastes:u}}function _(e,t={}){let{apiKey:r,baseUrl:s,timeoutMs:n,signal:o,userAgent:a}=t,i=`/stealerlogsbyemail/${encodeURIComponent(e)}`;return m(i,{apiKey:r,baseUrl:s,timeoutMs:n,signal:o,userAgent:a})}function H(e,t={}){let{apiKey:r,baseUrl:s,timeoutMs:n,signal:o,userAgent:a}=t,i=`/stealerlogsbyemaildomain/${encodeURIComponent(e)}`;return m(i,{apiKey:r,baseUrl:s,timeoutMs:n,signal:o,userAgent:a})}function k(e,t={}){let{apiKey:r,baseUrl:s,timeoutMs:n,signal:o,userAgent:a}=t,i=`/stealerlogsbywebsitedomain/${encodeURIComponent(e)}`;return m(i,{apiKey:r,baseUrl:s,timeoutMs:n,signal:o,userAgent:a})}function W(e={}){let{apiKey:t,baseUrl:r,timeoutMs:s,signal:n,userAgent:o}=e;return m("/subscribeddomains",{apiKey:t,baseUrl:r,timeoutMs:s,signal:n,userAgent:o})}async function q(e={}){return m("/subscription/status",e)}export{d as RateLimitError,C as breach,h as breachedAccount,T as breachedDomain,F as breaches,$ as dataClasses,j as latestBreach,y as pasteAccount,L as pwnedPassword,A as pwnedPasswordRange,N as search,_ as stealerLogsByEmail,H as stealerLogsByEmailDomain,k as stealerLogsByWebsiteDomain,W as subscribedDomains,q as subscriptionStatus};
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>): Record<string, string>;
13
+ export declare function buildHeaders(userAgent?: string, extra?: Record<string, string>): {
14
+ [x: string]: string;
15
+ };
@@ -1,7 +1,8 @@
1
- // @ts-ignore - package-info.js is generated
2
- import { PACKAGE_NAME, PACKAGE_VERSION } from './haveibeenpwned/package-info.js';
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('/') ? endpoint : `/${endpoint}`;
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['User-Agent'] = userAgent;
28
+ headers["User-Agent"] = userAgent;
26
29
  }
27
- else if (typeof navigator === 'undefined') {
28
- headers['User-Agent'] = `${PACKAGE_NAME} ${PACKAGE_VERSION}`;
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 undefined;
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,4CAA4C;AAC5C,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAEjF,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,EAC9B,OAAO,EACP,QAAQ,EACR,OAAO,EACP,SAAS,EACT,MAAM,EACN,SAAS,EACT,WAAW,GASZ;IACC,MAAM,WAAW,GAAgB;QAC/B,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;IACzC,MAAM,kBAAkB,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,CAAC;IAChF,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,GAA2B,EAAE,GAAG,KAAK,EAAE,CAAC;IAErD,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC;IACpC,CAAC;SAAM,IAAI,OAAO,SAAS,KAAK,WAAW,EAAE,CAAC;QAC5C,OAAO,CAAC,YAAY,CAAC,GAAG,GAAG,YAAY,IAAI,eAAe,EAAE,CAAC;IAC/D,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,WAAW,CAAC,SAAkB,EAAE,MAAoB;IAC3D,MAAM,OAAO,GAAkB,EAAE,CAAC;IAElC,IAAI,SAAS;QAAE,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;IAC5D,IAAI,MAAM;QAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEjC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC;IAE5C,OAAO,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC"}
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['get']>, message: string | undefined, options?: ErrorOptions);
15
+ constructor(retryAfter: ReturnType<Headers["get"]>, message: string | undefined, options?: ErrorOptions);
16
16
  }
@@ -1,5 +1,5 @@
1
- import { baseFetch } from '../base-fetch.js';
2
- import { BAD_REQUEST, UNAUTHORIZED, FORBIDDEN, NOT_FOUND, TOO_MANY_REQUESTS } from './responses.js';
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
- typeof retryAfter === 'string' ? Number.parseInt(retryAfter, 10) : undefined;
21
+ retryAfter === null ? undefined : Number.parseInt(retryAfter, 10);
22
22
  }
23
23
  }
24
- function blockedWithRayId(rayId) {
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
- * Fetches data from the supplied API endpoint.
29
- *
30
- * HTTP status code 200 returns an Object (data found).
31
- * HTTP status code 404 returns null (no data found).
32
- * HTTP status code 400 throws an Error (bad request).
33
- * HTTP status code 401 throws an Error (unauthorized).
34
- * HTTP status code 403 throws an Error (forbidden).
35
- * HTTP status code 429 throws an Error (too many requests).
36
- *
37
- * @internal
38
- * @private
39
- * @param {string} endpoint the API endpoint to query
40
- * @param {object} [options] a configuration object
41
- * @param {string} [options.apiKey] an API key from
42
- * https://haveibeenpwned.com/API/Key
43
- * @param {string} [options.baseUrl] a custom base URL for the
44
- * haveibeenpwned.com API endpoints (default:
45
- * `https://haveibeenpwned.com/api/v3`)
46
- * @param {number} [options.timeoutMs] timeout for the request in milliseconds
47
- * (default: none)
48
- * @param {AbortSignal} [options.signal] an AbortSignal to cancel the request (default: none)
49
- * @param {string} [options.userAgent] a custom string to send as the User-Agent
50
- * field in the request headers (default: `hibp <version>`)
51
- * @returns {Promise<ApiData>} a Promise which resolves to the data resulting
52
- * from the query (or null for 404 Not Found responses), or rejects with an
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['HIBP-API-Key'] = apiKey;
60
- const response = await baseFetch({
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
- if (response.ok)
69
- return response.json();
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 message = await response.text();
76
- throw new Error(message);
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('cf-ray');
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 body = (await response.json());
89
- const retryAfter = response.headers.get('retry-after');
90
- throw new RateLimitError(retryAfter, body.message);
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,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGpG;;;;;;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,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACjF,CAAC;CACF;AAED,SAAS,gBAAgB,CAAC,KAAa;IACrC,OAAO,0EAA0E,KAAK,GAAG,CAAC;AAC5F,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAgB,EAChB,UAMI,EAAE;IAEN,MAAM,EACJ,MAAM,EACN,OAAO,GAAG,mCAAmC,EAC7C,SAAS,EACT,MAAM,EACN,SAAS,GACV,GAAG,OAAO,CAAC;IAEZ,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,IAAI,MAAM;QAAE,OAAO,CAAC,cAAc,CAAC,GAAG,MAAM,CAAC;IAE7C,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC;QAC/B,OAAO;QACP,QAAQ;QACR,OAAO;QACP,SAAS;QACT,MAAM;QACN,SAAS;KACV,CAAC,CAAC;IAEH,IAAI,QAAQ,CAAC,EAAE;QAAE,OAAO,QAAQ,CAAC,IAAI,EAAsB,CAAC;IAE5D,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC;QACxB,KAAK,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;QAC1C,CAAC;QACD,KAAK,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;YACzB,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;QACD,KAAK,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;YACtB,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC7C,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;QACD,KAAK,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;YACtB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC;YAC9B,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAyB,CAAC;YAC7D,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YACvD,MAAM,IAAI,cAAc,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACrD,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;AACH,CAAC"}
1
+ {"version":3,"file":"fetch-from-api.js","sourceRoot":"","sources":["../../../../src/api/haveibeenpwned/fetch-from-api.ts"],"names":[],"mappings":"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"}
@@ -1,2 +1,2 @@
1
1
  export declare const PACKAGE_NAME = "hibp";
2
- export declare const PACKAGE_VERSION = "15.2.1";
2
+ export declare const PACKAGE_VERSION = "16.0.1";
@@ -1,4 +1,4 @@
1
1
  // This file is auto-generated. Do not edit.
2
2
  export const PACKAGE_NAME = "hibp";
3
- export const PACKAGE_VERSION = "15.2.1";
3
+ export const PACKAGE_VERSION = "16.0.1";
4
4
  //# sourceMappingURL=package-info.js.map
@@ -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