@terreno/syncdb 57.21.0 → 58.0.0-beta.2

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 (490) hide show
  1. package/CHANGELOG.md +89 -0
  2. package/README.md +8 -8
  3. package/dist/api/apiError.d.ts +43 -0
  4. package/dist/api/apiError.d.ts.map +1 -0
  5. package/dist/api/apiError.js +28 -0
  6. package/dist/api/apiError.js.map +1 -0
  7. package/dist/api/apiFetch.d.ts +44 -0
  8. package/dist/api/apiFetch.d.ts.map +1 -0
  9. package/dist/api/apiFetch.js +203 -0
  10. package/dist/api/apiFetch.js.map +1 -0
  11. package/dist/api/client.d.ts +70 -0
  12. package/dist/api/client.d.ts.map +1 -0
  13. package/dist/api/client.js +240 -0
  14. package/dist/api/client.js.map +1 -0
  15. package/dist/api/client.test.d.ts +2 -0
  16. package/dist/api/client.test.d.ts.map +1 -0
  17. package/dist/api/client.test.js +588 -0
  18. package/dist/api/client.test.js.map +1 -0
  19. package/dist/app/app.d.ts +13 -0
  20. package/dist/app/app.d.ts.map +1 -0
  21. package/dist/app/app.js +13 -0
  22. package/dist/app/app.js.map +1 -0
  23. package/dist/app/devConsoleLogger.d.ts +18 -0
  24. package/dist/app/devConsoleLogger.d.ts.map +1 -0
  25. package/dist/app/devConsoleLogger.js +147 -0
  26. package/dist/app/devConsoleLogger.js.map +1 -0
  27. package/dist/app/devConsoleLogger.test.d.ts +2 -0
  28. package/dist/app/devConsoleLogger.test.d.ts.map +1 -0
  29. package/dist/app/devConsoleLogger.test.js +202 -0
  30. package/dist/app/devConsoleLogger.test.js.map +1 -0
  31. package/dist/app/mcpTools.d.ts +32 -0
  32. package/dist/app/mcpTools.d.ts.map +1 -0
  33. package/dist/app/mcpTools.js +61 -0
  34. package/dist/app/mcpTools.js.map +1 -0
  35. package/dist/app/permissions.d.ts +26 -0
  36. package/dist/app/permissions.d.ts.map +1 -0
  37. package/dist/app/permissions.js +37 -0
  38. package/dist/app/permissions.js.map +1 -0
  39. package/dist/app/permissions.test.d.ts +2 -0
  40. package/dist/app/permissions.test.d.ts.map +1 -0
  41. package/dist/app/permissions.test.js +36 -0
  42. package/dist/app/permissions.test.js.map +1 -0
  43. package/dist/app/upgradeCheck.d.ts +46 -0
  44. package/dist/app/upgradeCheck.d.ts.map +1 -0
  45. package/dist/app/upgradeCheck.js +121 -0
  46. package/dist/app/upgradeCheck.js.map +1 -0
  47. package/dist/auth/SessionProvider.d.ts +40 -0
  48. package/dist/auth/SessionProvider.d.ts.map +1 -0
  49. package/dist/auth/SessionProvider.js +44 -0
  50. package/dist/auth/SessionProvider.js.map +1 -0
  51. package/dist/auth/SessionProvider.test.d.ts +2 -0
  52. package/dist/auth/SessionProvider.test.d.ts.map +1 -0
  53. package/dist/auth/SessionProvider.test.js +240 -0
  54. package/dist/auth/SessionProvider.test.js.map +1 -0
  55. package/dist/auth/TerrenoAccountSecurityScreen.d.ts +25 -0
  56. package/dist/auth/TerrenoAccountSecurityScreen.d.ts.map +1 -0
  57. package/dist/auth/TerrenoAccountSecurityScreen.js +21 -0
  58. package/dist/auth/TerrenoAccountSecurityScreen.js.map +1 -0
  59. package/dist/auth/TerrenoLoginScreen.d.ts +62 -0
  60. package/dist/auth/TerrenoLoginScreen.d.ts.map +1 -0
  61. package/dist/auth/TerrenoLoginScreen.js +45 -0
  62. package/dist/auth/TerrenoLoginScreen.js.map +1 -0
  63. package/dist/auth/auth.d.ts +36 -0
  64. package/dist/auth/auth.d.ts.map +1 -0
  65. package/dist/auth/auth.js +35 -0
  66. package/dist/auth/auth.js.map +1 -0
  67. package/dist/auth/betterAuthAdapter.d.ts +1 -1
  68. package/dist/auth/betterAuthClient.d.ts +276 -0
  69. package/dist/auth/betterAuthClient.d.ts.map +1 -0
  70. package/dist/auth/betterAuthClient.js +744 -0
  71. package/dist/auth/betterAuthClient.js.map +1 -0
  72. package/dist/auth/betterAuthClient.types.test.d.ts +2 -0
  73. package/dist/auth/betterAuthClient.types.test.d.ts.map +1 -0
  74. package/dist/auth/betterAuthClient.types.test.js +151 -0
  75. package/dist/auth/betterAuthClient.types.test.js.map +1 -0
  76. package/dist/auth/betterAuthClientRegistry.d.ts +51 -0
  77. package/dist/auth/betterAuthClientRegistry.d.ts.map +1 -0
  78. package/dist/auth/betterAuthClientRegistry.js +69 -0
  79. package/dist/auth/betterAuthClientRegistry.js.map +1 -0
  80. package/dist/auth/betterAuthClientRegistry.test.d.ts +2 -0
  81. package/dist/auth/betterAuthClientRegistry.test.d.ts.map +1 -0
  82. package/dist/auth/betterAuthClientRegistry.test.js +91 -0
  83. package/dist/auth/betterAuthClientRegistry.test.js.map +1 -0
  84. package/dist/auth/betterAuthTypes.d.ts +172 -0
  85. package/dist/auth/betterAuthTypes.d.ts.map +1 -0
  86. package/dist/auth/betterAuthTypes.js +7 -0
  87. package/dist/auth/betterAuthTypes.js.map +1 -0
  88. package/dist/auth/jwtAuthAdapter.d.ts +102 -0
  89. package/dist/auth/jwtAuthAdapter.d.ts.map +1 -0
  90. package/dist/auth/jwtAuthAdapter.js +282 -0
  91. package/dist/auth/jwtAuthAdapter.js.map +1 -0
  92. package/dist/auth/jwtAuthAdapter.test.d.ts +2 -0
  93. package/dist/auth/jwtAuthAdapter.test.d.ts.map +1 -0
  94. package/dist/auth/jwtAuthAdapter.test.js +614 -0
  95. package/dist/auth/jwtAuthAdapter.test.js.map +1 -0
  96. package/dist/auth/loginErrors.d.ts +75 -0
  97. package/dist/auth/loginErrors.d.ts.map +1 -0
  98. package/dist/auth/loginErrors.js +154 -0
  99. package/dist/auth/loginErrors.js.map +1 -0
  100. package/dist/auth/loginErrors.test.d.ts +2 -0
  101. package/dist/auth/loginErrors.test.d.ts.map +1 -0
  102. package/dist/auth/loginErrors.test.js +70 -0
  103. package/dist/auth/loginErrors.test.js.map +1 -0
  104. package/dist/auth/ownEntry.d.ts +8 -0
  105. package/dist/auth/ownEntry.d.ts.map +1 -0
  106. package/dist/auth/ownEntry.js +13 -0
  107. package/dist/auth/ownEntry.js.map +1 -0
  108. package/dist/auth/ownEntry.test.d.ts +2 -0
  109. package/dist/auth/ownEntry.test.d.ts.map +1 -0
  110. package/dist/auth/ownEntry.test.js +18 -0
  111. package/dist/auth/ownEntry.test.js.map +1 -0
  112. package/dist/auth/platform.d.ts +3 -0
  113. package/dist/auth/platform.d.ts.map +1 -0
  114. package/dist/auth/platform.js +4 -0
  115. package/dist/auth/platform.js.map +1 -0
  116. package/dist/auth/rememberedAccounts.d.ts +126 -0
  117. package/dist/auth/rememberedAccounts.d.ts.map +1 -0
  118. package/dist/auth/rememberedAccounts.js +399 -0
  119. package/dist/auth/rememberedAccounts.js.map +1 -0
  120. package/dist/auth/rememberedAccounts.test.d.ts +2 -0
  121. package/dist/auth/rememberedAccounts.test.d.ts.map +1 -0
  122. package/dist/auth/rememberedAccounts.test.js +676 -0
  123. package/dist/auth/rememberedAccounts.test.js.map +1 -0
  124. package/dist/auth/session.d.ts +118 -0
  125. package/dist/auth/session.d.ts.map +1 -0
  126. package/dist/auth/session.js +370 -0
  127. package/dist/auth/session.js.map +1 -0
  128. package/dist/auth/session.test.d.ts +2 -0
  129. package/dist/auth/session.test.d.ts.map +1 -0
  130. package/dist/auth/session.test.js +825 -0
  131. package/dist/auth/session.test.js.map +1 -0
  132. package/dist/auth/tokenExpiry.d.ts +70 -0
  133. package/dist/auth/tokenExpiry.d.ts.map +1 -0
  134. package/dist/auth/tokenExpiry.js +123 -0
  135. package/dist/auth/tokenExpiry.js.map +1 -0
  136. package/dist/auth/types.d.ts +1 -1
  137. package/dist/auth/types.js +1 -1
  138. package/dist/auth/useAccountSecurity.d.ts +183 -0
  139. package/dist/auth/useAccountSecurity.d.ts.map +1 -0
  140. package/dist/auth/useAccountSecurity.js +399 -0
  141. package/dist/auth/useAccountSecurity.js.map +1 -0
  142. package/dist/auth/useAccountSecurity.types.test.d.ts +2 -0
  143. package/dist/auth/useAccountSecurity.types.test.d.ts.map +1 -0
  144. package/dist/auth/useAccountSecurity.types.test.js +21 -0
  145. package/dist/auth/useAccountSecurity.types.test.js.map +1 -0
  146. package/dist/auth/useAuthMethods.d.ts +67 -0
  147. package/dist/auth/useAuthMethods.d.ts.map +1 -0
  148. package/dist/auth/useAuthMethods.js +77 -0
  149. package/dist/auth/useAuthMethods.js.map +1 -0
  150. package/dist/auth/useAuthMethods.test.d.ts +2 -0
  151. package/dist/auth/useAuthMethods.test.d.ts.map +1 -0
  152. package/dist/auth/useAuthMethods.test.js +145 -0
  153. package/dist/auth/useAuthMethods.test.js.map +1 -0
  154. package/dist/auth/useJwtAuth.d.ts +31 -0
  155. package/dist/auth/useJwtAuth.d.ts.map +1 -0
  156. package/dist/auth/useJwtAuth.js +58 -0
  157. package/dist/auth/useJwtAuth.js.map +1 -0
  158. package/dist/auth/useJwtAuth.test.d.ts +2 -0
  159. package/dist/auth/useJwtAuth.test.d.ts.map +1 -0
  160. package/dist/auth/useJwtAuth.test.js +165 -0
  161. package/dist/auth/useJwtAuth.test.js.map +1 -0
  162. package/dist/auth/useLoginController.d.ts +248 -0
  163. package/dist/auth/useLoginController.d.ts.map +1 -0
  164. package/dist/auth/useLoginController.js +671 -0
  165. package/dist/auth/useLoginController.js.map +1 -0
  166. package/dist/auth/useLoginController.types.test.d.ts +2 -0
  167. package/dist/auth/useLoginController.types.test.d.ts.map +1 -0
  168. package/dist/auth/useLoginController.types.test.js +19 -0
  169. package/dist/auth/useLoginController.types.test.js.map +1 -0
  170. package/dist/buildNumber.d.ts +34 -0
  171. package/dist/buildNumber.d.ts.map +1 -0
  172. package/dist/buildNumber.js +62 -0
  173. package/dist/buildNumber.js.map +1 -0
  174. package/dist/buildNumber.test.d.ts +2 -0
  175. package/dist/buildNumber.test.d.ts.map +1 -0
  176. package/dist/buildNumber.test.js +114 -0
  177. package/dist/buildNumber.test.js.map +1 -0
  178. package/dist/client.d.ts +18 -1
  179. package/dist/client.d.ts.map +1 -1
  180. package/dist/client.js +245 -185
  181. package/dist/client.js.map +1 -1
  182. package/dist/client.socketEvents.test.d.ts +2 -0
  183. package/dist/client.socketEvents.test.d.ts.map +1 -0
  184. package/dist/client.socketEvents.test.js +64 -0
  185. package/dist/client.socketEvents.test.js.map +1 -0
  186. package/dist/client.test.js +87 -1
  187. package/dist/client.test.js.map +1 -1
  188. package/dist/codegen/cli.js +23 -12
  189. package/dist/codegen/cli.js.map +1 -1
  190. package/dist/codegen/cli.test.js +57 -0
  191. package/dist/codegen/cli.test.js.map +1 -1
  192. package/dist/codegen/discoverCollections.d.ts.map +1 -1
  193. package/dist/codegen/discoverCollections.js +4 -0
  194. package/dist/codegen/discoverCollections.js.map +1 -1
  195. package/dist/codegen/discoverOperations.d.ts +11 -0
  196. package/dist/codegen/discoverOperations.d.ts.map +1 -0
  197. package/dist/codegen/discoverOperations.js +135 -0
  198. package/dist/codegen/discoverOperations.js.map +1 -0
  199. package/dist/codegen/emitApi.d.ts +8 -0
  200. package/dist/codegen/emitApi.d.ts.map +1 -0
  201. package/dist/codegen/emitApi.js +312 -0
  202. package/dist/codegen/emitApi.js.map +1 -0
  203. package/dist/codegen/emitApi.test.d.ts +2 -0
  204. package/dist/codegen/emitApi.test.d.ts.map +1 -0
  205. package/dist/codegen/emitApi.test.js +360 -0
  206. package/dist/codegen/emitApi.test.js.map +1 -0
  207. package/dist/codegen/emitSdk.js +2 -2
  208. package/dist/codegen/generate.d.ts +6 -1
  209. package/dist/codegen/generate.d.ts.map +1 -1
  210. package/dist/codegen/generate.js +18 -0
  211. package/dist/codegen/generate.js.map +1 -1
  212. package/dist/codegen/generate.test.js +53 -1
  213. package/dist/codegen/generate.test.js.map +1 -1
  214. package/dist/codegen/hookNames.d.ts +11 -0
  215. package/dist/codegen/hookNames.d.ts.map +1 -1
  216. package/dist/codegen/hookNames.js +23 -0
  217. package/dist/codegen/hookNames.js.map +1 -1
  218. package/dist/codegen/safeIdentifiers.d.ts +5 -1
  219. package/dist/codegen/safeIdentifiers.d.ts.map +1 -1
  220. package/dist/codegen/safeIdentifiers.js +7 -2
  221. package/dist/codegen/safeIdentifiers.js.map +1 -1
  222. package/dist/codegen/safeIdentifiers.test.js +9 -0
  223. package/dist/codegen/safeIdentifiers.test.js.map +1 -1
  224. package/dist/codegen/types.d.ts +46 -1
  225. package/dist/codegen/types.d.ts.map +1 -1
  226. package/dist/config/baseUrl.d.ts +13 -0
  227. package/dist/config/baseUrl.d.ts.map +1 -0
  228. package/dist/config/baseUrl.js +49 -0
  229. package/dist/config/baseUrl.js.map +1 -0
  230. package/dist/config/baseUrl.test.d.ts +2 -0
  231. package/dist/config/baseUrl.test.d.ts.map +1 -0
  232. package/dist/config/baseUrl.test.js +42 -0
  233. package/dist/config/baseUrl.test.js.map +1 -0
  234. package/dist/config/resolveBaseUrls.d.ts +53 -0
  235. package/dist/config/resolveBaseUrls.d.ts.map +1 -0
  236. package/dist/config/resolveBaseUrls.js +80 -0
  237. package/dist/config/resolveBaseUrls.js.map +1 -0
  238. package/dist/config/resolveBaseUrls.test.d.ts +2 -0
  239. package/dist/config/resolveBaseUrls.test.d.ts.map +1 -0
  240. package/dist/config/resolveBaseUrls.test.js +265 -0
  241. package/dist/config/resolveBaseUrls.test.js.map +1 -0
  242. package/dist/crypto/keyProviders.d.ts +2 -2
  243. package/dist/crypto/keyProviders.d.ts.map +1 -1
  244. package/dist/crypto/keyProviders.js +15 -4
  245. package/dist/crypto/keyProviders.js.map +1 -1
  246. package/dist/crypto/keyProviders.test.js +19 -0
  247. package/dist/crypto/keyProviders.test.js.map +1 -1
  248. package/dist/crypto/types.d.ts +5 -0
  249. package/dist/crypto/types.d.ts.map +1 -1
  250. package/dist/flags/flagTestServer.d.ts +19 -0
  251. package/dist/flags/flagTestServer.d.ts.map +1 -0
  252. package/dist/flags/flagTestServer.js +58 -0
  253. package/dist/flags/flagTestServer.js.map +1 -0
  254. package/dist/flags/useFeatureFlags.d.ts +30 -0
  255. package/dist/flags/useFeatureFlags.d.ts.map +1 -0
  256. package/dist/flags/useFeatureFlags.js +83 -0
  257. package/dist/flags/useFeatureFlags.js.map +1 -0
  258. package/dist/flags/useFeatureFlags.test.d.ts +2 -0
  259. package/dist/flags/useFeatureFlags.test.d.ts.map +1 -0
  260. package/dist/flags/useFeatureFlags.test.js +116 -0
  261. package/dist/flags/useFeatureFlags.test.js.map +1 -0
  262. package/dist/flags/useTerrenoFeatureFlags.d.ts +50 -0
  263. package/dist/flags/useTerrenoFeatureFlags.d.ts.map +1 -0
  264. package/dist/flags/useTerrenoFeatureFlags.js +125 -0
  265. package/dist/flags/useTerrenoFeatureFlags.js.map +1 -0
  266. package/dist/flags/useTerrenoFeatureFlags.test.d.ts +2 -0
  267. package/dist/flags/useTerrenoFeatureFlags.test.d.ts.map +1 -0
  268. package/dist/flags/useTerrenoFeatureFlags.test.js +259 -0
  269. package/dist/flags/useTerrenoFeatureFlags.test.js.map +1 -0
  270. package/dist/index.d.ts +4 -3
  271. package/dist/index.d.ts.map +1 -1
  272. package/dist/index.js +2 -1
  273. package/dist/index.js.map +1 -1
  274. package/dist/isolated/TerrenoAccountSecurityScreen.isolated.d.ts +2 -0
  275. package/dist/isolated/TerrenoAccountSecurityScreen.isolated.d.ts.map +1 -0
  276. package/dist/isolated/TerrenoAccountSecurityScreen.isolated.js +94 -0
  277. package/dist/isolated/TerrenoAccountSecurityScreen.isolated.js.map +1 -0
  278. package/dist/isolated/TerrenoLoginScreen.isolated.d.ts +2 -0
  279. package/dist/isolated/TerrenoLoginScreen.isolated.d.ts.map +1 -0
  280. package/dist/isolated/TerrenoLoginScreen.isolated.js +183 -0
  281. package/dist/isolated/TerrenoLoginScreen.isolated.js.map +1 -0
  282. package/dist/isolated/betterAuthClient.isolated.d.ts +2 -0
  283. package/dist/isolated/betterAuthClient.isolated.d.ts.map +1 -0
  284. package/dist/isolated/betterAuthClient.isolated.js +1734 -0
  285. package/dist/isolated/betterAuthClient.isolated.js.map +1 -0
  286. package/dist/isolated/betterAuthClient.native.isolated.d.ts +2 -0
  287. package/dist/isolated/betterAuthClient.native.isolated.d.ts.map +1 -0
  288. package/dist/isolated/betterAuthClient.native.isolated.js +153 -0
  289. package/dist/isolated/betterAuthClient.native.isolated.js.map +1 -0
  290. package/dist/isolated/mcpTools.isolated.d.ts +2 -0
  291. package/dist/isolated/mcpTools.isolated.d.ts.map +1 -0
  292. package/dist/isolated/mcpTools.isolated.js +197 -0
  293. package/dist/isolated/mcpTools.isolated.js.map +1 -0
  294. package/dist/isolated/rememberedAccounts.native.isolated.d.ts +2 -0
  295. package/dist/isolated/rememberedAccounts.native.isolated.d.ts.map +1 -0
  296. package/dist/isolated/rememberedAccounts.native.isolated.js +50 -0
  297. package/dist/isolated/rememberedAccounts.native.isolated.js.map +1 -0
  298. package/dist/isolated/sessionLogout.isolated.d.ts +2 -0
  299. package/dist/isolated/sessionLogout.isolated.d.ts.map +1 -0
  300. package/dist/isolated/sessionLogout.isolated.js +133 -0
  301. package/dist/isolated/sessionLogout.isolated.js.map +1 -0
  302. package/dist/isolated/tokenExpiry.isolated.d.ts +2 -0
  303. package/dist/isolated/tokenExpiry.isolated.d.ts.map +1 -0
  304. package/dist/isolated/tokenExpiry.isolated.js +232 -0
  305. package/dist/isolated/tokenExpiry.isolated.js.map +1 -0
  306. package/dist/isolated/upgradeCheck.isolated.d.ts +2 -0
  307. package/dist/isolated/upgradeCheck.isolated.d.ts.map +1 -0
  308. package/dist/isolated/upgradeCheck.isolated.js +241 -0
  309. package/dist/isolated/upgradeCheck.isolated.js.map +1 -0
  310. package/dist/isolated/useAccountSecurity.isolated.d.ts +2 -0
  311. package/dist/isolated/useAccountSecurity.isolated.d.ts.map +1 -0
  312. package/dist/isolated/useAccountSecurity.isolated.js +851 -0
  313. package/dist/isolated/useAccountSecurity.isolated.js.map +1 -0
  314. package/dist/isolated/useAccountSecurity.native.isolated.d.ts +2 -0
  315. package/dist/isolated/useAccountSecurity.native.isolated.d.ts.map +1 -0
  316. package/dist/isolated/useAccountSecurity.native.isolated.js +52 -0
  317. package/dist/isolated/useAccountSecurity.native.isolated.js.map +1 -0
  318. package/dist/isolated/useLoginController.isolated.d.ts +2 -0
  319. package/dist/isolated/useLoginController.isolated.d.ts.map +1 -0
  320. package/dist/isolated/useLoginController.isolated.js +1116 -0
  321. package/dist/isolated/useLoginController.isolated.js.map +1 -0
  322. package/dist/mutations/entityIds.d.ts +23 -0
  323. package/dist/mutations/entityIds.d.ts.map +1 -0
  324. package/dist/mutations/entityIds.js +31 -0
  325. package/dist/mutations/entityIds.js.map +1 -0
  326. package/dist/mutations/entityIds.test.d.ts +2 -0
  327. package/dist/mutations/entityIds.test.d.ts.map +1 -0
  328. package/dist/mutations/entityIds.test.js +48 -0
  329. package/dist/mutations/entityIds.test.js.map +1 -0
  330. package/dist/persisters/defaultPersisterFactory.native.d.ts.map +1 -1
  331. package/dist/persisters/defaultPersisterFactory.native.js +2 -0
  332. package/dist/persisters/defaultPersisterFactory.native.js.map +1 -1
  333. package/dist/persisters/encryptedIndexedDbPersister.d.ts.map +1 -1
  334. package/dist/persisters/encryptedIndexedDbPersister.js +3 -0
  335. package/dist/persisters/encryptedIndexedDbPersister.js.map +1 -1
  336. package/dist/persisters/types.d.ts +6 -0
  337. package/dist/persisters/types.d.ts.map +1 -1
  338. package/dist/query/queryWindows.js +2 -2
  339. package/dist/query/queryWindows.js.map +1 -1
  340. package/dist/react/apiHooks.d.ts +87 -0
  341. package/dist/react/apiHooks.d.ts.map +1 -0
  342. package/dist/react/apiHooks.js +195 -0
  343. package/dist/react/apiHooks.js.map +1 -0
  344. package/dist/react/apiHooks.test.d.ts +2 -0
  345. package/dist/react/apiHooks.test.d.ts.map +1 -0
  346. package/dist/react/apiHooks.test.js +366 -0
  347. package/dist/react/apiHooks.test.js.map +1 -0
  348. package/dist/react/index.d.ts +2 -0
  349. package/dist/react/index.d.ts.map +1 -1
  350. package/dist/react/index.js +2 -0
  351. package/dist/react/index.js.map +1 -1
  352. package/dist/react/provider.d.ts +2 -0
  353. package/dist/react/provider.d.ts.map +1 -1
  354. package/dist/react/provider.js +2 -0
  355. package/dist/react/provider.js.map +1 -1
  356. package/dist/react/useSocketEvent.d.ts +27 -0
  357. package/dist/react/useSocketEvent.d.ts.map +1 -0
  358. package/dist/react/useSocketEvent.js +36 -0
  359. package/dist/react/useSocketEvent.js.map +1 -0
  360. package/dist/react/useSocketEvent.test.d.ts +2 -0
  361. package/dist/react/useSocketEvent.test.d.ts.map +1 -0
  362. package/dist/react/useSocketEvent.test.js +76 -0
  363. package/dist/react/useSocketEvent.test.js.map +1 -0
  364. package/dist/sync/replayCoordinator.d.ts.map +1 -1
  365. package/dist/sync/replayCoordinator.js +5 -4
  366. package/dist/sync/replayCoordinator.js.map +1 -1
  367. package/dist/sync/socketTransport.d.ts.map +1 -1
  368. package/dist/sync/socketTransport.js +14 -1
  369. package/dist/sync/socketTransport.js.map +1 -1
  370. package/dist/sync/socketTransport.test.js +42 -0
  371. package/dist/sync/socketTransport.test.js.map +1 -1
  372. package/dist/sync/transport.d.ts +9 -0
  373. package/dist/sync/transport.d.ts.map +1 -1
  374. package/dist/sync/transport.js +13 -0
  375. package/dist/sync/transport.js.map +1 -1
  376. package/dist/testing/fakeTransport.d.ts +5 -1
  377. package/dist/testing/fakeTransport.d.ts.map +1 -1
  378. package/dist/testing/fakeTransport.js +26 -0
  379. package/dist/testing/fakeTransport.js.map +1 -1
  380. package/dist/testing/fakeTransport.test.js +15 -0
  381. package/dist/testing/fakeTransport.test.js.map +1 -1
  382. package/dist/types.d.ts +8 -0
  383. package/dist/types.d.ts.map +1 -1
  384. package/package.json +93 -8
  385. package/src/api/apiError.ts +47 -0
  386. package/src/api/apiFetch.ts +245 -0
  387. package/src/api/client.test.ts +711 -0
  388. package/src/api/client.ts +367 -0
  389. package/src/app/app.ts +30 -0
  390. package/src/app/devConsoleLogger.test.ts +246 -0
  391. package/src/app/devConsoleLogger.ts +173 -0
  392. package/src/app/mcpTools.ts +101 -0
  393. package/src/app/permissions.test.ts +44 -0
  394. package/src/app/permissions.ts +58 -0
  395. package/src/app/upgradeCheck.ts +177 -0
  396. package/src/auth/SessionProvider.test.tsx +286 -0
  397. package/src/auth/SessionProvider.tsx +87 -0
  398. package/src/auth/TerrenoAccountSecurityScreen.tsx +56 -0
  399. package/src/auth/TerrenoLoginScreen.tsx +131 -0
  400. package/src/auth/auth.ts +117 -0
  401. package/src/auth/betterAuthAdapter.ts +1 -1
  402. package/src/auth/betterAuthClient.ts +997 -0
  403. package/src/auth/betterAuthClient.types.test.ts +197 -0
  404. package/src/auth/betterAuthClientRegistry.test.ts +114 -0
  405. package/src/auth/betterAuthClientRegistry.ts +99 -0
  406. package/src/auth/betterAuthTypes.ts +189 -0
  407. package/src/auth/jwtAuthAdapter.test.ts +754 -0
  408. package/src/auth/jwtAuthAdapter.ts +420 -0
  409. package/src/auth/loginErrors.test.ts +97 -0
  410. package/src/auth/loginErrors.ts +249 -0
  411. package/src/auth/ownEntry.test.ts +22 -0
  412. package/src/auth/ownEntry.ts +15 -0
  413. package/src/auth/platform.ts +4 -0
  414. package/src/auth/rememberedAccounts.test.ts +844 -0
  415. package/src/auth/rememberedAccounts.ts +568 -0
  416. package/src/auth/session.test.ts +976 -0
  417. package/src/auth/session.ts +509 -0
  418. package/src/auth/tokenExpiry.ts +185 -0
  419. package/src/auth/types.ts +1 -1
  420. package/src/auth/useAccountSecurity.ts +678 -0
  421. package/src/auth/useAccountSecurity.types.test.ts +28 -0
  422. package/src/auth/useAuthMethods.test.ts +181 -0
  423. package/src/auth/useAuthMethods.ts +137 -0
  424. package/src/auth/useJwtAuth.test.tsx +202 -0
  425. package/src/auth/useJwtAuth.ts +102 -0
  426. package/src/auth/useLoginController.ts +1038 -0
  427. package/src/auth/useLoginController.types.test.ts +26 -0
  428. package/src/buildNumber.test.ts +139 -0
  429. package/src/buildNumber.ts +75 -0
  430. package/src/client.socketEvents.test.ts +77 -0
  431. package/src/client.test.ts +109 -1
  432. package/src/client.ts +104 -19
  433. package/src/codegen/cli.test.ts +66 -0
  434. package/src/codegen/cli.ts +23 -12
  435. package/src/codegen/discoverCollections.ts +4 -0
  436. package/src/codegen/discoverOperations.ts +172 -0
  437. package/src/codegen/emitApi.test.tsx +445 -0
  438. package/src/codegen/emitApi.ts +396 -0
  439. package/src/codegen/emitSdk.ts +2 -2
  440. package/src/codegen/fixtures/openapi.api.json +840 -0
  441. package/src/codegen/generate.test.ts +54 -1
  442. package/src/codegen/generate.ts +20 -1
  443. package/src/codegen/hookNames.ts +35 -0
  444. package/src/codegen/safeIdentifiers.test.ts +20 -0
  445. package/src/codegen/safeIdentifiers.ts +7 -2
  446. package/src/codegen/types.ts +45 -1
  447. package/src/config/baseUrl.test.ts +53 -0
  448. package/src/config/baseUrl.ts +68 -0
  449. package/src/config/resolveBaseUrls.test.ts +308 -0
  450. package/src/config/resolveBaseUrls.ts +118 -0
  451. package/src/crypto/keyProviders.test.ts +23 -0
  452. package/src/crypto/keyProviders.ts +15 -4
  453. package/src/crypto/types.ts +5 -0
  454. package/src/flags/flagTestServer.ts +77 -0
  455. package/src/flags/useFeatureFlags.test.tsx +146 -0
  456. package/src/flags/useFeatureFlags.ts +130 -0
  457. package/src/flags/useTerrenoFeatureFlags.test.tsx +329 -0
  458. package/src/flags/useTerrenoFeatureFlags.ts +188 -0
  459. package/src/index.ts +4 -1
  460. package/src/isolated/TerrenoAccountSecurityScreen.isolated.tsx +123 -0
  461. package/src/isolated/TerrenoLoginScreen.isolated.tsx +256 -0
  462. package/src/isolated/betterAuthClient.isolated.ts +2198 -0
  463. package/src/isolated/betterAuthClient.native.isolated.ts +173 -0
  464. package/src/isolated/mcpTools.isolated.ts +259 -0
  465. package/src/isolated/rememberedAccounts.native.isolated.ts +63 -0
  466. package/src/isolated/sessionLogout.isolated.ts +152 -0
  467. package/src/isolated/tokenExpiry.isolated.ts +271 -0
  468. package/src/isolated/upgradeCheck.isolated.tsx +321 -0
  469. package/src/isolated/useAccountSecurity.isolated.ts +1089 -0
  470. package/src/isolated/useAccountSecurity.native.isolated.ts +61 -0
  471. package/src/isolated/useLoginController.isolated.ts +1384 -0
  472. package/src/mutations/entityIds.test.ts +55 -0
  473. package/src/mutations/entityIds.ts +50 -0
  474. package/src/persisters/defaultPersisterFactory.native.ts +7 -1
  475. package/src/persisters/encryptedIndexedDbPersister.ts +3 -0
  476. package/src/persisters/types.ts +6 -0
  477. package/src/query/queryWindows.ts +2 -2
  478. package/src/react/apiHooks.test.tsx +473 -0
  479. package/src/react/apiHooks.tsx +336 -0
  480. package/src/react/index.ts +2 -0
  481. package/src/react/provider.tsx +3 -0
  482. package/src/react/useSocketEvent.test.tsx +96 -0
  483. package/src/react/useSocketEvent.ts +59 -0
  484. package/src/sync/replayCoordinator.ts +5 -4
  485. package/src/sync/socketTransport.test.ts +49 -0
  486. package/src/sync/socketTransport.ts +15 -0
  487. package/src/sync/transport.ts +25 -0
  488. package/src/testing/fakeTransport.test.ts +18 -0
  489. package/src/testing/fakeTransport.ts +36 -5
  490. package/src/types.ts +9 -0
@@ -0,0 +1,711 @@
1
+ import {describe, expect, it} from "bun:test";
2
+
3
+ import {ApiError, apiFetch, createApiClient, type FetchLike, isApiError} from "./client";
4
+
5
+ interface RecordedCall {
6
+ url: string;
7
+ init: RequestInit;
8
+ }
9
+
10
+ const jsonResponse = (body: unknown, status = 200): Response =>
11
+ new Response(JSON.stringify(body), {
12
+ headers: {"Content-Type": "application/json"},
13
+ status,
14
+ });
15
+
16
+ /** Scripted fetch double: each call shifts the next responder off the queue. */
17
+ const scriptedFetch = (
18
+ responders: Array<(call: RecordedCall) => Response | Promise<Response>>
19
+ ): {calls: RecordedCall[]; fetchImpl: FetchLike} => {
20
+ const calls: RecordedCall[] = [];
21
+ const fetchImpl: FetchLike = async (input, init) => {
22
+ const call = {init: init ?? {}, url: String(input)};
23
+ calls.push(call);
24
+ const responder = responders.shift();
25
+ if (!responder) {
26
+ throw new Error(`Unexpected fetch ${call.url}`);
27
+ }
28
+ return responder(call);
29
+ };
30
+ return {calls, fetchImpl};
31
+ };
32
+
33
+ /** Resolve the ApiError a request rejects with; fails the test if it resolves. */
34
+ const failureOf = (promise: Promise<unknown>): Promise<ApiError> =>
35
+ promise.then(
36
+ () => {
37
+ throw new Error("Expected the request to fail");
38
+ },
39
+ (error: unknown) => error as ApiError
40
+ );
41
+
42
+ const headerOf = (call: RecordedCall, name: string): string | null =>
43
+ new Headers(call.init.headers).get(name);
44
+
45
+ describe("createApiClient.request", () => {
46
+ it("prefixes relative URLs, sends the bearer token, and merges configured headers", async () => {
47
+ const {calls, fetchImpl} = scriptedFetch([() => jsonResponse({data: {email: "a@b.co"}})]);
48
+ const client = createApiClient({
49
+ authProvider: {getToken: async () => "tok-1"},
50
+ baseUrl: "http://api.test/",
51
+ fetchImpl,
52
+ headers: async () => ({"App-Platform": "web", "App-Version": "1.2.3"}),
53
+ });
54
+
55
+ const me = await client.request<{email: string}>({url: "/auth/me"});
56
+
57
+ expect(me).toEqual({email: "a@b.co"});
58
+ expect(calls[0].url).toBe("http://api.test/auth/me");
59
+ expect(calls[0].init.method).toBe("GET");
60
+ expect(headerOf(calls[0], "Authorization")).toBe("Bearer tok-1");
61
+ expect(headerOf(calls[0], "App-Version")).toBe("1.2.3");
62
+ expect(headerOf(calls[0], "App-Platform")).toBe("web");
63
+ });
64
+
65
+ it("leaves absolute URLs alone and omits Authorization when signed out", async () => {
66
+ const {calls, fetchImpl} = scriptedFetch([() => jsonResponse({ok: true})]);
67
+ const client = createApiClient({
68
+ authProvider: {getToken: async () => null},
69
+ baseUrl: "http://api.test",
70
+ credentials: "include",
71
+ fetchImpl,
72
+ });
73
+
74
+ await client.request({url: "https://other.test/health"});
75
+
76
+ expect(calls[0].url).toBe("https://other.test/health");
77
+ expect(headerOf(calls[0], "Authorization")).toBeNull();
78
+ expect(calls[0].init.credentials).toBe("include");
79
+ });
80
+
81
+ it("serializes params the way the qs-based backend parser reads them", async () => {
82
+ const {calls, fetchImpl} = scriptedFetch([() => jsonResponse({data: []})]);
83
+ const client = createApiClient({baseUrl: "http://api.test", fetchImpl});
84
+
85
+ await client.request({
86
+ params: {
87
+ completed: false,
88
+ empty: undefined,
89
+ ids: ["a", "b"],
90
+ limit: 20,
91
+ since: new Date("2026-01-02T03:04:05.000Z"),
92
+ updated: {$gte: "2026-01-01"},
93
+ },
94
+ url: "/todos",
95
+ });
96
+
97
+ const url = new URL(calls[0].url);
98
+ expect(url.pathname).toBe("/todos");
99
+ expect(url.searchParams.get("completed")).toBe("false");
100
+ expect(url.searchParams.has("empty")).toBe(false);
101
+ expect(url.searchParams.getAll("ids")).toEqual(["a", "b"]);
102
+ expect(url.searchParams.get("limit")).toBe("20");
103
+ expect(url.searchParams.get("updated[$gte]")).toBe("2026-01-01");
104
+ expect(url.searchParams.get("since")).toBe("2026-01-02T03:04:05.000Z");
105
+ });
106
+
107
+ it("JSON-encodes object bodies and passes FormData through untouched", async () => {
108
+ const {calls, fetchImpl} = scriptedFetch([
109
+ () => jsonResponse({data: {name: "New"}}),
110
+ () => jsonResponse({data: {url: "gs://x"}}),
111
+ ]);
112
+ const client = createApiClient({baseUrl: "http://api.test", fetchImpl});
113
+
114
+ await client.request({body: {name: "New"}, method: "PATCH", url: "/auth/me"});
115
+ const form = new FormData();
116
+ form.append("file", "content");
117
+ await client.request({body: form, method: "POST", url: "/files/upload"});
118
+
119
+ expect(calls[0].init.body).toBe('{"name":"New"}');
120
+ expect(headerOf(calls[0], "Content-Type")).toBe("application/json");
121
+ expect(calls[1].init.body).toBe(form);
122
+ expect(headerOf(calls[1], "Content-Type")).toBeNull();
123
+ });
124
+
125
+ it("uses the {message} of a legacy error body as the title", async () => {
126
+ const {fetchImpl} = scriptedFetch([
127
+ () => jsonResponse({message: "The current password is incorrect."}, 403),
128
+ () => jsonResponse({message: ""}, 403),
129
+ ]);
130
+ const client = createApiClient({baseUrl: "http://api.test", fetchImpl});
131
+
132
+ const withMessage = await failureOf(client.request({method: "PATCH", url: "/auth/me"}));
133
+ const withEmptyMessage = await failureOf(client.request({url: "/auth/me"}));
134
+
135
+ expect(withMessage.status).toBe(403);
136
+ expect(withMessage.message).toBe("The current password is incorrect.");
137
+ expect(withMessage.data).toEqual({title: "The current password is incorrect."});
138
+ expect(withEmptyMessage.data.title).toBe("Request failed (403)");
139
+ });
140
+
141
+ it("unwraps {data} documents, keeps list envelopes, and returns null for 204", async () => {
142
+ const list = {data: [{_id: "1"}], limit: 10, more: false, page: 1, total: 1};
143
+ const {fetchImpl} = scriptedFetch([
144
+ () => jsonResponse({data: {_id: "1"}}),
145
+ () => jsonResponse(list),
146
+ () => new Response(null, {status: 204}),
147
+ () => jsonResponse({data: {_id: "2"}}),
148
+ ]);
149
+ const client = createApiClient({baseUrl: "http://api.test", fetchImpl});
150
+
151
+ expect(await client.request<unknown>({url: "/todos/1"})).toEqual({_id: "1"});
152
+ expect(await client.request<unknown>({url: "/todos"})).toEqual(list);
153
+ expect(await client.request<unknown>({method: "DELETE", url: "/todos/1"})).toBeNull();
154
+ expect(await client.request<unknown>({unwrap: false, url: "/todos/2"})).toEqual({
155
+ data: {_id: "2"},
156
+ });
157
+ });
158
+
159
+ it("throws ApiError with the server's title, detail, and fields", async () => {
160
+ const {fetchImpl} = scriptedFetch([
161
+ () =>
162
+ jsonResponse(
163
+ {detail: "Email taken", fields: {email: "Already used"}, title: "Validation failed"},
164
+ 400
165
+ ),
166
+ () => new Response("upstream down", {status: 502, statusText: "Bad Gateway"}),
167
+ ]);
168
+ const errors: ApiError[] = [];
169
+ const client = createApiClient({
170
+ baseUrl: "http://api.test",
171
+ fetchImpl,
172
+ onError: (error) => {
173
+ errors.push(error);
174
+ },
175
+ });
176
+
177
+ const first = await failureOf(client.request({method: "POST", url: "/auth/signup"}));
178
+ const second = await failureOf(client.request({url: "/flaky"}));
179
+
180
+ expect(first).toBeInstanceOf(ApiError);
181
+ expect(first.status).toBe(400);
182
+ expect(first.message).toBe("Validation failed");
183
+ expect(first.data).toEqual({
184
+ detail: "Email taken",
185
+ fields: {email: "Already used"},
186
+ title: "Validation failed",
187
+ });
188
+ expect(second.status).toBe(502);
189
+ expect(second.data.title).toBe("Bad Gateway");
190
+ expect(errors.map((error) => error.status)).toEqual([400, 502]);
191
+ });
192
+
193
+ it("refreshes once on 401 and retries with the new token", async () => {
194
+ let token = "stale";
195
+ let refreshes = 0;
196
+ const {calls, fetchImpl} = scriptedFetch([
197
+ () => jsonResponse({title: "Unauthorized"}, 401),
198
+ () => jsonResponse({data: {_id: "u1"}}),
199
+ ]);
200
+ const client = createApiClient({
201
+ authProvider: {
202
+ getToken: async () => token,
203
+ refresh: async () => {
204
+ refreshes += 1;
205
+ token = "fresh";
206
+ return true;
207
+ },
208
+ },
209
+ baseUrl: "http://api.test",
210
+ fetchImpl,
211
+ });
212
+
213
+ expect(await client.request<unknown>({url: "/auth/me"})).toEqual({_id: "u1"});
214
+ expect(refreshes).toBe(1);
215
+ expect(headerOf(calls[0], "Authorization")).toBe("Bearer stale");
216
+ expect(headerOf(calls[1], "Authorization")).toBe("Bearer fresh");
217
+ });
218
+
219
+ it("surfaces 401 without looping when refresh fails or is unavailable", async () => {
220
+ const {calls, fetchImpl} = scriptedFetch([
221
+ () => jsonResponse({title: "Unauthorized"}, 401),
222
+ () => jsonResponse({title: "Unauthorized"}, 401),
223
+ ]);
224
+ const refreshing = createApiClient({
225
+ authProvider: {getToken: async () => "t", refresh: async () => false},
226
+ baseUrl: "http://api.test",
227
+ fetchImpl,
228
+ });
229
+ const plain = createApiClient({baseUrl: "http://api.test", fetchImpl});
230
+
231
+ const first = await failureOf(refreshing.request({url: "/auth/me"}));
232
+ const second = await failureOf(plain.request({url: "/auth/me"}));
233
+
234
+ expect(first.status).toBe(401);
235
+ expect(second.status).toBe(401);
236
+ expect(calls).toHaveLength(2);
237
+ });
238
+
239
+ it("maps timeouts and network failures to status-0 ApiErrors", async () => {
240
+ const hanging: FetchLike = (_input, init) =>
241
+ new Promise((_resolve, reject) => {
242
+ init?.signal?.addEventListener("abort", () => {
243
+ reject(new DOMException("aborted", "AbortError"));
244
+ });
245
+ });
246
+ const offline: FetchLike = async () => {
247
+ throw new TypeError("Network request failed");
248
+ };
249
+
250
+ const timedOut = await failureOf(
251
+ createApiClient({baseUrl: "http://api.test", fetchImpl: hanging}).request({
252
+ timeoutMs: 5,
253
+ url: "/slow",
254
+ })
255
+ );
256
+ const failed = await failureOf(
257
+ createApiClient({baseUrl: "http://api.test", fetchImpl: offline}).request({url: "/down"})
258
+ );
259
+
260
+ expect(timedOut).toBeInstanceOf(ApiError);
261
+ expect(timedOut.status).toBe(0);
262
+ expect(timedOut.data).toEqual({code: "request-timeout", title: "Request timed out"});
263
+ expect(failed.status).toBe(0);
264
+ expect(failed.data).toEqual({code: "network-error", title: "Network request failed"});
265
+ });
266
+ });
267
+
268
+ describe("createApiClient query cache", () => {
269
+ it("dedupes identical in-flight queries and reuses cached data", async () => {
270
+ const {calls, fetchImpl} = scriptedFetch([() => jsonResponse({data: {_id: "u1"}})]);
271
+ const client = createApiClient({baseUrl: "http://api.test", fetchImpl});
272
+
273
+ const [first, second] = await Promise.all([
274
+ client.fetchQuery({url: "/auth/me"}),
275
+ client.fetchQuery({url: "/auth/me"}),
276
+ ]);
277
+ const third = await client.fetchQuery({url: "/auth/me"});
278
+
279
+ expect(first).toEqual({_id: "u1"});
280
+ expect(second).toEqual({_id: "u1"});
281
+ expect(third).toEqual({_id: "u1"});
282
+ expect(calls).toHaveLength(1);
283
+ expect(client.getQueryState({url: "/auth/me"})).toMatchObject({
284
+ data: {_id: "u1"},
285
+ isFetching: false,
286
+ status: "fulfilled",
287
+ });
288
+ });
289
+
290
+ it("refetches subscribed queries whose tags are invalidated and drops unsubscribed ones", async () => {
291
+ const {calls, fetchImpl} = scriptedFetch([
292
+ () => jsonResponse({data: {name: "Old"}}),
293
+ () => jsonResponse({data: [{_id: "t"}], more: false}),
294
+ () => jsonResponse({data: {name: "New"}}),
295
+ ]);
296
+ const client = createApiClient({baseUrl: "http://api.test", fetchImpl});
297
+ const seen: unknown[] = [];
298
+
299
+ const unsubscribe = client.subscribeQuery(
300
+ {url: "/auth/me"},
301
+ () => {
302
+ seen.push(client.getQueryState({url: "/auth/me"}).data);
303
+ },
304
+ {providesTags: ["profile"]}
305
+ );
306
+ await client.fetchQuery({url: "/auth/me"});
307
+ await client.fetchQuery({url: "/todos"}, {providesTags: ["profile"]});
308
+
309
+ client.invalidateTags(["profile"]);
310
+ await client.fetchQuery({url: "/auth/me"});
311
+
312
+ expect(client.getQueryState({url: "/auth/me"}).data).toEqual({name: "New"});
313
+ expect(seen).toContainEqual({name: "New"});
314
+ expect(client.getQueryState({url: "/todos"}).status).toBe("uninitialized");
315
+ expect(calls.map((call) => new URL(call.url).pathname)).toEqual([
316
+ "/auth/me",
317
+ "/todos",
318
+ "/auth/me",
319
+ ]);
320
+ unsubscribe();
321
+ });
322
+
323
+ it("keys the cache by params and headers, and reset() clears everything", async () => {
324
+ const {calls, fetchImpl} = scriptedFetch([
325
+ () => jsonResponse({data: {org: "a"}}),
326
+ () => jsonResponse({data: {org: "b"}}),
327
+ () => jsonResponse({data: {org: "a2"}}),
328
+ ]);
329
+ const client = createApiClient({baseUrl: "http://api.test", fetchImpl});
330
+
331
+ await client.fetchQuery({headers: {"X-Organization-Id": "a"}, url: "/orgs/current"});
332
+ await client.fetchQuery({headers: {"X-Organization-Id": "b"}, url: "/orgs/current"});
333
+ client.reset();
334
+ const after = await client.fetchQuery({
335
+ headers: {"X-Organization-Id": "a"},
336
+ url: "/orgs/current",
337
+ });
338
+
339
+ expect(after).toEqual({org: "a2"});
340
+ expect(calls).toHaveLength(3);
341
+ });
342
+
343
+ it("stores rejected queries as errors and retries them on force", async () => {
344
+ const {fetchImpl} = scriptedFetch([
345
+ () => jsonResponse({title: "Nope"}, 500),
346
+ () => jsonResponse({data: {ok: true}}),
347
+ ]);
348
+ const client = createApiClient({baseUrl: "http://api.test", fetchImpl});
349
+
350
+ const failure = await failureOf(client.fetchQuery({url: "/x"}));
351
+ const state = client.getQueryState({url: "/x"});
352
+ const recovered = await client.fetchQuery({url: "/x"}, {force: true});
353
+
354
+ expect(failure.status).toBe(500);
355
+ expect(state.status).toBe("rejected");
356
+ expect((state.error as ApiError).data.title).toBe("Nope");
357
+ expect(recovered).toEqual({ok: true});
358
+ });
359
+ });
360
+
361
+ describe("apiFetch edge behavior", () => {
362
+ it("parses text and blob bodies and sends null params as empty values", async () => {
363
+ const {calls, fetchImpl} = scriptedFetch([
364
+ () => new Response("plain", {headers: {"Content-Type": "text/plain"}}),
365
+ () => new Response("csv,data", {headers: {"Content-Type": "text/csv"}}),
366
+ () => new Response("bytes"),
367
+ ]);
368
+ const client = createApiClient({baseUrl: "http://api.test", fetchImpl});
369
+
370
+ const implicitText = await client.request<string>({params: {cursor: null}, url: "/a"});
371
+ const explicitText = await client.request<string>({parseAs: "text", url: "/b"});
372
+ const blob = await client.request<Blob>({parseAs: "blob", url: "/c"});
373
+
374
+ expect(implicitText).toBe("plain");
375
+ expect(explicitText).toBe("csv,data");
376
+ expect(await blob.text()).toBe("bytes");
377
+ expect(calls[0].url).toBe("http://api.test/a?cursor=");
378
+ });
379
+
380
+ it("keeps code and meta from error bodies and recognizes ApiError instances", async () => {
381
+ const {fetchImpl} = scriptedFetch([
382
+ () => jsonResponse({code: "rate-limited", meta: {retryAfter: 30}, title: "Slow down"}, 429),
383
+ ]);
384
+ const client = createApiClient({baseUrl: "http://api.test", fetchImpl});
385
+
386
+ const error = await failureOf(client.request({url: "/busy"}));
387
+
388
+ expect(isApiError(error)).toBe(true);
389
+ expect(isApiError(new Error("plain"))).toBe(false);
390
+ expect(error.data).toEqual({code: "rate-limited", meta: {retryAfter: 30}, title: "Slow down"});
391
+ });
392
+
393
+ it("keeps the server's top-level disableExternalErrorTracking flag for onError", async () => {
394
+ const {fetchImpl} = scriptedFetch([
395
+ () => jsonResponse({disableExternalErrorTracking: true, status: 400, title: "Expected"}, 400),
396
+ () => jsonResponse({disableExternalErrorTracking: false, title: "Tracked"}, 400),
397
+ () => jsonResponse({disableExternalErrorTracking: "yes", title: "Malformed"}, 400),
398
+ ]);
399
+ const reported: ApiError[] = [];
400
+ const client = createApiClient({
401
+ baseUrl: "http://api.test",
402
+ fetchImpl,
403
+ onError: (error) => {
404
+ reported.push(error);
405
+ },
406
+ });
407
+
408
+ await failureOf(client.request({url: "/expected"}));
409
+ await failureOf(client.request({url: "/tracked"}));
410
+ await failureOf(client.request({url: "/malformed"}));
411
+
412
+ expect(reported.map((error) => error.data)).toEqual([
413
+ {disableExternalErrorTracking: true, title: "Expected"},
414
+ {disableExternalErrorTracking: false, title: "Tracked"},
415
+ {title: "Malformed"},
416
+ ]);
417
+ });
418
+
419
+ it("aborts when the caller's signal fires, including one that already fired", async () => {
420
+ const hanging: FetchLike = (_input, init) =>
421
+ new Promise((_resolve, reject) => {
422
+ if (init?.signal?.aborted) {
423
+ reject(new DOMException("aborted", "AbortError"));
424
+ return;
425
+ }
426
+ init?.signal?.addEventListener("abort", () => {
427
+ reject(new DOMException("aborted", "AbortError"));
428
+ });
429
+ });
430
+ const reported: ApiError[] = [];
431
+ const client = createApiClient({
432
+ baseUrl: "http://api.test",
433
+ fetchImpl: hanging,
434
+ onError: (error) => {
435
+ reported.push(error);
436
+ },
437
+ });
438
+ const live = new AbortController();
439
+ const done = new AbortController();
440
+ done.abort();
441
+
442
+ const pending = failureOf(client.request({signal: live.signal, url: "/slow"}));
443
+ live.abort();
444
+
445
+ const cancelled = await pending;
446
+ expect(cancelled.status).toBe(0);
447
+ expect(cancelled.data).toEqual({code: "request-aborted", title: "Request cancelled"});
448
+ expect((await failureOf(client.request({signal: done.signal, url: "/slow"}))).status).toBe(0);
449
+ expect(reported).toEqual([]);
450
+ });
451
+ });
452
+
453
+ describe("query cache lifetime", () => {
454
+ it("drops unsubscribed entries after keepUnusedDataMs and keeps subscribed ones", async () => {
455
+ const {calls, fetchImpl} = scriptedFetch([
456
+ () => jsonResponse({data: {n: 1}}),
457
+ () => jsonResponse({data: {n: 2}}),
458
+ () => jsonResponse({data: {n: 3}}),
459
+ ]);
460
+ const client = createApiClient({baseUrl: "http://api.test", fetchImpl, keepUnusedDataMs: 5});
461
+
462
+ await client.fetchQuery({url: "/kept"});
463
+ const unsubscribe = client.subscribeQuery({url: "/kept"}, () => {});
464
+ await client.fetchQuery({url: "/dropped"});
465
+ await new Promise((resolve) => setTimeout(resolve, 20));
466
+
467
+ expect(client.getQueryState({url: "/kept"}).data).toEqual({n: 1});
468
+ expect(client.getQueryState({url: "/dropped"}).status).toBe("uninitialized");
469
+ unsubscribe();
470
+ await new Promise((resolve) => setTimeout(resolve, 20));
471
+ expect(client.getQueryState({url: "/kept"}).status).toBe("uninitialized");
472
+ expect(await client.fetchQuery<unknown>({url: "/kept"})).toEqual({n: 3});
473
+ expect(calls).toHaveLength(3);
474
+ });
475
+ });
476
+
477
+ describe("auth refresh edges", () => {
478
+ it("does not refresh again when the retried request is still unauthorized", async () => {
479
+ let refreshes = 0;
480
+ const errors: ApiError[] = [];
481
+ const {calls, fetchImpl} = scriptedFetch([
482
+ () => jsonResponse({title: "Unauthorized"}, 401),
483
+ () => jsonResponse({title: "Session revoked"}, 401),
484
+ ]);
485
+ const client = createApiClient({
486
+ authProvider: {
487
+ getToken: async () => "t",
488
+ refresh: async () => {
489
+ refreshes += 1;
490
+ return true;
491
+ },
492
+ },
493
+ baseUrl: "http://api.test",
494
+ fetchImpl,
495
+ onError: (error) => {
496
+ errors.push(error);
497
+ },
498
+ });
499
+
500
+ const error = await failureOf(client.request({url: "/auth/me"}));
501
+
502
+ expect(error.data.title).toBe("Session revoked");
503
+ expect(refreshes).toBe(1);
504
+ expect(calls).toHaveLength(2);
505
+ expect(errors).toHaveLength(1);
506
+ });
507
+
508
+ it("shares one refresh between concurrent unauthorized requests", async () => {
509
+ let token = "stale";
510
+ let refreshes = 0;
511
+ const fetchImpl: FetchLike = async (_input, init) => {
512
+ const auth = new Headers(init?.headers).get("Authorization");
513
+ return auth === "Bearer fresh"
514
+ ? jsonResponse({data: {ok: true}})
515
+ : jsonResponse({title: "Unauthorized"}, 401);
516
+ };
517
+ const client = createApiClient({
518
+ authProvider: {
519
+ getToken: async () => token,
520
+ refresh: async () => {
521
+ refreshes += 1;
522
+ await new Promise((resolve) => setTimeout(resolve, 5));
523
+ token = "fresh";
524
+ return true;
525
+ },
526
+ },
527
+ baseUrl: "http://api.test",
528
+ fetchImpl,
529
+ });
530
+
531
+ const results = await Promise.all([
532
+ client.request<unknown>({url: "/a"}),
533
+ client.request<unknown>({url: "/b"}),
534
+ client.request<unknown>({url: "/c"}),
535
+ ]);
536
+
537
+ expect(results).toEqual([{ok: true}, {ok: true}, {ok: true}]);
538
+ expect(refreshes).toBe(1);
539
+ });
540
+ });
541
+
542
+ describe("query cache races and keys", () => {
543
+ const deferredFetch = (): {
544
+ fetchImpl: FetchLike;
545
+ resolveNext: (body: unknown) => void;
546
+ count: () => number;
547
+ } => {
548
+ const pending: Array<(response: Response) => void> = [];
549
+ let count = 0;
550
+ return {
551
+ count: () => count,
552
+ fetchImpl: () => {
553
+ count += 1;
554
+ return new Promise((resolve) => {
555
+ pending.push(resolve);
556
+ });
557
+ },
558
+ resolveNext: (body) => {
559
+ pending.shift()?.(jsonResponse(body));
560
+ },
561
+ };
562
+ };
563
+
564
+ it("ignores a response that lands after reset() so it cannot repopulate the cache", async () => {
565
+ const backend = deferredFetch();
566
+ const client = createApiClient({baseUrl: "http://api.test", fetchImpl: backend.fetchImpl});
567
+
568
+ const inFlight = client.fetchQuery({url: "/auth/me"});
569
+ await new Promise((resolve) => setTimeout(resolve, 0));
570
+ expect(backend.count()).toBe(1);
571
+ client.reset();
572
+ backend.resolveNext({data: {_id: "previous-user"}});
573
+ await inFlight;
574
+
575
+ expect(client.getQueryState({url: "/auth/me"}).status).toBe("uninitialized");
576
+ });
577
+
578
+ it("keeps the newest refetch when an invalidation overtakes an in-flight request", async () => {
579
+ const backend = deferredFetch();
580
+ const client = createApiClient({baseUrl: "http://api.test", fetchImpl: backend.fetchImpl});
581
+ const unsubscribe = client.subscribeQuery({url: "/auth/me"}, () => {}, {providesTags: ["me"]});
582
+
583
+ const first = client.fetchQuery({url: "/auth/me"}, {providesTags: ["me"]});
584
+ await new Promise((resolve) => setTimeout(resolve, 0));
585
+ client.invalidateTags(["me"]);
586
+ await new Promise((resolve) => setTimeout(resolve, 0));
587
+ backend.resolveNext({data: {name: "stale"}});
588
+ backend.resolveNext({data: {name: "fresh"}});
589
+ await first;
590
+ await client.fetchQuery({url: "/auth/me"});
591
+
592
+ expect(backend.count()).toBe(2);
593
+ expect(client.getQueryState({url: "/auth/me"}).data).toEqual({name: "fresh"});
594
+ unsubscribe();
595
+ });
596
+
597
+ it("keys cached POST queries by JSON body", async () => {
598
+ const {calls, fetchImpl} = scriptedFetch([
599
+ () => jsonResponse({data: ["a"]}),
600
+ () => jsonResponse({data: ["b"]}),
601
+ ]);
602
+ const client = createApiClient({baseUrl: "http://api.test", fetchImpl});
603
+
604
+ const first = await client.fetchQuery<unknown>({
605
+ body: {q: "a"},
606
+ method: "POST",
607
+ url: "/search",
608
+ });
609
+ const second = await client.fetchQuery<unknown>({
610
+ body: {q: "b"},
611
+ method: "POST",
612
+ url: "/search",
613
+ });
614
+
615
+ expect(first).toEqual(["a"]);
616
+ expect(second).toEqual(["b"]);
617
+ expect(calls).toHaveLength(2);
618
+ });
619
+ });
620
+
621
+ describe("apiFetch called directly", () => {
622
+ it("cancels an in-flight request when the caller's signal fires after it started", async () => {
623
+ let started: () => void = () => {};
624
+ const fetchStarted = new Promise<void>((resolve) => {
625
+ started = resolve;
626
+ });
627
+ const hanging: FetchLike = (_input, init) =>
628
+ new Promise((_resolve, reject) => {
629
+ init?.signal?.addEventListener("abort", () => {
630
+ reject(new DOMException("aborted", "AbortError"));
631
+ });
632
+ started();
633
+ });
634
+ const caller = new AbortController();
635
+
636
+ const pending = failureOf(apiFetch({fetchImpl: hanging, signal: caller.signal, url: "/slow"}));
637
+ await fetchStarted;
638
+ caller.abort();
639
+
640
+ const error = await pending;
641
+ expect(error.status).toBe(0);
642
+ expect(error.data).toEqual({code: "request-aborted", title: "Request cancelled"});
643
+ });
644
+
645
+ it("uses the global fetch when no fetchImpl is given", async () => {
646
+ const originalFetch = globalThis.fetch;
647
+ const seen: string[] = [];
648
+ globalThis.fetch = (async (input: string | URL | Request) => {
649
+ seen.push(String(input));
650
+ return jsonResponse({ok: true});
651
+ }) as typeof fetch;
652
+ try {
653
+ const {result} = await apiFetch({params: {q: "a"}, url: "http://api.test/search"});
654
+
655
+ expect(result).toEqual({ok: true});
656
+ expect(seen).toEqual(["http://api.test/search?q=a"]);
657
+ } finally {
658
+ globalThis.fetch = originalFetch;
659
+ }
660
+ });
661
+
662
+ it("falls back to the status text when a JSON error body is malformed or untitled", async () => {
663
+ const {fetchImpl} = scriptedFetch([
664
+ () =>
665
+ new Response("{not json", {
666
+ headers: {"Content-Type": "application/json"},
667
+ status: 502,
668
+ statusText: "Bad Gateway",
669
+ }),
670
+ () => jsonResponse({detail: "no title"}, 503),
671
+ ]);
672
+
673
+ const malformed = await failureOf(apiFetch({fetchImpl, url: "/a"}));
674
+ const untitled = await failureOf(apiFetch({fetchImpl, url: "/b"}));
675
+
676
+ expect(malformed.status).toBe(502);
677
+ expect(malformed.data).toEqual({title: "Bad Gateway"});
678
+ expect(untitled.data).toEqual({title: "Request failed (503)"});
679
+ });
680
+ });
681
+
682
+ describe("tag invalidation failures", () => {
683
+ it("records a failed refetch on the subscribed entry without an unhandled rejection", async () => {
684
+ const {fetchImpl} = scriptedFetch([
685
+ () => jsonResponse({data: {name: "Ada"}}),
686
+ () => jsonResponse({title: "Gone"}, 500),
687
+ ]);
688
+ const client = createApiClient({baseUrl: "http://api.test", fetchImpl});
689
+ const args = {url: "/auth/me"};
690
+ let notified = 0;
691
+ const unsubscribe = client.subscribeQuery(
692
+ args,
693
+ () => {
694
+ notified += 1;
695
+ },
696
+ {providesTags: ["profile"]}
697
+ );
698
+ await client.fetchQuery(args, {providesTags: ["profile"]});
699
+
700
+ client.invalidateTags(["profile"]);
701
+ await new Promise((resolve) => setTimeout(resolve, 0));
702
+
703
+ const state = client.getQueryState<{name: string}>(args);
704
+ expect(state.status).toBe("rejected");
705
+ expect((state.error as ApiError).data.title).toBe("Gone");
706
+ expect(state.data).toEqual({name: "Ada"});
707
+ expect(notified).toBeGreaterThan(0);
708
+ unsubscribe();
709
+ client.reset();
710
+ });
711
+ });