spitch 0.0.1-alpha.1 → 0.1.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 (467) hide show
  1. package/CHANGELOG.md +18 -5
  2. package/LICENSE +1 -1
  3. package/README.md +201 -65
  4. package/api-promise.d.mts +2 -0
  5. package/api-promise.d.mts.map +1 -0
  6. package/api-promise.d.ts +2 -0
  7. package/api-promise.d.ts.map +1 -0
  8. package/api-promise.js +6 -0
  9. package/api-promise.js.map +1 -0
  10. package/api-promise.mjs +2 -0
  11. package/api-promise.mjs.map +1 -0
  12. package/client.d.mts +192 -0
  13. package/client.d.mts.map +1 -0
  14. package/client.d.ts +192 -0
  15. package/client.d.ts.map +1 -0
  16. package/client.js +473 -0
  17. package/client.js.map +1 -0
  18. package/client.mjs +469 -0
  19. package/client.mjs.map +1 -0
  20. package/core/api-promise.d.mts +46 -0
  21. package/core/api-promise.d.mts.map +1 -0
  22. package/core/api-promise.d.ts +46 -0
  23. package/core/api-promise.d.ts.map +1 -0
  24. package/core/api-promise.js +74 -0
  25. package/core/api-promise.js.map +1 -0
  26. package/core/api-promise.mjs +70 -0
  27. package/core/api-promise.mjs.map +1 -0
  28. package/core/error.d.mts +46 -0
  29. package/core/error.d.mts.map +1 -0
  30. package/core/error.d.ts +46 -0
  31. package/core/error.d.ts.map +1 -0
  32. package/core/error.js +113 -0
  33. package/core/error.js.map +1 -0
  34. package/core/error.mjs +97 -0
  35. package/core/error.mjs.map +1 -0
  36. package/core/pagination.d.mts +54 -0
  37. package/core/pagination.d.mts.map +1 -0
  38. package/core/pagination.d.ts +54 -0
  39. package/core/pagination.d.ts.map +1 -0
  40. package/core/pagination.js +101 -0
  41. package/core/pagination.js.map +1 -0
  42. package/core/pagination.mjs +95 -0
  43. package/core/pagination.mjs.map +1 -0
  44. package/core/resource.d.mts +6 -0
  45. package/core/resource.d.mts.map +1 -0
  46. package/core/resource.d.ts +6 -0
  47. package/core/resource.d.ts.map +1 -0
  48. package/core/resource.js +11 -0
  49. package/core/resource.js.map +1 -0
  50. package/core/resource.mjs +7 -0
  51. package/core/resource.mjs.map +1 -0
  52. package/core/uploads.d.mts +3 -0
  53. package/core/uploads.d.mts.map +1 -0
  54. package/core/uploads.d.ts +3 -0
  55. package/core/uploads.d.ts.map +1 -0
  56. package/core/uploads.js +6 -0
  57. package/core/uploads.js.map +1 -0
  58. package/core/uploads.mjs +2 -0
  59. package/core/uploads.mjs.map +1 -0
  60. package/error.d.mts +2 -0
  61. package/error.d.mts.map +1 -0
  62. package/error.d.ts +1 -52
  63. package/error.d.ts.map +1 -1
  64. package/error.js +3 -140
  65. package/error.js.map +1 -1
  66. package/error.mjs +1 -126
  67. package/error.mjs.map +1 -1
  68. package/index.d.mts +7 -117
  69. package/index.d.mts.map +1 -0
  70. package/index.d.ts +6 -116
  71. package/index.d.ts.map +1 -1
  72. package/index.js +28 -107
  73. package/index.js.map +1 -1
  74. package/index.mjs +6 -81
  75. package/index.mjs.map +1 -1
  76. package/internal/builtin-types.d.mts +73 -0
  77. package/internal/builtin-types.d.mts.map +1 -0
  78. package/internal/builtin-types.d.ts +73 -0
  79. package/internal/builtin-types.d.ts.map +1 -0
  80. package/internal/builtin-types.js +4 -0
  81. package/internal/builtin-types.js.map +1 -0
  82. package/internal/builtin-types.mjs +3 -0
  83. package/internal/builtin-types.mjs.map +1 -0
  84. package/internal/detect-platform.d.mts +15 -0
  85. package/internal/detect-platform.d.mts.map +1 -0
  86. package/internal/detect-platform.d.ts +15 -0
  87. package/internal/detect-platform.d.ts.map +1 -0
  88. package/internal/detect-platform.js +162 -0
  89. package/internal/detect-platform.js.map +1 -0
  90. package/internal/detect-platform.mjs +157 -0
  91. package/internal/detect-platform.mjs.map +1 -0
  92. package/internal/errors.d.mts +3 -0
  93. package/internal/errors.d.mts.map +1 -0
  94. package/internal/errors.d.ts +3 -0
  95. package/internal/errors.d.ts.map +1 -0
  96. package/internal/errors.js +41 -0
  97. package/internal/errors.js.map +1 -0
  98. package/internal/errors.mjs +36 -0
  99. package/internal/errors.mjs.map +1 -0
  100. package/internal/headers.d.mts +20 -0
  101. package/internal/headers.d.mts.map +1 -0
  102. package/internal/headers.d.ts +20 -0
  103. package/internal/headers.d.ts.map +1 -0
  104. package/internal/headers.js +79 -0
  105. package/internal/headers.js.map +1 -0
  106. package/internal/headers.mjs +74 -0
  107. package/internal/headers.mjs.map +1 -0
  108. package/internal/parse.d.mts +12 -0
  109. package/internal/parse.d.mts.map +1 -0
  110. package/internal/parse.d.ts +12 -0
  111. package/internal/parse.d.ts.map +1 -0
  112. package/internal/parse.js +35 -0
  113. package/internal/parse.js.map +1 -0
  114. package/internal/parse.mjs +32 -0
  115. package/internal/parse.mjs.map +1 -0
  116. package/internal/request-options.d.mts +75 -0
  117. package/internal/request-options.d.mts.map +1 -0
  118. package/internal/request-options.d.ts +75 -0
  119. package/internal/request-options.d.ts.map +1 -0
  120. package/internal/request-options.js +14 -0
  121. package/internal/request-options.js.map +1 -0
  122. package/internal/request-options.mjs +10 -0
  123. package/internal/request-options.mjs.map +1 -0
  124. package/internal/shim-types.d.mts +17 -0
  125. package/internal/shim-types.d.mts.map +1 -0
  126. package/internal/shim-types.d.ts +17 -0
  127. package/internal/shim-types.d.ts.map +1 -0
  128. package/internal/shim-types.js +4 -0
  129. package/internal/shim-types.js.map +1 -0
  130. package/internal/shim-types.mjs +3 -0
  131. package/internal/shim-types.mjs.map +1 -0
  132. package/internal/shims.d.mts +20 -0
  133. package/internal/shims.d.mts.map +1 -0
  134. package/internal/shims.d.ts +20 -0
  135. package/internal/shims.d.ts.map +1 -0
  136. package/internal/shims.js +92 -0
  137. package/internal/shims.js.map +1 -0
  138. package/internal/shims.mjs +85 -0
  139. package/internal/shims.mjs.map +1 -0
  140. package/internal/to-file.d.mts +45 -0
  141. package/internal/to-file.d.mts.map +1 -0
  142. package/internal/to-file.d.ts +45 -0
  143. package/internal/to-file.d.ts.map +1 -0
  144. package/internal/to-file.js +91 -0
  145. package/internal/to-file.js.map +1 -0
  146. package/internal/to-file.mjs +88 -0
  147. package/internal/to-file.mjs.map +1 -0
  148. package/internal/tslib.js +81 -0
  149. package/internal/tslib.mjs +17 -0
  150. package/internal/types.d.mts +69 -0
  151. package/internal/types.d.mts.map +1 -0
  152. package/internal/types.d.ts +69 -0
  153. package/internal/types.d.ts.map +1 -0
  154. package/internal/types.js +4 -0
  155. package/internal/types.js.map +1 -0
  156. package/internal/types.mjs +3 -0
  157. package/internal/types.mjs.map +1 -0
  158. package/internal/uploads.d.mts +42 -0
  159. package/internal/uploads.d.mts.map +1 -0
  160. package/internal/uploads.d.ts +42 -0
  161. package/internal/uploads.d.ts.map +1 -0
  162. package/internal/uploads.js +141 -0
  163. package/internal/uploads.js.map +1 -0
  164. package/internal/uploads.mjs +131 -0
  165. package/internal/uploads.mjs.map +1 -0
  166. package/internal/utils/base64.d.mts +3 -0
  167. package/internal/utils/base64.d.mts.map +1 -0
  168. package/internal/utils/base64.d.ts +3 -0
  169. package/internal/utils/base64.d.ts.map +1 -0
  170. package/internal/utils/base64.js +38 -0
  171. package/internal/utils/base64.js.map +1 -0
  172. package/internal/utils/base64.mjs +33 -0
  173. package/internal/utils/base64.mjs.map +1 -0
  174. package/internal/utils/bytes.d.mts +4 -0
  175. package/internal/utils/bytes.d.mts.map +1 -0
  176. package/internal/utils/bytes.d.ts +4 -0
  177. package/internal/utils/bytes.d.ts.map +1 -0
  178. package/internal/utils/bytes.js +31 -0
  179. package/internal/utils/bytes.js.map +1 -0
  180. package/internal/utils/bytes.mjs +26 -0
  181. package/internal/utils/bytes.mjs.map +1 -0
  182. package/internal/utils/env.d.mts +9 -0
  183. package/internal/utils/env.d.mts.map +1 -0
  184. package/internal/utils/env.d.ts +9 -0
  185. package/internal/utils/env.d.ts.map +1 -0
  186. package/internal/utils/env.js +22 -0
  187. package/internal/utils/env.js.map +1 -0
  188. package/internal/utils/env.mjs +18 -0
  189. package/internal/utils/env.mjs.map +1 -0
  190. package/internal/utils/log.d.mts +37 -0
  191. package/internal/utils/log.d.mts.map +1 -0
  192. package/internal/utils/log.d.ts +37 -0
  193. package/internal/utils/log.d.ts.map +1 -0
  194. package/internal/utils/log.js +85 -0
  195. package/internal/utils/log.js.map +1 -0
  196. package/internal/utils/log.mjs +79 -0
  197. package/internal/utils/log.mjs.map +1 -0
  198. package/internal/utils/path.d.mts +15 -0
  199. package/internal/utils/path.d.mts.map +1 -0
  200. package/internal/utils/path.d.ts +15 -0
  201. package/internal/utils/path.d.ts.map +1 -0
  202. package/internal/utils/path.js +79 -0
  203. package/internal/utils/path.js.map +1 -0
  204. package/internal/utils/path.mjs +74 -0
  205. package/internal/utils/path.mjs.map +1 -0
  206. package/internal/utils/sleep.d.mts +2 -0
  207. package/internal/utils/sleep.d.mts.map +1 -0
  208. package/internal/utils/sleep.d.ts +2 -0
  209. package/internal/utils/sleep.d.ts.map +1 -0
  210. package/internal/utils/sleep.js +7 -0
  211. package/internal/utils/sleep.js.map +1 -0
  212. package/internal/utils/sleep.mjs +3 -0
  213. package/internal/utils/sleep.mjs.map +1 -0
  214. package/internal/utils/uuid.d.mts +5 -0
  215. package/internal/utils/uuid.d.mts.map +1 -0
  216. package/internal/utils/uuid.d.ts +5 -0
  217. package/internal/utils/uuid.d.ts.map +1 -0
  218. package/internal/utils/uuid.js +19 -0
  219. package/internal/utils/uuid.js.map +1 -0
  220. package/internal/utils/uuid.mjs +15 -0
  221. package/internal/utils/uuid.mjs.map +1 -0
  222. package/internal/utils/values.d.mts +18 -0
  223. package/internal/utils/values.d.mts.map +1 -0
  224. package/internal/utils/values.d.ts +18 -0
  225. package/internal/utils/values.d.ts.map +1 -0
  226. package/internal/utils/values.js +112 -0
  227. package/internal/utils/values.js.map +1 -0
  228. package/internal/utils/values.mjs +94 -0
  229. package/internal/utils/values.mjs.map +1 -0
  230. package/internal/utils.d.mts +7 -0
  231. package/internal/utils.d.mts.map +1 -0
  232. package/internal/utils.d.ts +7 -0
  233. package/internal/utils.d.ts.map +1 -0
  234. package/internal/utils.js +11 -0
  235. package/internal/utils.js.map +1 -0
  236. package/internal/utils.mjs +8 -0
  237. package/internal/utils.mjs.map +1 -0
  238. package/package.json +117 -72
  239. package/pagination.d.mts +2 -0
  240. package/pagination.d.mts.map +1 -0
  241. package/pagination.d.ts +2 -0
  242. package/pagination.d.ts.map +1 -0
  243. package/pagination.js +6 -0
  244. package/pagination.js.map +1 -0
  245. package/pagination.mjs +2 -0
  246. package/pagination.mjs.map +1 -0
  247. package/resource.d.mts +2 -0
  248. package/resource.d.mts.map +1 -0
  249. package/resource.d.ts +1 -5
  250. package/resource.d.ts.map +1 -1
  251. package/resource.js +3 -8
  252. package/resource.js.map +1 -1
  253. package/resource.mjs +1 -6
  254. package/resource.mjs.map +1 -1
  255. package/resources/files.d.mts +74 -0
  256. package/resources/files.d.mts.map +1 -0
  257. package/resources/files.d.ts +74 -0
  258. package/resources/files.d.ts.map +1 -0
  259. package/resources/files.js +48 -0
  260. package/resources/files.js.map +1 -0
  261. package/resources/files.mjs +44 -0
  262. package/resources/files.mjs.map +1 -0
  263. package/resources/index.d.mts +4 -0
  264. package/resources/index.d.mts.map +1 -0
  265. package/resources/index.d.ts +3 -2
  266. package/resources/index.d.ts.map +1 -1
  267. package/resources/index.js +3 -1
  268. package/resources/index.js.map +1 -1
  269. package/resources/index.mjs +2 -1
  270. package/resources/index.mjs.map +1 -1
  271. package/resources/speech.d.mts +45 -0
  272. package/resources/speech.d.mts.map +1 -0
  273. package/resources/speech.d.ts +29 -28
  274. package/resources/speech.d.ts.map +1 -1
  275. package/resources/speech.js +12 -32
  276. package/resources/speech.js.map +1 -1
  277. package/resources/speech.mjs +12 -9
  278. package/resources/speech.mjs.map +1 -1
  279. package/resources/text.d.mts +34 -0
  280. package/resources/text.d.mts.map +1 -0
  281. package/resources/text.d.ts +23 -8
  282. package/resources/text.d.ts.map +1 -1
  283. package/resources/text.js +7 -3
  284. package/resources/text.js.map +1 -1
  285. package/resources/text.mjs +7 -3
  286. package/resources/text.mjs.map +1 -1
  287. package/resources.d.mts +2 -0
  288. package/resources.d.mts.map +1 -0
  289. package/resources.d.ts +2 -0
  290. package/resources.d.ts.map +1 -0
  291. package/resources.js +5 -0
  292. package/resources.js.map +1 -0
  293. package/resources.mjs +2 -0
  294. package/resources.mjs.map +1 -0
  295. package/src/api-promise.ts +2 -0
  296. package/src/client.ts +790 -0
  297. package/src/core/README.md +3 -0
  298. package/src/core/api-promise.ts +92 -0
  299. package/src/core/error.ts +130 -0
  300. package/src/core/pagination.ts +157 -0
  301. package/src/core/resource.ts +11 -0
  302. package/src/core/uploads.ts +2 -0
  303. package/src/error.ts +2 -146
  304. package/src/index.ts +7 -177
  305. package/src/internal/README.md +3 -0
  306. package/src/internal/builtin-types.ts +93 -0
  307. package/src/internal/detect-platform.ts +196 -0
  308. package/src/internal/errors.ts +33 -0
  309. package/src/internal/headers.ts +97 -0
  310. package/src/internal/parse.ts +50 -0
  311. package/src/internal/request-options.ts +91 -0
  312. package/src/internal/shim-types.ts +26 -0
  313. package/src/internal/shims.ts +107 -0
  314. package/src/internal/to-file.ts +154 -0
  315. package/src/internal/types.ts +95 -0
  316. package/src/internal/uploads.ts +187 -0
  317. package/src/internal/utils/base64.ts +40 -0
  318. package/src/internal/utils/bytes.ts +32 -0
  319. package/src/internal/utils/env.ts +18 -0
  320. package/src/internal/utils/log.ts +126 -0
  321. package/src/internal/utils/path.ts +88 -0
  322. package/src/internal/utils/sleep.ts +3 -0
  323. package/src/internal/utils/uuid.ts +17 -0
  324. package/src/internal/utils/values.ts +105 -0
  325. package/src/internal/utils.ts +8 -0
  326. package/src/pagination.ts +2 -0
  327. package/src/resource.ts +2 -11
  328. package/src/resources/files.ts +136 -0
  329. package/src/resources/index.ts +19 -2
  330. package/src/resources/speech.ts +77 -32
  331. package/src/resources/text.ts +38 -9
  332. package/src/resources.ts +1 -0
  333. package/src/tsconfig.json +2 -2
  334. package/src/uploads.ts +2 -255
  335. package/src/version.ts +1 -1
  336. package/uploads.d.mts +2 -0
  337. package/uploads.d.mts.map +1 -0
  338. package/uploads.d.ts +1 -74
  339. package/uploads.d.ts.map +1 -1
  340. package/uploads.js +3 -168
  341. package/uploads.js.map +1 -1
  342. package/uploads.mjs +1 -157
  343. package/uploads.mjs.map +1 -1
  344. package/version.d.mts +2 -0
  345. package/version.d.mts.map +1 -0
  346. package/version.d.ts +1 -1
  347. package/version.d.ts.map +1 -1
  348. package/version.js +1 -1
  349. package/version.js.map +1 -1
  350. package/version.mjs +1 -1
  351. package/version.mjs.map +1 -1
  352. package/_shims/MultipartBody.d.ts +0 -9
  353. package/_shims/MultipartBody.d.ts.map +0 -1
  354. package/_shims/MultipartBody.js +0 -16
  355. package/_shims/MultipartBody.js.map +0 -1
  356. package/_shims/MultipartBody.mjs +0 -12
  357. package/_shims/MultipartBody.mjs.map +0 -1
  358. package/_shims/README.md +0 -46
  359. package/_shims/auto/runtime-bun.d.ts +0 -5
  360. package/_shims/auto/runtime-bun.d.ts.map +0 -1
  361. package/_shims/auto/runtime-bun.js +0 -21
  362. package/_shims/auto/runtime-bun.js.map +0 -1
  363. package/_shims/auto/runtime-bun.mjs +0 -2
  364. package/_shims/auto/runtime-bun.mjs.map +0 -1
  365. package/_shims/auto/runtime-node.d.ts +0 -5
  366. package/_shims/auto/runtime-node.d.ts.map +0 -1
  367. package/_shims/auto/runtime-node.js +0 -21
  368. package/_shims/auto/runtime-node.js.map +0 -1
  369. package/_shims/auto/runtime-node.mjs +0 -2
  370. package/_shims/auto/runtime-node.mjs.map +0 -1
  371. package/_shims/auto/runtime.d.ts +0 -5
  372. package/_shims/auto/runtime.d.ts.map +0 -1
  373. package/_shims/auto/runtime.js +0 -21
  374. package/_shims/auto/runtime.js.map +0 -1
  375. package/_shims/auto/runtime.mjs +0 -2
  376. package/_shims/auto/runtime.mjs.map +0 -1
  377. package/_shims/auto/types-node.d.ts +0 -5
  378. package/_shims/auto/types-node.d.ts.map +0 -1
  379. package/_shims/auto/types-node.js +0 -21
  380. package/_shims/auto/types-node.js.map +0 -1
  381. package/_shims/auto/types-node.mjs +0 -2
  382. package/_shims/auto/types-node.mjs.map +0 -1
  383. package/_shims/auto/types.d.ts +0 -101
  384. package/_shims/auto/types.js +0 -3
  385. package/_shims/auto/types.mjs +0 -3
  386. package/_shims/bun-runtime.d.ts +0 -6
  387. package/_shims/bun-runtime.d.ts.map +0 -1
  388. package/_shims/bun-runtime.js +0 -14
  389. package/_shims/bun-runtime.js.map +0 -1
  390. package/_shims/bun-runtime.mjs +0 -10
  391. package/_shims/bun-runtime.mjs.map +0 -1
  392. package/_shims/index.d.ts +0 -81
  393. package/_shims/index.js +0 -13
  394. package/_shims/index.mjs +0 -7
  395. package/_shims/manual-types.d.ts +0 -12
  396. package/_shims/manual-types.js +0 -3
  397. package/_shims/manual-types.mjs +0 -3
  398. package/_shims/node-runtime.d.ts +0 -3
  399. package/_shims/node-runtime.d.ts.map +0 -1
  400. package/_shims/node-runtime.js +0 -89
  401. package/_shims/node-runtime.js.map +0 -1
  402. package/_shims/node-runtime.mjs +0 -56
  403. package/_shims/node-runtime.mjs.map +0 -1
  404. package/_shims/node-types.d.ts +0 -42
  405. package/_shims/node-types.js +0 -3
  406. package/_shims/node-types.mjs +0 -3
  407. package/_shims/registry.d.ts +0 -37
  408. package/_shims/registry.d.ts.map +0 -1
  409. package/_shims/registry.js +0 -41
  410. package/_shims/registry.js.map +0 -1
  411. package/_shims/registry.mjs +0 -37
  412. package/_shims/registry.mjs.map +0 -1
  413. package/_shims/web-runtime.d.ts +0 -5
  414. package/_shims/web-runtime.d.ts.map +0 -1
  415. package/_shims/web-runtime.js +0 -78
  416. package/_shims/web-runtime.js.map +0 -1
  417. package/_shims/web-runtime.mjs +0 -71
  418. package/_shims/web-runtime.mjs.map +0 -1
  419. package/_shims/web-types.d.ts +0 -83
  420. package/_shims/web-types.js +0 -3
  421. package/_shims/web-types.mjs +0 -3
  422. package/core.d.ts +0 -242
  423. package/core.d.ts.map +0 -1
  424. package/core.js +0 -901
  425. package/core.js.map +0 -1
  426. package/core.mjs +0 -869
  427. package/core.mjs.map +0 -1
  428. package/shims/node.d.ts +0 -30
  429. package/shims/node.d.ts.map +0 -1
  430. package/shims/node.js +0 -31
  431. package/shims/node.js.map +0 -1
  432. package/shims/node.mjs +0 -5
  433. package/shims/node.mjs.map +0 -1
  434. package/shims/web.d.ts +0 -26
  435. package/shims/web.d.ts.map +0 -1
  436. package/shims/web.js +0 -31
  437. package/shims/web.js.map +0 -1
  438. package/shims/web.mjs +0 -5
  439. package/shims/web.mjs.map +0 -1
  440. package/src/_shims/MultipartBody.ts +0 -9
  441. package/src/_shims/README.md +0 -46
  442. package/src/_shims/auto/runtime-bun.ts +0 -4
  443. package/src/_shims/auto/runtime-node.ts +0 -4
  444. package/src/_shims/auto/runtime.ts +0 -4
  445. package/src/_shims/auto/types-node.ts +0 -4
  446. package/src/_shims/auto/types.d.ts +0 -101
  447. package/src/_shims/auto/types.js +0 -3
  448. package/src/_shims/auto/types.mjs +0 -3
  449. package/src/_shims/bun-runtime.ts +0 -14
  450. package/src/_shims/index.d.ts +0 -81
  451. package/src/_shims/index.js +0 -13
  452. package/src/_shims/index.mjs +0 -7
  453. package/src/_shims/manual-types.d.ts +0 -12
  454. package/src/_shims/manual-types.js +0 -3
  455. package/src/_shims/manual-types.mjs +0 -3
  456. package/src/_shims/node-runtime.ts +0 -81
  457. package/src/_shims/node-types.d.ts +0 -42
  458. package/src/_shims/node-types.js +0 -3
  459. package/src/_shims/node-types.mjs +0 -3
  460. package/src/_shims/registry.ts +0 -65
  461. package/src/_shims/web-runtime.ts +0 -103
  462. package/src/_shims/web-types.d.ts +0 -83
  463. package/src/_shims/web-types.js +0 -3
  464. package/src/_shims/web-types.mjs +0 -3
  465. package/src/core.ts +0 -1190
  466. package/src/shims/node.ts +0 -50
  467. package/src/shims/web.ts +0 -50
package/client.d.mts ADDED
@@ -0,0 +1,192 @@
1
+ import type { RequestInit, RequestInfo } from "./internal/builtin-types.mjs";
2
+ import type { PromiseOrValue, MergedRequestInit, FinalizedRequestInit } from "./internal/types.mjs";
3
+ export type { Logger, LogLevel } from "./internal/utils/log.mjs";
4
+ import * as Opts from "./internal/request-options.mjs";
5
+ import * as Errors from "./core/error.mjs";
6
+ import * as Pagination from "./core/pagination.mjs";
7
+ import { type FilesCursorParams, FilesCursorResponse } from "./core/pagination.mjs";
8
+ import * as Uploads from "./core/uploads.mjs";
9
+ import * as API from "./resources/index.mjs";
10
+ import { APIPromise } from "./core/api-promise.mjs";
11
+ import { File, FileDeleteResponse, FileDownloadParams, FileDownloadResponse, FileListParams, FileUploadParams, FileUsage, Files, FilesFilesCursor } from "./resources/files.mjs";
12
+ import { Speech, SpeechGenerateParams, SpeechTranscribeParams, Transcription } from "./resources/speech.mjs";
13
+ import { Diacritics, Text, TextToneMarkParams, TextTranslateParams, Translation } from "./resources/text.mjs";
14
+ import { type Fetch } from "./internal/builtin-types.mjs";
15
+ import { HeadersLike, NullableHeaders } from "./internal/headers.mjs";
16
+ import { FinalRequestOptions, RequestOptions } from "./internal/request-options.mjs";
17
+ import { type LogLevel, type Logger } from "./internal/utils/log.mjs";
18
+ export interface ClientOptions {
19
+ /**
20
+ * Defaults to process.env['SPITCH_API_KEY'].
21
+ */
22
+ apiKey?: string | undefined;
23
+ /**
24
+ * Override the default base URL for the API, e.g., "https://api.example.com/v2/"
25
+ *
26
+ * Defaults to process.env['SPITCH_BASE_URL'].
27
+ */
28
+ baseURL?: string | null | undefined;
29
+ /**
30
+ * The maximum amount of time (in milliseconds) that the client should wait for a response
31
+ * from the server before timing out a single request.
32
+ *
33
+ * Note that request timeouts are retried by default, so in a worst-case scenario you may wait
34
+ * much longer than this timeout before the promise succeeds or fails.
35
+ *
36
+ * @unit milliseconds
37
+ */
38
+ timeout?: number | undefined;
39
+ /**
40
+ * Additional `RequestInit` options to be passed to `fetch` calls.
41
+ * Properties will be overridden by per-request `fetchOptions`.
42
+ */
43
+ fetchOptions?: MergedRequestInit | undefined;
44
+ /**
45
+ * Specify a custom `fetch` function implementation.
46
+ *
47
+ * If not provided, we expect that `fetch` is defined globally.
48
+ */
49
+ fetch?: Fetch | undefined;
50
+ /**
51
+ * The maximum number of times that the client will retry a request in case of a
52
+ * temporary failure, like a network error or a 5XX error from the server.
53
+ *
54
+ * @default 2
55
+ */
56
+ maxRetries?: number | undefined;
57
+ /**
58
+ * Default headers to include with every request to the API.
59
+ *
60
+ * These can be removed in individual requests by explicitly setting the
61
+ * header to `null` in request options.
62
+ */
63
+ defaultHeaders?: HeadersLike | undefined;
64
+ /**
65
+ * Default query parameters to include with every request to the API.
66
+ *
67
+ * These can be removed in individual requests by explicitly setting the
68
+ * param to `undefined` in request options.
69
+ */
70
+ defaultQuery?: Record<string, string | undefined> | undefined;
71
+ /**
72
+ * Set the log level.
73
+ *
74
+ * Defaults to process.env['SPITCH_LOG'] or 'warn' if it isn't set.
75
+ */
76
+ logLevel?: LogLevel | undefined;
77
+ /**
78
+ * Set the logger.
79
+ *
80
+ * Defaults to globalThis.console.
81
+ */
82
+ logger?: Logger | undefined;
83
+ }
84
+ /**
85
+ * API Client for interfacing with the Spitch API.
86
+ */
87
+ export declare class Spitch {
88
+ #private;
89
+ apiKey: string;
90
+ baseURL: string;
91
+ maxRetries: number;
92
+ timeout: number;
93
+ logger: Logger | undefined;
94
+ logLevel: LogLevel | undefined;
95
+ fetchOptions: MergedRequestInit | undefined;
96
+ private fetch;
97
+ protected idempotencyHeader?: string;
98
+ private _options;
99
+ /**
100
+ * API Client for interfacing with the Spitch API.
101
+ *
102
+ * @param {string | undefined} [opts.apiKey=process.env['SPITCH_API_KEY'] ?? undefined]
103
+ * @param {string} [opts.baseURL=process.env['SPITCH_BASE_URL'] ?? https://api.spi-tch.com] - Override the default base URL for the API.
104
+ * @param {number} [opts.timeout=1 minute] - The maximum amount of time (in milliseconds) the client will wait for a response before timing out.
105
+ * @param {MergedRequestInit} [opts.fetchOptions] - Additional `RequestInit` options to be passed to `fetch` calls.
106
+ * @param {Fetch} [opts.fetch] - Specify a custom `fetch` function implementation.
107
+ * @param {number} [opts.maxRetries=2] - The maximum number of times the client will retry a request.
108
+ * @param {HeadersLike} opts.defaultHeaders - Default headers to include with every request to the API.
109
+ * @param {Record<string, string | undefined>} opts.defaultQuery - Default query parameters to include with every request to the API.
110
+ */
111
+ constructor({ baseURL, apiKey, ...opts }?: ClientOptions);
112
+ /**
113
+ * Create a new client instance re-using the same options given to the current client with optional overriding.
114
+ */
115
+ withOptions(options: Partial<ClientOptions>): this;
116
+ protected defaultQuery(): Record<string, string | undefined> | undefined;
117
+ protected validateHeaders({ values, nulls }: NullableHeaders): void;
118
+ protected authHeaders(opts: FinalRequestOptions): Promise<NullableHeaders | undefined>;
119
+ /**
120
+ * Basic re-implementation of `qs.stringify` for primitive types.
121
+ */
122
+ protected stringifyQuery(query: Record<string, unknown>): string;
123
+ private getUserAgent;
124
+ protected defaultIdempotencyKey(): string;
125
+ protected makeStatusError(status: number, error: Object, message: string | undefined, headers: Headers): Errors.APIError;
126
+ buildURL(path: string, query: Record<string, unknown> | null | undefined, defaultBaseURL?: string | undefined): string;
127
+ /**
128
+ * Used as a callback for mutating the given `FinalRequestOptions` object.
129
+ */
130
+ protected prepareOptions(options: FinalRequestOptions): Promise<void>;
131
+ /**
132
+ * Used as a callback for mutating the given `RequestInit` object.
133
+ *
134
+ * This is useful for cases where you want to add certain headers based off of
135
+ * the request properties, e.g. `method` or `url`.
136
+ */
137
+ protected prepareRequest(request: RequestInit, { url, options }: {
138
+ url: string;
139
+ options: FinalRequestOptions;
140
+ }): Promise<void>;
141
+ get<Rsp>(path: string, opts?: PromiseOrValue<RequestOptions>): APIPromise<Rsp>;
142
+ post<Rsp>(path: string, opts?: PromiseOrValue<RequestOptions>): APIPromise<Rsp>;
143
+ patch<Rsp>(path: string, opts?: PromiseOrValue<RequestOptions>): APIPromise<Rsp>;
144
+ put<Rsp>(path: string, opts?: PromiseOrValue<RequestOptions>): APIPromise<Rsp>;
145
+ delete<Rsp>(path: string, opts?: PromiseOrValue<RequestOptions>): APIPromise<Rsp>;
146
+ private methodRequest;
147
+ request<Rsp>(options: PromiseOrValue<FinalRequestOptions>, remainingRetries?: number | null): APIPromise<Rsp>;
148
+ private makeRequest;
149
+ getAPIList<Item, PageClass extends Pagination.AbstractPage<Item> = Pagination.AbstractPage<Item>>(path: string, Page: new (...args: any[]) => PageClass, opts?: RequestOptions): Pagination.PagePromise<PageClass, Item>;
150
+ requestAPIList<Item = unknown, PageClass extends Pagination.AbstractPage<Item> = Pagination.AbstractPage<Item>>(Page: new (...args: ConstructorParameters<typeof Pagination.AbstractPage>) => PageClass, options: FinalRequestOptions): Pagination.PagePromise<PageClass, Item>;
151
+ fetchWithTimeout(url: RequestInfo, init: RequestInit | undefined, ms: number, controller: AbortController): Promise<Response>;
152
+ private shouldRetry;
153
+ private retryRequest;
154
+ private calculateDefaultRetryTimeoutMillis;
155
+ buildRequest(inputOptions: FinalRequestOptions, { retryCount }?: {
156
+ retryCount?: number;
157
+ }): Promise<{
158
+ req: FinalizedRequestInit;
159
+ url: string;
160
+ timeout: number;
161
+ }>;
162
+ private buildHeaders;
163
+ private buildBody;
164
+ static Spitch: typeof Spitch;
165
+ static DEFAULT_TIMEOUT: number;
166
+ static SpitchError: typeof Errors.SpitchError;
167
+ static APIError: typeof Errors.APIError;
168
+ static APIConnectionError: typeof Errors.APIConnectionError;
169
+ static APIConnectionTimeoutError: typeof Errors.APIConnectionTimeoutError;
170
+ static APIUserAbortError: typeof Errors.APIUserAbortError;
171
+ static NotFoundError: typeof Errors.NotFoundError;
172
+ static ConflictError: typeof Errors.ConflictError;
173
+ static RateLimitError: typeof Errors.RateLimitError;
174
+ static BadRequestError: typeof Errors.BadRequestError;
175
+ static AuthenticationError: typeof Errors.AuthenticationError;
176
+ static InternalServerError: typeof Errors.InternalServerError;
177
+ static PermissionDeniedError: typeof Errors.PermissionDeniedError;
178
+ static UnprocessableEntityError: typeof Errors.UnprocessableEntityError;
179
+ static toFile: typeof Uploads.toFile;
180
+ speech: API.Speech;
181
+ text: API.Text;
182
+ files: API.Files;
183
+ }
184
+ export declare namespace Spitch {
185
+ export type RequestOptions = Opts.RequestOptions;
186
+ export import FilesCursor = Pagination.FilesCursor;
187
+ export { type FilesCursorParams as FilesCursorParams, type FilesCursorResponse as FilesCursorResponse };
188
+ export { Speech as Speech, type Transcription as Transcription, type SpeechGenerateParams as SpeechGenerateParams, type SpeechTranscribeParams as SpeechTranscribeParams, };
189
+ export { Text as Text, type Diacritics as Diacritics, type Translation as Translation, type TextToneMarkParams as TextToneMarkParams, type TextTranslateParams as TextTranslateParams, };
190
+ export { type Files as Files, type File as File, type FileUsage as FileUsage, type FileDeleteResponse as FileDeleteResponse, type FileDownloadResponse as FileDownloadResponse, type FilesFilesCursor as FilesFilesCursor, type FileListParams as FileListParams, type FileDownloadParams as FileDownloadParams, type FileUploadParams as FileUploadParams, };
191
+ }
192
+ //# sourceMappingURL=client.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.d.mts","sourceRoot":"","sources":["src/client.ts"],"names":[],"mappings":"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"}
package/client.d.ts ADDED
@@ -0,0 +1,192 @@
1
+ import type { RequestInit, RequestInfo } from "./internal/builtin-types.js";
2
+ import type { PromiseOrValue, MergedRequestInit, FinalizedRequestInit } from "./internal/types.js";
3
+ export type { Logger, LogLevel } from "./internal/utils/log.js";
4
+ import * as Opts from "./internal/request-options.js";
5
+ import * as Errors from "./core/error.js";
6
+ import * as Pagination from "./core/pagination.js";
7
+ import { type FilesCursorParams, FilesCursorResponse } from "./core/pagination.js";
8
+ import * as Uploads from "./core/uploads.js";
9
+ import * as API from "./resources/index.js";
10
+ import { APIPromise } from "./core/api-promise.js";
11
+ import { File, FileDeleteResponse, FileDownloadParams, FileDownloadResponse, FileListParams, FileUploadParams, FileUsage, Files, FilesFilesCursor } from "./resources/files.js";
12
+ import { Speech, SpeechGenerateParams, SpeechTranscribeParams, Transcription } from "./resources/speech.js";
13
+ import { Diacritics, Text, TextToneMarkParams, TextTranslateParams, Translation } from "./resources/text.js";
14
+ import { type Fetch } from "./internal/builtin-types.js";
15
+ import { HeadersLike, NullableHeaders } from "./internal/headers.js";
16
+ import { FinalRequestOptions, RequestOptions } from "./internal/request-options.js";
17
+ import { type LogLevel, type Logger } from "./internal/utils/log.js";
18
+ export interface ClientOptions {
19
+ /**
20
+ * Defaults to process.env['SPITCH_API_KEY'].
21
+ */
22
+ apiKey?: string | undefined;
23
+ /**
24
+ * Override the default base URL for the API, e.g., "https://api.example.com/v2/"
25
+ *
26
+ * Defaults to process.env['SPITCH_BASE_URL'].
27
+ */
28
+ baseURL?: string | null | undefined;
29
+ /**
30
+ * The maximum amount of time (in milliseconds) that the client should wait for a response
31
+ * from the server before timing out a single request.
32
+ *
33
+ * Note that request timeouts are retried by default, so in a worst-case scenario you may wait
34
+ * much longer than this timeout before the promise succeeds or fails.
35
+ *
36
+ * @unit milliseconds
37
+ */
38
+ timeout?: number | undefined;
39
+ /**
40
+ * Additional `RequestInit` options to be passed to `fetch` calls.
41
+ * Properties will be overridden by per-request `fetchOptions`.
42
+ */
43
+ fetchOptions?: MergedRequestInit | undefined;
44
+ /**
45
+ * Specify a custom `fetch` function implementation.
46
+ *
47
+ * If not provided, we expect that `fetch` is defined globally.
48
+ */
49
+ fetch?: Fetch | undefined;
50
+ /**
51
+ * The maximum number of times that the client will retry a request in case of a
52
+ * temporary failure, like a network error or a 5XX error from the server.
53
+ *
54
+ * @default 2
55
+ */
56
+ maxRetries?: number | undefined;
57
+ /**
58
+ * Default headers to include with every request to the API.
59
+ *
60
+ * These can be removed in individual requests by explicitly setting the
61
+ * header to `null` in request options.
62
+ */
63
+ defaultHeaders?: HeadersLike | undefined;
64
+ /**
65
+ * Default query parameters to include with every request to the API.
66
+ *
67
+ * These can be removed in individual requests by explicitly setting the
68
+ * param to `undefined` in request options.
69
+ */
70
+ defaultQuery?: Record<string, string | undefined> | undefined;
71
+ /**
72
+ * Set the log level.
73
+ *
74
+ * Defaults to process.env['SPITCH_LOG'] or 'warn' if it isn't set.
75
+ */
76
+ logLevel?: LogLevel | undefined;
77
+ /**
78
+ * Set the logger.
79
+ *
80
+ * Defaults to globalThis.console.
81
+ */
82
+ logger?: Logger | undefined;
83
+ }
84
+ /**
85
+ * API Client for interfacing with the Spitch API.
86
+ */
87
+ export declare class Spitch {
88
+ #private;
89
+ apiKey: string;
90
+ baseURL: string;
91
+ maxRetries: number;
92
+ timeout: number;
93
+ logger: Logger | undefined;
94
+ logLevel: LogLevel | undefined;
95
+ fetchOptions: MergedRequestInit | undefined;
96
+ private fetch;
97
+ protected idempotencyHeader?: string;
98
+ private _options;
99
+ /**
100
+ * API Client for interfacing with the Spitch API.
101
+ *
102
+ * @param {string | undefined} [opts.apiKey=process.env['SPITCH_API_KEY'] ?? undefined]
103
+ * @param {string} [opts.baseURL=process.env['SPITCH_BASE_URL'] ?? https://api.spi-tch.com] - Override the default base URL for the API.
104
+ * @param {number} [opts.timeout=1 minute] - The maximum amount of time (in milliseconds) the client will wait for a response before timing out.
105
+ * @param {MergedRequestInit} [opts.fetchOptions] - Additional `RequestInit` options to be passed to `fetch` calls.
106
+ * @param {Fetch} [opts.fetch] - Specify a custom `fetch` function implementation.
107
+ * @param {number} [opts.maxRetries=2] - The maximum number of times the client will retry a request.
108
+ * @param {HeadersLike} opts.defaultHeaders - Default headers to include with every request to the API.
109
+ * @param {Record<string, string | undefined>} opts.defaultQuery - Default query parameters to include with every request to the API.
110
+ */
111
+ constructor({ baseURL, apiKey, ...opts }?: ClientOptions);
112
+ /**
113
+ * Create a new client instance re-using the same options given to the current client with optional overriding.
114
+ */
115
+ withOptions(options: Partial<ClientOptions>): this;
116
+ protected defaultQuery(): Record<string, string | undefined> | undefined;
117
+ protected validateHeaders({ values, nulls }: NullableHeaders): void;
118
+ protected authHeaders(opts: FinalRequestOptions): Promise<NullableHeaders | undefined>;
119
+ /**
120
+ * Basic re-implementation of `qs.stringify` for primitive types.
121
+ */
122
+ protected stringifyQuery(query: Record<string, unknown>): string;
123
+ private getUserAgent;
124
+ protected defaultIdempotencyKey(): string;
125
+ protected makeStatusError(status: number, error: Object, message: string | undefined, headers: Headers): Errors.APIError;
126
+ buildURL(path: string, query: Record<string, unknown> | null | undefined, defaultBaseURL?: string | undefined): string;
127
+ /**
128
+ * Used as a callback for mutating the given `FinalRequestOptions` object.
129
+ */
130
+ protected prepareOptions(options: FinalRequestOptions): Promise<void>;
131
+ /**
132
+ * Used as a callback for mutating the given `RequestInit` object.
133
+ *
134
+ * This is useful for cases where you want to add certain headers based off of
135
+ * the request properties, e.g. `method` or `url`.
136
+ */
137
+ protected prepareRequest(request: RequestInit, { url, options }: {
138
+ url: string;
139
+ options: FinalRequestOptions;
140
+ }): Promise<void>;
141
+ get<Rsp>(path: string, opts?: PromiseOrValue<RequestOptions>): APIPromise<Rsp>;
142
+ post<Rsp>(path: string, opts?: PromiseOrValue<RequestOptions>): APIPromise<Rsp>;
143
+ patch<Rsp>(path: string, opts?: PromiseOrValue<RequestOptions>): APIPromise<Rsp>;
144
+ put<Rsp>(path: string, opts?: PromiseOrValue<RequestOptions>): APIPromise<Rsp>;
145
+ delete<Rsp>(path: string, opts?: PromiseOrValue<RequestOptions>): APIPromise<Rsp>;
146
+ private methodRequest;
147
+ request<Rsp>(options: PromiseOrValue<FinalRequestOptions>, remainingRetries?: number | null): APIPromise<Rsp>;
148
+ private makeRequest;
149
+ getAPIList<Item, PageClass extends Pagination.AbstractPage<Item> = Pagination.AbstractPage<Item>>(path: string, Page: new (...args: any[]) => PageClass, opts?: RequestOptions): Pagination.PagePromise<PageClass, Item>;
150
+ requestAPIList<Item = unknown, PageClass extends Pagination.AbstractPage<Item> = Pagination.AbstractPage<Item>>(Page: new (...args: ConstructorParameters<typeof Pagination.AbstractPage>) => PageClass, options: FinalRequestOptions): Pagination.PagePromise<PageClass, Item>;
151
+ fetchWithTimeout(url: RequestInfo, init: RequestInit | undefined, ms: number, controller: AbortController): Promise<Response>;
152
+ private shouldRetry;
153
+ private retryRequest;
154
+ private calculateDefaultRetryTimeoutMillis;
155
+ buildRequest(inputOptions: FinalRequestOptions, { retryCount }?: {
156
+ retryCount?: number;
157
+ }): Promise<{
158
+ req: FinalizedRequestInit;
159
+ url: string;
160
+ timeout: number;
161
+ }>;
162
+ private buildHeaders;
163
+ private buildBody;
164
+ static Spitch: typeof Spitch;
165
+ static DEFAULT_TIMEOUT: number;
166
+ static SpitchError: typeof Errors.SpitchError;
167
+ static APIError: typeof Errors.APIError;
168
+ static APIConnectionError: typeof Errors.APIConnectionError;
169
+ static APIConnectionTimeoutError: typeof Errors.APIConnectionTimeoutError;
170
+ static APIUserAbortError: typeof Errors.APIUserAbortError;
171
+ static NotFoundError: typeof Errors.NotFoundError;
172
+ static ConflictError: typeof Errors.ConflictError;
173
+ static RateLimitError: typeof Errors.RateLimitError;
174
+ static BadRequestError: typeof Errors.BadRequestError;
175
+ static AuthenticationError: typeof Errors.AuthenticationError;
176
+ static InternalServerError: typeof Errors.InternalServerError;
177
+ static PermissionDeniedError: typeof Errors.PermissionDeniedError;
178
+ static UnprocessableEntityError: typeof Errors.UnprocessableEntityError;
179
+ static toFile: typeof Uploads.toFile;
180
+ speech: API.Speech;
181
+ text: API.Text;
182
+ files: API.Files;
183
+ }
184
+ export declare namespace Spitch {
185
+ export type RequestOptions = Opts.RequestOptions;
186
+ export import FilesCursor = Pagination.FilesCursor;
187
+ export { type FilesCursorParams as FilesCursorParams, type FilesCursorResponse as FilesCursorResponse };
188
+ export { Speech as Speech, type Transcription as Transcription, type SpeechGenerateParams as SpeechGenerateParams, type SpeechTranscribeParams as SpeechTranscribeParams, };
189
+ export { Text as Text, type Diacritics as Diacritics, type Translation as Translation, type TextToneMarkParams as TextToneMarkParams, type TextTranslateParams as TextTranslateParams, };
190
+ export { type Files as Files, type File as File, type FileUsage as FileUsage, type FileDeleteResponse as FileDeleteResponse, type FileDownloadResponse as FileDownloadResponse, type FilesFilesCursor as FilesFilesCursor, type FileListParams as FileListParams, type FileDownloadParams as FileDownloadParams, type FileUploadParams as FileUploadParams, };
191
+ }
192
+ //# sourceMappingURL=client.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["src/client.ts"],"names":[],"mappings":"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"}