spitch 0.1.0-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 +14 -9
  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 -118
  69. package/index.d.mts.map +1 -0
  70. package/index.d.ts +6 -117
  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 +3 -2
  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 -29
  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 -178
  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 +18 -7
  330. package/src/resources/speech.ts +76 -33
  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
@@ -0,0 +1,3 @@
1
+ # `core`
2
+
3
+ This directory holds public modules implementing non-resource-specific SDK functionality.
@@ -0,0 +1,92 @@
1
+ // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
2
+
3
+ import { type Spitch } from '../client';
4
+
5
+ import { type PromiseOrValue } from '../internal/types';
6
+ import { APIResponseProps, defaultParseResponse } from '../internal/parse';
7
+
8
+ /**
9
+ * A subclass of `Promise` providing additional helper methods
10
+ * for interacting with the SDK.
11
+ */
12
+ export class APIPromise<T> extends Promise<T> {
13
+ private parsedPromise: Promise<T> | undefined;
14
+ #client: Spitch;
15
+
16
+ constructor(
17
+ client: Spitch,
18
+ private responsePromise: Promise<APIResponseProps>,
19
+ private parseResponse: (
20
+ client: Spitch,
21
+ props: APIResponseProps,
22
+ ) => PromiseOrValue<T> = defaultParseResponse,
23
+ ) {
24
+ super((resolve) => {
25
+ // this is maybe a bit weird but this has to be a no-op to not implicitly
26
+ // parse the response body; instead .then, .catch, .finally are overridden
27
+ // to parse the response
28
+ resolve(null as any);
29
+ });
30
+ this.#client = client;
31
+ }
32
+
33
+ _thenUnwrap<U>(transform: (data: T, props: APIResponseProps) => U): APIPromise<U> {
34
+ return new APIPromise(this.#client, this.responsePromise, async (client, props) =>
35
+ transform(await this.parseResponse(client, props), props),
36
+ );
37
+ }
38
+
39
+ /**
40
+ * Gets the raw `Response` instance instead of parsing the response
41
+ * data.
42
+ *
43
+ * If you want to parse the response body but still get the `Response`
44
+ * instance, you can use {@link withResponse()}.
45
+ *
46
+ * 👋 Getting the wrong TypeScript type for `Response`?
47
+ * Try setting `"moduleResolution": "NodeNext"` or add `"lib": ["DOM"]`
48
+ * to your `tsconfig.json`.
49
+ */
50
+ asResponse(): Promise<Response> {
51
+ return this.responsePromise.then((p) => p.response);
52
+ }
53
+
54
+ /**
55
+ * Gets the parsed response data and the raw `Response` instance.
56
+ *
57
+ * If you just want to get the raw `Response` instance without parsing it,
58
+ * you can use {@link asResponse()}.
59
+ *
60
+ * 👋 Getting the wrong TypeScript type for `Response`?
61
+ * Try setting `"moduleResolution": "NodeNext"` or add `"lib": ["DOM"]`
62
+ * to your `tsconfig.json`.
63
+ */
64
+ async withResponse(): Promise<{ data: T; response: Response }> {
65
+ const [data, response] = await Promise.all([this.parse(), this.asResponse()]);
66
+ return { data, response };
67
+ }
68
+
69
+ private parse(): Promise<T> {
70
+ if (!this.parsedPromise) {
71
+ this.parsedPromise = this.responsePromise.then((data) => this.parseResponse(this.#client, data));
72
+ }
73
+ return this.parsedPromise;
74
+ }
75
+
76
+ override then<TResult1 = T, TResult2 = never>(
77
+ onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | undefined | null,
78
+ onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | undefined | null,
79
+ ): Promise<TResult1 | TResult2> {
80
+ return this.parse().then(onfulfilled, onrejected);
81
+ }
82
+
83
+ override catch<TResult = never>(
84
+ onrejected?: ((reason: any) => TResult | PromiseLike<TResult>) | undefined | null,
85
+ ): Promise<T | TResult> {
86
+ return this.parse().catch(onrejected);
87
+ }
88
+
89
+ override finally(onfinally?: (() => void) | undefined | null): Promise<T> {
90
+ return this.parse().finally(onfinally);
91
+ }
92
+ }
@@ -0,0 +1,130 @@
1
+ // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
2
+
3
+ import { castToError } from '../internal/errors';
4
+
5
+ export class SpitchError extends Error {}
6
+
7
+ export class APIError<
8
+ TStatus extends number | undefined = number | undefined,
9
+ THeaders extends Headers | undefined = Headers | undefined,
10
+ TError extends Object | undefined = Object | undefined,
11
+ > extends SpitchError {
12
+ /** HTTP status for the response that caused the error */
13
+ readonly status: TStatus;
14
+ /** HTTP headers for the response that caused the error */
15
+ readonly headers: THeaders;
16
+ /** JSON body of the response that caused the error */
17
+ readonly error: TError;
18
+
19
+ constructor(status: TStatus, error: TError, message: string | undefined, headers: THeaders) {
20
+ super(`${APIError.makeMessage(status, error, message)}`);
21
+ this.status = status;
22
+ this.headers = headers;
23
+ this.error = error;
24
+ }
25
+
26
+ private static makeMessage(status: number | undefined, error: any, message: string | undefined) {
27
+ const msg =
28
+ error?.message ?
29
+ typeof error.message === 'string' ?
30
+ error.message
31
+ : JSON.stringify(error.message)
32
+ : error ? JSON.stringify(error)
33
+ : message;
34
+
35
+ if (status && msg) {
36
+ return `${status} ${msg}`;
37
+ }
38
+ if (status) {
39
+ return `${status} status code (no body)`;
40
+ }
41
+ if (msg) {
42
+ return msg;
43
+ }
44
+ return '(no status code or body)';
45
+ }
46
+
47
+ static generate(
48
+ status: number | undefined,
49
+ errorResponse: Object | undefined,
50
+ message: string | undefined,
51
+ headers: Headers | undefined,
52
+ ): APIError {
53
+ if (!status || !headers) {
54
+ return new APIConnectionError({ message, cause: castToError(errorResponse) });
55
+ }
56
+
57
+ const error = errorResponse as Record<string, any>;
58
+
59
+ if (status === 400) {
60
+ return new BadRequestError(status, error, message, headers);
61
+ }
62
+
63
+ if (status === 401) {
64
+ return new AuthenticationError(status, error, message, headers);
65
+ }
66
+
67
+ if (status === 403) {
68
+ return new PermissionDeniedError(status, error, message, headers);
69
+ }
70
+
71
+ if (status === 404) {
72
+ return new NotFoundError(status, error, message, headers);
73
+ }
74
+
75
+ if (status === 409) {
76
+ return new ConflictError(status, error, message, headers);
77
+ }
78
+
79
+ if (status === 422) {
80
+ return new UnprocessableEntityError(status, error, message, headers);
81
+ }
82
+
83
+ if (status === 429) {
84
+ return new RateLimitError(status, error, message, headers);
85
+ }
86
+
87
+ if (status >= 500) {
88
+ return new InternalServerError(status, error, message, headers);
89
+ }
90
+
91
+ return new APIError(status, error, message, headers);
92
+ }
93
+ }
94
+
95
+ export class APIUserAbortError extends APIError<undefined, undefined, undefined> {
96
+ constructor({ message }: { message?: string } = {}) {
97
+ super(undefined, undefined, message || 'Request was aborted.', undefined);
98
+ }
99
+ }
100
+
101
+ export class APIConnectionError extends APIError<undefined, undefined, undefined> {
102
+ constructor({ message, cause }: { message?: string | undefined; cause?: Error | undefined }) {
103
+ super(undefined, undefined, message || 'Connection error.', undefined);
104
+ // in some environments the 'cause' property is already declared
105
+ // @ts-ignore
106
+ if (cause) this.cause = cause;
107
+ }
108
+ }
109
+
110
+ export class APIConnectionTimeoutError extends APIConnectionError {
111
+ constructor({ message }: { message?: string } = {}) {
112
+ super({ message: message ?? 'Request timed out.' });
113
+ }
114
+ }
115
+
116
+ export class BadRequestError extends APIError<400, Headers> {}
117
+
118
+ export class AuthenticationError extends APIError<401, Headers> {}
119
+
120
+ export class PermissionDeniedError extends APIError<403, Headers> {}
121
+
122
+ export class NotFoundError extends APIError<404, Headers> {}
123
+
124
+ export class ConflictError extends APIError<409, Headers> {}
125
+
126
+ export class UnprocessableEntityError extends APIError<422, Headers> {}
127
+
128
+ export class RateLimitError extends APIError<429, Headers> {}
129
+
130
+ export class InternalServerError extends APIError<number, Headers> {}
@@ -0,0 +1,157 @@
1
+ // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
2
+
3
+ import { SpitchError } from './error';
4
+ import { FinalRequestOptions } from '../internal/request-options';
5
+ import { defaultParseResponse } from '../internal/parse';
6
+ import { type Spitch } from '../client';
7
+ import { APIPromise } from './api-promise';
8
+ import { type APIResponseProps } from '../internal/parse';
9
+ import { maybeObj } from '../internal/utils/values';
10
+
11
+ export type PageRequestOptions = Pick<FinalRequestOptions, 'query' | 'headers' | 'body' | 'path' | 'method'>;
12
+
13
+ export abstract class AbstractPage<Item> implements AsyncIterable<Item> {
14
+ #client: Spitch;
15
+ protected options: FinalRequestOptions;
16
+
17
+ protected response: Response;
18
+ protected body: unknown;
19
+
20
+ constructor(client: Spitch, response: Response, body: unknown, options: FinalRequestOptions) {
21
+ this.#client = client;
22
+ this.options = options;
23
+ this.response = response;
24
+ this.body = body;
25
+ }
26
+
27
+ abstract nextPageRequestOptions(): PageRequestOptions | null;
28
+
29
+ abstract getPaginatedItems(): Item[];
30
+
31
+ hasNextPage(): boolean {
32
+ const items = this.getPaginatedItems();
33
+ if (!items.length) return false;
34
+ return this.nextPageRequestOptions() != null;
35
+ }
36
+
37
+ async getNextPage(): Promise<this> {
38
+ const nextOptions = this.nextPageRequestOptions();
39
+ if (!nextOptions) {
40
+ throw new SpitchError(
41
+ 'No next page expected; please check `.hasNextPage()` before calling `.getNextPage()`.',
42
+ );
43
+ }
44
+
45
+ return await this.#client.requestAPIList(this.constructor as any, nextOptions);
46
+ }
47
+
48
+ async *iterPages(): AsyncGenerator<this> {
49
+ let page: this = this;
50
+ yield page;
51
+ while (page.hasNextPage()) {
52
+ page = await page.getNextPage();
53
+ yield page;
54
+ }
55
+ }
56
+
57
+ async *[Symbol.asyncIterator](): AsyncGenerator<Item> {
58
+ for await (const page of this.iterPages()) {
59
+ for (const item of page.getPaginatedItems()) {
60
+ yield item;
61
+ }
62
+ }
63
+ }
64
+ }
65
+
66
+ /**
67
+ * This subclass of Promise will resolve to an instantiated Page once the request completes.
68
+ *
69
+ * It also implements AsyncIterable to allow auto-paginating iteration on an unawaited list call, eg:
70
+ *
71
+ * for await (const item of client.items.list()) {
72
+ * console.log(item)
73
+ * }
74
+ */
75
+ export class PagePromise<
76
+ PageClass extends AbstractPage<Item>,
77
+ Item = ReturnType<PageClass['getPaginatedItems']>[number],
78
+ >
79
+ extends APIPromise<PageClass>
80
+ implements AsyncIterable<Item>
81
+ {
82
+ constructor(
83
+ client: Spitch,
84
+ request: Promise<APIResponseProps>,
85
+ Page: new (...args: ConstructorParameters<typeof AbstractPage>) => PageClass,
86
+ ) {
87
+ super(
88
+ client,
89
+ request,
90
+ async (client, props) =>
91
+ new Page(client, props.response, await defaultParseResponse(client, props), props.options),
92
+ );
93
+ }
94
+
95
+ /**
96
+ * Allow auto-paginating iteration on an unawaited list call, eg:
97
+ *
98
+ * for await (const item of client.items.list()) {
99
+ * console.log(item)
100
+ * }
101
+ */
102
+ async *[Symbol.asyncIterator](): AsyncGenerator<Item> {
103
+ const page = await this;
104
+ for await (const item of page) {
105
+ yield item;
106
+ }
107
+ }
108
+ }
109
+
110
+ export interface FilesCursorResponse<Item> {
111
+ items: Array<Item>;
112
+
113
+ next_cursor: string | null;
114
+ }
115
+
116
+ export interface FilesCursorParams {
117
+ cursor?: string;
118
+
119
+ limit?: number;
120
+ }
121
+
122
+ export class FilesCursor<Item> extends AbstractPage<Item> implements FilesCursorResponse<Item> {
123
+ items: Array<Item>;
124
+
125
+ next_cursor: string | null;
126
+
127
+ constructor(
128
+ client: Spitch,
129
+ response: Response,
130
+ body: FilesCursorResponse<Item>,
131
+ options: FinalRequestOptions,
132
+ ) {
133
+ super(client, response, body, options);
134
+
135
+ this.items = body.items || [];
136
+ this.next_cursor = body.next_cursor || null;
137
+ }
138
+
139
+ getPaginatedItems(): Item[] {
140
+ return this.items ?? [];
141
+ }
142
+
143
+ nextPageRequestOptions(): PageRequestOptions | null {
144
+ const cursor = this.next_cursor;
145
+ if (!cursor) {
146
+ return null;
147
+ }
148
+
149
+ return {
150
+ ...this.options,
151
+ query: {
152
+ ...maybeObj(this.options.query),
153
+ cursor,
154
+ },
155
+ };
156
+ }
157
+ }
@@ -0,0 +1,11 @@
1
+ // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
2
+
3
+ import type { Spitch } from '../client';
4
+
5
+ export abstract class APIResource {
6
+ protected _client: Spitch;
7
+
8
+ constructor(client: Spitch) {
9
+ this._client = client;
10
+ }
11
+ }
@@ -0,0 +1,2 @@
1
+ export { type Uploadable } from '../internal/uploads';
2
+ export { toFile, type ToFileInput } from '../internal/to-file';
package/src/error.ts CHANGED
@@ -1,146 +1,2 @@
1
- // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
2
-
3
- import { castToError, Headers } from './core';
4
-
5
- export class SpitchError extends Error {}
6
-
7
- export class APIError extends SpitchError {
8
- readonly status: number | undefined;
9
- readonly headers: Headers | undefined;
10
- readonly error: Object | undefined;
11
-
12
- constructor(
13
- status: number | undefined,
14
- error: Object | undefined,
15
- message: string | undefined,
16
- headers: Headers | undefined,
17
- ) {
18
- super(`${APIError.makeMessage(status, error, message)}`);
19
- this.status = status;
20
- this.headers = headers;
21
- this.error = error;
22
- }
23
-
24
- private static makeMessage(status: number | undefined, error: any, message: string | undefined) {
25
- const msg =
26
- error?.message ?
27
- typeof error.message === 'string' ?
28
- error.message
29
- : JSON.stringify(error.message)
30
- : error ? JSON.stringify(error)
31
- : message;
32
-
33
- if (status && msg) {
34
- return `${status} ${msg}`;
35
- }
36
- if (status) {
37
- return `${status} status code (no body)`;
38
- }
39
- if (msg) {
40
- return msg;
41
- }
42
- return '(no status code or body)';
43
- }
44
-
45
- static generate(
46
- status: number | undefined,
47
- errorResponse: Object | undefined,
48
- message: string | undefined,
49
- headers: Headers | undefined,
50
- ) {
51
- if (!status) {
52
- return new APIConnectionError({ message, cause: castToError(errorResponse) });
53
- }
54
-
55
- const error = errorResponse as Record<string, any>;
56
-
57
- if (status === 400) {
58
- return new BadRequestError(status, error, message, headers);
59
- }
60
-
61
- if (status === 401) {
62
- return new AuthenticationError(status, error, message, headers);
63
- }
64
-
65
- if (status === 403) {
66
- return new PermissionDeniedError(status, error, message, headers);
67
- }
68
-
69
- if (status === 404) {
70
- return new NotFoundError(status, error, message, headers);
71
- }
72
-
73
- if (status === 409) {
74
- return new ConflictError(status, error, message, headers);
75
- }
76
-
77
- if (status === 422) {
78
- return new UnprocessableEntityError(status, error, message, headers);
79
- }
80
-
81
- if (status === 429) {
82
- return new RateLimitError(status, error, message, headers);
83
- }
84
-
85
- if (status >= 500) {
86
- return new InternalServerError(status, error, message, headers);
87
- }
88
-
89
- return new APIError(status, error, message, headers);
90
- }
91
- }
92
-
93
- export class APIUserAbortError extends APIError {
94
- override readonly status: undefined = undefined;
95
-
96
- constructor({ message }: { message?: string } = {}) {
97
- super(undefined, undefined, message || 'Request was aborted.', undefined);
98
- }
99
- }
100
-
101
- export class APIConnectionError extends APIError {
102
- override readonly status: undefined = undefined;
103
-
104
- constructor({ message, cause }: { message?: string | undefined; cause?: Error | undefined }) {
105
- super(undefined, undefined, message || 'Connection error.', undefined);
106
- // in some environments the 'cause' property is already declared
107
- // @ts-ignore
108
- if (cause) this.cause = cause;
109
- }
110
- }
111
-
112
- export class APIConnectionTimeoutError extends APIConnectionError {
113
- constructor({ message }: { message?: string } = {}) {
114
- super({ message: message ?? 'Request timed out.' });
115
- }
116
- }
117
-
118
- export class BadRequestError extends APIError {
119
- override readonly status: 400 = 400;
120
- }
121
-
122
- export class AuthenticationError extends APIError {
123
- override readonly status: 401 = 401;
124
- }
125
-
126
- export class PermissionDeniedError extends APIError {
127
- override readonly status: 403 = 403;
128
- }
129
-
130
- export class NotFoundError extends APIError {
131
- override readonly status: 404 = 404;
132
- }
133
-
134
- export class ConflictError extends APIError {
135
- override readonly status: 409 = 409;
136
- }
137
-
138
- export class UnprocessableEntityError extends APIError {
139
- override readonly status: 422 = 422;
140
- }
141
-
142
- export class RateLimitError extends APIError {
143
- override readonly status: 429 = 429;
144
- }
145
-
146
- export class InternalServerError extends APIError {}
1
+ /** @deprecated Import from ./core/error instead */
2
+ export * from './core/error';