@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,367 @@
1
+ /**
2
+ * `@terreno/syncdb/api` — request client for every non-synced `@terreno/api` route
3
+ * (`/auth/me`, modelRouter actions, AI, consents, …). Synced collections use the
4
+ * local-first store instead; this client covers request/response APIs.
5
+ *
6
+ * It shares the {@link AuthProvider} contract with `createSyncDb`, so sync and
7
+ * request traffic authenticate (and refresh on 401) the same way.
8
+ */
9
+ import type {AuthProvider} from "../types";
10
+ import {API_ERROR_CODES, ApiError} from "./apiError";
11
+ import {
12
+ type ApiFetchArgs,
13
+ apiFetch,
14
+ type FetchLike,
15
+ resolveApiUrl,
16
+ unwrapEnvelope,
17
+ } from "./apiFetch";
18
+
19
+ export {API_ERROR_CODES, ApiError, type ApiErrorData, isApiError} from "./apiError";
20
+ export {
21
+ type ApiFetchArgs,
22
+ apiFetch,
23
+ DEFAULT_API_TIMEOUT_MS,
24
+ type FetchLike,
25
+ resolveApiUrl,
26
+ serializeParams,
27
+ unwrapEnvelope,
28
+ } from "./apiFetch";
29
+
30
+ /** How long an unsubscribed cache entry survives before it is dropped. */
31
+ export const DEFAULT_KEEP_UNUSED_DATA_MS = 60_000;
32
+
33
+ export interface ApiRequestArgs extends Omit<ApiFetchArgs, "fetchImpl" | "headers"> {
34
+ headers?: Record<string, string>;
35
+ /** Unwrap `{data}` single-document envelopes (default `true`). */
36
+ unwrap?: boolean;
37
+ }
38
+
39
+ export interface ApiClientConfig {
40
+ /** API origin; relative request URLs are prefixed with it. */
41
+ baseUrl?: string;
42
+ /** Same provider passed to `createSyncDb`. Only `getToken` and `refresh` are used. */
43
+ authProvider?: Pick<AuthProvider, "getToken"> & Partial<Pick<AuthProvider, "refresh">>;
44
+ /** `"include"` for cookie sessions across origins, `"same-origin"` for SPAs. */
45
+ credentials?: RequestCredentials;
46
+ /** Extra headers on every request (e.g. `App-Version`, `App-Platform`). */
47
+ headers?:
48
+ | Record<string, string>
49
+ | (() => Record<string, string> | Promise<Record<string, string>>);
50
+ fetchImpl?: FetchLike;
51
+ timeoutMs?: number;
52
+ /** Called for every failed request, after any refresh retry (e.g. report to Sentry). */
53
+ onError?: (error: ApiError, args: ApiRequestArgs) => void;
54
+ keepUnusedDataMs?: number;
55
+ }
56
+
57
+ export type ApiQueryStatus = "uninitialized" | "pending" | "fulfilled" | "rejected";
58
+
59
+ export interface ApiQueryState<T = unknown> {
60
+ status: ApiQueryStatus;
61
+ data: T | undefined;
62
+ error: unknown;
63
+ /** True while any request (first load or refetch) is in flight. */
64
+ isFetching: boolean;
65
+ }
66
+
67
+ export interface ApiQueryOptions {
68
+ providesTags?: readonly string[];
69
+ /** Ignore cached data and in-flight requests and fetch again. */
70
+ force?: boolean;
71
+ }
72
+
73
+ export interface ApiClient {
74
+ readonly baseUrl: string | undefined;
75
+ /** One uncached request with auth, refresh-on-401, and envelope unwrapping. */
76
+ request: <T = unknown>(args: ApiRequestArgs) => Promise<T>;
77
+ /** Cached request: dedupes identical in-flight calls and reuses fulfilled data. */
78
+ fetchQuery: <T = unknown>(args: ApiRequestArgs, options?: ApiQueryOptions) => Promise<T>;
79
+ getQueryState: <T = unknown>(args: ApiRequestArgs) => ApiQueryState<T>;
80
+ /** Listen for state changes on one cache entry. Returns unsubscribe. */
81
+ subscribeQuery: (
82
+ args: ApiRequestArgs,
83
+ listener: () => void,
84
+ options?: Pick<ApiQueryOptions, "providesTags">
85
+ ) => () => void;
86
+ /** Refetch subscribed entries carrying any of `tags`; drop unsubscribed ones. */
87
+ invalidateTags: (tags: readonly string[]) => void;
88
+ /** Drop every cache entry (call on logout / user switch). */
89
+ reset: () => void;
90
+ }
91
+
92
+ interface CacheEntry {
93
+ args: ApiRequestArgs;
94
+ state: ApiQueryState;
95
+ listeners: Set<() => void>;
96
+ tags: Set<string>;
97
+ inFlight: Promise<unknown> | undefined;
98
+ generation: number;
99
+ gcTimer: ReturnType<typeof setTimeout> | undefined;
100
+ }
101
+
102
+ const UNINITIALIZED: ApiQueryState = {
103
+ data: undefined,
104
+ error: undefined,
105
+ isFetching: false,
106
+ status: "uninitialized",
107
+ };
108
+
109
+ const sortedJson = (value: unknown): string =>
110
+ JSON.stringify(value, (_key, nested: unknown) => {
111
+ if (nested && typeof nested === "object" && !Array.isArray(nested)) {
112
+ return Object.fromEntries(
113
+ Object.entries(nested as Record<string, unknown>).sort(([a], [b]) => a.localeCompare(b))
114
+ );
115
+ }
116
+ return nested;
117
+ });
118
+
119
+ const isPlainBody = (body: unknown): boolean =>
120
+ body != null &&
121
+ typeof body === "object" &&
122
+ (Array.isArray(body) || Object.getPrototypeOf(body) === Object.prototype);
123
+
124
+ /**
125
+ * Stable cache key: method, URL, params, headers, JSON or string body, and unwrap mode.
126
+ * FormData and Blob bodies are not part of the key; send those with `request()`.
127
+ */
128
+ export const apiQueryKey = (args: ApiRequestArgs): string =>
129
+ sortedJson([
130
+ (args.method ?? "GET").toUpperCase(),
131
+ args.url,
132
+ args.params ?? null,
133
+ args.headers ?? null,
134
+ isPlainBody(args.body) ? args.body : typeof args.body === "string" ? args.body : null,
135
+ args.unwrap ?? true,
136
+ ]);
137
+
138
+ /** Create a request client. One per app; pass it to `ApiClientProvider`. */
139
+ export const createApiClient = (config: ApiClientConfig = {}): ApiClient => {
140
+ const keepUnusedDataMs = config.keepUnusedDataMs ?? DEFAULT_KEEP_UNUSED_DATA_MS;
141
+ const entries = new Map<string, CacheEntry>();
142
+ let refreshing: Promise<boolean> | undefined;
143
+
144
+ // Concurrent 401s share one refresh so a burst of queries refreshes the token once.
145
+ const refreshOnce = (refresh: () => Promise<boolean>): Promise<boolean> => {
146
+ refreshing ??= refresh().finally(() => {
147
+ refreshing = undefined;
148
+ });
149
+ return refreshing;
150
+ };
151
+
152
+ const buildHeaders = async (args: ApiRequestArgs): Promise<Headers> => {
153
+ const headers = new Headers({Accept: "application/json"});
154
+ const extra = typeof config.headers === "function" ? await config.headers() : config.headers;
155
+ for (const [key, value] of Object.entries(extra ?? {})) {
156
+ headers.set(key, value);
157
+ }
158
+ for (const [key, value] of Object.entries(args.headers ?? {})) {
159
+ headers.set(key, value);
160
+ }
161
+ const token = await config.authProvider?.getToken();
162
+ if (token) {
163
+ headers.set("Authorization", `Bearer ${token}`);
164
+ }
165
+ return headers;
166
+ };
167
+
168
+ const send = async (args: ApiRequestArgs): Promise<unknown> => {
169
+ const {headers: _headers, unwrap: _unwrap, ...fetchArgs} = args;
170
+ const {result} = await apiFetch({
171
+ ...fetchArgs,
172
+ credentials: args.credentials ?? config.credentials,
173
+ fetchImpl: config.fetchImpl,
174
+ headers: await buildHeaders(args),
175
+ timeoutMs: args.timeoutMs ?? config.timeoutMs,
176
+ url: resolveApiUrl({baseUrl: config.baseUrl, url: args.url}),
177
+ });
178
+ return result;
179
+ };
180
+
181
+ const request = async <T = unknown>(args: ApiRequestArgs): Promise<T> => {
182
+ try {
183
+ let result: unknown;
184
+ try {
185
+ result = await send(args);
186
+ } catch (error) {
187
+ const refresh = config.authProvider?.refresh;
188
+ if (!(error instanceof ApiError) || error.status !== 401 || !refresh) {
189
+ throw error;
190
+ }
191
+ if (!(await refreshOnce(refresh))) {
192
+ throw error;
193
+ }
194
+ result = await send(args);
195
+ }
196
+ return (args.unwrap === false ? result : unwrapEnvelope(result)) as T;
197
+ } catch (error) {
198
+ // A caller-cancelled request is not a failure worth reporting.
199
+ if (error instanceof ApiError && error.data.code !== API_ERROR_CODES.aborted) {
200
+ config.onError?.(error, args);
201
+ }
202
+ throw error;
203
+ }
204
+ };
205
+
206
+ const notify = (entry: CacheEntry): void => {
207
+ for (const listener of [...entry.listeners]) {
208
+ listener();
209
+ }
210
+ };
211
+
212
+ const setState = (entry: CacheEntry, next: Partial<ApiQueryState>): void => {
213
+ entry.state = {...entry.state, ...next};
214
+ notify(entry);
215
+ };
216
+
217
+ const scheduleGc = (key: string, entry: CacheEntry): void => {
218
+ if (entry.listeners.size > 0 || entry.gcTimer) {
219
+ return;
220
+ }
221
+ entry.gcTimer = setTimeout(() => {
222
+ entry.gcTimer = undefined;
223
+ if (entry.listeners.size === 0 && entries.get(key) === entry) {
224
+ entries.delete(key);
225
+ }
226
+ }, keepUnusedDataMs);
227
+ };
228
+
229
+ const ensureEntry = (args: ApiRequestArgs): [string, CacheEntry] => {
230
+ const key = apiQueryKey(args);
231
+ let entry = entries.get(key);
232
+ if (!entry) {
233
+ // A shared entry outlives any one caller, so it never keeps a caller's abort signal.
234
+ const {signal: _signal, ...shared} = args;
235
+ entry = {
236
+ args: shared,
237
+ gcTimer: undefined,
238
+ generation: 0,
239
+ inFlight: undefined,
240
+ listeners: new Set(),
241
+ state: UNINITIALIZED,
242
+ tags: new Set(),
243
+ };
244
+ entries.set(key, entry);
245
+ }
246
+ return [key, entry];
247
+ };
248
+
249
+ const runQuery = (key: string, entry: CacheEntry): Promise<unknown> => {
250
+ entry.generation += 1;
251
+ const generation = entry.generation;
252
+ setState(entry, {
253
+ isFetching: true,
254
+ status: entry.state.status === "fulfilled" ? "fulfilled" : "pending",
255
+ });
256
+ const promise = request(entry.args).then(
257
+ (data) => {
258
+ if (entry.generation === generation && entries.get(key) === entry) {
259
+ entry.inFlight = undefined;
260
+ setState(entry, {data, error: undefined, isFetching: false, status: "fulfilled"});
261
+ scheduleGc(key, entry);
262
+ }
263
+ return data;
264
+ },
265
+ (error: unknown) => {
266
+ if (entry.generation === generation && entries.get(key) === entry) {
267
+ entry.inFlight = undefined;
268
+ setState(entry, {error, isFetching: false, status: "rejected"});
269
+ scheduleGc(key, entry);
270
+ }
271
+ throw error;
272
+ }
273
+ );
274
+ entry.inFlight = promise;
275
+ return promise;
276
+ };
277
+
278
+ const fetchQuery = <T = unknown>(
279
+ args: ApiRequestArgs,
280
+ options: ApiQueryOptions = {}
281
+ ): Promise<T> => {
282
+ const [key, entry] = ensureEntry(args);
283
+ for (const tag of options.providesTags ?? []) {
284
+ entry.tags.add(tag);
285
+ }
286
+ if (!options.force) {
287
+ if (entry.inFlight !== undefined) {
288
+ return entry.inFlight as Promise<T>;
289
+ }
290
+ if (entry.state.status === "fulfilled") {
291
+ return Promise.resolve(entry.state.data as T);
292
+ }
293
+ }
294
+ return runQuery(key, entry) as Promise<T>;
295
+ };
296
+
297
+ const getQueryState = <T = unknown>(args: ApiRequestArgs): ApiQueryState<T> =>
298
+ (entries.get(apiQueryKey(args))?.state ?? UNINITIALIZED) as ApiQueryState<T>;
299
+
300
+ const subscribeQuery = (
301
+ args: ApiRequestArgs,
302
+ listener: () => void,
303
+ options: Pick<ApiQueryOptions, "providesTags"> = {}
304
+ ): (() => void) => {
305
+ const [key, entry] = ensureEntry(args);
306
+ for (const tag of options.providesTags ?? []) {
307
+ entry.tags.add(tag);
308
+ }
309
+ if (entry.gcTimer) {
310
+ clearTimeout(entry.gcTimer);
311
+ entry.gcTimer = undefined;
312
+ }
313
+ entry.listeners.add(listener);
314
+ return () => {
315
+ entry.listeners.delete(listener);
316
+ scheduleGc(key, entry);
317
+ };
318
+ };
319
+
320
+ const invalidateTags = (tags: readonly string[]): void => {
321
+ const wanted = new Set(tags);
322
+ for (const [key, entry] of [...entries]) {
323
+ if (![...entry.tags].some((tag) => wanted.has(tag))) {
324
+ continue;
325
+ }
326
+ if (entry.listeners.size === 0) {
327
+ if (entry.gcTimer) {
328
+ clearTimeout(entry.gcTimer);
329
+ }
330
+ entries.delete(key);
331
+ continue;
332
+ }
333
+ // Refetch errors surface through the entry state; nothing awaits this promise.
334
+ runQuery(key, entry).catch(() => {});
335
+ }
336
+ };
337
+
338
+ const reset = (): void => {
339
+ for (const [key, entry] of [...entries]) {
340
+ if (entry.gcTimer) {
341
+ clearTimeout(entry.gcTimer);
342
+ entry.gcTimer = undefined;
343
+ }
344
+ entry.generation += 1;
345
+ entry.inFlight = undefined;
346
+ entry.tags.clear();
347
+ // A fresh object, so a hook that rendered the initial state before a request started and
348
+ // was reset in the same commit still sees a change and fetches again.
349
+ entry.state = {...UNINITIALIZED};
350
+ // Mounted hooks keep their entry so they see the reset and fetch again.
351
+ if (entry.listeners.size === 0) {
352
+ entries.delete(key);
353
+ }
354
+ notify(entry);
355
+ }
356
+ };
357
+
358
+ return {
359
+ baseUrl: config.baseUrl,
360
+ fetchQuery,
361
+ getQueryState,
362
+ invalidateTags,
363
+ request,
364
+ reset,
365
+ subscribeQuery,
366
+ };
367
+ };
package/src/app/app.ts ADDED
@@ -0,0 +1,30 @@
1
+ /**
2
+ * `@terreno/syncdb/app` — app-shell utilities that sit beside the data layer:
3
+ * the upgrade check (on the request client), RBAC helpers, the dev console log
4
+ * bridge, and MCP tool discovery (on the shared auth provider).
5
+ *
6
+ * Needs `react`, `react-native`, and `expo-constants`; `useMCPTools` also needs
7
+ * `@modelcontextprotocol/client` (all optional peer dependencies).
8
+ */
9
+ export {type InstallDevConsoleLoggerOptions, installDevConsoleLogger} from "./devConsoleLogger";
10
+ export {
11
+ type MCPToolInfo,
12
+ type UseMCPToolsOptions,
13
+ type UseMCPToolsResult,
14
+ useMCPTools,
15
+ } from "./mcpTools";
16
+ export {
17
+ ADMIN_PAGE_ACTION,
18
+ ADMIN_PAGE_PERMISSION,
19
+ ADMIN_PAGE_RESOURCE,
20
+ canOpenAdminPage,
21
+ hasPermission,
22
+ type PermissionRequest,
23
+ type PermissionSet,
24
+ } from "./permissions";
25
+ export {
26
+ type UseUpgradeCheckOptions,
27
+ type UseUpgradeCheckResult,
28
+ useUpgradeCheck,
29
+ type VersionCheckResponse,
30
+ } from "./upgradeCheck";
@@ -0,0 +1,246 @@
1
+ import {afterEach, beforeEach, describe, expect, it, mock} from "bun:test";
2
+ import {installDevConsoleLogger, resetDevConsoleLoggerForTests} from "./devConsoleLogger";
3
+
4
+ describe("installDevConsoleLogger", () => {
5
+ const prevFetch = globalThis.fetch;
6
+
7
+ beforeEach(() => {
8
+ process.env.TERRENO_DEV_CONSOLE_LOGGER_TEST = "true";
9
+ resetDevConsoleLoggerForTests();
10
+ });
11
+
12
+ afterEach(() => {
13
+ resetDevConsoleLoggerForTests();
14
+ delete process.env.TERRENO_DEV_CONSOLE_LOGGER_TEST;
15
+ globalThis.fetch = prevFetch;
16
+ });
17
+
18
+ it("installs only once per process flag", () => {
19
+ installDevConsoleLogger();
20
+ installDevConsoleLogger();
21
+ const g = globalThis as typeof globalThis & {__TERRENO_CONSOLE_LOGGER__?: boolean};
22
+ expect(g.__TERRENO_CONSOLE_LOGGER__).toBe(true);
23
+ });
24
+
25
+ it("POSTs a single batched payload after debounce with expected shape", async () => {
26
+ const fetchMock = mock((_input: RequestInfo | URL, _init?: RequestInit) =>
27
+ Promise.resolve(new Response(null, {status: 204}))
28
+ );
29
+ globalThis.fetch = fetchMock as unknown as typeof fetch;
30
+
31
+ installDevConsoleLogger();
32
+ console.error("one");
33
+ console.warn("two");
34
+ await new Promise<void>((r) => {
35
+ setTimeout(r, 450);
36
+ });
37
+
38
+ expect(fetchMock.mock.calls.length).toBe(1);
39
+ const init = fetchMock.mock.calls[0]?.[1] as RequestInit | undefined;
40
+ expect(init?.method).toBe("POST");
41
+ const body = JSON.parse(String(init?.body)) as {
42
+ entries: Array<{level: string; message: string}>;
43
+ };
44
+ expect(body.entries.map((e) => e.message)).toEqual(["one", "two"]);
45
+ expect(body.entries[0]?.level).toBe("error");
46
+ expect(body.entries[1]?.level).toBe("warn");
47
+ });
48
+
49
+ it("flushes bursts in server-sized batches", async () => {
50
+ const fetchMock = mock((_input: RequestInfo | URL, _init?: RequestInit) =>
51
+ Promise.resolve(new Response(null, {status: 204}))
52
+ );
53
+ globalThis.fetch = fetchMock as unknown as typeof fetch;
54
+ const originalWarn = console.warn;
55
+ console.warn = (): void => {};
56
+
57
+ try {
58
+ installDevConsoleLogger();
59
+ for (let index = 0; index < 101; index += 1) {
60
+ console.warn(`line-${index}`);
61
+ }
62
+ await new Promise<void>((resolve) => {
63
+ setTimeout(resolve, 450);
64
+ });
65
+ } finally {
66
+ resetDevConsoleLoggerForTests();
67
+ console.warn = originalWarn;
68
+ }
69
+
70
+ expect(fetchMock.mock.calls).toHaveLength(2);
71
+ const firstBody = JSON.parse(String(fetchMock.mock.calls[0]?.[1]?.body)) as {
72
+ entries: unknown[];
73
+ };
74
+ const secondBody = JSON.parse(String(fetchMock.mock.calls[1]?.[1]?.body)) as {
75
+ entries: unknown[];
76
+ };
77
+ expect(firstBody.entries).toHaveLength(100);
78
+ expect(secondBody.entries).toHaveLength(1);
79
+ });
80
+
81
+ it("retries a rejected backend batch once", async () => {
82
+ const fetchMock = mock((_input: RequestInfo | URL, _init?: RequestInit) =>
83
+ Promise.resolve(
84
+ new Response(null, {
85
+ status: fetchMock.mock.calls.length === 1 ? 503 : 204,
86
+ })
87
+ )
88
+ );
89
+ globalThis.fetch = fetchMock as unknown as typeof fetch;
90
+ const originalWarn = console.warn;
91
+ console.warn = (): void => {};
92
+
93
+ try {
94
+ installDevConsoleLogger();
95
+ console.warn("retry-me");
96
+ await new Promise<void>((resolve) => {
97
+ setTimeout(resolve, 450);
98
+ });
99
+ } finally {
100
+ resetDevConsoleLoggerForTests();
101
+ console.warn = originalWarn;
102
+ }
103
+
104
+ expect(fetchMock.mock.calls).toHaveLength(2);
105
+ });
106
+
107
+ it("captures native and web global errors and restores the native handler", async (): Promise<void> => {
108
+ type GlobalHandler = (error: unknown, isFatal?: boolean) => void;
109
+ const globalRecord = globalThis as typeof globalThis & Record<string, unknown>;
110
+ const originalErrorUtils = Object.getOwnPropertyDescriptor(globalThis, "ErrorUtils");
111
+ const originalWindow = Object.getOwnPropertyDescriptor(globalThis, "window");
112
+ const previousHandler = mock((_error: unknown, _isFatal?: boolean): void => {});
113
+ let globalHandler: GlobalHandler = previousHandler;
114
+ const listeners = new Map<string, (event: unknown) => void>();
115
+ const fetchMock = mock((_input: RequestInfo | URL, _init?: RequestInit) =>
116
+ Promise.resolve(new Response(null, {status: 204}))
117
+ );
118
+ globalThis.fetch = fetchMock as unknown as typeof fetch;
119
+
120
+ Object.defineProperty(globalThis, "ErrorUtils", {
121
+ configurable: true,
122
+ value: {
123
+ getGlobalHandler: (): GlobalHandler => previousHandler,
124
+ setGlobalHandler: (handler: GlobalHandler): void => {
125
+ globalHandler = handler;
126
+ },
127
+ },
128
+ });
129
+ Object.defineProperty(globalThis, "window", {
130
+ configurable: true,
131
+ value: {
132
+ addEventListener: (name: string, listener: (event: unknown) => void): void => {
133
+ listeners.set(name, listener);
134
+ },
135
+ },
136
+ });
137
+
138
+ try {
139
+ installDevConsoleLogger();
140
+ globalHandler(new Error("native error"), true);
141
+ globalHandler("native string");
142
+ listeners.get("unhandledrejection")?.({reason: "promise error"});
143
+ listeners.get("error")?.({error: new Error("web error"), message: "window error"});
144
+ await new Promise<void>((resolve) => {
145
+ setTimeout(resolve, 450);
146
+ });
147
+
148
+ expect(previousHandler.mock.calls.length).toBe(2);
149
+ expect(fetchMock.mock.calls.length).toBe(1);
150
+ const body = JSON.parse(String(fetchMock.mock.calls[0]?.[1]?.body)) as {
151
+ entries: Array<{message: string; stack?: string}>;
152
+ };
153
+ expect(body.entries.map((entry) => entry.message)).toEqual([
154
+ "native error",
155
+ "native string",
156
+ "promise error",
157
+ "window error",
158
+ ]);
159
+ expect(typeof body.entries[0]?.stack).toBe("string");
160
+
161
+ resetDevConsoleLoggerForTests();
162
+ expect(globalHandler).toBe(previousHandler);
163
+ } finally {
164
+ resetDevConsoleLoggerForTests();
165
+ if (originalErrorUtils) {
166
+ Object.defineProperty(globalThis, "ErrorUtils", originalErrorUtils);
167
+ } else {
168
+ Reflect.deleteProperty(globalRecord, "ErrorUtils");
169
+ }
170
+ if (originalWindow) {
171
+ Object.defineProperty(globalThis, "window", originalWindow);
172
+ } else {
173
+ Reflect.deleteProperty(globalRecord, "window");
174
+ }
175
+ }
176
+ });
177
+ });
178
+
179
+ describe("installDevConsoleLogger options and gating", () => {
180
+ const prevFetch = globalThis.fetch;
181
+ const globalRecord = globalThis as typeof globalThis & {__DEV__?: boolean};
182
+
183
+ afterEach(() => {
184
+ resetDevConsoleLoggerForTests();
185
+ delete process.env.TERRENO_DEV_CONSOLE_LOGGER_TEST;
186
+ delete globalRecord.__DEV__;
187
+ globalThis.fetch = prevFetch;
188
+ });
189
+
190
+ it("does nothing outside dev and test installs", () => {
191
+ delete process.env.TERRENO_DEV_CONSOLE_LOGGER_TEST;
192
+ const originalError = console.error;
193
+ installDevConsoleLogger();
194
+ const g = globalThis as typeof globalThis & {__TERRENO_CONSOLE_LOGGER__?: boolean};
195
+ expect(g.__TERRENO_CONSOLE_LOGGER__).toBeUndefined();
196
+ expect(console.error).toBe(originalError);
197
+ });
198
+
199
+ it("installs under __DEV__ and posts to the given base URL", async () => {
200
+ globalRecord.__DEV__ = true;
201
+ const fetchMock = mock((_input: RequestInfo | URL, _init?: RequestInit) =>
202
+ Promise.resolve(new Response(null, {status: 204}))
203
+ );
204
+ globalThis.fetch = fetchMock as unknown as typeof fetch;
205
+ const originalWarn = console.warn;
206
+ console.warn = (): void => {};
207
+
208
+ try {
209
+ installDevConsoleLogger({baseUrl: "https://api.example.com/"});
210
+ console.warn("dev-only");
211
+ await new Promise<void>((resolve) => {
212
+ setTimeout(resolve, 450);
213
+ });
214
+ } finally {
215
+ resetDevConsoleLoggerForTests();
216
+ console.warn = originalWarn;
217
+ }
218
+
219
+ expect(String(fetchMock.mock.calls[0]?.[0])).toBe(
220
+ "https://api.example.com/__terreno/browser-logs"
221
+ );
222
+ });
223
+
224
+ it("retries once when the request throws and never surfaces the failure", async () => {
225
+ process.env.TERRENO_DEV_CONSOLE_LOGGER_TEST = "true";
226
+ const fetchMock = mock((_input: RequestInfo | URL, _init?: RequestInit) =>
227
+ Promise.reject(new Error("backend down"))
228
+ );
229
+ globalThis.fetch = fetchMock as unknown as typeof fetch;
230
+ const originalWarn = console.warn;
231
+ console.warn = (): void => {};
232
+
233
+ try {
234
+ installDevConsoleLogger();
235
+ console.warn("lost");
236
+ await new Promise<void>((resolve) => {
237
+ setTimeout(resolve, 450);
238
+ });
239
+ } finally {
240
+ resetDevConsoleLoggerForTests();
241
+ console.warn = originalWarn;
242
+ }
243
+
244
+ expect(fetchMock.mock.calls).toHaveLength(2);
245
+ });
246
+ });