@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
package/src/client.ts CHANGED
@@ -7,6 +7,7 @@ import {attachDebugChannel, type DebugChannelBridge} from "./debug/debugChannel"
7
7
  import {resolveDebugLog, type SyncDebugLog, type SyncDebugLogOptions} from "./debug/debugLog";
8
8
  import {registerSyncDbDevtools} from "./debug/devtools";
9
9
  import {getConflict, listConflicts, pruneGhostConflicts} from "./mutations/conflicts";
10
+ import {generateEntityId, isObjectIdHex, type SyncIdFormat} from "./mutations/entityIds";
10
11
  import {createOutbox, generateMutationId, type Outbox} from "./mutations/outbox";
11
12
  import {resolveConflict as applyConflictResolution} from "./mutations/resolveConflict";
12
13
  import {createDefaultPersisterFactory} from "./persisters/defaultPersisterFactory";
@@ -28,7 +29,12 @@ import {
28
29
  } from "./sync/httpChannel";
29
30
  import {createReplayCoordinator, type ReplayCoordinator} from "./sync/replayCoordinator";
30
31
  import {createSocketTransport} from "./sync/socketTransport";
31
- import type {SendMutationBatchResult, SendMutationResult, SyncTransport} from "./sync/transport";
32
+ import type {
33
+ SendMutationBatchResult,
34
+ SendMutationResult,
35
+ SocketEventHandler,
36
+ SyncTransport,
37
+ } from "./sync/transport";
32
38
  import {type HydrateWindowEntitiesResult, hydrateWindowEntities} from "./sync/windowHydrate";
33
39
  import type {
34
40
  AuthProvider,
@@ -86,6 +92,13 @@ export interface SyncDbConfig {
86
92
  name: string;
87
93
  /** Collections to sync (become local entity tables and subscriptions). */
88
94
  collections: string[];
95
+ /**
96
+ * Id format per collection for creates (default `uuid`). Use `objectId` for a collection
97
+ * whose server model keeps the default ObjectId `_id`: the client mints 24-hex ObjectIds,
98
+ * and `mutate()` rejects an explicit id that is not one. The server rejects a non-hex id
99
+ * for such a collection with an `invalid_id` validation nack.
100
+ */
101
+ idFormats?: Record<string, SyncIdFormat>;
89
102
  authProvider: AuthProvider;
90
103
  /** Server origin; required unless both transport and httpChannel are injected. */
91
104
  baseUrl?: string;
@@ -339,6 +352,15 @@ export interface SyncDb {
339
352
  * Returns an unsubscribe function.
340
353
  */
341
354
  onStatusChange: (callback: () => void) => () => void;
355
+ /**
356
+ * Listen for an app-level server event on the sync socket (for example the
357
+ * feature-flags `featureFlagsChanged` push). One socket serves sync and app
358
+ * events. Listeners survive stop/start and reconnects; they fire only while the
359
+ * socket is connected. Names starting with `sync:` and Socket.io lifecycle
360
+ * events are reserved and throw. Returns an unsubscribe function; a transport
361
+ * without event support returns a no-op.
362
+ */
363
+ onSocketEvent: (event: string, handler: SocketEventHandler) => () => void;
342
364
  /**
343
365
  * In-memory debug event log when `config.debug` is enabled; otherwise
344
366
  * undefined. Its `snapshot()` is a plain serializable object suitable for
@@ -508,6 +530,12 @@ export const createSyncDb = (config: SyncDbConfig): SyncDb => {
508
530
  let unbindDeltaHandler: (() => void) | undefined;
509
531
  /** True once a start() has completed without a matching stop() (E1 double-start guard). */
510
532
  let isStarted = false;
533
+ // Bumped synchronously by every stop()/signOut() CALL, before it queues on the
534
+ // lifecycle mutex. `generation` only changes once the stop runs, which is after
535
+ // any start() ahead of it in the queue has finished, so this is how a start()
536
+ // already running (or still queued) learns the host app logged out and stops
537
+ // before opening persistence or connecting the transport without a session.
538
+ let stopRequests = 0;
511
539
 
512
540
  /**
513
541
  * Queue `op` onto the lifecycle mutex; resolves/rejects with `op`'s own
@@ -1470,7 +1498,10 @@ export const createSyncDb = (config: SyncDbConfig): SyncDb => {
1470
1498
  */
1471
1499
  let persistenceMode: "durable" | "memory" | "error" = "durable";
1472
1500
 
1473
- const createAndStartPersister = async (userId: string): Promise<void> => {
1501
+ const createAndStartPersister = async (
1502
+ userId: string,
1503
+ {isSuperseded}: {isSuperseded?: () => boolean} = {}
1504
+ ): Promise<void> => {
1474
1505
  // Reset per-call: a fresh persister/load attempt starts optimistic even
1475
1506
  // if a PRIOR persister instance (e.g. before a wipe-and-rebuild) had
1476
1507
  // flagged a load failure.
@@ -1534,11 +1565,26 @@ export const createSyncDb = (config: SyncDbConfig): SyncDb => {
1534
1565
  // app supplying its own storage backend can still opt into E3 SyncStatus
1535
1566
  // surfacing; the default factory already received the same callbacks
1536
1567
  // above (at creation time) and ignores this second copy.
1537
- persister = factory({
1568
+ const created = factory({
1538
1569
  databaseName: config.name,
1539
1570
  hooks: {onDecryptFailure, onLoadFailure, onSaveFailure},
1540
1571
  store: store.raw,
1541
1572
  });
1573
+ persister = created;
1574
+ // Resolve the encryption key now, while the session that start() resolved is
1575
+ // still valid. Otherwise the first fetch happens on the first (debounced) save,
1576
+ // and a logout in that window leaves every save, including stop()'s flush of
1577
+ // pending outbox writes, failing with a 401 from /sync/key. A failure here
1578
+ // (offline cold start) is not fatal: saves retry the key and report through
1579
+ // onSaveFailure.
1580
+ await created.prepare?.().catch((): void => {});
1581
+ if (isSuperseded?.()) {
1582
+ // A stop() arrived while the key was resolving. Nothing has loaded into this
1583
+ // persister, so drop it without saving rather than let stop() flush it.
1584
+ persister = undefined;
1585
+ await created.destroy();
1586
+ return;
1587
+ }
1542
1588
  await persister.startAutoLoad();
1543
1589
  // Read through a function call: `onLoadFailure` (invoked synchronously
1544
1590
  // from inside `startAutoLoad()`, not after it returns) mutates
@@ -1898,9 +1944,16 @@ export const createSyncDb = (config: SyncDbConfig): SyncDb => {
1898
1944
  * `await` — belt-and-suspenders against any future call site that manages
1899
1945
  * to bypass the mutex (e.g. a direct call from a test), and cheap enough to
1900
1946
  * always do.
1947
+ *
1948
+ * A stop()/signOut() call also cancels a start() that is running or queued
1949
+ * ahead of it (see `stopRequests`): the start() returns at its next check, so
1950
+ * a logout mid-start never opens persistence or connects the transport after
1951
+ * the session is gone. Pending local writes still reach storage through
1952
+ * stop()'s flush, which uses the key start() resolved up front.
1901
1953
  */
1902
- const start = async (): Promise<void> =>
1903
- withLifecycle(async (): Promise<void> => {
1954
+ const start = async (): Promise<void> => {
1955
+ const stopRequestsAtCall = stopRequests;
1956
+ return withLifecycle(async (): Promise<void> => {
1904
1957
  if (isStarted) {
1905
1958
  // E1: double-start() is a no-op rather than a second full
1906
1959
  // initialization — calling start() again would double-register the
@@ -1908,8 +1961,17 @@ export const createSyncDb = (config: SyncDbConfig): SyncDb => {
1908
1961
  // A caller that wants a hard restart should stop() first.
1909
1962
  return;
1910
1963
  }
1964
+ if (stopRequests !== stopRequestsAtCall) {
1965
+ // A stop() was called after this start() but before it ran: the host app
1966
+ // already logged out, so there is nothing to start.
1967
+ return;
1968
+ }
1911
1969
  generation += 1;
1912
1970
  const myGeneration = generation;
1971
+ // Superseded by a later lifecycle op, or cancelled by a stop()/signOut() call
1972
+ // that is still queued behind this start().
1973
+ const isCancelled = (): boolean =>
1974
+ generation !== myGeneration || stopRequests !== stopRequestsAtCall;
1913
1975
  const authRetryAttempts = Math.max(
1914
1976
  1,
1915
1977
  config.startAuthRetryAttempts ?? DEFAULT_START_AUTH_RETRY_ATTEMPTS
@@ -1922,31 +1984,33 @@ export const createSyncDb = (config: SyncDbConfig): SyncDb => {
1922
1984
  break;
1923
1985
  }
1924
1986
  await sleep(authRetryDelayMs);
1925
- if (generation !== myGeneration) {
1987
+ if (isCancelled()) {
1926
1988
  // A stop() (or another start()) ran while we were retrying auth
1927
1989
  // resolution — abandon this attempt, see the generation check below.
1928
1990
  return;
1929
1991
  }
1930
1992
  }
1931
- if (!userId) {
1932
- throw new Error("createSyncDb.start() requires an authenticated user");
1933
- }
1934
- if (generation !== myGeneration) {
1993
+ if (isCancelled()) {
1935
1994
  // A stop() (or another start()) ran while awaiting the auth
1936
1995
  // provider — that operation now owns the lifecycle; abandon this one
1937
1996
  // rather than initializing state a newer generation doesn't expect.
1997
+ // Checked before the no-user error: a logout that cancels this start()
1998
+ // is expected, not a failure.
1938
1999
  return;
1939
2000
  }
2001
+ if (!userId) {
2002
+ throw new Error("createSyncDb.start() requires an authenticated user");
2003
+ }
1940
2004
  simulatedOffline = false;
1941
2005
  setAuthPaused(false);
1942
2006
  // Re-open the cross-window debug bridge a previous stop()/signOut() closed.
1943
2007
  attachDebugBridge();
1944
- await createAndStartPersister(userId);
1945
- if (generation !== myGeneration) {
2008
+ await createAndStartPersister(userId, {isSuperseded: isCancelled});
2009
+ if (isCancelled()) {
1946
2010
  return;
1947
2011
  }
1948
2012
  const {userChanged} = await runUserCheck(userId);
1949
- if (generation !== myGeneration) {
2013
+ if (isCancelled()) {
1950
2014
  return;
1951
2015
  }
1952
2016
  if (userChanged) {
@@ -2004,7 +2068,7 @@ export const createSyncDb = (config: SyncDbConfig): SyncDb => {
2004
2068
  // up syncing when connectivity returns.
2005
2069
  warn("transport connect failed; starting offline")(error);
2006
2070
  }
2007
- if (generation !== myGeneration) {
2071
+ if (isCancelled()) {
2008
2072
  return;
2009
2073
  }
2010
2074
  subscribeConfiguredCollections();
@@ -2018,9 +2082,11 @@ export const createSyncDb = (config: SyncDbConfig): SyncDb => {
2018
2082
  isStarted = true;
2019
2083
  void replayOutbox().catch(warn("startup replay failed"));
2020
2084
  });
2085
+ };
2021
2086
 
2022
- const stop = async (): Promise<void> =>
2023
- withLifecycle(async (): Promise<void> => {
2087
+ const stop = async (): Promise<void> => {
2088
+ stopRequests += 1;
2089
+ return withLifecycle(async (): Promise<void> => {
2024
2090
  generation += 1;
2025
2091
  isStarted = false;
2026
2092
  closeDebugBridge();
@@ -2051,6 +2117,7 @@ export const createSyncDb = (config: SyncDbConfig): SyncDb => {
2051
2117
  await persisterToStop.destroy();
2052
2118
  }
2053
2119
  });
2120
+ };
2054
2121
 
2055
2122
  const goOffline = (): void => {
2056
2123
  if (simulatedOffline) {
@@ -2097,8 +2164,16 @@ export const createSyncDb = (config: SyncDbConfig): SyncDb => {
2097
2164
  if (operation !== "create" && !id) {
2098
2165
  throw new Error(`mutate() requires an id for ${operation}`);
2099
2166
  }
2167
+ const idFormat = config.idFormats?.[collection];
2168
+ // The server can never store this id; fail at the call site instead of queuing a
2169
+ // mutation it will reject.
2170
+ if (id && idFormat === "objectId" && !isObjectIdHex(id)) {
2171
+ throw new Error(
2172
+ `mutate() requires a 24-character hex ObjectId for ${collection}; got ${JSON.stringify(id)}`
2173
+ );
2174
+ }
2100
2175
  const mutationId = generateMutationId();
2101
- const entityId = id ?? generateMutationId();
2176
+ const entityId = id ?? generateEntityId(idFormat);
2102
2177
  const existing = store.getEntity<Record<string, unknown> | null>({collection, id: entityId});
2103
2178
 
2104
2179
  if (operation === "delete") {
@@ -2330,8 +2405,9 @@ export const createSyncDb = (config: SyncDbConfig): SyncDb => {
2330
2405
  * reconcile/replay from the signed-out session sees itself superseded and
2331
2406
  * stands down instead of writing into a store that no longer has an owner.
2332
2407
  */
2333
- const signOut = async (): Promise<void> =>
2334
- withLifecycle(async (): Promise<void> => {
2408
+ const signOut = async (): Promise<void> => {
2409
+ stopRequests += 1;
2410
+ return withLifecycle(async (): Promise<void> => {
2335
2411
  generation += 1;
2336
2412
  isStarted = false;
2337
2413
  closeDebugBridge();
@@ -2376,6 +2452,14 @@ export const createSyncDb = (config: SyncDbConfig): SyncDb => {
2376
2452
  await persisterToStop.destroy();
2377
2453
  }
2378
2454
  });
2455
+ };
2456
+
2457
+ const onSocketEvent = (event: string, handler: SocketEventHandler): (() => void) => {
2458
+ if (!transport.onEvent) {
2459
+ return () => {};
2460
+ }
2461
+ return transport.onEvent(event, handler);
2462
+ };
2379
2463
 
2380
2464
  const client: SyncDb = {
2381
2465
  debug: debugLog,
@@ -2385,6 +2469,7 @@ export const createSyncDb = (config: SyncDbConfig): SyncDb => {
2385
2469
  goOnline,
2386
2470
  hydrateWindow,
2387
2471
  mutate,
2472
+ onSocketEvent,
2388
2473
  onStatusChange,
2389
2474
  outbox,
2390
2475
  queryWindows,
@@ -58,4 +58,70 @@ describe("terreno-syncdb-codegen CLI", () => {
58
58
  await rm(dir, {force: true, recursive: true});
59
59
  }
60
60
  });
61
+
62
+ it("writes the API SDK with --api-out alone", async () => {
63
+ const dir = await mkdtemp(join(tmpdir(), "syncdb-cli-"));
64
+ const apiOut = join(dir, "apiSdk.ts");
65
+ const apiFixture = join(import.meta.dir, "fixtures", "openapi.api.json");
66
+ try {
67
+ const proc = Bun.spawn(
68
+ ["bun", cliPath, "--schema", apiFixture, "--api-out", apiOut, "--no-format"],
69
+ {stderr: "pipe", stdout: "pipe"}
70
+ );
71
+ expect(await proc.exited).toBe(0);
72
+ const source = await readFile(apiOut, "utf8");
73
+ expect(source).toContain("export const useGetAuthMeQuery");
74
+ expect(source).not.toContain("useGetTodosQuery");
75
+ } finally {
76
+ await rm(dir, {force: true, recursive: true});
77
+ }
78
+ });
79
+
80
+ it("drops --config excludePaths from the API SDK", async () => {
81
+ const dir = await mkdtemp(join(tmpdir(), "syncdb-cli-"));
82
+ const apiOut = join(dir, "apiSdk.ts");
83
+ const configPath = join(dir, "config.json");
84
+ const apiFixture = join(import.meta.dir, "fixtures", "openapi.api.json");
85
+ try {
86
+ await writeFile(configPath, JSON.stringify({excludePaths: ["/auth/", "^/files/upload$"]}));
87
+ const proc = Bun.spawn(
88
+ [
89
+ "bun",
90
+ cliPath,
91
+ "--schema",
92
+ apiFixture,
93
+ "--api-out",
94
+ apiOut,
95
+ "--config",
96
+ configPath,
97
+ "--no-format",
98
+ ],
99
+ {stderr: "pipe", stdout: "pipe"}
100
+ );
101
+ expect(await proc.exited).toBe(0);
102
+ const source = await readFile(apiOut, "utf8");
103
+ expect(source).not.toContain("export const useGetAuthMeQuery");
104
+ expect(source).not.toContain("export const usePostFilesUploadMutation");
105
+ expect(source).toContain("export const useGetFilesByGcsKeyQuery");
106
+ expect(source).toContain("export const useGetVersionCheckQuery");
107
+ } finally {
108
+ await rm(dir, {force: true, recursive: true});
109
+ }
110
+ });
111
+
112
+ it("exits 1 with the error message when the spec has clashing operation names", async () => {
113
+ const dir = await mkdtemp(join(tmpdir(), "syncdb-cli-"));
114
+ const spec = join(dir, "clash.json");
115
+ try {
116
+ await writeFile(spec, JSON.stringify({paths: {"/a_b": {get: {}}, "/a-b": {get: {}}}}));
117
+ const proc = Bun.spawn(
118
+ ["bun", cliPath, "--schema", spec, "--api-out", join(dir, "x.ts"), "--no-format"],
119
+ {stderr: "pipe", stdout: "pipe"}
120
+ );
121
+ expect(await proc.exited).toBe(1);
122
+ expect(await new Response(proc.stderr).text()).toContain('both generate "getAB"');
123
+ } finally {
124
+ await rm(dir, {force: true, recursive: true});
125
+ }
126
+ });
61
127
  });
@@ -2,17 +2,20 @@
2
2
 
3
3
  import {parseArgs} from "node:util";
4
4
 
5
- import {generateSyncDbSdk, loadConfigFile, parseCollectionsFlag} from "./generate";
5
+ import {generateApiSdk, generateSyncDbSdk, loadConfigFile, parseCollectionsFlag} from "./generate";
6
6
 
7
7
  const printUsage = (): void => {
8
- console.error(`Usage: terreno-syncdb-codegen --schema <url|path> --out <file> [options]
8
+ console.error(`Usage: terreno-syncdb-codegen --schema <url|path> [--out <file>] [--api-out <file>] [options]
9
9
 
10
10
  Options:
11
11
  --schema <url|path> OpenAPI document (required)
12
- --out <file> Output TypeScript path (required)
12
+ --out <file> Synced-collection SDK output (collection hooks, SYNC_COLLECTIONS)
13
+ --api-out <file> API SDK output (typed hooks for every non-synced route)
13
14
  --collections a,b Allowlist / fallback collection names
14
- --config <json> Optional {overrides: {todos: {retries: false}}}
15
+ --config <json> Optional {overrides: {todos: {retries: false}}, excludePaths: ["/admin/"]}
15
16
  --no-format Skip biome formatting
17
+
18
+ At least one of --out or --api-out is required.
16
19
  `);
17
20
  };
18
21
 
@@ -20,6 +23,7 @@ const main = async (): Promise<void> => {
20
23
  const {values} = parseArgs({
21
24
  allowPositionals: false,
22
25
  options: {
26
+ "api-out": {type: "string"},
23
27
  collections: {type: "string"},
24
28
  config: {type: "string"},
25
29
  "no-format": {default: false, type: "boolean"},
@@ -29,19 +33,26 @@ const main = async (): Promise<void> => {
29
33
  strict: true,
30
34
  });
31
35
 
32
- if (!values.schema || !values.out) {
36
+ if (!values.schema || (!values.out && !values["api-out"])) {
33
37
  printUsage();
34
38
  process.exit(1);
35
39
  }
36
40
 
37
41
  try {
38
- await generateSyncDbSdk({
39
- collections: parseCollectionsFlag(values.collections),
40
- config: await loadConfigFile(values.config),
41
- format: values["no-format"] !== true,
42
- out: values.out,
43
- schema: values.schema,
44
- });
42
+ const config = await loadConfigFile(values.config);
43
+ const format = values["no-format"] !== true;
44
+ if (values.out) {
45
+ await generateSyncDbSdk({
46
+ collections: parseCollectionsFlag(values.collections),
47
+ config,
48
+ format,
49
+ out: values.out,
50
+ schema: values.schema,
51
+ });
52
+ }
53
+ if (values["api-out"]) {
54
+ await generateApiSdk({config, format, out: values["api-out"], schema: values.schema});
55
+ }
45
56
  } catch (error) {
46
57
  const message = error instanceof Error ? error.message : String(error);
47
58
  console.error(message);
@@ -37,6 +37,10 @@ const listItemSchema = (
37
37
 
38
38
  const fallbackEntityName = (collection: string): string => {
39
39
  const pascal = toPascalCase(collection);
40
+ // `gpt/histories` → GptHistory, not GptHistorie.
41
+ if (pascal.endsWith("ies") && pascal.length > 3) {
42
+ return `${pascal.slice(0, -3)}y`;
43
+ }
40
44
  if (pascal.endsWith("s") && pascal.length > 1) {
41
45
  return pascal.slice(0, -1);
42
46
  }
@@ -0,0 +1,172 @@
1
+ import {operationName} from "./hookNames";
2
+ import type {
3
+ DiscoveredOperation,
4
+ OpenApiDocument,
5
+ OpenApiOperation,
6
+ OpenApiParameter,
7
+ OpenApiSchema,
8
+ } from "./types";
9
+
10
+ const METHODS = ["get", "post", "put", "patch", "delete"] as const;
11
+
12
+ type Method = (typeof METHODS)[number];
13
+
14
+ const SUCCESS_CODES = ["200", "201", "202", "203", "204"];
15
+
16
+ const trimSlash = (path: string): string => (path.endsWith("/") ? path.slice(0, -1) : path);
17
+
18
+ /**
19
+ * Collection CRUD routes for synced collections: the list path (GET/POST) and its
20
+ * `/{param}` item path (GET/PATCH/PUT/DELETE). The local-first store owns those;
21
+ * actions under the same prefix (`/todos/{id}/markComplete`) stay in the API SDK.
22
+ */
23
+ const syncedCrudKeys = (spec: OpenApiDocument): Set<string> => {
24
+ const keys = new Set<string>();
25
+ const paths = Object.keys(spec.paths ?? {});
26
+ for (const [path, item] of Object.entries(spec.paths ?? {})) {
27
+ if (!item.get?.["x-terreno-sync"]?.collection) {
28
+ continue;
29
+ }
30
+ keys.add(`get ${path}`);
31
+ keys.add(`post ${path}`);
32
+ const base = trimSlash(path);
33
+ for (const candidate of paths) {
34
+ if (!candidate.startsWith(`${base}/`)) {
35
+ continue;
36
+ }
37
+ if (!/^\{[^/]+\}\/?$/.test(candidate.slice(base.length + 1))) {
38
+ continue;
39
+ }
40
+ for (const method of ["get", "patch", "put", "delete"]) {
41
+ keys.add(`${method} ${candidate}`);
42
+ }
43
+ }
44
+ }
45
+ return keys;
46
+ };
47
+
48
+ const isExcluded = (path: string, excludePaths: string[] | undefined): boolean =>
49
+ (excludePaths ?? []).some((pattern) =>
50
+ pattern.startsWith("^") ? new RegExp(pattern).test(path) : path.startsWith(pattern)
51
+ );
52
+
53
+ const pickBody = (operation: OpenApiOperation): DiscoveredOperation["body"] => {
54
+ const content = operation.requestBody?.content;
55
+ if (!content) {
56
+ return undefined;
57
+ }
58
+ const mediaType =
59
+ ["application/json", "multipart/form-data"].find((type) => content[type]) ??
60
+ Object.keys(content)[0];
61
+ if (!mediaType) {
62
+ return undefined;
63
+ }
64
+ return {
65
+ mediaType,
66
+ required: operation.requestBody?.required ?? true,
67
+ schema: content[mediaType]?.schema ?? {},
68
+ };
69
+ };
70
+
71
+ const pickResponse = (operation: OpenApiOperation): OpenApiSchema | null | undefined => {
72
+ const responses = operation.responses ?? {};
73
+ for (const code of SUCCESS_CODES) {
74
+ const schema = responses[code]?.content?.["application/json"]?.schema;
75
+ if (schema) {
76
+ return schema;
77
+ }
78
+ }
79
+ const hasOnlyNoContent = Boolean(responses["204"]) && !responses["200"] && !responses["201"];
80
+ return hasOnlyNoContent ? null : undefined;
81
+ };
82
+
83
+ const paramsIn = (operation: OpenApiOperation, location: string): OpenApiParameter[] =>
84
+ (operation.parameters ?? []).filter((param) => param.in === location && param.name);
85
+
86
+ /**
87
+ * Express keeps `:name` and Express 5 `*name` segments in some spec keys. Read both as
88
+ * `{name}`; `*name` params may contain slashes, so they are recorded as wildcards.
89
+ */
90
+ const normalizePath = (path: string): {path: string; wildcards: string[]} => {
91
+ const wildcards: string[] = [];
92
+ const normalized = path
93
+ .split("/")
94
+ .map((segment) => {
95
+ const match = segment.match(/^([:*])([A-Za-z_$][A-Za-z0-9_$]*)$/);
96
+ if (!match) {
97
+ return segment;
98
+ }
99
+ if (match[1] === "*") {
100
+ wildcards.push(match[2]);
101
+ }
102
+ return `{${match[2]}}`;
103
+ })
104
+ .join("/");
105
+ return {path: normalized, wildcards};
106
+ };
107
+
108
+ /**
109
+ * Every OpenAPI operation the API SDK should emit a hook for: everything except
110
+ * synced collection CRUD and `excludePaths`. Throws when two operations would
111
+ * generate the same hook name.
112
+ */
113
+ export const discoverOperations = ({
114
+ excludePaths,
115
+ spec,
116
+ }: {
117
+ excludePaths?: string[];
118
+ spec: OpenApiDocument;
119
+ }): DiscoveredOperation[] => {
120
+ const synced = syncedCrudKeys(spec);
121
+ const operations: DiscoveredOperation[] = [];
122
+ const seen = new Map<string, string>();
123
+ for (const [path, item] of Object.entries(spec.paths ?? {})) {
124
+ if (isExcluded(path, excludePaths)) {
125
+ continue;
126
+ }
127
+ for (const method of METHODS) {
128
+ const operation = item[method as Method];
129
+ if (!operation || synced.has(`${method} ${path}`)) {
130
+ continue;
131
+ }
132
+ const normalized = normalizePath(path);
133
+ const name = operationName({
134
+ method,
135
+ operationId: operation.operationId,
136
+ path: normalized.path,
137
+ });
138
+ const where = `${method.toUpperCase()} ${path}`;
139
+ const templateParams = new Set(
140
+ [...normalized.path.matchAll(/\{([^}]+)\}/g)].map(([, param]) => param)
141
+ );
142
+ const strayParam = paramsIn(operation, "path").find(
143
+ (param) => !templateParams.has(param.name ?? "")
144
+ );
145
+ if (strayParam) {
146
+ throw new Error(
147
+ `${where} declares path param "${strayParam.name}" that its path does not contain.`
148
+ );
149
+ }
150
+ const clash = seen.get(name);
151
+ if (clash) {
152
+ throw new Error(
153
+ `Operations ${clash} and ${where} both generate "${name}". Give one an operationId.`
154
+ );
155
+ }
156
+ seen.set(name, where);
157
+ operations.push({
158
+ body: pickBody(operation),
159
+ method,
160
+ name,
161
+ path: normalized.path,
162
+ pathParams: paramsIn(operation, "path"),
163
+ queryParams: paramsIn(operation, "query"),
164
+ response: pickResponse(operation),
165
+ summary: operation.summary,
166
+ tags: operation.tags ?? [],
167
+ wildcardParams: normalized.wildcards,
168
+ });
169
+ }
170
+ }
171
+ return operations;
172
+ };