@censys/platform-sdk 0.5.0 → 0.6.0

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 (230) hide show
  1. package/README.md +17 -17
  2. package/docs/sdks/globaldata/README.md +190 -92
  3. package/docs/sdks/threathunting/README.md +29 -21
  4. package/examples/globalDataSearch.example.ts +1 -1
  5. package/examples/package-lock.json +3 -3
  6. package/funcs/globalDataConvertLegacySearchQueries.d.ts +18 -0
  7. package/funcs/globalDataConvertLegacySearchQueries.d.ts.map +1 -0
  8. package/funcs/globalDataConvertLegacySearchQueries.js +134 -0
  9. package/funcs/globalDataConvertLegacySearchQueries.js.map +1 -0
  10. package/funcs/globalDataCreateTrackedScan.d.ts +2 -2
  11. package/funcs/globalDataCreateTrackedScan.js +2 -2
  12. package/funcs/{globalDataGetTrackedScanThreatHunting.d.ts → globalDataGetCertificateRaw.d.ts} +4 -5
  13. package/funcs/globalDataGetCertificateRaw.d.ts.map +1 -0
  14. package/funcs/{globalDataGetHostObservationsWithCertificate.js → globalDataGetCertificateRaw.js} +10 -19
  15. package/funcs/globalDataGetCertificateRaw.js.map +1 -0
  16. package/funcs/globalDataGetCertificates.d.ts +1 -1
  17. package/funcs/globalDataGetCertificates.d.ts.map +1 -1
  18. package/funcs/globalDataGetCertificates.js +9 -6
  19. package/funcs/globalDataGetCertificates.js.map +1 -1
  20. package/funcs/globalDataGetCertificatesRaw.d.ts +18 -0
  21. package/funcs/globalDataGetCertificatesRaw.d.ts.map +1 -0
  22. package/funcs/globalDataGetCertificatesRaw.js +130 -0
  23. package/funcs/globalDataGetCertificatesRaw.js.map +1 -0
  24. package/funcs/globalDataGetHostTimeline.d.ts +1 -1
  25. package/funcs/globalDataGetHostTimeline.js +1 -1
  26. package/funcs/globalDataGetHosts.d.ts +1 -1
  27. package/funcs/globalDataGetHosts.d.ts.map +1 -1
  28. package/funcs/globalDataGetHosts.js +8 -6
  29. package/funcs/globalDataGetHosts.js.map +1 -1
  30. package/funcs/globalDataGetTrackedScan.d.ts +2 -3
  31. package/funcs/globalDataGetTrackedScan.d.ts.map +1 -1
  32. package/funcs/globalDataGetTrackedScan.js +2 -3
  33. package/funcs/globalDataGetTrackedScan.js.map +1 -1
  34. package/funcs/globalDataGetWebProperties.d.ts +1 -1
  35. package/funcs/globalDataGetWebProperties.d.ts.map +1 -1
  36. package/funcs/globalDataGetWebProperties.js +9 -6
  37. package/funcs/globalDataGetWebProperties.js.map +1 -1
  38. package/funcs/threatHuntingCreateTrackedScan.d.ts +2 -2
  39. package/funcs/threatHuntingCreateTrackedScan.js +2 -2
  40. package/funcs/threatHuntingGetHostObservationsWithCertificate.d.ts +18 -0
  41. package/funcs/threatHuntingGetHostObservationsWithCertificate.d.ts.map +1 -0
  42. package/funcs/threatHuntingGetHostObservationsWithCertificate.js +141 -0
  43. package/funcs/threatHuntingGetHostObservationsWithCertificate.js.map +1 -0
  44. package/funcs/threatHuntingGetTrackedScanThreatHunting.d.ts +18 -0
  45. package/funcs/threatHuntingGetTrackedScanThreatHunting.d.ts.map +1 -0
  46. package/funcs/{globalDataGetTrackedScanThreatHunting.js → threatHuntingGetTrackedScanThreatHunting.js} +5 -6
  47. package/funcs/threatHuntingGetTrackedScanThreatHunting.js.map +1 -0
  48. package/jsr.json +1 -1
  49. package/lib/config.d.ts +4 -4
  50. package/lib/config.js +4 -4
  51. package/lib/security.d.ts.map +1 -1
  52. package/lib/security.js.map +1 -1
  53. package/models/components/alternativequery.d.ts +69 -0
  54. package/models/components/alternativequery.d.ts.map +1 -0
  55. package/models/components/alternativequery.js +93 -0
  56. package/models/components/alternativequery.js.map +1 -0
  57. package/models/components/assetcertificatelistinputbody.d.ts +32 -0
  58. package/models/components/assetcertificatelistinputbody.d.ts.map +1 -0
  59. package/models/components/assetcertificatelistinputbody.js +78 -0
  60. package/models/components/assetcertificatelistinputbody.js.map +1 -0
  61. package/models/components/assethostlistinputbody.d.ts +32 -0
  62. package/models/components/assethostlistinputbody.d.ts.map +1 -0
  63. package/models/components/assethostlistinputbody.js +78 -0
  64. package/models/components/assethostlistinputbody.js.map +1 -0
  65. package/models/components/assetwebpropertylistinputbody.d.ts +32 -0
  66. package/models/components/assetwebpropertylistinputbody.d.ts.map +1 -0
  67. package/models/components/assetwebpropertylistinputbody.js +78 -0
  68. package/models/components/assetwebpropertylistinputbody.js.map +1 -0
  69. package/models/components/asteriskmanagerinterface.d.ts +29 -0
  70. package/models/components/asteriskmanagerinterface.d.ts.map +1 -0
  71. package/models/components/asteriskmanagerinterface.js +69 -0
  72. package/models/components/asteriskmanagerinterface.js.map +1 -0
  73. package/models/components/convertqueryerror.d.ts +32 -0
  74. package/models/components/convertqueryerror.d.ts.map +1 -0
  75. package/models/components/convertqueryerror.js +69 -0
  76. package/models/components/convertqueryerror.js.map +1 -0
  77. package/models/components/index.d.ts +12 -0
  78. package/models/components/index.d.ts.map +1 -1
  79. package/models/components/index.js +12 -0
  80. package/models/components/index.js.map +1 -1
  81. package/models/components/openvpnmgmt.d.ts +37 -0
  82. package/models/components/openvpnmgmt.d.ts.map +1 -0
  83. package/models/components/openvpnmgmt.js +92 -0
  84. package/models/components/openvpnmgmt.js.map +1 -0
  85. package/models/components/rawcertificateresponse.d.ts +31 -0
  86. package/models/components/rawcertificateresponse.d.ts.map +1 -0
  87. package/models/components/rawcertificateresponse.js +80 -0
  88. package/models/components/rawcertificateresponse.js.map +1 -0
  89. package/models/components/rdp.d.ts +2 -0
  90. package/models/components/rdp.d.ts.map +1 -1
  91. package/models/components/rdp.js +4 -0
  92. package/models/components/rdp.js.map +1 -1
  93. package/models/components/responseenvelopelistrawcertificateresponse.d.ts +30 -0
  94. package/models/components/responseenvelopelistrawcertificateresponse.d.ts.map +1 -0
  95. package/models/components/responseenvelopelistrawcertificateresponse.js +72 -0
  96. package/models/components/responseenvelopelistrawcertificateresponse.js.map +1 -0
  97. package/models/components/responseenvelopelistsearchconvertqueryresponse.d.ts +30 -0
  98. package/models/components/responseenvelopelistsearchconvertqueryresponse.d.ts.map +1 -0
  99. package/models/components/responseenvelopelistsearchconvertqueryresponse.js +72 -0
  100. package/models/components/responseenvelopelistsearchconvertqueryresponse.js.map +1 -0
  101. package/models/components/screenshot.d.ts +2 -0
  102. package/models/components/screenshot.d.ts.map +1 -1
  103. package/models/components/screenshot.js +2 -0
  104. package/models/components/screenshot.js.map +1 -1
  105. package/models/components/searchconvertqueryinputbody.d.ts +32 -0
  106. package/models/components/searchconvertqueryinputbody.d.ts.map +1 -0
  107. package/models/components/searchconvertqueryinputbody.js +69 -0
  108. package/models/components/searchconvertqueryinputbody.js.map +1 -0
  109. package/models/components/searchconvertqueryresponse.d.ts +91 -0
  110. package/models/components/searchconvertqueryresponse.d.ts.map +1 -0
  111. package/models/components/searchconvertqueryresponse.js +117 -0
  112. package/models/components/searchconvertqueryresponse.js.map +1 -0
  113. package/models/components/service.d.ts +6 -0
  114. package/models/components/service.d.ts.map +1 -1
  115. package/models/components/service.js +11 -0
  116. package/models/components/service.js.map +1 -1
  117. package/models/components/servicescan.d.ts +6 -0
  118. package/models/components/servicescan.d.ts.map +1 -1
  119. package/models/components/servicescan.js +10 -0
  120. package/models/components/servicescan.js.map +1 -1
  121. package/models/operations/index.d.ts +7 -4
  122. package/models/operations/index.d.ts.map +1 -1
  123. package/models/operations/index.js +7 -4
  124. package/models/operations/index.js.map +1 -1
  125. package/models/operations/v3globaldataassetcertificatelistpost.d.ts +91 -0
  126. package/models/operations/v3globaldataassetcertificatelistpost.d.ts.map +1 -0
  127. package/models/operations/v3globaldataassetcertificatelistpost.js +157 -0
  128. package/models/operations/v3globaldataassetcertificatelistpost.js.map +1 -0
  129. package/models/operations/v3globaldataassetcertificatelistrawpost.d.ts +91 -0
  130. package/models/operations/v3globaldataassetcertificatelistrawpost.d.ts.map +1 -0
  131. package/models/operations/v3globaldataassetcertificatelistrawpost.js +157 -0
  132. package/models/operations/v3globaldataassetcertificatelistrawpost.js.map +1 -0
  133. package/models/operations/v3globaldataassetcertificateraw.d.ts +93 -0
  134. package/models/operations/v3globaldataassetcertificateraw.d.ts.map +1 -0
  135. package/models/operations/v3globaldataassetcertificateraw.js +156 -0
  136. package/models/operations/v3globaldataassetcertificateraw.js.map +1 -0
  137. package/models/operations/v3globaldataassethostlistpost.d.ts +91 -0
  138. package/models/operations/v3globaldataassethostlistpost.d.ts.map +1 -0
  139. package/models/operations/v3globaldataassethostlistpost.js +157 -0
  140. package/models/operations/v3globaldataassethostlistpost.js.map +1 -0
  141. package/models/operations/v3globaldataassethosttimeline.d.ts +2 -2
  142. package/models/operations/v3globaldataassetwebpropertylistpost.d.ts +91 -0
  143. package/models/operations/v3globaldataassetwebpropertylistpost.d.ts.map +1 -0
  144. package/models/operations/v3globaldataassetwebpropertylistpost.js +157 -0
  145. package/models/operations/v3globaldataassetwebpropertylistpost.js.map +1 -0
  146. package/models/operations/v3globaldatasearchconvert.d.ts +91 -0
  147. package/models/operations/v3globaldatasearchconvert.d.ts.map +1 -0
  148. package/models/operations/v3globaldatasearchconvert.js +157 -0
  149. package/models/operations/v3globaldatasearchconvert.js.map +1 -0
  150. package/models/operations/v3threathuntinggethostobservationswithcertificate.d.ts +124 -0
  151. package/models/operations/v3threathuntinggethostobservationswithcertificate.d.ts.map +1 -0
  152. package/models/operations/v3threathuntinggethostobservationswithcertificate.js +183 -0
  153. package/models/operations/v3threathuntinggethostobservationswithcertificate.js.map +1 -0
  154. package/package.json +3 -3
  155. package/sdk/globaldata.d.ts +24 -19
  156. package/sdk/globaldata.d.ts.map +1 -1
  157. package/sdk/globaldata.js +29 -21
  158. package/sdk/globaldata.js.map +1 -1
  159. package/sdk/threathunting.d.ts +7 -9
  160. package/sdk/threathunting.d.ts.map +1 -1
  161. package/sdk/threathunting.js +11 -13
  162. package/sdk/threathunting.js.map +1 -1
  163. package/src/funcs/globalDataConvertLegacySearchQueries.ts +188 -0
  164. package/src/funcs/globalDataCreateTrackedScan.ts +2 -2
  165. package/src/funcs/{globalDataGetHostObservationsWithCertificate.ts → globalDataGetCertificateRaw.ts} +19 -26
  166. package/src/funcs/globalDataGetCertificates.ts +15 -14
  167. package/src/funcs/globalDataGetCertificatesRaw.ts +187 -0
  168. package/src/funcs/globalDataGetHostTimeline.ts +1 -1
  169. package/src/funcs/globalDataGetHosts.ts +24 -16
  170. package/src/funcs/globalDataGetTrackedScan.ts +2 -3
  171. package/src/funcs/globalDataGetWebProperties.ts +15 -14
  172. package/src/funcs/threatHuntingCreateTrackedScan.ts +2 -2
  173. package/src/funcs/threatHuntingGetHostObservationsWithCertificate.ts +201 -0
  174. package/src/funcs/{globalDataGetTrackedScanThreatHunting.ts → threatHuntingGetTrackedScanThreatHunting.ts} +3 -4
  175. package/src/lib/config.ts +4 -4
  176. package/src/lib/security.ts +4 -1
  177. package/src/models/components/alternativequery.ts +104 -0
  178. package/src/models/components/assetcertificatelistinputbody.ts +80 -0
  179. package/src/models/components/assethostlistinputbody.ts +78 -0
  180. package/src/models/components/assetwebpropertylistinputbody.ts +80 -0
  181. package/src/models/components/asteriskmanagerinterface.ts +66 -0
  182. package/src/models/components/convertqueryerror.ts +69 -0
  183. package/src/models/components/index.ts +12 -0
  184. package/src/models/components/openvpnmgmt.ts +93 -0
  185. package/src/models/components/rawcertificateresponse.ts +79 -0
  186. package/src/models/components/rdp.ts +6 -0
  187. package/src/models/components/responseenvelopelistrawcertificateresponse.ts +84 -0
  188. package/src/models/components/responseenvelopelistsearchconvertqueryresponse.ts +88 -0
  189. package/src/models/components/screenshot.ts +4 -0
  190. package/src/models/components/searchconvertqueryinputbody.ts +71 -0
  191. package/src/models/components/searchconvertqueryresponse.ts +166 -0
  192. package/src/models/components/service.ts +25 -0
  193. package/src/models/components/servicescan.ts +24 -0
  194. package/src/models/operations/index.ts +7 -4
  195. package/src/models/operations/v3globaldataassetcertificatelistpost.ts +265 -0
  196. package/src/models/operations/v3globaldataassetcertificatelistrawpost.ts +269 -0
  197. package/src/models/operations/v3globaldataassetcertificateraw.ts +248 -0
  198. package/src/models/operations/v3globaldataassethostlistpost.ts +238 -0
  199. package/src/models/operations/v3globaldataassethosttimeline.ts +2 -2
  200. package/src/models/operations/v3globaldataassetwebpropertylistpost.ts +265 -0
  201. package/src/models/operations/v3globaldatasearchconvert.ts +234 -0
  202. package/src/models/operations/v3threathuntinggethostobservationswithcertificate.ts +315 -0
  203. package/src/sdk/globaldata.ts +49 -35
  204. package/src/sdk/threathunting.ts +16 -15
  205. package/tests/sdk.test.ts +2 -2
  206. package/funcs/globalDataGetHostObservationsWithCertificate.d.ts +0 -18
  207. package/funcs/globalDataGetHostObservationsWithCertificate.d.ts.map +0 -1
  208. package/funcs/globalDataGetHostObservationsWithCertificate.js.map +0 -1
  209. package/funcs/globalDataGetTrackedScanThreatHunting.d.ts.map +0 -1
  210. package/funcs/globalDataGetTrackedScanThreatHunting.js.map +0 -1
  211. package/models/operations/v3globaldataassetcertificatelist.d.ts +0 -94
  212. package/models/operations/v3globaldataassetcertificatelist.d.ts.map +0 -1
  213. package/models/operations/v3globaldataassetcertificatelist.js +0 -157
  214. package/models/operations/v3globaldataassetcertificatelist.js.map +0 -1
  215. package/models/operations/v3globaldataassethostlist.d.ts +0 -94
  216. package/models/operations/v3globaldataassethostlist.d.ts.map +0 -1
  217. package/models/operations/v3globaldataassethostlist.js +0 -157
  218. package/models/operations/v3globaldataassethostlist.js.map +0 -1
  219. package/models/operations/v3globaldataassetwebpropertylist.d.ts +0 -94
  220. package/models/operations/v3globaldataassetwebpropertylist.d.ts.map +0 -1
  221. package/models/operations/v3globaldataassetwebpropertylist.js +0 -157
  222. package/models/operations/v3globaldataassetwebpropertylist.js.map +0 -1
  223. package/models/operations/v3globaldatagethostobservationswithcertificate.d.ts +0 -124
  224. package/models/operations/v3globaldatagethostobservationswithcertificate.d.ts.map +0 -1
  225. package/models/operations/v3globaldatagethostobservationswithcertificate.js +0 -178
  226. package/models/operations/v3globaldatagethostobservationswithcertificate.js.map +0 -1
  227. package/src/models/operations/v3globaldataassetcertificatelist.ts +0 -259
  228. package/src/models/operations/v3globaldataassethostlist.ts +0 -233
  229. package/src/models/operations/v3globaldataassetwebpropertylist.ts +0 -259
  230. package/src/models/operations/v3globaldatagethostobservationswithcertificate.ts +0 -317
@@ -7,19 +7,18 @@ Endpoints related to the Threat Hunting product
7
7
 
8
8
  ### Available Operations
9
9
 
10
- * [getTrackedScan](#gettrackedscan) - Get tracked scan details
11
- * [createTrackedScan](#createtrackedscan) - Create a tracked discovery scan
12
- * [getTrackedScanThreatHunting](#gettrackedscanthreathunting) - Get tracked scan details
10
+ * [getHostObservationsWithCertificate](#gethostobservationswithcertificate) - Get host history for a certificate
11
+ * [createTrackedScan](#createtrackedscan) - Live Discovery: Initiate a new scan
12
+ * [getTrackedScanThreatHunting](#gettrackedscanthreathunting) - Get scan status
13
13
  * [valueCounts](#valuecounts) - CensEye: Retrieve value counts to discover pivots
14
14
 
15
- ## getTrackedScan
15
+ ## getHostObservationsWithCertificate
16
16
 
17
- Retrieve the current status and results of a tracked scan by its ID.
18
- This endpoint works for both discovery scans and rescans.
17
+ Retrieve the historical observations of hosts associated with a certificate. This is useful for threat hunting, detection engineering, and timeline generation. Certificate history is also visible to Threat Hunting users in the Platform UI on the [certificate timeline](https://docs.censys.com/docs/platform-threat-hunting-use-cert-history-to-build-better-detections#/).<br><br>You can define a specific time frame of interest. If you do not specify a time frame, this endpoint will search the historical dataset that is available to your account. You may also filter results by port and transport protocol.<br><br>This endpoint is available to organizations that have access to the Threat Hunting module. It costs 5 credits per page of results.
19
18
 
20
19
  ### Example Usage
21
20
 
22
- <!-- UsageSnippet language="typescript" operationID="v3-globaldata-scans-get" method="get" path="/v3/global/scans/{scan_id}" -->
21
+ <!-- UsageSnippet language="typescript" operationID="v3-threathunting-get-host-observations-with-certificate" method="get" path="/v3/threat-hunting/certificate/{certificate_id}/observations/hosts" -->
23
22
  ```typescript
24
23
  import { SDK } from "@censys/platform-sdk";
25
24
 
@@ -29,8 +28,13 @@ const sdk = new SDK({
29
28
  });
30
29
 
31
30
  async function run() {
32
- const result = await sdk.threatHunting.getTrackedScan({
33
- scanId: "5f39588f-d4c5-48e5-8894-0bb5918c28fa",
31
+ const result = await sdk.threatHunting.getHostObservationsWithCertificate({
32
+ certificateId: "55af8a301eb51abdaf7c31bec951638fe5a99d5d92117eca2be493026613fa46",
33
+ startTime: "2023-01-01T00:00:00Z",
34
+ endTime: "2023-12-31T23:59:59Z",
35
+ port: 443,
36
+ protocol: "TCP",
37
+ pageSize: 50,
34
38
  });
35
39
 
36
40
  console.log(result);
@@ -45,7 +49,7 @@ The standalone function version of this method:
45
49
 
46
50
  ```typescript
47
51
  import { SDKCore } from "@censys/platform-sdk/core.js";
48
- import { globalDataGetTrackedScan } from "@censys/platform-sdk/funcs/globalDataGetTrackedScan.js";
52
+ import { threatHuntingGetHostObservationsWithCertificate } from "@censys/platform-sdk/funcs/threatHuntingGetHostObservationsWithCertificate.js";
49
53
 
50
54
  // Use `SDKCore` for best tree-shaking performance.
51
55
  // You can create one instance of it to use across an application.
@@ -55,14 +59,19 @@ const sdk = new SDKCore({
55
59
  });
56
60
 
57
61
  async function run() {
58
- const res = await globalDataGetTrackedScan(sdk, {
59
- scanId: "5f39588f-d4c5-48e5-8894-0bb5918c28fa",
62
+ const res = await threatHuntingGetHostObservationsWithCertificate(sdk, {
63
+ certificateId: "55af8a301eb51abdaf7c31bec951638fe5a99d5d92117eca2be493026613fa46",
64
+ startTime: "2023-01-01T00:00:00Z",
65
+ endTime: "2023-12-31T23:59:59Z",
66
+ port: 443,
67
+ protocol: "TCP",
68
+ pageSize: 50,
60
69
  });
61
70
  if (res.ok) {
62
71
  const { value: result } = res;
63
72
  console.log(result);
64
73
  } else {
65
- console.log("globalDataGetTrackedScan failed:", res.error);
74
+ console.log("threatHuntingGetHostObservationsWithCertificate failed:", res.error);
66
75
  }
67
76
  }
68
77
 
@@ -73,14 +82,14 @@ run();
73
82
 
74
83
  | Parameter | Type | Required | Description |
75
84
  | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
76
- | `request` | [operations.V3GlobaldataScansGetRequest](../../models/operations/v3globaldatascansgetrequest.md) | :heavy_check_mark: | The request object to use for the request. |
85
+ | `request` | [operations.V3ThreathuntingGetHostObservationsWithCertificateRequest](../../models/operations/v3threathuntinggethostobservationswithcertificaterequest.md) | :heavy_check_mark: | The request object to use for the request. |
77
86
  | `options` | RequestOptions | :heavy_minus_sign: | Used to set various options for making HTTP requests. |
78
87
  | `options.fetchOptions` | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options) | :heavy_minus_sign: | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
79
88
  | `options.retries` | [RetryConfig](../../lib/utils/retryconfig.md) | :heavy_minus_sign: | Enables retrying HTTP requests under certain failure conditions. |
80
89
 
81
90
  ### Response
82
91
 
83
- **Promise\<[operations.V3GlobaldataScansGetResponse](../../models/operations/v3globaldatascansgetresponse.md)\>**
92
+ **Promise\<[operations.V3ThreathuntingGetHostObservationsWithCertificateResponse](../../models/operations/v3threathuntinggethostobservationswithcertificateresponse.md)\>**
84
93
 
85
94
  ### Errors
86
95
 
@@ -91,7 +100,7 @@ run();
91
100
 
92
101
  ## createTrackedScan
93
102
 
94
- Create a new tracked discovery scan for a specified target. Discovery scans are used to scan new targets that have not been previously identified. The scan will be queued. The response will contain a scan ID that you can use with the [get tracked scan details endpoint](https://docs.censys.com/reference/v3-globaldata-scans-get#/) to monitor its status and results.<br><br>This endpoint is available to organizations that have access to the Threat Hunting module.
103
+ Initiate a scan to look for a currently unobserved service at a specific IP and port (`ip:port`) or hostname and port (`hostname:port`). This is equivalent to the [Live Discovery](https://docs.censys.com/docs/platform-threat-hunting-use-live-scan-and-rescan-to-validate-infrastructure#/) feature available in the UI, but you can also target web properties in addition to hosts.<br><br>The scan may take several minutes to complete. The response will contain a scan ID that you can use to [monitor the scan's status](https://docs.censys.com/reference/v3-threathunting-scans-get#/). After the scan completes, perform a lookup on the target asset to retrieve detailed scan information.<br><br>This endpoint is available to organizations that have access to the Threat Hunting module. It costs 15 credits to execute this endpoint.
95
104
 
96
105
  ### Example Usage
97
106
 
@@ -181,8 +190,7 @@ run();
181
190
 
182
191
  ## getTrackedScanThreatHunting
183
192
 
184
- Retrieve the current status and results of a tracked scan by its ID.
185
- This endpoint works for both discovery scans and rescans.
193
+ Retrieve the current status of a scan by its ID. This endpoint works for both [Live Discovery scans](https://docs.censys.com/reference/v3-threathunting-scans-discovery#/) and [Live Rescans](https://docs.censys.com/reference/v3-globaldata-scans-rescan#/).<br><br>If the scan was successful, perform a lookup on the target asset to retrieve detailed scan information.<br><br>This endpoint is available to all Enterprise customers. This endpoint does not cost any credits to execute.
186
194
 
187
195
  ### Example Usage
188
196
 
@@ -212,7 +220,7 @@ The standalone function version of this method:
212
220
 
213
221
  ```typescript
214
222
  import { SDKCore } from "@censys/platform-sdk/core.js";
215
- import { globalDataGetTrackedScanThreatHunting } from "@censys/platform-sdk/funcs/globalDataGetTrackedScanThreatHunting.js";
223
+ import { threatHuntingGetTrackedScanThreatHunting } from "@censys/platform-sdk/funcs/threatHuntingGetTrackedScanThreatHunting.js";
216
224
 
217
225
  // Use `SDKCore` for best tree-shaking performance.
218
226
  // You can create one instance of it to use across an application.
@@ -222,14 +230,14 @@ const sdk = new SDKCore({
222
230
  });
223
231
 
224
232
  async function run() {
225
- const res = await globalDataGetTrackedScanThreatHunting(sdk, {
233
+ const res = await threatHuntingGetTrackedScanThreatHunting(sdk, {
226
234
  scanId: "cd62e794-9f12-4c2f-b5b3-153853aaf8d9",
227
235
  });
228
236
  if (res.ok) {
229
237
  const { value: result } = res;
230
238
  console.log(result);
231
239
  } else {
232
- console.log("globalDataGetTrackedScanThreatHunting failed:", res.error);
240
+ console.log("threatHuntingGetTrackedScanThreatHunting failed:", res.error);
233
241
  }
234
242
  }
235
243
 
@@ -8,7 +8,7 @@ dotenv.config();
8
8
  * Example usage of the @censys/platform-sdk SDK
9
9
  *
10
10
  * To run this example from the examples directory:
11
- * npm run build && npx tsx globalDataSearch.ts
11
+ * npm run build && npx tsx globalDataSearch.example.ts
12
12
  */
13
13
 
14
14
  import { SDK } from "@censys/platform-sdk";
@@ -18,7 +18,7 @@
18
18
  },
19
19
  "..": {
20
20
  "name": "@censys/platform-sdk",
21
- "version": "0.5.0",
21
+ "version": "0.6.0",
22
22
  "dependencies": {
23
23
  "zod": "^3.20.0"
24
24
  },
@@ -26,8 +26,8 @@
26
26
  "@eslint/js": "^9.19.0",
27
27
  "eslint": "^9.19.0",
28
28
  "globals": "^15.14.0",
29
- "typescript": "^5.4.5",
30
- "typescript-eslint": "^8.22.0"
29
+ "typescript": "~5.8.3",
30
+ "typescript-eslint": "^8.26.0"
31
31
  }
32
32
  },
33
33
  "node_modules/@censys/platform-sdk": {
@@ -0,0 +1,18 @@
1
+ import { SDKCore } from "../core.js";
2
+ import { RequestOptions } from "../lib/sdks.js";
3
+ import { ConnectionError, InvalidRequestError, RequestAbortedError, RequestTimeoutError, UnexpectedClientError } from "../models/errors/httpclienterrors.js";
4
+ import * as errors from "../models/errors/index.js";
5
+ import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
6
+ import { SDKBaseError } from "../models/errors/sdkbaseerror.js";
7
+ import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
8
+ import * as operations from "../models/operations/index.js";
9
+ import { APIPromise } from "../types/async.js";
10
+ import { Result } from "../types/fp.js";
11
+ /**
12
+ * Convert Legacy Search queries to Platform queries
13
+ *
14
+ * @remarks
15
+ * Convert Censys Search Language queries used in Legacy Search into Censys Query Language (CenQL) queries for use in the Platform.<br><br>Reference the [documentation on CenQL](https://docs.censys.com/docs/censys-query-language) for more information about query syntax.
16
+ */
17
+ export declare function globalDataConvertLegacySearchQueries(client: SDKCore, request: operations.V3GlobaldataSearchConvertRequest, options?: RequestOptions): APIPromise<Result<operations.V3GlobaldataSearchConvertResponse, errors.ErrorModel | SDKBaseError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
18
+ //# sourceMappingURL=globalDataConvertLegacySearchQueries.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"globalDataConvertLegacySearchQueries.d.ts","sourceRoot":"","sources":["../src/funcs/globalDataConvertLegacySearchQueries.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAKrC,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,MAAM,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,6CAA6C,CAAC;AACtF,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,KAAK,UAAU,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAW,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC;;;;;GAKG;AACH,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,UAAU,CAAC,gCAAgC,EACpD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CACX,MAAM,CACJ,UAAU,CAAC,iCAAiC,EAC1C,MAAM,CAAC,UAAU,GACjB,YAAY,GACZ,uBAAuB,GACvB,eAAe,GACf,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,qBAAqB,GACrB,kBAAkB,CACrB,CACF,CAMA"}
@@ -0,0 +1,134 @@
1
+ "use strict";
2
+ /*
3
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
4
+ */
5
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
6
+ if (k2 === undefined) k2 = k;
7
+ var desc = Object.getOwnPropertyDescriptor(m, k);
8
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
9
+ desc = { enumerable: true, get: function() { return m[k]; } };
10
+ }
11
+ Object.defineProperty(o, k2, desc);
12
+ }) : (function(o, m, k, k2) {
13
+ if (k2 === undefined) k2 = k;
14
+ o[k2] = m[k];
15
+ }));
16
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
17
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
18
+ }) : function(o, v) {
19
+ o["default"] = v;
20
+ });
21
+ var __importStar = (this && this.__importStar) || (function () {
22
+ var ownKeys = function(o) {
23
+ ownKeys = Object.getOwnPropertyNames || function (o) {
24
+ var ar = [];
25
+ for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
26
+ return ar;
27
+ };
28
+ return ownKeys(o);
29
+ };
30
+ return function (mod) {
31
+ if (mod && mod.__esModule) return mod;
32
+ var result = {};
33
+ if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
34
+ __setModuleDefault(result, mod);
35
+ return result;
36
+ };
37
+ })();
38
+ Object.defineProperty(exports, "__esModule", { value: true });
39
+ exports.globalDataConvertLegacySearchQueries = globalDataConvertLegacySearchQueries;
40
+ const encodings_js_1 = require("../lib/encodings.js");
41
+ const M = __importStar(require("../lib/matchers.js"));
42
+ const primitives_js_1 = require("../lib/primitives.js");
43
+ const schemas_js_1 = require("../lib/schemas.js");
44
+ const security_js_1 = require("../lib/security.js");
45
+ const url_js_1 = require("../lib/url.js");
46
+ const errors = __importStar(require("../models/errors/index.js"));
47
+ const operations = __importStar(require("../models/operations/index.js"));
48
+ const async_js_1 = require("../types/async.js");
49
+ /**
50
+ * Convert Legacy Search queries to Platform queries
51
+ *
52
+ * @remarks
53
+ * Convert Censys Search Language queries used in Legacy Search into Censys Query Language (CenQL) queries for use in the Platform.<br><br>Reference the [documentation on CenQL](https://docs.censys.com/docs/censys-query-language) for more information about query syntax.
54
+ */
55
+ function globalDataConvertLegacySearchQueries(client, request, options) {
56
+ return new async_js_1.APIPromise($do(client, request, options));
57
+ }
58
+ async function $do(client, request, options) {
59
+ const parsed = (0, schemas_js_1.safeParse)(request, (value) => operations.V3GlobaldataSearchConvertRequest$outboundSchema.parse(value), "Input validation failed");
60
+ if (!parsed.ok) {
61
+ return [parsed, { status: "invalid" }];
62
+ }
63
+ const payload = parsed.value;
64
+ const body = (0, encodings_js_1.encodeJSON)("body", payload.SearchConvertQueryInputBody, {
65
+ explode: true,
66
+ });
67
+ const path = (0, url_js_1.pathToFunc)("/v3/global/search/convert")();
68
+ const query = (0, encodings_js_1.encodeFormQuery)({
69
+ "organization_id": payload.organization_id
70
+ ?? client._options.organizationId,
71
+ }, { explode: false });
72
+ const headers = new Headers((0, primitives_js_1.compactMap)({
73
+ "Content-Type": "application/json",
74
+ Accept: "application/json",
75
+ }));
76
+ const secConfig = await (0, security_js_1.extractSecurity)(client._options.personalAccessToken);
77
+ const securityInput = secConfig == null
78
+ ? {}
79
+ : { personalAccessToken: secConfig };
80
+ const requestSecurity = (0, security_js_1.resolveGlobalSecurity)(securityInput);
81
+ const context = {
82
+ options: client._options,
83
+ baseURL: options?.serverURL ?? client._baseURL ?? "",
84
+ operationID: "v3-globaldata-search-convert",
85
+ oAuth2Scopes: [],
86
+ resolvedSecurity: requestSecurity,
87
+ securitySource: client._options.personalAccessToken,
88
+ retryConfig: options?.retries
89
+ || client._options.retryConfig
90
+ || { strategy: "none" },
91
+ retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
92
+ };
93
+ const requestRes = client._createRequest(context, {
94
+ security: requestSecurity,
95
+ method: "POST",
96
+ baseURL: options?.serverURL,
97
+ path: path,
98
+ headers: headers,
99
+ query: query,
100
+ body: body,
101
+ userAgent: client._options.userAgent,
102
+ timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
103
+ }, options);
104
+ if (!requestRes.ok) {
105
+ return [requestRes, { status: "invalid" }];
106
+ }
107
+ const req = requestRes.value;
108
+ const doResult = await client._do(req, {
109
+ context,
110
+ errorCodes: ["401", "4XX", "500", "5XX"],
111
+ retryConfig: context.retryConfig,
112
+ retryCodes: context.retryCodes,
113
+ });
114
+ if (!doResult.ok) {
115
+ return [doResult, { status: "request-error", request: req }];
116
+ }
117
+ const response = doResult.value;
118
+ const responseFields = {
119
+ HttpMeta: { Response: response, Request: req },
120
+ };
121
+ const [result] = await M.match(M.json(200, operations.V3GlobaldataSearchConvertResponse$inboundSchema, {
122
+ hdrs: true,
123
+ key: "Result",
124
+ }), M.jsonErr(401, errors.ErrorModel$inboundSchema, {
125
+ ctype: "application/problem+json",
126
+ }), M.jsonErr(500, errors.ErrorModel$inboundSchema, {
127
+ ctype: "application/problem+json",
128
+ }), M.fail("4XX"), M.fail("5XX"))(response, req, { extraFields: responseFields });
129
+ if (!result.ok) {
130
+ return [result, { status: "complete", request: req, response }];
131
+ }
132
+ return [result, { status: "complete", request: req, response }];
133
+ }
134
+ //# sourceMappingURL=globalDataConvertLegacySearchQueries.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"globalDataConvertLegacySearchQueries.js","sourceRoot":"","sources":["../src/funcs/globalDataConvertLegacySearchQueries.ts"],"names":[],"mappings":"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"}
@@ -9,10 +9,10 @@ import * as operations from "../models/operations/index.js";
9
9
  import { APIPromise } from "../types/async.js";
10
10
  import { Result } from "../types/fp.js";
11
11
  /**
12
- * Create a tracked rescan
12
+ * Live Rescan: Initiate a new rescan
13
13
  *
14
14
  * @remarks
15
- * Create a new tracked rescan for a known service or web property. Rescans are used to update information for previously discovered targets. The scan will be queued. The response will contain a scan ID that you can use with the [get tracked scan details endpoint](https://docs.censys.com/reference/v3-globaldata-scans-get#/) to monitor its status and results.<br><br>This endpoint is available to all Enterprise customers.
15
+ * Initiate a rescan for a known host service at a specific IP and port (`ip:port`) or hostname and port (`hostname:port`). This is equivalent to the [Live Rescan](https://docs.censys.com/docs/platform-live-rescan#/) feature available in the UI, but you can also target web properties in addition to hosts.<br><br>The scan may take several minutes to complete. The response will contain a scan ID that you can use to [monitor the scan's status](https://docs.censys.com/reference/v3-globaldata-scans-get#/). After the scan completes, perform a lookup on the target asset to retrieve detailed scan information.<br><br>This endpoint is available to all Enterprise customers. It costs 10 credits to execute.
16
16
  */
17
17
  export declare function globalDataCreateTrackedScan(client: SDKCore, request: operations.V3GlobaldataScansRescanRequest, options?: RequestOptions): APIPromise<Result<operations.V3GlobaldataScansRescanResponse, errors.ErrorModel | SDKBaseError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
18
18
  //# sourceMappingURL=globalDataCreateTrackedScan.d.ts.map
@@ -47,10 +47,10 @@ const errors = __importStar(require("../models/errors/index.js"));
47
47
  const operations = __importStar(require("../models/operations/index.js"));
48
48
  const async_js_1 = require("../types/async.js");
49
49
  /**
50
- * Create a tracked rescan
50
+ * Live Rescan: Initiate a new rescan
51
51
  *
52
52
  * @remarks
53
- * Create a new tracked rescan for a known service or web property. Rescans are used to update information for previously discovered targets. The scan will be queued. The response will contain a scan ID that you can use with the [get tracked scan details endpoint](https://docs.censys.com/reference/v3-globaldata-scans-get#/) to monitor its status and results.<br><br>This endpoint is available to all Enterprise customers.
53
+ * Initiate a rescan for a known host service at a specific IP and port (`ip:port`) or hostname and port (`hostname:port`). This is equivalent to the [Live Rescan](https://docs.censys.com/docs/platform-live-rescan#/) feature available in the UI, but you can also target web properties in addition to hosts.<br><br>The scan may take several minutes to complete. The response will contain a scan ID that you can use to [monitor the scan's status](https://docs.censys.com/reference/v3-globaldata-scans-get#/). After the scan completes, perform a lookup on the target asset to retrieve detailed scan information.<br><br>This endpoint is available to all Enterprise customers. It costs 10 credits to execute.
54
54
  */
55
55
  function globalDataCreateTrackedScan(client, request, options) {
56
56
  return new async_js_1.APIPromise($do(client, request, options));
@@ -9,11 +9,10 @@ import * as operations from "../models/operations/index.js";
9
9
  import { APIPromise } from "../types/async.js";
10
10
  import { Result } from "../types/fp.js";
11
11
  /**
12
- * Get tracked scan details
12
+ * Get a certificate in PEM format
13
13
  *
14
14
  * @remarks
15
- * Retrieve the current status and results of a tracked scan by its ID.
16
- * This endpoint works for both discovery scans and rescans.
15
+ * Retrieve the raw PEM-encoded format of a certificate. A certificate ID is its SHA-256 fingerprint in the Censys dataset.
17
16
  */
18
- export declare function globalDataGetTrackedScanThreatHunting(client: SDKCore, request: operations.V3ThreathuntingScansGetRequest, options?: RequestOptions): APIPromise<Result<operations.V3ThreathuntingScansGetResponse, errors.ErrorModel | SDKBaseError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
19
- //# sourceMappingURL=globalDataGetTrackedScanThreatHunting.d.ts.map
17
+ export declare function globalDataGetCertificateRaw(client: SDKCore, request: operations.V3GlobaldataAssetCertificateRawRequest, options?: RequestOptions): APIPromise<Result<operations.V3GlobaldataAssetCertificateRawResponse, errors.ErrorModel | SDKBaseError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
18
+ //# sourceMappingURL=globalDataGetCertificateRaw.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"globalDataGetCertificateRaw.d.ts","sourceRoot":"","sources":["../src/funcs/globalDataGetCertificateRaw.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAKrC,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,MAAM,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,6CAA6C,CAAC;AACtF,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,KAAK,UAAU,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAW,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,UAAU,CAAC,sCAAsC,EAC1D,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CACX,MAAM,CACJ,UAAU,CAAC,uCAAuC,EAChD,MAAM,CAAC,UAAU,GACjB,YAAY,GACZ,uBAAuB,GACvB,eAAe,GACf,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,qBAAqB,GACrB,kBAAkB,CACrB,CACF,CAMA"}
@@ -36,7 +36,7 @@ var __importStar = (this && this.__importStar) || (function () {
36
36
  };
37
37
  })();
38
38
  Object.defineProperty(exports, "__esModule", { value: true });
39
- exports.globalDataGetHostObservationsWithCertificate = globalDataGetHostObservationsWithCertificate;
39
+ exports.globalDataGetCertificateRaw = globalDataGetCertificateRaw;
40
40
  const encodings_js_1 = require("../lib/encodings.js");
41
41
  const M = __importStar(require("../lib/matchers.js"));
42
42
  const primitives_js_1 = require("../lib/primitives.js");
@@ -47,18 +47,16 @@ const errors = __importStar(require("../models/errors/index.js"));
47
47
  const operations = __importStar(require("../models/operations/index.js"));
48
48
  const async_js_1 = require("../types/async.js");
49
49
  /**
50
- * Get Host Observations With Certificate
50
+ * Get a certificate in PEM format
51
51
  *
52
52
  * @remarks
53
- * Retrieve historical observations of hosts associated with a certificate fingerprint. Useful for threat hunting, detection engineering, and timeline generation.
53
+ * Retrieve the raw PEM-encoded format of a certificate. A certificate ID is its SHA-256 fingerprint in the Censys dataset.
54
54
  */
55
- function globalDataGetHostObservationsWithCertificate(client, request, options) {
55
+ function globalDataGetCertificateRaw(client, request, options) {
56
56
  return new async_js_1.APIPromise($do(client, request, options));
57
57
  }
58
58
  async function $do(client, request, options) {
59
- const parsed = (0, schemas_js_1.safeParse)(request, (value) => operations
60
- .V3GlobaldataGetHostObservationsWithCertificateRequest$outboundSchema
61
- .parse(value), "Input validation failed");
59
+ const parsed = (0, schemas_js_1.safeParse)(request, (value) => operations.V3GlobaldataAssetCertificateRawRequest$outboundSchema.parse(value), "Input validation failed");
62
60
  if (!parsed.ok) {
63
61
  return [parsed, { status: "invalid" }];
64
62
  }
@@ -70,19 +68,13 @@ async function $do(client, request, options) {
70
68
  charEncoding: "percent",
71
69
  }),
72
70
  };
73
- const path = (0, url_js_1.pathToFunc)("/v3/global/asset/certificate/{certificate_id}/observations/hosts")(pathParams);
71
+ const path = (0, url_js_1.pathToFunc)("/v3/global/asset/certificate/{certificate_id}/raw")(pathParams);
74
72
  const query = (0, encodings_js_1.encodeFormQuery)({
75
- "end_time": payload.end_time,
76
73
  "organization_id": payload.organization_id
77
74
  ?? client._options.organizationId,
78
- "page_size": payload.page_size,
79
- "page_token": payload.page_token,
80
- "port": payload.port,
81
- "protocol": payload.protocol,
82
- "start_time": payload.start_time,
83
75
  }, { explode: false });
84
76
  const headers = new Headers((0, primitives_js_1.compactMap)({
85
- Accept: "application/json",
77
+ Accept: "application/x-pem-file",
86
78
  }));
87
79
  const secConfig = await (0, security_js_1.extractSecurity)(client._options.personalAccessToken);
88
80
  const securityInput = secConfig == null
@@ -92,7 +84,7 @@ async function $do(client, request, options) {
92
84
  const context = {
93
85
  options: client._options,
94
86
  baseURL: options?.serverURL ?? client._baseURL ?? "",
95
- operationID: "v3-globaldata-get-host-observations-with-certificate",
87
+ operationID: "v3-globaldata-asset-certificate-raw",
96
88
  oAuth2Scopes: [],
97
89
  resolvedSecurity: requestSecurity,
98
90
  securitySource: client._options.personalAccessToken,
@@ -129,8 +121,7 @@ async function $do(client, request, options) {
129
121
  const responseFields = {
130
122
  HttpMeta: { Response: response, Request: req },
131
123
  };
132
- const [result] = await M.match(M.json(200, operations
133
- .V3GlobaldataGetHostObservationsWithCertificateResponse$inboundSchema, { hdrs: true, key: "Result" }), M.jsonErr([401, 403], errors.ErrorModel$inboundSchema, {
124
+ const [result] = await M.match(M.stream(200, operations.V3GlobaldataAssetCertificateRawResponse$inboundSchema, { ctype: "application/x-pem-file", hdrs: true, key: "Result" }), M.jsonErr([401, 403], errors.ErrorModel$inboundSchema, {
134
125
  ctype: "application/problem+json",
135
126
  }), M.fail("4XX"), M.fail("5XX"))(response, req, { extraFields: responseFields });
136
127
  if (!result.ok) {
@@ -138,4 +129,4 @@ async function $do(client, request, options) {
138
129
  }
139
130
  return [result, { status: "complete", request: req, response }];
140
131
  }
141
- //# sourceMappingURL=globalDataGetHostObservationsWithCertificate.js.map
132
+ //# sourceMappingURL=globalDataGetCertificateRaw.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"globalDataGetCertificateRaw.js","sourceRoot":"","sources":["../src/funcs/globalDataGetCertificateRaw.ts"],"names":[],"mappings":"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"}
@@ -14,5 +14,5 @@ import { Result } from "../types/fp.js";
14
14
  * @remarks
15
15
  * Retrieve information about multiple certificates. A certificate ID is its SHA-256 fingerprint in the Censys dataset.
16
16
  */
17
- export declare function globalDataGetCertificates(client: SDKCore, request: operations.V3GlobaldataAssetCertificateListRequest, options?: RequestOptions): APIPromise<Result<operations.V3GlobaldataAssetCertificateListResponse, errors.ErrorModel | SDKBaseError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
17
+ export declare function globalDataGetCertificates(client: SDKCore, request: operations.V3GlobaldataAssetCertificateListPostRequest, options?: RequestOptions): APIPromise<Result<operations.V3GlobaldataAssetCertificateListPostResponse, errors.ErrorModel | SDKBaseError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
18
18
  //# sourceMappingURL=globalDataGetCertificates.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"globalDataGetCertificates.d.ts","sourceRoot":"","sources":["../src/funcs/globalDataGetCertificates.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAKrC,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,MAAM,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,6CAA6C,CAAC;AACtF,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,KAAK,UAAU,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAW,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,UAAU,CAAC,uCAAuC,EAC3D,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CACX,MAAM,CACJ,UAAU,CAAC,wCAAwC,EACjD,MAAM,CAAC,UAAU,GACjB,YAAY,GACZ,uBAAuB,GACvB,eAAe,GACf,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,qBAAqB,GACrB,kBAAkB,CACrB,CACF,CAMA"}
1
+ {"version":3,"file":"globalDataGetCertificates.d.ts","sourceRoot":"","sources":["../src/funcs/globalDataGetCertificates.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAKrC,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,MAAM,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,6CAA6C,CAAC;AACtF,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,KAAK,UAAU,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAW,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,UAAU,CAAC,2CAA2C,EAC/D,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CACX,MAAM,CACJ,UAAU,CAAC,4CAA4C,EACrD,MAAM,CAAC,UAAU,GACjB,YAAY,GACZ,uBAAuB,GACvB,eAAe,GACf,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,qBAAqB,GACrB,kBAAkB,CACrB,CACF,CAMA"}
@@ -56,19 +56,22 @@ function globalDataGetCertificates(client, request, options) {
56
56
  return new async_js_1.APIPromise($do(client, request, options));
57
57
  }
58
58
  async function $do(client, request, options) {
59
- const parsed = (0, schemas_js_1.safeParse)(request, (value) => operations.V3GlobaldataAssetCertificateListRequest$outboundSchema.parse(value), "Input validation failed");
59
+ const parsed = (0, schemas_js_1.safeParse)(request, (value) => operations.V3GlobaldataAssetCertificateListPostRequest$outboundSchema
60
+ .parse(value), "Input validation failed");
60
61
  if (!parsed.ok) {
61
62
  return [parsed, { status: "invalid" }];
62
63
  }
63
64
  const payload = parsed.value;
64
- const body = null;
65
+ const body = (0, encodings_js_1.encodeJSON)("body", payload.AssetCertificateListInputBody, {
66
+ explode: true,
67
+ });
65
68
  const path = (0, url_js_1.pathToFunc)("/v3/global/asset/certificate")();
66
69
  const query = (0, encodings_js_1.encodeFormQuery)({
67
- "certificate_ids": payload.certificate_ids,
68
70
  "organization_id": payload.organization_id
69
71
  ?? client._options.organizationId,
70
72
  }, { explode: false });
71
73
  const headers = new Headers((0, primitives_js_1.compactMap)({
74
+ "Content-Type": "application/json",
72
75
  Accept: "application/vnd.censys.api.v3.certificate.v1+json",
73
76
  }));
74
77
  const secConfig = await (0, security_js_1.extractSecurity)(client._options.personalAccessToken);
@@ -79,7 +82,7 @@ async function $do(client, request, options) {
79
82
  const context = {
80
83
  options: client._options,
81
84
  baseURL: options?.serverURL ?? client._baseURL ?? "",
82
- operationID: "v3-globaldata-asset-certificate-list",
85
+ operationID: "v3-globaldata-asset-certificate-list-post",
83
86
  oAuth2Scopes: [],
84
87
  resolvedSecurity: requestSecurity,
85
88
  securitySource: client._options.personalAccessToken,
@@ -90,7 +93,7 @@ async function $do(client, request, options) {
90
93
  };
91
94
  const requestRes = client._createRequest(context, {
92
95
  security: requestSecurity,
93
- method: "GET",
96
+ method: "POST",
94
97
  baseURL: options?.serverURL,
95
98
  path: path,
96
99
  headers: headers,
@@ -116,7 +119,7 @@ async function $do(client, request, options) {
116
119
  const responseFields = {
117
120
  HttpMeta: { Response: response, Request: req },
118
121
  };
119
- const [result] = await M.match(M.json(200, operations.V3GlobaldataAssetCertificateListResponse$inboundSchema, {
122
+ const [result] = await M.match(M.json(200, operations.V3GlobaldataAssetCertificateListPostResponse$inboundSchema, {
120
123
  ctype: "application/vnd.censys.api.v3.certificate.v1+json",
121
124
  hdrs: true,
122
125
  key: "Result",
@@ -1 +1 @@
1
- {"version":3,"file":"globalDataGetCertificates.js","sourceRoot":"","sources":["../src/funcs/globalDataGetCertificates.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"globalDataGetCertificates.js","sourceRoot":"","sources":["../src/funcs/globalDataGetCertificates.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,18 @@
1
+ import { SDKCore } from "../core.js";
2
+ import { RequestOptions } from "../lib/sdks.js";
3
+ import { ConnectionError, InvalidRequestError, RequestAbortedError, RequestTimeoutError, UnexpectedClientError } from "../models/errors/httpclienterrors.js";
4
+ import * as errors from "../models/errors/index.js";
5
+ import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
6
+ import { SDKBaseError } from "../models/errors/sdkbaseerror.js";
7
+ import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
8
+ import * as operations from "../models/operations/index.js";
9
+ import { APIPromise } from "../types/async.js";
10
+ import { Result } from "../types/fp.js";
11
+ /**
12
+ * Get multiple certificates in PEM format
13
+ *
14
+ * @remarks
15
+ * Retrieve the raw PEM-encoded format for multiple certificates. A certificate ID is its SHA-256 fingerprint in the Censys dataset.
16
+ */
17
+ export declare function globalDataGetCertificatesRaw(client: SDKCore, request: operations.V3GlobaldataAssetCertificateListRawPostRequest, options?: RequestOptions): APIPromise<Result<operations.V3GlobaldataAssetCertificateListRawPostResponse, errors.ErrorModel | SDKBaseError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
18
+ //# sourceMappingURL=globalDataGetCertificatesRaw.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"globalDataGetCertificatesRaw.d.ts","sourceRoot":"","sources":["../src/funcs/globalDataGetCertificatesRaw.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAKrC,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,MAAM,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,6CAA6C,CAAC;AACtF,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,KAAK,UAAU,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAW,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,UAAU,CAAC,8CAA8C,EAClE,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CACX,MAAM,CACJ,UAAU,CAAC,+CAA+C,EACxD,MAAM,CAAC,UAAU,GACjB,YAAY,GACZ,uBAAuB,GACvB,eAAe,GACf,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,qBAAqB,GACrB,kBAAkB,CACrB,CACF,CAMA"}