@tryfinch/finch-api 2.0.0 → 3.0.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 (593) hide show
  1. package/{dist/esm/_shims → _shims}/agent.d.ts +2 -2
  2. package/_shims/agent.d.ts.map +1 -0
  3. package/_shims/agent.js.map +1 -0
  4. package/{dist/esm/_shims/agent.js → _shims/agent.mjs} +1 -1
  5. package/_shims/agent.mjs.map +1 -0
  6. package/{dist/esm/_shims → _shims}/agent.node.d.ts +1 -0
  7. package/_shims/agent.node.d.ts.map +1 -0
  8. package/_shims/agent.node.js.map +1 -0
  9. package/{dist/esm/_shims/agent.node.js → _shims/agent.node.mjs} +1 -1
  10. package/_shims/agent.node.mjs.map +1 -0
  11. package/_shims/fetch.d.ts +52 -0
  12. package/_shims/fetch.js +13 -0
  13. package/_shims/fetch.mjs +15 -0
  14. package/_shims/fetch.node.d.ts +53 -0
  15. package/_shims/fetch.node.js +12 -0
  16. package/_shims/fetch.node.mjs +14 -0
  17. package/{dist/cjs/_shims → _shims}/fileFromPath.d.ts +1 -2
  18. package/_shims/fileFromPath.d.ts.map +1 -0
  19. package/_shims/fileFromPath.js +16 -0
  20. package/_shims/fileFromPath.js.map +1 -0
  21. package/{dist/esm/_shims/fileFromPath.js → _shims/fileFromPath.mjs} +1 -1
  22. package/_shims/fileFromPath.mjs.map +1 -0
  23. package/{dist/cjs/_shims → _shims}/fileFromPath.node.d.ts +1 -2
  24. package/_shims/fileFromPath.node.d.ts.map +1 -0
  25. package/_shims/fileFromPath.node.js +17 -0
  26. package/_shims/fileFromPath.node.js.map +1 -0
  27. package/{dist/esm/_shims/fileFromPath.node.js → _shims/fileFromPath.node.mjs} +1 -1
  28. package/_shims/fileFromPath.node.mjs.map +1 -0
  29. package/_shims/formdata.d.ts +43 -0
  30. package/_shims/formdata.js +9 -0
  31. package/{dist/esm/_shims/formdata.js → _shims/formdata.mjs} +7 -11
  32. package/_shims/formdata.node.d.ts +44 -0
  33. package/_shims/formdata.node.js +11 -0
  34. package/_shims/getMultipartRequestOptions.d.ts.map +1 -0
  35. package/_shims/getMultipartRequestOptions.js +12 -0
  36. package/_shims/getMultipartRequestOptions.js.map +1 -0
  37. package/_shims/getMultipartRequestOptions.mjs +8 -0
  38. package/_shims/getMultipartRequestOptions.mjs.map +1 -0
  39. package/_shims/getMultipartRequestOptions.node.d.ts.map +1 -0
  40. package/_shims/getMultipartRequestOptions.node.js +22 -0
  41. package/_shims/getMultipartRequestOptions.node.js.map +1 -0
  42. package/{dist/esm/_shims/getMultipartRequestOptions.node.js → _shims/getMultipartRequestOptions.node.mjs} +3 -2
  43. package/_shims/getMultipartRequestOptions.node.mjs.map +1 -0
  44. package/_shims/node-readable.d.ts +23 -0
  45. package/_shims/node-readable.d.ts.map +1 -0
  46. package/_shims/node-readable.js +11 -0
  47. package/_shims/node-readable.js.map +1 -0
  48. package/_shims/node-readable.mjs +7 -0
  49. package/_shims/node-readable.mjs.map +1 -0
  50. package/_shims/node-readable.node.d.ts +8 -0
  51. package/_shims/node-readable.node.d.ts.map +1 -0
  52. package/_shims/node-readable.node.js +9 -0
  53. package/_shims/node-readable.node.js.map +1 -0
  54. package/_shims/node-readable.node.mjs +5 -0
  55. package/_shims/node-readable.node.mjs.map +1 -0
  56. package/{dist/esm/core.d.ts → core.d.ts} +15 -10
  57. package/core.d.ts.map +1 -0
  58. package/{dist/cjs/core.js → core.js} +191 -333
  59. package/core.js.map +1 -0
  60. package/{dist/esm/core.js → core.mjs} +56 -25
  61. package/core.mjs.map +1 -0
  62. package/error.d.ts.map +1 -0
  63. package/{dist/cjs/error.js → error.js} +1 -1
  64. package/error.js.map +1 -0
  65. package/{dist/esm/error.js → error.mjs} +5 -3
  66. package/error.mjs.map +1 -0
  67. package/{dist/cjs/index.d.ts → index.d.mts} +43 -8
  68. package/{dist/esm/index.d.ts → index.d.ts} +38 -3
  69. package/index.d.ts.map +1 -0
  70. package/{dist/cjs/index.js → index.js} +20 -17
  71. package/index.js.map +1 -0
  72. package/{dist/esm/index.js → index.mjs} +18 -9
  73. package/index.mjs.map +1 -0
  74. package/package.json +34 -77
  75. package/pagination.d.ts.map +1 -0
  76. package/{dist/cjs/pagination.js → pagination.js} +1 -1
  77. package/pagination.js.map +1 -0
  78. package/{dist/esm/pagination.js → pagination.mjs} +2 -2
  79. package/pagination.mjs.map +1 -0
  80. package/resource.d.ts.map +1 -0
  81. package/resource.js.map +1 -0
  82. package/{dist/esm/resource.js → resource.mjs} +1 -1
  83. package/resource.mjs.map +1 -0
  84. package/{dist/esm/resources → resources}/account.d.ts +2 -2
  85. package/resources/account.d.ts.map +1 -0
  86. package/{dist/cjs/resources → resources}/account.js +1 -1
  87. package/resources/account.js.map +1 -0
  88. package/{dist/esm/resources/account.js → resources/account.mjs} +2 -2
  89. package/resources/account.mjs.map +1 -0
  90. package/{dist/esm/resources → resources}/ats/applications.d.ts +4 -4
  91. package/resources/ats/applications.d.ts.map +1 -0
  92. package/{dist/cjs/resources → resources}/ats/applications.js +4 -8
  93. package/resources/ats/applications.js.map +1 -0
  94. package/{dist/esm/resources/ats/applications.js → resources/ats/applications.mjs} +4 -4
  95. package/resources/ats/applications.mjs.map +1 -0
  96. package/{dist/esm/resources → resources}/ats/ats.d.ts +1 -1
  97. package/{dist/cjs/resources → resources}/ats/ats.d.ts.map +1 -1
  98. package/{dist/cjs/resources → resources}/ats/ats.js +7 -7
  99. package/resources/ats/ats.js.map +1 -0
  100. package/{dist/esm/resources/ats/ats.js → resources/ats/ats.mjs} +8 -8
  101. package/resources/ats/ats.mjs.map +1 -0
  102. package/{dist/esm/resources → resources}/ats/candidates.d.ts +3 -3
  103. package/resources/ats/candidates.d.ts.map +1 -0
  104. package/{dist/cjs/resources → resources}/ats/candidates.js +4 -4
  105. package/resources/ats/candidates.js.map +1 -0
  106. package/{dist/esm/resources/ats/candidates.js → resources/ats/candidates.mjs} +4 -4
  107. package/resources/ats/candidates.mjs.map +1 -0
  108. package/resources/ats/index.d.ts.map +1 -0
  109. package/{dist/cjs/resources → resources}/ats/index.js +6 -6
  110. package/resources/ats/index.js.map +1 -0
  111. package/resources/ats/index.mjs +8 -0
  112. package/resources/ats/index.mjs.map +1 -0
  113. package/{dist/esm/resources → resources}/ats/jobs.d.ts +3 -3
  114. package/resources/ats/jobs.d.ts.map +1 -0
  115. package/{dist/cjs/resources → resources}/ats/jobs.js +4 -4
  116. package/resources/ats/jobs.js.map +1 -0
  117. package/{dist/esm/resources/ats/jobs.js → resources/ats/jobs.mjs} +4 -4
  118. package/resources/ats/jobs.mjs.map +1 -0
  119. package/{dist/esm/resources → resources}/ats/offers.d.ts +3 -3
  120. package/resources/ats/offers.d.ts.map +1 -0
  121. package/{dist/cjs/resources → resources}/ats/offers.js +4 -4
  122. package/resources/ats/offers.js.map +1 -0
  123. package/{dist/esm/resources/ats/offers.js → resources/ats/offers.mjs} +4 -4
  124. package/resources/ats/offers.mjs.map +1 -0
  125. package/{dist/esm/resources → resources}/ats/stages.d.ts +6 -4
  126. package/resources/ats/stages.d.ts.map +1 -0
  127. package/resources/ats/stages.js +22 -0
  128. package/resources/ats/stages.js.map +1 -0
  129. package/{dist/esm/resources/ats/stages.js → resources/ats/stages.mjs} +4 -7
  130. package/resources/ats/stages.mjs.map +1 -0
  131. package/{dist/esm/resources → resources}/hris/benefits/benefits.d.ts +8 -5
  132. package/resources/hris/benefits/benefits.d.ts.map +1 -0
  133. package/{dist/cjs/resources → resources}/hris/benefits/benefits.js +7 -9
  134. package/resources/hris/benefits/benefits.js.map +1 -0
  135. package/{dist/esm/resources/hris/benefits/benefits.js → resources/hris/benefits/benefits.mjs} +6 -8
  136. package/resources/hris/benefits/benefits.mjs.map +1 -0
  137. package/resources/hris/benefits/index.d.ts.map +1 -0
  138. package/{dist/cjs/resources → resources}/hris/benefits/index.js +2 -2
  139. package/resources/hris/benefits/index.js.map +1 -0
  140. package/{dist/esm/resources/hris/benefits/index.js → resources/hris/benefits/index.mjs} +3 -3
  141. package/resources/hris/benefits/index.mjs.map +1 -0
  142. package/{dist/esm/resources → resources}/hris/benefits/individuals.d.ts +11 -7
  143. package/resources/hris/benefits/individuals.d.ts.map +1 -0
  144. package/resources/hris/benefits/individuals.js +68 -0
  145. package/resources/hris/benefits/individuals.js.map +1 -0
  146. package/{dist/esm/resources/hris/benefits/individuals.js → resources/hris/benefits/individuals.mjs} +5 -10
  147. package/resources/hris/benefits/individuals.mjs.map +1 -0
  148. package/{dist/esm/resources → resources}/hris/company.d.ts +3 -3
  149. package/resources/hris/company.d.ts.map +1 -0
  150. package/{dist/cjs/resources → resources}/hris/company.js +1 -1
  151. package/resources/hris/company.js.map +1 -0
  152. package/{dist/esm/resources/hris/company.js → resources/hris/company.mjs} +2 -2
  153. package/resources/hris/company.mjs.map +1 -0
  154. package/{dist/esm/resources → resources}/hris/directory.d.ts +3 -3
  155. package/resources/hris/directory.d.ts.map +1 -0
  156. package/{dist/cjs/resources → resources}/hris/directory.js +4 -8
  157. package/resources/hris/directory.js.map +1 -0
  158. package/{dist/esm/resources/hris/directory.js → resources/hris/directory.mjs} +4 -4
  159. package/resources/hris/directory.mjs.map +1 -0
  160. package/{dist/esm/resources → resources}/hris/hris.d.ts +1 -1
  161. package/{dist/esm/resources → resources}/hris/hris.d.ts.map +1 -1
  162. package/{dist/cjs/resources → resources}/hris/hris.js +8 -8
  163. package/resources/hris/hris.js.map +1 -0
  164. package/{dist/esm/resources/hris/hris.js → resources/hris/hris.mjs} +9 -9
  165. package/resources/hris/hris.mjs.map +1 -0
  166. package/resources/hris/index.d.ts.map +1 -0
  167. package/{dist/cjs/resources → resources}/hris/index.js +7 -7
  168. package/resources/hris/index.js.map +1 -0
  169. package/resources/hris/index.mjs +9 -0
  170. package/resources/hris/index.mjs.map +1 -0
  171. package/{dist/esm/resources → resources}/hris/individuals/employment-data.d.ts +7 -5
  172. package/resources/hris/individuals/employment-data.d.ts.map +1 -0
  173. package/{dist/cjs/resources → resources}/hris/individuals/employment-data.js +8 -9
  174. package/resources/hris/individuals/employment-data.js.map +1 -0
  175. package/{dist/esm/resources/hris/individuals/employment-data.js → resources/hris/individuals/employment-data.mjs} +4 -5
  176. package/resources/hris/individuals/employment-data.mjs.map +1 -0
  177. package/resources/hris/individuals/index.d.ts.map +1 -0
  178. package/{dist/cjs/resources → resources}/hris/individuals/index.js +2 -2
  179. package/resources/hris/individuals/index.js.map +1 -0
  180. package/{dist/esm/resources/hris/individuals/index.js → resources/hris/individuals/index.mjs} +3 -3
  181. package/resources/hris/individuals/index.mjs.map +1 -0
  182. package/{dist/esm/resources → resources}/hris/individuals/individuals.d.ts +7 -5
  183. package/resources/hris/individuals/individuals.d.ts.map +1 -0
  184. package/{dist/cjs/resources → resources}/hris/individuals/individuals.js +10 -11
  185. package/resources/hris/individuals/individuals.js.map +1 -0
  186. package/{dist/esm/resources/hris/individuals/individuals.js → resources/hris/individuals/individuals.mjs} +6 -7
  187. package/resources/hris/individuals/individuals.mjs.map +1 -0
  188. package/{dist/esm/resources → resources}/hris/pay-statements.d.ts +8 -6
  189. package/resources/hris/pay-statements.d.ts.map +1 -0
  190. package/resources/hris/pay-statements.js +26 -0
  191. package/resources/hris/pay-statements.js.map +1 -0
  192. package/{dist/esm/resources/hris/pay-statements.js → resources/hris/pay-statements.mjs} +4 -7
  193. package/resources/hris/pay-statements.mjs.map +1 -0
  194. package/{dist/esm/resources → resources}/hris/payments.d.ts +7 -5
  195. package/resources/hris/payments.d.ts.map +1 -0
  196. package/resources/hris/payments.js +19 -0
  197. package/resources/hris/payments.js.map +1 -0
  198. package/{dist/esm/resources/hris/payments.js → resources/hris/payments.mjs} +4 -7
  199. package/resources/hris/payments.mjs.map +1 -0
  200. package/resources/index.d.ts.map +1 -0
  201. package/{dist/cjs/resources → resources}/index.js +4 -4
  202. package/resources/index.js.map +1 -0
  203. package/resources/index.mjs +6 -0
  204. package/resources/index.mjs.map +1 -0
  205. package/{dist/esm/resources → resources}/providers.d.ts +6 -4
  206. package/resources/providers.d.ts.map +1 -0
  207. package/resources/providers.js +19 -0
  208. package/resources/providers.js.map +1 -0
  209. package/{dist/esm/resources/providers.js → resources/providers.mjs} +4 -7
  210. package/resources/providers.mjs.map +1 -0
  211. package/resources/top-level.d.ts.map +1 -0
  212. package/resources/top-level.js.map +1 -0
  213. package/{dist/esm/resources/top-level.js → resources/top-level.mjs} +1 -1
  214. package/resources/top-level.mjs.map +1 -0
  215. package/{_shims → src/_shims}/agent.node.ts +2 -0
  216. package/{_shims → src/_shims}/agent.ts +2 -2
  217. package/src/_shims/fetch.d.ts +52 -0
  218. package/src/_shims/fetch.js +13 -0
  219. package/src/_shims/fetch.mjs +15 -0
  220. package/src/_shims/fetch.node.d.ts +53 -0
  221. package/src/_shims/fetch.node.js +12 -0
  222. package/src/_shims/fetch.node.mjs +14 -0
  223. package/{_shims → src/_shims}/fileFromPath.node.ts +1 -2
  224. package/{_shims → src/_shims}/fileFromPath.ts +1 -2
  225. package/src/_shims/formdata.d.ts +43 -0
  226. package/src/_shims/formdata.js +9 -0
  227. package/src/_shims/formdata.mjs +11 -0
  228. package/src/_shims/formdata.node.d.ts +44 -0
  229. package/src/_shims/formdata.node.js +11 -0
  230. package/{dist/esm/_shims/formdata.node.js → src/_shims/formdata.node.mjs} +3 -1
  231. package/{_shims → src/_shims}/getMultipartRequestOptions.node.ts +2 -1
  232. package/{_shims → src/_shims}/getMultipartRequestOptions.ts +2 -1
  233. package/src/_shims/node-readable.node.ts +10 -0
  234. package/src/_shims/node-readable.ts +30 -0
  235. package/{core.ts → src/core.ts} +42 -20
  236. package/{index.ts → src/index.ts} +52 -3
  237. package/{resources → src/resources}/account.ts +2 -2
  238. package/{resources → src/resources}/ats/applications.ts +5 -5
  239. package/{resources → src/resources}/ats/ats.ts +1 -1
  240. package/{resources → src/resources}/ats/candidates.ts +4 -4
  241. package/{resources → src/resources}/ats/jobs.ts +4 -4
  242. package/{resources → src/resources}/ats/offers.ts +4 -4
  243. package/{resources → src/resources}/ats/stages.ts +6 -4
  244. package/{resources → src/resources}/hris/benefits/benefits.ts +10 -6
  245. package/{resources → src/resources}/hris/benefits/individuals.ts +14 -8
  246. package/{resources → src/resources}/hris/company.ts +3 -3
  247. package/{resources → src/resources}/hris/directory.ts +4 -4
  248. package/{resources → src/resources}/hris/hris.ts +1 -1
  249. package/{resources → src/resources}/hris/individuals/employment-data.ts +7 -5
  250. package/{resources → src/resources}/hris/individuals/individuals.ts +8 -6
  251. package/{resources → src/resources}/hris/pay-statements.ts +8 -6
  252. package/{resources → src/resources}/hris/payments.ts +7 -5
  253. package/{resources → src/resources}/providers.ts +6 -4
  254. package/{streaming.ts → src/streaming.ts} +4 -1
  255. package/src/uploads.ts +248 -0
  256. package/src/version.ts +1 -0
  257. package/{dist/esm/streaming.d.ts → streaming.d.ts} +2 -0
  258. package/streaming.d.ts.map +1 -0
  259. package/streaming.js +155 -0
  260. package/streaming.js.map +1 -0
  261. package/{dist/esm/streaming.js → streaming.mjs} +3 -2
  262. package/streaming.mjs.map +1 -0
  263. package/uploads.d.ts +90 -0
  264. package/uploads.d.ts.map +1 -0
  265. package/uploads.js +207 -0
  266. package/uploads.js.map +1 -0
  267. package/uploads.mjs +174 -0
  268. package/uploads.mjs.map +1 -0
  269. package/version.d.ts +2 -0
  270. package/version.d.ts.map +1 -0
  271. package/{dist/cjs/version.js → version.js} +1 -1
  272. package/version.js.map +1 -0
  273. package/version.mjs +2 -0
  274. package/version.mjs.map +1 -0
  275. package/CHANGELOG.md +0 -90
  276. package/LICENSE +0 -201
  277. package/README.md +0 -220
  278. package/_shims/fetch.node.ts +0 -11
  279. package/_shims/fetch.ts +0 -32
  280. package/_shims/formdata.ts +0 -22
  281. package/_shims/newFileArgs.ts +0 -94
  282. package/_shims/toFile.node.ts +0 -25
  283. package/_shims/toFile.ts +0 -26
  284. package/_shims/uploadable.node.ts +0 -21
  285. package/_shims/uploadable.ts +0 -82
  286. package/check-version.ts +0 -18
  287. package/dist/cjs/_shims/agent.d.ts +0 -9
  288. package/dist/cjs/_shims/agent.d.ts.map +0 -1
  289. package/dist/cjs/_shims/agent.js.map +0 -1
  290. package/dist/cjs/_shims/agent.node.d.ts +0 -6
  291. package/dist/cjs/_shims/agent.node.d.ts.map +0 -1
  292. package/dist/cjs/_shims/agent.node.js.map +0 -1
  293. package/dist/cjs/_shims/fetch.d.ts +0 -19
  294. package/dist/cjs/_shims/fetch.d.ts.map +0 -1
  295. package/dist/cjs/_shims/fetch.js +0 -24
  296. package/dist/cjs/_shims/fetch.js.map +0 -1
  297. package/dist/cjs/_shims/fetch.node.d.ts +0 -9
  298. package/dist/cjs/_shims/fetch.node.d.ts.map +0 -1
  299. package/dist/cjs/_shims/fetch.node.js +0 -68
  300. package/dist/cjs/_shims/fetch.node.js.map +0 -1
  301. package/dist/cjs/_shims/fileFromPath.d.ts.map +0 -1
  302. package/dist/cjs/_shims/fileFromPath.js +0 -49
  303. package/dist/cjs/_shims/fileFromPath.js.map +0 -1
  304. package/dist/cjs/_shims/fileFromPath.node.d.ts.map +0 -1
  305. package/dist/cjs/_shims/fileFromPath.node.js +0 -50
  306. package/dist/cjs/_shims/fileFromPath.node.js.map +0 -1
  307. package/dist/cjs/_shims/formdata.d.ts +0 -13
  308. package/dist/cjs/_shims/formdata.d.ts.map +0 -1
  309. package/dist/cjs/_shims/formdata.js +0 -20
  310. package/dist/cjs/_shims/formdata.js.map +0 -1
  311. package/dist/cjs/_shims/formdata.node.d.ts +0 -7
  312. package/dist/cjs/_shims/formdata.node.d.ts.map +0 -1
  313. package/dist/cjs/_shims/formdata.node.js +0 -27
  314. package/dist/cjs/_shims/formdata.node.js.map +0 -1
  315. package/dist/cjs/_shims/getMultipartRequestOptions.d.ts +0 -10
  316. package/dist/cjs/_shims/getMultipartRequestOptions.d.ts.map +0 -1
  317. package/dist/cjs/_shims/getMultipartRequestOptions.js +0 -44
  318. package/dist/cjs/_shims/getMultipartRequestOptions.js.map +0 -1
  319. package/dist/cjs/_shims/getMultipartRequestOptions.node.d.ts +0 -10
  320. package/dist/cjs/_shims/getMultipartRequestOptions.node.d.ts.map +0 -1
  321. package/dist/cjs/_shims/getMultipartRequestOptions.node.js +0 -52
  322. package/dist/cjs/_shims/getMultipartRequestOptions.node.js.map +0 -1
  323. package/dist/cjs/_shims/newFileArgs.d.ts +0 -19
  324. package/dist/cjs/_shims/newFileArgs.d.ts.map +0 -1
  325. package/dist/cjs/_shims/newFileArgs.js +0 -169
  326. package/dist/cjs/_shims/newFileArgs.js.map +0 -1
  327. package/dist/cjs/_shims/toFile.d.ts +0 -21
  328. package/dist/cjs/_shims/toFile.d.ts.map +0 -1
  329. package/dist/cjs/_shims/toFile.js +0 -56
  330. package/dist/cjs/_shims/toFile.js.map +0 -1
  331. package/dist/cjs/_shims/toFile.node.d.ts +0 -20
  332. package/dist/cjs/_shims/toFile.node.d.ts.map +0 -1
  333. package/dist/cjs/_shims/toFile.node.js +0 -56
  334. package/dist/cjs/_shims/toFile.node.js.map +0 -1
  335. package/dist/cjs/_shims/uploadable.d.ts +0 -56
  336. package/dist/cjs/_shims/uploadable.d.ts.map +0 -1
  337. package/dist/cjs/_shims/uploadable.js +0 -37
  338. package/dist/cjs/_shims/uploadable.js.map +0 -1
  339. package/dist/cjs/_shims/uploadable.node.d.ts +0 -7
  340. package/dist/cjs/_shims/uploadable.node.d.ts.map +0 -1
  341. package/dist/cjs/_shims/uploadable.node.js +0 -23
  342. package/dist/cjs/_shims/uploadable.node.js.map +0 -1
  343. package/dist/cjs/check-version.d.ts +0 -2
  344. package/dist/cjs/check-version.d.ts.map +0 -1
  345. package/dist/cjs/check-version.js +0 -23
  346. package/dist/cjs/check-version.js.map +0 -1
  347. package/dist/cjs/core.d.ts +0 -221
  348. package/dist/cjs/core.d.ts.map +0 -1
  349. package/dist/cjs/core.js.map +0 -1
  350. package/dist/cjs/error.d.ts +0 -48
  351. package/dist/cjs/error.d.ts.map +0 -1
  352. package/dist/cjs/error.js.map +0 -1
  353. package/dist/cjs/index.d.ts.map +0 -1
  354. package/dist/cjs/index.js.map +0 -1
  355. package/dist/cjs/pagination.d.ts +0 -168
  356. package/dist/cjs/pagination.d.ts.map +0 -1
  357. package/dist/cjs/pagination.js.map +0 -1
  358. package/dist/cjs/resource.d.ts +0 -12
  359. package/dist/cjs/resource.d.ts.map +0 -1
  360. package/dist/cjs/resource.js.map +0 -1
  361. package/dist/cjs/resources/account.d.ts +0 -54
  362. package/dist/cjs/resources/account.d.ts.map +0 -1
  363. package/dist/cjs/resources/account.js.map +0 -1
  364. package/dist/cjs/resources/ats/applications.d.ts +0 -36
  365. package/dist/cjs/resources/ats/applications.d.ts.map +0 -1
  366. package/dist/cjs/resources/ats/applications.js.map +0 -1
  367. package/dist/cjs/resources/ats/ats.d.ts +0 -32
  368. package/dist/cjs/resources/ats/ats.js.map +0 -1
  369. package/dist/cjs/resources/ats/candidates.d.ts +0 -50
  370. package/dist/cjs/resources/ats/candidates.d.ts.map +0 -1
  371. package/dist/cjs/resources/ats/candidates.js.map +0 -1
  372. package/dist/cjs/resources/ats/index.d.ts +0 -7
  373. package/dist/cjs/resources/ats/index.d.ts.map +0 -1
  374. package/dist/cjs/resources/ats/index.js.map +0 -1
  375. package/dist/cjs/resources/ats/jobs.d.ts +0 -47
  376. package/dist/cjs/resources/ats/jobs.d.ts.map +0 -1
  377. package/dist/cjs/resources/ats/jobs.js.map +0 -1
  378. package/dist/cjs/resources/ats/offers.d.ts +0 -39
  379. package/dist/cjs/resources/ats/offers.d.ts.map +0 -1
  380. package/dist/cjs/resources/ats/offers.js.map +0 -1
  381. package/dist/cjs/resources/ats/stages.d.ts +0 -28
  382. package/dist/cjs/resources/ats/stages.d.ts.map +0 -1
  383. package/dist/cjs/resources/ats/stages.js +0 -65
  384. package/dist/cjs/resources/ats/stages.js.map +0 -1
  385. package/dist/cjs/resources/hris/benefits/benefits.d.ts +0 -180
  386. package/dist/cjs/resources/hris/benefits/benefits.d.ts.map +0 -1
  387. package/dist/cjs/resources/hris/benefits/benefits.js.map +0 -1
  388. package/dist/cjs/resources/hris/benefits/index.d.ts +0 -28
  389. package/dist/cjs/resources/hris/benefits/index.d.ts.map +0 -1
  390. package/dist/cjs/resources/hris/benefits/index.js.map +0 -1
  391. package/dist/cjs/resources/hris/benefits/individuals.d.ts +0 -176
  392. package/dist/cjs/resources/hris/benefits/individuals.d.ts.map +0 -1
  393. package/dist/cjs/resources/hris/benefits/individuals.js +0 -114
  394. package/dist/cjs/resources/hris/benefits/individuals.js.map +0 -1
  395. package/dist/cjs/resources/hris/company.d.ts +0 -108
  396. package/dist/cjs/resources/hris/company.d.ts.map +0 -1
  397. package/dist/cjs/resources/hris/company.js.map +0 -1
  398. package/dist/cjs/resources/hris/directory.d.ts +0 -70
  399. package/dist/cjs/resources/hris/directory.d.ts.map +0 -1
  400. package/dist/cjs/resources/hris/directory.js.map +0 -1
  401. package/dist/cjs/resources/hris/hris.d.ts +0 -134
  402. package/dist/cjs/resources/hris/hris.d.ts.map +0 -1
  403. package/dist/cjs/resources/hris/hris.js.map +0 -1
  404. package/dist/cjs/resources/hris/index.d.ts +0 -34
  405. package/dist/cjs/resources/hris/index.d.ts.map +0 -1
  406. package/dist/cjs/resources/hris/index.js.map +0 -1
  407. package/dist/cjs/resources/hris/individuals/employment-data.d.ts +0 -150
  408. package/dist/cjs/resources/hris/individuals/employment-data.d.ts.map +0 -1
  409. package/dist/cjs/resources/hris/individuals/employment-data.js.map +0 -1
  410. package/dist/cjs/resources/hris/individuals/index.d.ts +0 -14
  411. package/dist/cjs/resources/hris/individuals/index.d.ts.map +0 -1
  412. package/dist/cjs/resources/hris/individuals/index.js.map +0 -1
  413. package/dist/cjs/resources/hris/individuals/individuals.d.ts +0 -91
  414. package/dist/cjs/resources/hris/individuals/individuals.d.ts.map +0 -1
  415. package/dist/cjs/resources/hris/individuals/individuals.js.map +0 -1
  416. package/dist/cjs/resources/hris/pay-statements.d.ts +0 -195
  417. package/dist/cjs/resources/hris/pay-statements.d.ts.map +0 -1
  418. package/dist/cjs/resources/hris/pay-statements.js +0 -69
  419. package/dist/cjs/resources/hris/pay-statements.js.map +0 -1
  420. package/dist/cjs/resources/hris/payments.d.ts +0 -60
  421. package/dist/cjs/resources/hris/payments.d.ts.map +0 -1
  422. package/dist/cjs/resources/hris/payments.js +0 -62
  423. package/dist/cjs/resources/hris/payments.js.map +0 -1
  424. package/dist/cjs/resources/index.d.ts +0 -5
  425. package/dist/cjs/resources/index.d.ts.map +0 -1
  426. package/dist/cjs/resources/index.js.map +0 -1
  427. package/dist/cjs/resources/providers.d.ts +0 -51
  428. package/dist/cjs/resources/providers.d.ts.map +0 -1
  429. package/dist/cjs/resources/providers.js +0 -62
  430. package/dist/cjs/resources/providers.js.map +0 -1
  431. package/dist/cjs/resources/top-level.d.ts.map +0 -1
  432. package/dist/cjs/resources/top-level.js.map +0 -1
  433. package/dist/cjs/streaming.d.ts +0 -12
  434. package/dist/cjs/streaming.d.ts.map +0 -1
  435. package/dist/cjs/streaming.js +0 -284
  436. package/dist/cjs/streaming.js.map +0 -1
  437. package/dist/cjs/uploads.d.ts +0 -24
  438. package/dist/cjs/uploads.d.ts.map +0 -1
  439. package/dist/cjs/uploads.js +0 -121
  440. package/dist/cjs/uploads.js.map +0 -1
  441. package/dist/cjs/version.d.ts +0 -2
  442. package/dist/cjs/version.d.ts.map +0 -1
  443. package/dist/cjs/version.js.map +0 -1
  444. package/dist/esm/_shims/agent.d.ts.map +0 -1
  445. package/dist/esm/_shims/agent.js.map +0 -1
  446. package/dist/esm/_shims/agent.node.d.ts.map +0 -1
  447. package/dist/esm/_shims/agent.node.js.map +0 -1
  448. package/dist/esm/_shims/fetch.d.ts +0 -19
  449. package/dist/esm/_shims/fetch.d.ts.map +0 -1
  450. package/dist/esm/_shims/fetch.js +0 -18
  451. package/dist/esm/_shims/fetch.js.map +0 -1
  452. package/dist/esm/_shims/fetch.node.d.ts +0 -9
  453. package/dist/esm/_shims/fetch.node.d.ts.map +0 -1
  454. package/dist/esm/_shims/fetch.node.js +0 -7
  455. package/dist/esm/_shims/fetch.node.js.map +0 -1
  456. package/dist/esm/_shims/fileFromPath.d.ts +0 -23
  457. package/dist/esm/_shims/fileFromPath.d.ts.map +0 -1
  458. package/dist/esm/_shims/fileFromPath.js.map +0 -1
  459. package/dist/esm/_shims/fileFromPath.node.d.ts +0 -18
  460. package/dist/esm/_shims/fileFromPath.node.d.ts.map +0 -1
  461. package/dist/esm/_shims/fileFromPath.node.js.map +0 -1
  462. package/dist/esm/_shims/formdata.d.ts +0 -13
  463. package/dist/esm/_shims/formdata.d.ts.map +0 -1
  464. package/dist/esm/_shims/formdata.js.map +0 -1
  465. package/dist/esm/_shims/formdata.node.d.ts +0 -7
  466. package/dist/esm/_shims/formdata.node.d.ts.map +0 -1
  467. package/dist/esm/_shims/formdata.node.js.map +0 -1
  468. package/dist/esm/_shims/getMultipartRequestOptions.d.ts.map +0 -1
  469. package/dist/esm/_shims/getMultipartRequestOptions.js +0 -7
  470. package/dist/esm/_shims/getMultipartRequestOptions.js.map +0 -1
  471. package/dist/esm/_shims/getMultipartRequestOptions.node.d.ts.map +0 -1
  472. package/dist/esm/_shims/getMultipartRequestOptions.node.js.map +0 -1
  473. package/dist/esm/_shims/newFileArgs.d.ts +0 -19
  474. package/dist/esm/_shims/newFileArgs.d.ts.map +0 -1
  475. package/dist/esm/_shims/newFileArgs.js +0 -66
  476. package/dist/esm/_shims/newFileArgs.js.map +0 -1
  477. package/dist/esm/_shims/toFile.d.ts +0 -21
  478. package/dist/esm/_shims/toFile.d.ts.map +0 -1
  479. package/dist/esm/_shims/toFile.js +0 -19
  480. package/dist/esm/_shims/toFile.js.map +0 -1
  481. package/dist/esm/_shims/toFile.node.d.ts +0 -20
  482. package/dist/esm/_shims/toFile.node.d.ts.map +0 -1
  483. package/dist/esm/_shims/toFile.node.js +0 -19
  484. package/dist/esm/_shims/toFile.node.js.map +0 -1
  485. package/dist/esm/_shims/uploadable.d.ts +0 -56
  486. package/dist/esm/_shims/uploadable.d.ts.map +0 -1
  487. package/dist/esm/_shims/uploadable.js +0 -30
  488. package/dist/esm/_shims/uploadable.js.map +0 -1
  489. package/dist/esm/_shims/uploadable.node.d.ts +0 -7
  490. package/dist/esm/_shims/uploadable.node.d.ts.map +0 -1
  491. package/dist/esm/_shims/uploadable.node.js +0 -10
  492. package/dist/esm/_shims/uploadable.node.js.map +0 -1
  493. package/dist/esm/check-version.d.ts +0 -2
  494. package/dist/esm/check-version.d.ts.map +0 -1
  495. package/dist/esm/check-version.js +0 -16
  496. package/dist/esm/check-version.js.map +0 -1
  497. package/dist/esm/core.d.ts.map +0 -1
  498. package/dist/esm/core.js.map +0 -1
  499. package/dist/esm/error.d.ts.map +0 -1
  500. package/dist/esm/error.js.map +0 -1
  501. package/dist/esm/index.d.ts.map +0 -1
  502. package/dist/esm/index.js.map +0 -1
  503. package/dist/esm/package.json +0 -3
  504. package/dist/esm/pagination.d.ts.map +0 -1
  505. package/dist/esm/pagination.js.map +0 -1
  506. package/dist/esm/resource.d.ts.map +0 -1
  507. package/dist/esm/resource.js.map +0 -1
  508. package/dist/esm/resources/account.d.ts.map +0 -1
  509. package/dist/esm/resources/account.js.map +0 -1
  510. package/dist/esm/resources/ats/applications.d.ts.map +0 -1
  511. package/dist/esm/resources/ats/applications.js.map +0 -1
  512. package/dist/esm/resources/ats/ats.d.ts.map +0 -1
  513. package/dist/esm/resources/ats/ats.js.map +0 -1
  514. package/dist/esm/resources/ats/candidates.d.ts.map +0 -1
  515. package/dist/esm/resources/ats/candidates.js.map +0 -1
  516. package/dist/esm/resources/ats/index.d.ts.map +0 -1
  517. package/dist/esm/resources/ats/index.js +0 -8
  518. package/dist/esm/resources/ats/index.js.map +0 -1
  519. package/dist/esm/resources/ats/jobs.d.ts.map +0 -1
  520. package/dist/esm/resources/ats/jobs.js.map +0 -1
  521. package/dist/esm/resources/ats/offers.d.ts.map +0 -1
  522. package/dist/esm/resources/ats/offers.js.map +0 -1
  523. package/dist/esm/resources/ats/stages.d.ts.map +0 -1
  524. package/dist/esm/resources/ats/stages.js.map +0 -1
  525. package/dist/esm/resources/hris/benefits/benefits.d.ts.map +0 -1
  526. package/dist/esm/resources/hris/benefits/benefits.js.map +0 -1
  527. package/dist/esm/resources/hris/benefits/index.d.ts.map +0 -1
  528. package/dist/esm/resources/hris/benefits/index.js.map +0 -1
  529. package/dist/esm/resources/hris/benefits/individuals.d.ts.map +0 -1
  530. package/dist/esm/resources/hris/benefits/individuals.js.map +0 -1
  531. package/dist/esm/resources/hris/company.d.ts.map +0 -1
  532. package/dist/esm/resources/hris/company.js.map +0 -1
  533. package/dist/esm/resources/hris/directory.d.ts.map +0 -1
  534. package/dist/esm/resources/hris/directory.js.map +0 -1
  535. package/dist/esm/resources/hris/hris.js.map +0 -1
  536. package/dist/esm/resources/hris/index.d.ts.map +0 -1
  537. package/dist/esm/resources/hris/index.js +0 -9
  538. package/dist/esm/resources/hris/index.js.map +0 -1
  539. package/dist/esm/resources/hris/individuals/employment-data.d.ts.map +0 -1
  540. package/dist/esm/resources/hris/individuals/employment-data.js.map +0 -1
  541. package/dist/esm/resources/hris/individuals/index.d.ts.map +0 -1
  542. package/dist/esm/resources/hris/individuals/index.js.map +0 -1
  543. package/dist/esm/resources/hris/individuals/individuals.d.ts.map +0 -1
  544. package/dist/esm/resources/hris/individuals/individuals.js.map +0 -1
  545. package/dist/esm/resources/hris/pay-statements.d.ts.map +0 -1
  546. package/dist/esm/resources/hris/pay-statements.js.map +0 -1
  547. package/dist/esm/resources/hris/payments.d.ts.map +0 -1
  548. package/dist/esm/resources/hris/payments.js.map +0 -1
  549. package/dist/esm/resources/index.d.ts.map +0 -1
  550. package/dist/esm/resources/index.js +0 -6
  551. package/dist/esm/resources/index.js.map +0 -1
  552. package/dist/esm/resources/providers.d.ts.map +0 -1
  553. package/dist/esm/resources/providers.js.map +0 -1
  554. package/dist/esm/resources/top-level.d.ts +0 -2
  555. package/dist/esm/resources/top-level.d.ts.map +0 -1
  556. package/dist/esm/resources/top-level.js.map +0 -1
  557. package/dist/esm/streaming.d.ts.map +0 -1
  558. package/dist/esm/streaming.js.map +0 -1
  559. package/dist/esm/uploads.d.ts +0 -24
  560. package/dist/esm/uploads.d.ts.map +0 -1
  561. package/dist/esm/uploads.js +0 -61
  562. package/dist/esm/uploads.js.map +0 -1
  563. package/dist/esm/version.d.ts +0 -2
  564. package/dist/esm/version.d.ts.map +0 -1
  565. package/dist/esm/version.js +0 -2
  566. package/dist/esm/version.js.map +0 -1
  567. package/uploads.ts +0 -81
  568. package/version.ts +0 -1
  569. /package/{dist/cjs/_shims → _shims}/agent.js +0 -0
  570. /package/{dist/cjs/_shims → _shims}/agent.node.js +0 -0
  571. /package/_shims/{formdata.node.ts → formdata.node.mjs} +0 -0
  572. /package/{dist/esm/_shims → _shims}/getMultipartRequestOptions.d.ts +0 -0
  573. /package/{dist/esm/_shims → _shims}/getMultipartRequestOptions.node.d.ts +0 -0
  574. /package/{dist/esm/error.d.ts → error.d.ts} +0 -0
  575. /package/{dist/esm/pagination.d.ts → pagination.d.ts} +0 -0
  576. /package/{dist/esm/resource.d.ts → resource.d.ts} +0 -0
  577. /package/{dist/cjs/resource.js → resource.js} +0 -0
  578. /package/{dist/esm/resources → resources}/ats/index.d.ts +0 -0
  579. /package/{dist/esm/resources → resources}/hris/benefits/index.d.ts +0 -0
  580. /package/{dist/esm/resources → resources}/hris/index.d.ts +0 -0
  581. /package/{dist/esm/resources → resources}/hris/individuals/index.d.ts +0 -0
  582. /package/{dist/esm/resources → resources}/index.d.ts +0 -0
  583. /package/{dist/cjs/resources → resources}/top-level.d.ts +0 -0
  584. /package/{dist/cjs/resources → resources}/top-level.js +0 -0
  585. /package/{error.ts → src/error.ts} +0 -0
  586. /package/{pagination.ts → src/pagination.ts} +0 -0
  587. /package/{resource.ts → src/resource.ts} +0 -0
  588. /package/{resources → src/resources}/ats/index.ts +0 -0
  589. /package/{resources → src/resources}/hris/benefits/index.ts +0 -0
  590. /package/{resources → src/resources}/hris/index.ts +0 -0
  591. /package/{resources → src/resources}/hris/individuals/index.ts +0 -0
  592. /package/{resources → src/resources}/index.ts +0 -0
  593. /package/{resources → src/resources}/top-level.ts +0 -0
@@ -1,5 +1,5 @@
1
1
  import type { Response } from '@tryfinch/finch-api/_shims/fetch';
2
- import { APIResponse, Headers, createResponseHeaders } from '~/core';
2
+ import { APIResponse, Headers, createResponseHeaders } from './core';
3
3
 
4
4
  type ServerSentEvent = {
5
5
  event: string | null;
@@ -63,7 +63,9 @@ class SSEDecoder {
63
63
  }
64
64
 
65
65
  export class Stream<Item> implements AsyncIterable<Item>, APIResponse<Stream<Item>> {
66
+ /** @deprecated - please use the async iterator instead. We plan to add additional helper methods shortly. */
66
67
  response: Response;
68
+ /** @deprecated - we plan to add a different way to access raw response information shortly. */
67
69
  responseHeaders: Headers;
68
70
  controller: AbortController;
69
71
 
@@ -84,6 +86,7 @@ export class Stream<Item> implements AsyncIterable<Item>, APIResponse<Stream<Ite
84
86
 
85
87
  const lineDecoder = new LineDecoder();
86
88
 
89
+ // @ts-ignore
87
90
  for await (const chunk of this.response.body) {
88
91
  let text;
89
92
  if (chunk instanceof Buffer) {
package/src/uploads.ts ADDED
@@ -0,0 +1,248 @@
1
+ import { type RequestOptions } from './core';
2
+ import { type Readable } from '@tryfinch/finch-api/_shims/node-readable';
3
+ import { type BodyInit } from '@tryfinch/finch-api/_shims/fetch';
4
+ import { FormData, File, type FilePropertyBag } from '@tryfinch/finch-api/_shims/formdata';
5
+ import { getMultipartRequestOptions } from '@tryfinch/finch-api/_shims/getMultipartRequestOptions';
6
+ import { fileFromPath } from '@tryfinch/finch-api/_shims/fileFromPath';
7
+ import { type FsReadStream, isFsReadStream } from '@tryfinch/finch-api/_shims/node-readable';
8
+
9
+ export { fileFromPath };
10
+
11
+ export type BlobPart = string | ArrayBuffer | ArrayBufferView | BlobLike | Uint8Array | DataView;
12
+
13
+ /**
14
+ * Typically, this is a native "File" class.
15
+ *
16
+ * We provide the {@link toFile} utility to convert a variety of objects
17
+ * into the File class.
18
+ *
19
+ * For convenience, you can also pass a fetch Response, or in Node,
20
+ * the result of fs.createReadStream().
21
+ */
22
+ export type Uploadable = FileLike | ResponseLike | FsReadStream;
23
+
24
+ /**
25
+ * Intended to match web.Blob, node.Blob, node-fetch.Blob, etc.
26
+ */
27
+ export interface BlobLike {
28
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/size) */
29
+ readonly size: number;
30
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/type) */
31
+ readonly type: string;
32
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/text) */
33
+ text(): Promise<string>;
34
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/slice) */
35
+ slice(start?: number, end?: number): BlobLike;
36
+ // unfortunately @types/node-fetch@^2.6.4 doesn't type the arrayBuffer method
37
+ }
38
+
39
+ /**
40
+ * Intended to match web.File, node.File, node-fetch.File, etc.
41
+ */
42
+ export interface FileLike extends BlobLike {
43
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/File/lastModified) */
44
+ readonly lastModified: number;
45
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/File/name) */
46
+ readonly name: string;
47
+ }
48
+
49
+ /**
50
+ * Intended to match web.Response, node.Response, node-fetch.Response, etc.
51
+ */
52
+ export interface ResponseLike {
53
+ url: string;
54
+ blob(): Promise<BlobLike>;
55
+ }
56
+
57
+ export const isResponseLike = (value: any): value is ResponseLike =>
58
+ value != null &&
59
+ typeof value === 'object' &&
60
+ typeof value.url === 'string' &&
61
+ typeof value.blob === 'function';
62
+
63
+ export const isFileLike = (value: any): value is FileLike =>
64
+ value != null &&
65
+ typeof value === 'object' &&
66
+ typeof value.name === 'string' &&
67
+ typeof value.lastModified === 'number' &&
68
+ isBlobLike(value);
69
+
70
+ /**
71
+ * The BlobLike type omits arrayBuffer() because @types/node-fetch@^2.6.4 lacks it; but this check
72
+ * adds the arrayBuffer() method type because it is available and used at runtime
73
+ */
74
+ export const isBlobLike = (value: any): value is BlobLike & { arrayBuffer(): Promise<ArrayBuffer> } =>
75
+ value != null &&
76
+ typeof value === 'object' &&
77
+ typeof value.size === 'number' &&
78
+ typeof value.type === 'string' &&
79
+ typeof value.text === 'function' &&
80
+ typeof value.slice === 'function' &&
81
+ typeof value.arrayBuffer === 'function';
82
+
83
+ export const isUploadable = (value: any): value is Uploadable => {
84
+ return isFileLike(value) || isResponseLike(value) || isFsReadStream(value);
85
+ };
86
+
87
+ export type ToFileInput = Uploadable | Exclude<BlobPart, string> | AsyncIterable<BlobPart>;
88
+
89
+ /**
90
+ * Helper for creating a {@link File} to pass to an SDK upload method from a variety of different data formats
91
+ * @param bits the raw content of the file. Can be an {@link Uploadable}, {@link BlobPart}, or {@link AsyncIterable} of {@link BlobPart}s
92
+ * @param {string=} name the name of the file. If omitted, toFile will try to determine a file name from bits if possible
93
+ * @param {Object=} options additional properties
94
+ * @param {string=} options.type the MIME type of the content
95
+ * @param {number=} options.lastModified the last modified timestamp
96
+ * @returns a {@link File} with the given properties
97
+ */
98
+ export async function toFile(
99
+ value: ToFileInput,
100
+ name?: string | null | undefined,
101
+ options: FilePropertyBag | undefined = {},
102
+ ): Promise<FileLike> {
103
+ if (isResponseLike(value)) {
104
+ const blob = await value.blob();
105
+ name ||= new URL(value.url).pathname.split(/[\\/]/).pop() ?? 'unknown_file';
106
+
107
+ return new File([blob as any], name, options);
108
+ }
109
+
110
+ const bits = await getBytes(value);
111
+
112
+ name ||= getName(value) ?? 'unknown_file';
113
+
114
+ if (!options.type) {
115
+ const type = (bits[0] as any)?.type;
116
+ if (typeof type === 'string') {
117
+ options = { ...options, type };
118
+ }
119
+ }
120
+
121
+ return new File(bits, name, options);
122
+ }
123
+
124
+ async function getBytes(value: ToFileInput): Promise<Array<BlobPart>> {
125
+ if (value instanceof Promise) return getBytes(await (value as any));
126
+
127
+ let parts: Array<BlobPart> = [];
128
+ if (
129
+ typeof value === 'string' ||
130
+ ArrayBuffer.isView(value) || // includes Uint8Array, Buffer, etc.
131
+ value instanceof ArrayBuffer
132
+ ) {
133
+ parts.push(value);
134
+ } else if (isBlobLike(value)) {
135
+ parts.push(await value.arrayBuffer());
136
+ } else if (
137
+ isAsyncIterableIterator(value) // includes Readable, ReadableStream, etc.
138
+ ) {
139
+ for await (const chunk of value) {
140
+ parts.push(chunk as BlobPart); // TODO, consider validating?
141
+ }
142
+ } else {
143
+ throw new Error(
144
+ `Unexpected data type: ${typeof value}; constructor: ${
145
+ value?.constructor?.name
146
+ }; props: ${propsForError(value)}`,
147
+ );
148
+ }
149
+
150
+ return parts;
151
+ }
152
+
153
+ function propsForError(value: any): string {
154
+ const props = Object.getOwnPropertyNames(value);
155
+ return `[${props.map((p) => `"${p}"`).join(', ')}]`;
156
+ }
157
+
158
+ function getName(value: any): string | undefined {
159
+ return (
160
+ getStringFromMaybeBuffer(value.name) ||
161
+ getStringFromMaybeBuffer(value.filename) ||
162
+ // For fs.ReadStream
163
+ getStringFromMaybeBuffer(value.path)?.split(/[\\/]/).pop()
164
+ );
165
+ }
166
+
167
+ const getStringFromMaybeBuffer = (x: string | Buffer | unknown): string | undefined => {
168
+ if (typeof x === 'string') return x;
169
+ if (typeof Buffer !== 'undefined' && x instanceof Buffer) return String(x);
170
+ return undefined;
171
+ };
172
+
173
+ const isAsyncIterableIterator = (value: any): value is AsyncIterableIterator<unknown> =>
174
+ value != null && typeof value === 'object' && typeof value[Symbol.asyncIterator] === 'function';
175
+
176
+ export class MultipartBody {
177
+ constructor(public body: Readable | BodyInit) {}
178
+ get [Symbol.toStringTag](): string {
179
+ return 'MultipartBody';
180
+ }
181
+ }
182
+
183
+ export const isMultipartBody = (body: any): body is MultipartBody =>
184
+ body && typeof body === 'object' && body.body && body[Symbol.toStringTag] === 'MultipartBody';
185
+
186
+ /**
187
+ * Returns a multipart/form-data request if any part of the given request body contains a File / Blob value.
188
+ * Otherwise returns the request as is.
189
+ */
190
+ export const maybeMultipartFormRequestOptions = async <T extends {} = Record<string, unknown>>(
191
+ opts: RequestOptions<T>,
192
+ ): Promise<RequestOptions<T | MultipartBody>> => {
193
+ if (!hasUploadableValue(opts.body)) return opts;
194
+
195
+ const form = await createForm(opts.body);
196
+ return getMultipartRequestOptions(form, opts);
197
+ };
198
+
199
+ export const multipartFormRequestOptions = async <T extends {} = Record<string, unknown>>(
200
+ opts: RequestOptions<T>,
201
+ ): Promise<RequestOptions<T | MultipartBody>> => {
202
+ const form = await createForm(opts.body);
203
+ return getMultipartRequestOptions(form, opts);
204
+ };
205
+
206
+ export const createForm = async <T = Record<string, unknown>>(body: T | undefined): Promise<FormData> => {
207
+ const form = new FormData();
208
+ await Promise.all(Object.entries(body || {}).map(([key, value]) => addFormValue(form, key, value)));
209
+ return form;
210
+ };
211
+
212
+ const hasUploadableValue = (value: unknown): boolean => {
213
+ if (isUploadable(value)) return true;
214
+ if (Array.isArray(value)) return value.some(hasUploadableValue);
215
+ if (value && typeof value === 'object') {
216
+ for (const k in value) {
217
+ if (hasUploadableValue((value as any)[k])) return true;
218
+ }
219
+ }
220
+ return false;
221
+ };
222
+
223
+ const addFormValue = async (form: FormData, key: string, value: unknown): Promise<void> => {
224
+ if (value === undefined) return;
225
+ if (value == null) {
226
+ throw new TypeError(
227
+ `Received null for "${key}"; to pass null in FormData, you must use the string 'null'`,
228
+ );
229
+ }
230
+
231
+ // TODO: make nested formats configurable
232
+ if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
233
+ form.append(key, value);
234
+ } else if (isUploadable(value)) {
235
+ const file = await toFile(value);
236
+ form.append(key, file);
237
+ } else if (Array.isArray(value)) {
238
+ await Promise.all(value.map((entry) => addFormValue(form, key + '[]', entry)));
239
+ } else if (typeof value === 'object') {
240
+ await Promise.all(
241
+ Object.entries(value).map(([name, prop]) => addFormValue(form, `${key}[${name}]`, prop)),
242
+ );
243
+ } else {
244
+ throw new TypeError(
245
+ `Invalid value given to form, expected a string, number, boolean, object, Array, File or Blob but got ${value} instead`,
246
+ );
247
+ }
248
+ };
package/src/version.ts ADDED
@@ -0,0 +1 @@
1
+ export const VERSION = '3.0.0'; // x-release-please-version
@@ -1,7 +1,9 @@
1
1
  import type { Response } from '@tryfinch/finch-api/_shims/fetch';
2
2
  import { APIResponse, Headers } from './core.js';
3
3
  export declare class Stream<Item> implements AsyncIterable<Item>, APIResponse<Stream<Item>> {
4
+ /** @deprecated - please use the async iterator instead. We plan to add additional helper methods shortly. */
4
5
  response: Response;
6
+ /** @deprecated - we plan to add a different way to access raw response information shortly. */
5
7
  responseHeaders: Headers;
6
8
  controller: AbortController;
7
9
  private decoder;
@@ -0,0 +1 @@
1
+ {"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["src/streaming.ts"],"names":[],"mappings":";AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAyB,MAAM,QAAQ,CAAC;AA+DrE,qBAAa,MAAM,CAAC,IAAI,CAAE,YAAW,aAAa,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACjF,6GAA6G;IAC7G,QAAQ,EAAE,QAAQ,CAAC;IACnB,+FAA+F;IAC/F,eAAe,EAAE,OAAO,CAAC;IACzB,UAAU,EAAE,eAAe,CAAC;IAE5B,OAAO,CAAC,OAAO,CAAa;gBAEhB,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe;YAO5C,YAAY;IA+BpB,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,CAAC;CAoBrE"}
package/streaming.js ADDED
@@ -0,0 +1,155 @@
1
+ 'use strict';
2
+ Object.defineProperty(exports, '__esModule', { value: true });
3
+ exports.Stream = void 0;
4
+ const core_1 = require('./core.js');
5
+ class SSEDecoder {
6
+ constructor() {
7
+ this.event = null;
8
+ this.data = [];
9
+ this.chunks = [];
10
+ }
11
+ decode(line) {
12
+ if (line.endsWith('\r')) {
13
+ line = line.substring(0, line.length - 1);
14
+ }
15
+ if (!line) {
16
+ // empty line and we didn't previously encounter any messages
17
+ if (!this.event && !this.data.length) return null;
18
+ const sse = {
19
+ event: this.event,
20
+ data: this.data.join('\n'),
21
+ raw: this.chunks,
22
+ };
23
+ this.event = null;
24
+ this.data = [];
25
+ this.chunks = [];
26
+ return sse;
27
+ }
28
+ this.chunks.push(line);
29
+ if (line.startsWith(':')) {
30
+ return null;
31
+ }
32
+ let [fieldname, _, value] = partition(line, ':');
33
+ if (value.startsWith(' ')) {
34
+ value = value.substring(1);
35
+ }
36
+ if (fieldname === 'event') {
37
+ this.event = value;
38
+ } else if (fieldname === 'data') {
39
+ this.data.push(value);
40
+ }
41
+ return null;
42
+ }
43
+ }
44
+ class Stream {
45
+ constructor(response, controller) {
46
+ this.response = response;
47
+ this.controller = controller;
48
+ this.decoder = new SSEDecoder();
49
+ this.responseHeaders = (0, core_1.createResponseHeaders)(response.headers);
50
+ }
51
+ async *iterMessages() {
52
+ if (!this.response.body) {
53
+ this.controller.abort();
54
+ throw new Error(`Attempted to iterate over a response with no body`);
55
+ }
56
+ const lineDecoder = new LineDecoder();
57
+ // @ts-ignore
58
+ for await (const chunk of this.response.body) {
59
+ let text;
60
+ if (chunk instanceof Buffer) {
61
+ text = chunk.toString();
62
+ } else if (chunk instanceof Uint8Array) {
63
+ text = Buffer.from(chunk).toString();
64
+ } else {
65
+ text = chunk;
66
+ }
67
+ for (const line of lineDecoder.decode(text)) {
68
+ const sse = this.decoder.decode(line);
69
+ if (sse) yield sse;
70
+ }
71
+ }
72
+ for (const line of lineDecoder.flush()) {
73
+ const sse = this.decoder.decode(line);
74
+ if (sse) yield sse;
75
+ }
76
+ }
77
+ async *[Symbol.asyncIterator]() {
78
+ try {
79
+ for await (const sse of this.iterMessages()) {
80
+ try {
81
+ yield JSON.parse(sse.data);
82
+ } catch (e) {
83
+ console.error(`Could not parse message into JSON:`, sse.data);
84
+ console.error(`From chunk:`, sse.raw);
85
+ throw e;
86
+ }
87
+ }
88
+ } catch (e) {
89
+ // If the user calls `stream.controller.abort()`, we should exit without throwing.
90
+ if (e instanceof Error && e.name === 'AbortError') return;
91
+ throw e;
92
+ } finally {
93
+ // If the user `break`s, abort the ongoing request.
94
+ this.controller.abort();
95
+ }
96
+ }
97
+ }
98
+ exports.Stream = Stream;
99
+ const NEWLINE_CHARS = '\n\r\x0b\x0c\x1c\x1d\x1e\x85\u2028\u2029';
100
+ /**
101
+ * A re-implementation of httpx's `LineDecoder` in Python that handles incrementally
102
+ * reading lines from text.
103
+ *
104
+ * https://github.com/encode/httpx/blob/920333ea98118e9cf617f246905d7b202510941c/httpx/_decoders.py#L258
105
+ */
106
+ class LineDecoder {
107
+ constructor() {
108
+ this.buffer = [];
109
+ this.trailingCR = false;
110
+ }
111
+ decode(text) {
112
+ if (this.trailingCR) {
113
+ text = '\r' + text;
114
+ this.trailingCR = false;
115
+ }
116
+ if (text.endsWith('\r')) {
117
+ this.trailingCR = true;
118
+ text = text.slice(0, -1);
119
+ }
120
+ if (!text) {
121
+ return [];
122
+ }
123
+ const trailing_newline = NEWLINE_CHARS.includes(text.slice(-1));
124
+ let lines = text.split(/\r\n|[\n\r\x0b\x0c\x1c\x1d\x1e\x85\u2028\u2029]/g);
125
+ if (lines.length === 1 && !trailing_newline) {
126
+ this.buffer.push(lines[0]);
127
+ return [];
128
+ }
129
+ if (this.buffer.length > 0) {
130
+ lines = [this.buffer.join('') + lines[0], ...lines.slice(1)];
131
+ this.buffer = [];
132
+ }
133
+ if (!trailing_newline) {
134
+ this.buffer = [lines.pop() || ''];
135
+ }
136
+ return lines;
137
+ }
138
+ flush() {
139
+ if (!this.buffer.length && !this.trailingCR) {
140
+ return [];
141
+ }
142
+ const lines = [this.buffer.join('')];
143
+ this.buffer = [];
144
+ this.trailingCR = false;
145
+ return lines;
146
+ }
147
+ }
148
+ function partition(str, delimiter) {
149
+ const index = str.indexOf(delimiter);
150
+ if (index !== -1) {
151
+ return [str.substring(0, index), delimiter, str.substring(index + delimiter.length)];
152
+ }
153
+ return [str, '', ''];
154
+ }
155
+ //# sourceMappingURL=streaming.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"streaming.js","sourceRoot":"","sources":["src/streaming.ts"],"names":[],"mappings":"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"}
@@ -1,4 +1,4 @@
1
- import { createResponseHeaders } from './core.js';
1
+ import { createResponseHeaders } from './core.mjs';
2
2
  class SSEDecoder {
3
3
  constructor() {
4
4
  this.event = null;
@@ -51,6 +51,7 @@ export class Stream {
51
51
  throw new Error(`Attempted to iterate over a response with no body`);
52
52
  }
53
53
  const lineDecoder = new LineDecoder();
54
+ // @ts-ignore
54
55
  for await (const chunk of this.response.body) {
55
56
  let text;
56
57
  if (chunk instanceof Buffer) {
@@ -147,4 +148,4 @@ function partition(str, delimiter) {
147
148
  }
148
149
  return [str, '', ''];
149
150
  }
150
- //# sourceMappingURL=streaming.js.map
151
+ //# sourceMappingURL=streaming.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"streaming.mjs","sourceRoot":"","sources":["src/streaming.ts"],"names":[],"mappings":"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"}
package/uploads.d.ts ADDED
@@ -0,0 +1,90 @@
1
+ import { type RequestOptions } from './core.js';
2
+ import { type Readable } from '@tryfinch/finch-api/_shims/node-readable';
3
+ import { type BodyInit } from '@tryfinch/finch-api/_shims/fetch';
4
+ import { FormData, type FilePropertyBag } from '@tryfinch/finch-api/_shims/formdata';
5
+ import { fileFromPath } from '@tryfinch/finch-api/_shims/fileFromPath';
6
+ import { type FsReadStream } from '@tryfinch/finch-api/_shims/node-readable';
7
+ export { fileFromPath };
8
+ export type BlobPart = string | ArrayBuffer | ArrayBufferView | BlobLike | Uint8Array | DataView;
9
+ /**
10
+ * Typically, this is a native "File" class.
11
+ *
12
+ * We provide the {@link toFile} utility to convert a variety of objects
13
+ * into the File class.
14
+ *
15
+ * For convenience, you can also pass a fetch Response, or in Node,
16
+ * the result of fs.createReadStream().
17
+ */
18
+ export type Uploadable = FileLike | ResponseLike | FsReadStream;
19
+ /**
20
+ * Intended to match web.Blob, node.Blob, node-fetch.Blob, etc.
21
+ */
22
+ export interface BlobLike {
23
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/size) */
24
+ readonly size: number;
25
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/type) */
26
+ readonly type: string;
27
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/text) */
28
+ text(): Promise<string>;
29
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/slice) */
30
+ slice(start?: number, end?: number): BlobLike;
31
+ }
32
+ /**
33
+ * Intended to match web.File, node.File, node-fetch.File, etc.
34
+ */
35
+ export interface FileLike extends BlobLike {
36
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/File/lastModified) */
37
+ readonly lastModified: number;
38
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/File/name) */
39
+ readonly name: string;
40
+ }
41
+ /**
42
+ * Intended to match web.Response, node.Response, node-fetch.Response, etc.
43
+ */
44
+ export interface ResponseLike {
45
+ url: string;
46
+ blob(): Promise<BlobLike>;
47
+ }
48
+ export declare const isResponseLike: (value: any) => value is ResponseLike;
49
+ export declare const isFileLike: (value: any) => value is FileLike;
50
+ /**
51
+ * The BlobLike type omits arrayBuffer() because @types/node-fetch@^2.6.4 lacks it; but this check
52
+ * adds the arrayBuffer() method type because it is available and used at runtime
53
+ */
54
+ export declare const isBlobLike: (value: any) => value is BlobLike & {
55
+ arrayBuffer(): Promise<ArrayBuffer>;
56
+ };
57
+ export declare const isUploadable: (value: any) => value is Uploadable;
58
+ export type ToFileInput = Uploadable | Exclude<BlobPart, string> | AsyncIterable<BlobPart>;
59
+ /**
60
+ * Helper for creating a {@link File} to pass to an SDK upload method from a variety of different data formats
61
+ * @param bits the raw content of the file. Can be an {@link Uploadable}, {@link BlobPart}, or {@link AsyncIterable} of {@link BlobPart}s
62
+ * @param {string=} name the name of the file. If omitted, toFile will try to determine a file name from bits if possible
63
+ * @param {Object=} options additional properties
64
+ * @param {string=} options.type the MIME type of the content
65
+ * @param {number=} options.lastModified the last modified timestamp
66
+ * @returns a {@link File} with the given properties
67
+ */
68
+ export declare function toFile(
69
+ value: ToFileInput,
70
+ name?: string | null | undefined,
71
+ options?: FilePropertyBag | undefined,
72
+ ): Promise<FileLike>;
73
+ export declare class MultipartBody {
74
+ body: Readable | BodyInit;
75
+ constructor(body: Readable | BodyInit);
76
+ get [Symbol.toStringTag](): string;
77
+ }
78
+ export declare const isMultipartBody: (body: any) => body is MultipartBody;
79
+ /**
80
+ * Returns a multipart/form-data request if any part of the given request body contains a File / Blob value.
81
+ * Otherwise returns the request as is.
82
+ */
83
+ export declare const maybeMultipartFormRequestOptions: <T extends {} = Record<string, unknown>>(
84
+ opts: RequestOptions<T>,
85
+ ) => Promise<RequestOptions<MultipartBody | T>>;
86
+ export declare const multipartFormRequestOptions: <T extends {} = Record<string, unknown>>(
87
+ opts: RequestOptions<T>,
88
+ ) => Promise<RequestOptions<MultipartBody | T>>;
89
+ export declare const createForm: <T = Record<string, unknown>>(body: T | undefined) => Promise<FormData>;
90
+ //# sourceMappingURL=uploads.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"uploads.d.ts","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":";;AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,0CAA0C,CAAC;AACzE,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAQ,KAAK,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAE3F,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,EAAE,KAAK,YAAY,EAAkB,MAAM,0CAA0C,CAAC;AAE7F,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,eAAe,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEjG;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,YAAY,GAAG,YAAY,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACxB,6EAA6E;IAC7E,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;CAE/C;AAED;;GAEG;AACH,MAAM,WAAW,QAAS,SAAQ,QAAQ;IACxC,oFAAoF;IACpF,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC3B;AAED,eAAO,MAAM,cAAc,UAAW,GAAG,0BAIP,CAAC;AAEnC,eAAO,MAAM,UAAU,UAAW,GAAG,sBAKlB,CAAC;AAEpB;;;GAGG;AACH,eAAO,MAAM,UAAU,UAAW,GAAG;mBAAwC,QAAQ,WAAW,CAAC;CAOxD,CAAC;AAE1C,eAAO,MAAM,YAAY,UAAW,GAAG,wBAEtC,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;AAE3F;;;;;;;;GAQG;AACH,wBAAsB,MAAM,CAC1B,KAAK,EAAE,WAAW,EAClB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAChC,OAAO,GAAE,eAAe,GAAG,SAAc,GACxC,OAAO,CAAC,QAAQ,CAAC,CAoBnB;AAsDD,qBAAa,aAAa;IACL,IAAI,EAAE,QAAQ,GAAG,QAAQ;gBAAzB,IAAI,EAAE,QAAQ,GAAG,QAAQ;IAC5C,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAEjC;CACF;AAED,eAAO,MAAM,eAAe,SAAU,GAAG,0BACsD,CAAC;AAEhG;;;GAGG;AACH,eAAO,MAAM,gCAAgC,iHAO5C,CAAC;AAEF,eAAO,MAAM,2BAA2B,iHAKvC,CAAC;AAEF,eAAO,MAAM,UAAU,wDAA6D,QAAQ,QAAQ,CAInG,CAAC"}