appwrite-utils-cli 1.9.7 → 1.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (425) hide show
  1. package/CONFIG_TODO.md +1189 -1189
  2. package/README.md +1004 -1004
  3. package/SELECTION_DIALOGS.md +145 -145
  4. package/SERVICE_IMPLEMENTATION_REPORT.md +462 -462
  5. package/package.json +6 -3
  6. package/scripts/copy-templates.ts +23 -23
  7. package/src/adapters/index.ts +11 -37
  8. package/src/backups/operations/bucketBackup.ts +277 -277
  9. package/src/backups/operations/collectionBackup.ts +310 -310
  10. package/src/backups/operations/comprehensiveBackup.ts +342 -342
  11. package/src/backups/schemas/bucketManifest.ts +78 -78
  12. package/src/backups/schemas/comprehensiveManifest.ts +76 -76
  13. package/src/backups/tracking/centralizedTracking.ts +352 -352
  14. package/src/cli/commands/configCommands.ts +265 -201
  15. package/src/cli/commands/databaseCommands.ts +931 -879
  16. package/src/cli/commands/functionCommands.ts +333 -332
  17. package/src/cli/commands/importFileCommands.ts +815 -0
  18. package/src/cli/commands/schemaCommands.ts +141 -141
  19. package/src/cli/commands/storageCommands.ts +2 -3
  20. package/src/cli/commands/transferCommands.ts +454 -457
  21. package/src/collections/attributes.ts.backup +1555 -1555
  22. package/src/collections/{attributes.ts → columns.ts} +15 -10
  23. package/src/collections/indexes.ts +350 -352
  24. package/src/collections/methods.ts +714 -700
  25. package/src/collections/tableOperations.ts +29 -8
  26. package/src/collections/transferOperations.ts +376 -377
  27. package/src/collections/wipeOperations.ts +449 -346
  28. package/src/databases/methods.ts +49 -49
  29. package/src/databases/setup.ts +77 -77
  30. package/src/examples/yamlTerminologyExample.ts +346 -346
  31. package/src/functions/deployments.ts +221 -220
  32. package/src/functions/fnConfigDiscovery.ts +2 -2
  33. package/src/functions/methods.ts +284 -284
  34. package/src/functions/templates/count-docs-in-collection/README.md +53 -53
  35. package/src/functions/templates/count-docs-in-collection/src/main.ts +159 -159
  36. package/src/functions/templates/count-docs-in-collection/src/request.ts +8 -8
  37. package/src/functions/templates/hono-typescript/README.md +285 -285
  38. package/src/functions/templates/hono-typescript/src/adapters/request.ts +73 -73
  39. package/src/functions/templates/hono-typescript/src/adapters/response.ts +105 -105
  40. package/src/functions/templates/hono-typescript/src/app.ts +179 -179
  41. package/src/functions/templates/hono-typescript/src/context.ts +102 -102
  42. package/src/functions/templates/hono-typescript/src/{index.ts → main.ts} +53 -53
  43. package/src/functions/templates/hono-typescript/src/middleware/appwrite.ts +118 -118
  44. package/src/functions/templates/typescript-node/README.md +31 -31
  45. package/src/functions/templates/typescript-node/src/context.ts +102 -102
  46. package/src/functions/templates/typescript-node/src/{index.ts → main.ts} +29 -29
  47. package/src/functions/templates/uv/README.md +30 -30
  48. package/src/functions/templates/uv/pyproject.toml +29 -29
  49. package/src/functions/templates/uv/src/context.py +124 -124
  50. package/src/functions/templates/uv/src/{index.py → main.py} +45 -45
  51. package/src/init.ts +62 -62
  52. package/src/interactiveCLI.ts +1095 -1030
  53. package/src/main.ts +1517 -1670
  54. package/src/migrations/afterImportActions.ts +579 -580
  55. package/src/migrations/appwriteToX.ts +634 -630
  56. package/src/migrations/comprehensiveTransfer.ts +2149 -2149
  57. package/src/migrations/dataLoader.ts +1729 -1702
  58. package/src/migrations/importController.ts +440 -428
  59. package/src/migrations/importDataActions.ts +315 -315
  60. package/src/migrations/relationships.ts +333 -334
  61. package/src/migrations/services/DataTransformationService.ts +195 -195
  62. package/src/migrations/services/FileHandlerService.ts +310 -310
  63. package/src/migrations/services/ImportOrchestrator.ts +674 -665
  64. package/src/migrations/services/RateLimitManager.ts +362 -362
  65. package/src/migrations/services/RelationshipResolver.ts +460 -460
  66. package/src/migrations/services/UserMappingService.ts +344 -344
  67. package/src/migrations/services/ValidationService.ts +333 -333
  68. package/src/migrations/transfer.ts +987 -942
  69. package/src/migrations/yaml/YamlImportConfigLoader.ts +438 -438
  70. package/src/migrations/yaml/YamlImportIntegration.ts +438 -438
  71. package/src/migrations/yaml/generateImportSchemas.ts +1347 -1347
  72. package/src/schemas/authUser.ts +23 -23
  73. package/src/setup.ts +8 -8
  74. package/src/setupCommands.ts +5 -6
  75. package/src/setupController.ts +42 -42
  76. package/src/shared/backupMetadataSchema.ts +93 -93
  77. package/src/shared/backupTracking.ts +211 -211
  78. package/src/shared/confirmationDialogs.ts +326 -326
  79. package/src/shared/migrationHelpers.ts +232 -232
  80. package/src/shared/operationLogger.ts +20 -20
  81. package/src/shared/operationQueue.ts +326 -327
  82. package/src/shared/operationsTable.ts +338 -338
  83. package/src/shared/operationsTableSchema.ts +60 -60
  84. package/src/shared/progressManager.ts +277 -277
  85. package/src/shared/relationshipExtractor.ts +214 -214
  86. package/src/shared/selectionDialogs.ts +775 -722
  87. package/src/storage/backupCompression.ts +88 -88
  88. package/src/storage/methods.ts +695 -682
  89. package/src/storage/schemas.ts +205 -205
  90. package/src/tables/indexManager.ts +408 -408
  91. package/src/types/node-appwrite-tablesdb.d.ts +43 -43
  92. package/src/types.ts +9 -9
  93. package/src/users/methods.ts +358 -359
  94. package/src/utils/configMigration.ts +347 -347
  95. package/src/utils/index.ts +2 -2
  96. package/src/utils/loadConfigs.ts +457 -449
  97. package/src/utils/setupFiles.ts +1236 -1238
  98. package/src/utilsController.ts +1263 -1213
  99. package/tests/README.md +496 -496
  100. package/tests/adapters/AdapterFactory.test.ts +276 -276
  101. package/tests/integration/syncOperations.test.ts +462 -462
  102. package/tests/jest.config.js +24 -24
  103. package/tests/migration/configMigration.test.ts +545 -545
  104. package/tests/setup.ts +61 -61
  105. package/tests/testUtils.ts +339 -339
  106. package/tests/utils/loadConfigs.test.ts +349 -349
  107. package/tests/validation/configValidation.test.ts +411 -411
  108. package/tsconfig.json +44 -44
  109. package/.appwrite/.yaml_schemas/appwrite-config.schema.json +0 -380
  110. package/.appwrite/.yaml_schemas/collection.schema.json +0 -255
  111. package/.appwrite/collections/Categories.yaml +0 -182
  112. package/.appwrite/collections/ExampleCollection.yaml +0 -36
  113. package/.appwrite/collections/Posts.yaml +0 -227
  114. package/.appwrite/collections/Users.yaml +0 -149
  115. package/.appwrite/config.yaml +0 -109
  116. package/.appwrite/import/README.md +0 -148
  117. package/.appwrite/import/categories-import.yaml +0 -129
  118. package/.appwrite/import/posts-import.yaml +0 -208
  119. package/.appwrite/import/users-import.yaml +0 -130
  120. package/.appwrite/importData/categories.json +0 -194
  121. package/.appwrite/importData/posts.json +0 -270
  122. package/.appwrite/importData/users.json +0 -220
  123. package/.appwrite/schemas/categories.json +0 -128
  124. package/.appwrite/schemas/exampleCollection.json +0 -52
  125. package/.appwrite/schemas/posts.json +0 -173
  126. package/.appwrite/schemas/users.json +0 -125
  127. package/dist/adapters/AdapterFactory.d.ts +0 -94
  128. package/dist/adapters/AdapterFactory.js +0 -420
  129. package/dist/adapters/DatabaseAdapter.d.ts +0 -243
  130. package/dist/adapters/DatabaseAdapter.js +0 -50
  131. package/dist/adapters/LegacyAdapter.d.ts +0 -50
  132. package/dist/adapters/LegacyAdapter.js +0 -615
  133. package/dist/adapters/TablesDBAdapter.d.ts +0 -45
  134. package/dist/adapters/TablesDBAdapter.js +0 -611
  135. package/dist/adapters/index.d.ts +0 -11
  136. package/dist/adapters/index.js +0 -12
  137. package/dist/backups/operations/bucketBackup.d.ts +0 -19
  138. package/dist/backups/operations/bucketBackup.js +0 -197
  139. package/dist/backups/operations/collectionBackup.d.ts +0 -30
  140. package/dist/backups/operations/collectionBackup.js +0 -201
  141. package/dist/backups/operations/comprehensiveBackup.d.ts +0 -25
  142. package/dist/backups/operations/comprehensiveBackup.js +0 -238
  143. package/dist/backups/schemas/bucketManifest.d.ts +0 -93
  144. package/dist/backups/schemas/bucketManifest.js +0 -33
  145. package/dist/backups/schemas/comprehensiveManifest.d.ts +0 -108
  146. package/dist/backups/schemas/comprehensiveManifest.js +0 -32
  147. package/dist/backups/tracking/centralizedTracking.d.ts +0 -34
  148. package/dist/backups/tracking/centralizedTracking.js +0 -274
  149. package/dist/cli/commands/configCommands.d.ts +0 -8
  150. package/dist/cli/commands/configCommands.js +0 -166
  151. package/dist/cli/commands/databaseCommands.d.ts +0 -14
  152. package/dist/cli/commands/databaseCommands.js +0 -644
  153. package/dist/cli/commands/functionCommands.d.ts +0 -7
  154. package/dist/cli/commands/functionCommands.js +0 -330
  155. package/dist/cli/commands/schemaCommands.d.ts +0 -7
  156. package/dist/cli/commands/schemaCommands.js +0 -169
  157. package/dist/cli/commands/storageCommands.d.ts +0 -5
  158. package/dist/cli/commands/storageCommands.js +0 -143
  159. package/dist/cli/commands/transferCommands.d.ts +0 -5
  160. package/dist/cli/commands/transferCommands.js +0 -384
  161. package/dist/collections/attributes.d.ts +0 -13
  162. package/dist/collections/attributes.js +0 -1333
  163. package/dist/collections/indexes.d.ts +0 -12
  164. package/dist/collections/indexes.js +0 -217
  165. package/dist/collections/methods.d.ts +0 -19
  166. package/dist/collections/methods.js +0 -587
  167. package/dist/collections/tableOperations.d.ts +0 -86
  168. package/dist/collections/tableOperations.js +0 -447
  169. package/dist/collections/transferOperations.d.ts +0 -8
  170. package/dist/collections/transferOperations.js +0 -412
  171. package/dist/collections/wipeOperations.d.ts +0 -16
  172. package/dist/collections/wipeOperations.js +0 -233
  173. package/dist/config/ConfigManager.d.ts +0 -450
  174. package/dist/config/ConfigManager.js +0 -650
  175. package/dist/config/configMigration.d.ts +0 -87
  176. package/dist/config/configMigration.js +0 -390
  177. package/dist/config/configValidation.d.ts +0 -66
  178. package/dist/config/configValidation.js +0 -358
  179. package/dist/config/index.d.ts +0 -8
  180. package/dist/config/index.js +0 -7
  181. package/dist/config/services/ConfigDiscoveryService.d.ts +0 -122
  182. package/dist/config/services/ConfigDiscoveryService.js +0 -322
  183. package/dist/config/services/ConfigLoaderService.d.ts +0 -129
  184. package/dist/config/services/ConfigLoaderService.js +0 -535
  185. package/dist/config/services/ConfigMergeService.d.ts +0 -208
  186. package/dist/config/services/ConfigMergeService.js +0 -308
  187. package/dist/config/services/ConfigValidationService.d.ts +0 -214
  188. package/dist/config/services/ConfigValidationService.js +0 -310
  189. package/dist/config/services/SessionAuthService.d.ts +0 -225
  190. package/dist/config/services/SessionAuthService.js +0 -456
  191. package/dist/config/services/__tests__/ConfigMergeService.test.d.ts +0 -1
  192. package/dist/config/services/__tests__/ConfigMergeService.test.js +0 -271
  193. package/dist/config/services/index.d.ts +0 -13
  194. package/dist/config/services/index.js +0 -10
  195. package/dist/config/yamlConfig.d.ts +0 -722
  196. package/dist/config/yamlConfig.js +0 -702
  197. package/dist/databases/methods.d.ts +0 -6
  198. package/dist/databases/methods.js +0 -35
  199. package/dist/databases/setup.d.ts +0 -5
  200. package/dist/databases/setup.js +0 -45
  201. package/dist/examples/yamlTerminologyExample.d.ts +0 -42
  202. package/dist/examples/yamlTerminologyExample.js +0 -272
  203. package/dist/functions/deployments.d.ts +0 -4
  204. package/dist/functions/deployments.js +0 -146
  205. package/dist/functions/fnConfigDiscovery.d.ts +0 -3
  206. package/dist/functions/fnConfigDiscovery.js +0 -108
  207. package/dist/functions/methods.d.ts +0 -16
  208. package/dist/functions/methods.js +0 -174
  209. package/dist/functions/pathResolution.d.ts +0 -37
  210. package/dist/functions/pathResolution.js +0 -185
  211. package/dist/functions/templates/count-docs-in-collection/README.md +0 -54
  212. package/dist/functions/templates/count-docs-in-collection/package.json +0 -25
  213. package/dist/functions/templates/count-docs-in-collection/src/main.ts +0 -159
  214. package/dist/functions/templates/count-docs-in-collection/src/request.ts +0 -9
  215. package/dist/functions/templates/count-docs-in-collection/tsconfig.json +0 -28
  216. package/dist/functions/templates/hono-typescript/README.md +0 -286
  217. package/dist/functions/templates/hono-typescript/package.json +0 -26
  218. package/dist/functions/templates/hono-typescript/src/adapters/request.ts +0 -74
  219. package/dist/functions/templates/hono-typescript/src/adapters/response.ts +0 -106
  220. package/dist/functions/templates/hono-typescript/src/app.ts +0 -180
  221. package/dist/functions/templates/hono-typescript/src/context.ts +0 -103
  222. package/dist/functions/templates/hono-typescript/src/index.ts +0 -54
  223. package/dist/functions/templates/hono-typescript/src/middleware/appwrite.ts +0 -119
  224. package/dist/functions/templates/hono-typescript/tsconfig.json +0 -20
  225. package/dist/functions/templates/typescript-node/README.md +0 -32
  226. package/dist/functions/templates/typescript-node/package.json +0 -25
  227. package/dist/functions/templates/typescript-node/src/context.ts +0 -103
  228. package/dist/functions/templates/typescript-node/src/index.ts +0 -29
  229. package/dist/functions/templates/typescript-node/tsconfig.json +0 -28
  230. package/dist/functions/templates/uv/README.md +0 -31
  231. package/dist/functions/templates/uv/pyproject.toml +0 -30
  232. package/dist/functions/templates/uv/src/__init__.py +0 -0
  233. package/dist/functions/templates/uv/src/context.py +0 -125
  234. package/dist/functions/templates/uv/src/index.py +0 -46
  235. package/dist/init.d.ts +0 -2
  236. package/dist/init.js +0 -57
  237. package/dist/interactiveCLI.d.ts +0 -31
  238. package/dist/interactiveCLI.js +0 -898
  239. package/dist/main.d.ts +0 -2
  240. package/dist/main.js +0 -1180
  241. package/dist/migrations/afterImportActions.d.ts +0 -17
  242. package/dist/migrations/afterImportActions.js +0 -306
  243. package/dist/migrations/appwriteToX.d.ts +0 -211
  244. package/dist/migrations/appwriteToX.js +0 -491
  245. package/dist/migrations/comprehensiveTransfer.d.ts +0 -147
  246. package/dist/migrations/comprehensiveTransfer.js +0 -1317
  247. package/dist/migrations/dataLoader.d.ts +0 -753
  248. package/dist/migrations/dataLoader.js +0 -1250
  249. package/dist/migrations/importController.d.ts +0 -23
  250. package/dist/migrations/importController.js +0 -268
  251. package/dist/migrations/importDataActions.d.ts +0 -50
  252. package/dist/migrations/importDataActions.js +0 -230
  253. package/dist/migrations/relationships.d.ts +0 -29
  254. package/dist/migrations/relationships.js +0 -204
  255. package/dist/migrations/services/DataTransformationService.d.ts +0 -55
  256. package/dist/migrations/services/DataTransformationService.js +0 -158
  257. package/dist/migrations/services/FileHandlerService.d.ts +0 -75
  258. package/dist/migrations/services/FileHandlerService.js +0 -236
  259. package/dist/migrations/services/ImportOrchestrator.d.ts +0 -97
  260. package/dist/migrations/services/ImportOrchestrator.js +0 -485
  261. package/dist/migrations/services/RateLimitManager.d.ts +0 -138
  262. package/dist/migrations/services/RateLimitManager.js +0 -279
  263. package/dist/migrations/services/RelationshipResolver.d.ts +0 -120
  264. package/dist/migrations/services/RelationshipResolver.js +0 -332
  265. package/dist/migrations/services/UserMappingService.d.ts +0 -109
  266. package/dist/migrations/services/UserMappingService.js +0 -277
  267. package/dist/migrations/services/ValidationService.d.ts +0 -74
  268. package/dist/migrations/services/ValidationService.js +0 -260
  269. package/dist/migrations/transfer.d.ts +0 -26
  270. package/dist/migrations/transfer.js +0 -608
  271. package/dist/migrations/yaml/YamlImportConfigLoader.d.ts +0 -131
  272. package/dist/migrations/yaml/YamlImportConfigLoader.js +0 -383
  273. package/dist/migrations/yaml/YamlImportIntegration.d.ts +0 -93
  274. package/dist/migrations/yaml/YamlImportIntegration.js +0 -341
  275. package/dist/migrations/yaml/generateImportSchemas.d.ts +0 -30
  276. package/dist/migrations/yaml/generateImportSchemas.js +0 -1327
  277. package/dist/schemas/authUser.d.ts +0 -24
  278. package/dist/schemas/authUser.js +0 -17
  279. package/dist/setup.d.ts +0 -2
  280. package/dist/setup.js +0 -5
  281. package/dist/setupCommands.d.ts +0 -58
  282. package/dist/setupCommands.js +0 -490
  283. package/dist/setupController.d.ts +0 -9
  284. package/dist/setupController.js +0 -34
  285. package/dist/shared/attributeMapper.d.ts +0 -20
  286. package/dist/shared/attributeMapper.js +0 -203
  287. package/dist/shared/backupMetadataSchema.d.ts +0 -94
  288. package/dist/shared/backupMetadataSchema.js +0 -38
  289. package/dist/shared/backupTracking.d.ts +0 -18
  290. package/dist/shared/backupTracking.js +0 -176
  291. package/dist/shared/confirmationDialogs.d.ts +0 -75
  292. package/dist/shared/confirmationDialogs.js +0 -236
  293. package/dist/shared/errorUtils.d.ts +0 -54
  294. package/dist/shared/errorUtils.js +0 -95
  295. package/dist/shared/functionManager.d.ts +0 -48
  296. package/dist/shared/functionManager.js +0 -348
  297. package/dist/shared/jsonSchemaGenerator.d.ts +0 -50
  298. package/dist/shared/jsonSchemaGenerator.js +0 -290
  299. package/dist/shared/logging.d.ts +0 -61
  300. package/dist/shared/logging.js +0 -116
  301. package/dist/shared/messageFormatter.d.ts +0 -39
  302. package/dist/shared/messageFormatter.js +0 -162
  303. package/dist/shared/migrationHelpers.d.ts +0 -61
  304. package/dist/shared/migrationHelpers.js +0 -145
  305. package/dist/shared/operationLogger.d.ts +0 -10
  306. package/dist/shared/operationLogger.js +0 -12
  307. package/dist/shared/operationQueue.d.ts +0 -40
  308. package/dist/shared/operationQueue.js +0 -311
  309. package/dist/shared/operationsTable.d.ts +0 -26
  310. package/dist/shared/operationsTable.js +0 -286
  311. package/dist/shared/operationsTableSchema.d.ts +0 -48
  312. package/dist/shared/operationsTableSchema.js +0 -35
  313. package/dist/shared/progressManager.d.ts +0 -62
  314. package/dist/shared/progressManager.js +0 -215
  315. package/dist/shared/pydanticModelGenerator.d.ts +0 -17
  316. package/dist/shared/pydanticModelGenerator.js +0 -615
  317. package/dist/shared/relationshipExtractor.d.ts +0 -56
  318. package/dist/shared/relationshipExtractor.js +0 -138
  319. package/dist/shared/schemaGenerator.d.ts +0 -40
  320. package/dist/shared/schemaGenerator.js +0 -556
  321. package/dist/shared/selectionDialogs.d.ts +0 -214
  322. package/dist/shared/selectionDialogs.js +0 -544
  323. package/dist/storage/backupCompression.d.ts +0 -20
  324. package/dist/storage/backupCompression.js +0 -67
  325. package/dist/storage/methods.d.ts +0 -32
  326. package/dist/storage/methods.js +0 -472
  327. package/dist/storage/schemas.d.ts +0 -842
  328. package/dist/storage/schemas.js +0 -175
  329. package/dist/tables/indexManager.d.ts +0 -65
  330. package/dist/tables/indexManager.js +0 -294
  331. package/dist/types.d.ts +0 -4
  332. package/dist/types.js +0 -3
  333. package/dist/users/methods.d.ts +0 -16
  334. package/dist/users/methods.js +0 -277
  335. package/dist/utils/ClientFactory.d.ts +0 -87
  336. package/dist/utils/ClientFactory.js +0 -212
  337. package/dist/utils/configDiscovery.d.ts +0 -78
  338. package/dist/utils/configDiscovery.js +0 -472
  339. package/dist/utils/configMigration.d.ts +0 -1
  340. package/dist/utils/configMigration.js +0 -261
  341. package/dist/utils/constantsGenerator.d.ts +0 -31
  342. package/dist/utils/constantsGenerator.js +0 -321
  343. package/dist/utils/dataConverters.d.ts +0 -46
  344. package/dist/utils/dataConverters.js +0 -139
  345. package/dist/utils/directoryUtils.d.ts +0 -22
  346. package/dist/utils/directoryUtils.js +0 -59
  347. package/dist/utils/getClientFromConfig.d.ts +0 -39
  348. package/dist/utils/getClientFromConfig.js +0 -199
  349. package/dist/utils/helperFunctions.d.ts +0 -63
  350. package/dist/utils/helperFunctions.js +0 -156
  351. package/dist/utils/index.d.ts +0 -2
  352. package/dist/utils/index.js +0 -2
  353. package/dist/utils/loadConfigs.d.ts +0 -50
  354. package/dist/utils/loadConfigs.js +0 -358
  355. package/dist/utils/pathResolvers.d.ts +0 -53
  356. package/dist/utils/pathResolvers.js +0 -72
  357. package/dist/utils/projectConfig.d.ts +0 -122
  358. package/dist/utils/projectConfig.js +0 -206
  359. package/dist/utils/retryFailedPromises.d.ts +0 -2
  360. package/dist/utils/retryFailedPromises.js +0 -23
  361. package/dist/utils/sessionAuth.d.ts +0 -48
  362. package/dist/utils/sessionAuth.js +0 -164
  363. package/dist/utils/setupFiles.d.ts +0 -4
  364. package/dist/utils/setupFiles.js +0 -1192
  365. package/dist/utils/typeGuards.d.ts +0 -35
  366. package/dist/utils/typeGuards.js +0 -57
  367. package/dist/utils/validationRules.d.ts +0 -43
  368. package/dist/utils/validationRules.js +0 -42
  369. package/dist/utils/versionDetection.d.ts +0 -58
  370. package/dist/utils/versionDetection.js +0 -251
  371. package/dist/utils/yamlConverter.d.ts +0 -100
  372. package/dist/utils/yamlConverter.js +0 -428
  373. package/dist/utils/yamlLoader.d.ts +0 -70
  374. package/dist/utils/yamlLoader.js +0 -267
  375. package/dist/utilsController.d.ts +0 -107
  376. package/dist/utilsController.js +0 -873
  377. package/src/adapters/AdapterFactory.ts +0 -529
  378. package/src/adapters/DatabaseAdapter.ts +0 -319
  379. package/src/adapters/LegacyAdapter.ts +0 -844
  380. package/src/adapters/TablesDBAdapter.ts +0 -823
  381. package/src/config/ConfigManager.ts +0 -849
  382. package/src/config/README.md +0 -274
  383. package/src/config/configMigration.ts +0 -575
  384. package/src/config/configValidation.ts +0 -445
  385. package/src/config/index.ts +0 -10
  386. package/src/config/services/ConfigDiscoveryService.ts +0 -410
  387. package/src/config/services/ConfigLoaderService.ts +0 -732
  388. package/src/config/services/ConfigMergeService.ts +0 -388
  389. package/src/config/services/ConfigValidationService.ts +0 -394
  390. package/src/config/services/SessionAuthService.ts +0 -565
  391. package/src/config/services/__tests__/ConfigMergeService.test.ts +0 -351
  392. package/src/config/services/index.ts +0 -29
  393. package/src/config/yamlConfig.ts +0 -761
  394. package/src/functions/pathResolution.ts +0 -227
  395. package/src/functions/templates/count-docs-in-collection/package.json +0 -25
  396. package/src/functions/templates/count-docs-in-collection/tsconfig.json +0 -28
  397. package/src/functions/templates/hono-typescript/package.json +0 -26
  398. package/src/functions/templates/hono-typescript/tsconfig.json +0 -20
  399. package/src/functions/templates/typescript-node/package.json +0 -25
  400. package/src/functions/templates/typescript-node/tsconfig.json +0 -28
  401. package/src/shared/attributeMapper.ts +0 -229
  402. package/src/shared/errorUtils.ts +0 -110
  403. package/src/shared/functionManager.ts +0 -537
  404. package/src/shared/jsonSchemaGenerator.ts +0 -383
  405. package/src/shared/logging.ts +0 -149
  406. package/src/shared/messageFormatter.ts +0 -208
  407. package/src/shared/pydanticModelGenerator.ts +0 -618
  408. package/src/shared/schemaGenerator.ts +0 -644
  409. package/src/utils/ClientFactory.ts +0 -240
  410. package/src/utils/configDiscovery.ts +0 -557
  411. package/src/utils/constantsGenerator.ts +0 -369
  412. package/src/utils/dataConverters.ts +0 -159
  413. package/src/utils/directoryUtils.ts +0 -61
  414. package/src/utils/getClientFromConfig.ts +0 -257
  415. package/src/utils/helperFunctions.ts +0 -228
  416. package/src/utils/pathResolvers.ts +0 -81
  417. package/src/utils/projectConfig.ts +0 -340
  418. package/src/utils/retryFailedPromises.ts +0 -29
  419. package/src/utils/sessionAuth.ts +0 -230
  420. package/src/utils/typeGuards.ts +0 -65
  421. package/src/utils/validationRules.ts +0 -88
  422. package/src/utils/versionDetection.ts +0 -292
  423. package/src/utils/yamlConverter.ts +0 -542
  424. package/src/utils/yamlLoader.ts +0 -371
  425. package/tmp-sync-test/.appwrite/collections/TestCollection.yaml +0 -7
@@ -4,17 +4,16 @@ import {
4
4
  ID,
5
5
  Query,
6
6
  } from "node-appwrite";
7
- import { tryAwaitWithRetry, delay, calculateExponentialBackoff } from "../utils/helperFunctions.js";
8
- import { MessageFormatter } from "../shared/messageFormatter.js";
7
+ import { tryAwaitWithRetry, delay, calculateExponentialBackoff, MessageFormatter } from "appwrite-utils-helpers";
9
8
  import { chunk } from "es-toolkit";
10
- import type { DatabaseAdapter } from "../adapters/DatabaseAdapter.js";
11
- import { isLegacyDatabases } from "../utils/typeGuards.js";
12
- import { getAdapter } from "../utils/getClientFromConfig.js";
13
-
14
- /**
15
- * Transfers all documents from one collection to another in a different database
16
- * within the same Appwrite Project
17
- */
9
+ import type { DatabaseAdapter } from "appwrite-utils-helpers";
10
+ import { isLegacyDatabases } from "appwrite-utils-helpers";
11
+ import { getAdapter } from "appwrite-utils-helpers";
12
+
13
+ /**
14
+ * Transfers all documents from one collection to another in a different database
15
+ * within the same Appwrite Project
16
+ */
18
17
  export const transferDocumentsBetweenDbsLocalToLocal = async (
19
18
  db: Databases | DatabaseAdapter,
20
19
  fromDbId: string,
@@ -172,327 +171,327 @@ export const transferDocumentsBetweenDbsLocalToLocal = async (
172
171
  { prefix: "Transfer" }
173
172
  );
174
173
  };
175
-
176
- /**
177
- * Enhanced document transfer with fault tolerance and exponential backoff
178
- */
179
- const transferDocumentWithRetry = async (
180
- db: Databases,
181
- dbId: string,
182
- collectionId: string,
183
- documentId: string,
184
- documentData: any,
185
- permissions: string[],
186
- maxRetries: number = 3,
187
- retryCount: number = 0
188
- ): Promise<boolean> => {
189
- try {
190
- await db.createDocument(
191
- dbId,
192
- collectionId,
193
- documentId,
194
- documentData,
195
- permissions
196
- );
197
- return true;
198
- } catch (error: any) {
199
- // Check if document already exists
200
- if (error.code === 409 || error.message?.toLowerCase().includes('already exists')) {
201
- await db.updateDocument(
202
- dbId,
203
- collectionId,
204
- documentId,
205
- documentData,
206
- permissions
207
- );
208
- }
209
-
210
- if (retryCount < maxRetries) {
211
- // Calculate exponential backoff: 1s, 2s, 4s, max 8s
212
- const exponentialDelay = calculateExponentialBackoff(retryCount, 1000, 8000);
213
- MessageFormatter.progress(`Retrying document ${documentId} (attempt ${retryCount + 1}/${maxRetries}, backoff: ${exponentialDelay}ms)`, { prefix: "Transfer" });
214
-
215
- await delay(exponentialDelay);
216
-
217
- return await transferDocumentWithRetry(
218
- db,
219
- dbId,
220
- collectionId,
221
- documentId,
222
- documentData,
223
- permissions,
224
- maxRetries,
225
- retryCount + 1
226
- );
227
- }
228
-
229
- MessageFormatter.error(`Failed to transfer document ${documentId} after ${maxRetries} retries`, error, { prefix: "Transfer" });
230
- return false;
231
- }
232
- };
233
-
234
- /**
235
- * Check if endpoint supports bulk operations (cloud.appwrite.io)
236
- */
237
- const supportsBulkOperations = (endpoint: string): boolean => {
238
- return endpoint.includes('cloud.appwrite.io');
239
- };
240
-
241
- /**
242
- * Direct HTTP implementation of bulk upsert API
243
- */
244
- const bulkUpsertDocuments = async (
245
- client: any,
246
- dbId: string,
247
- collectionId: string,
248
- documents: any[]
249
- ): Promise<any> => {
250
- const apiPath = `/databases/${dbId}/collections/${collectionId}/documents`;
251
- const url = new URL(client.config.endpoint + apiPath);
252
-
253
- const headers = {
254
- 'Content-Type': 'application/json',
255
- 'X-Appwrite-Project': client.config.project,
256
- 'X-Appwrite-Key': client.config.key
257
- };
258
-
259
- const response = await fetch(url.toString(), {
260
- method: 'PUT',
261
- headers,
262
- body: JSON.stringify({ documents })
263
- });
264
-
265
- if (!response.ok) {
266
- const errorData: any = await response.json().catch(() => ({ message: 'Unknown error' }));
267
- throw new Error(`Bulk upsert failed: ${response.status} - ${errorData.message || 'Unknown error'}`);
268
- }
269
-
270
- return await response.json();
271
- };
272
-
273
- /**
274
- * Direct HTTP implementation of bulk create API
275
- */
276
- const bulkCreateDocuments = async (
277
- client: any,
278
- dbId: string,
279
- collectionId: string,
280
- documents: any[]
281
- ): Promise<any> => {
282
- const apiPath = `/databases/${dbId}/collections/${collectionId}/documents`;
283
- const url = new URL(client.config.endpoint + apiPath);
284
-
285
- const headers = {
286
- 'Content-Type': 'application/json',
287
- 'X-Appwrite-Project': client.config.project,
288
- 'X-Appwrite-Key': client.config.key
289
- };
290
-
291
- const response = await fetch(url.toString(), {
292
- method: 'POST',
293
- headers,
294
- body: JSON.stringify({ documents })
295
- });
296
-
297
- if (!response.ok) {
298
- const errorData: any = await response.json().catch(() => ({ message: 'Unknown error' }));
299
- throw new Error(`Bulk create failed: ${response.status} - ${errorData.message || 'Unknown error'}`);
300
- }
301
-
302
- return await response.json();
303
- };
304
-
305
- /**
306
- * Enhanced bulk document creation using direct HTTP calls
307
- */
308
- const transferDocumentsBulkUpsert = async (
309
- client: any,
310
- dbId: string,
311
- collectionId: string,
312
- documents: any[],
313
- maxBatchSize: number = 1000
314
- ): Promise<{ successful: number; failed: number }> => {
315
- let successful = 0;
316
- let failed = 0;
317
-
318
- // Prepare documents for bulk upsert
319
- const preparedDocs = documents.map(doc => {
320
- const toCreateObject: any = { ...doc };
321
- delete toCreateObject.$databaseId;
322
- delete toCreateObject.$collectionId;
323
- delete toCreateObject.$createdAt;
324
- delete toCreateObject.$updatedAt;
325
-
326
- // Keep $id and $permissions for upsert functionality
327
- return toCreateObject;
328
- });
329
-
330
- // Process in batches based on plan limits
331
- const documentBatches = chunk(preparedDocs, maxBatchSize);
332
-
333
- for (const batch of documentBatches) {
334
- MessageFormatter.progress(`Bulk upserting ${batch.length} documents...`, { prefix: "Transfer" });
335
-
336
- try {
337
- // Try bulk upsert with direct HTTP call
338
- const result = await bulkUpsertDocuments(client, dbId, collectionId, batch);
339
- successful += result.documents?.length || batch.length;
340
- MessageFormatter.success(`Bulk upserted ${result.documents?.length || batch.length} documents`, { prefix: "Transfer" });
341
-
342
- } catch (error: any) {
343
- MessageFormatter.progress(`Bulk upsert failed, trying smaller batch size...`, { prefix: "Transfer" });
344
-
345
- // If bulk upsert fails, try with smaller batch size (Pro plan limit)
346
- if (maxBatchSize > 100) {
347
- const smallerBatches = chunk(batch, 100);
348
-
349
- for (const smallBatch of smallerBatches) {
350
- try {
351
- const result = await bulkUpsertDocuments(client, dbId, collectionId, smallBatch);
352
- successful += result.documents?.length || smallBatch.length;
353
- MessageFormatter.success(`Bulk upserted ${result.documents?.length || smallBatch.length} documents (smaller batch)`, { prefix: "Transfer" });
354
- } catch (smallBatchError: any) {
355
- MessageFormatter.progress(`Smaller batch failed, falling back to individual transfers...`, { prefix: "Transfer" });
356
-
357
- // Fall back to individual document transfer for this batch
358
- const db = new Databases(client);
359
- const { successful: indivSuccessful, failed: indivFailed } = await transferDocumentBatchWithRetryFallback(
360
- db, dbId, collectionId, smallBatch.map((doc, index) => ({
361
- ...doc,
362
- $id: documents[documentBatches.indexOf(batch) * maxBatchSize + smallerBatches.indexOf(smallBatch) * 100 + index]?.$id || ID.unique(),
363
- $permissions: documents[documentBatches.indexOf(batch) * maxBatchSize + smallerBatches.indexOf(smallBatch) * 100 + index]?.$permissions || []
364
- }))
365
- );
366
- successful += indivSuccessful;
367
- failed += indivFailed;
368
- }
369
-
370
- // Add delay between batches
371
- await delay(200);
372
- }
373
- } else {
374
- // Fall back to individual document transfer
375
- const db = new Databases(client);
376
- const { successful: indivSuccessful, failed: indivFailed } = await transferDocumentBatchWithRetryFallback(
377
- db, dbId, collectionId, batch.map((doc, index) => ({
378
- ...doc,
379
- $id: documents[documentBatches.indexOf(batch) * maxBatchSize + index]?.$id || ID.unique(),
380
- $permissions: documents[documentBatches.indexOf(batch) * maxBatchSize + index]?.$permissions || []
381
- }))
382
- );
383
- successful += indivSuccessful;
384
- failed += indivFailed;
385
- }
386
- }
387
-
388
- // Add delay between major batches
389
- if (documentBatches.indexOf(batch) < documentBatches.length - 1) {
390
- await delay(500);
391
- }
392
- }
393
-
394
- return { successful, failed };
395
- };
396
-
397
- /**
398
- * Fallback batch document transfer with individual retry logic
399
- */
400
- const transferDocumentBatchWithRetryFallback = async (
401
- db: Databases,
402
- dbId: string,
403
- collectionId: string,
404
- documents: any[],
405
- batchSize: number = 10
406
- ): Promise<{ successful: number; failed: number }> => {
407
- let successful = 0;
408
- let failed = 0;
409
-
410
- // Process documents in smaller batches to avoid overwhelming the server
411
- const documentBatches = chunk(documents, batchSize);
412
-
413
- for (const batch of documentBatches) {
414
- MessageFormatter.progress(`Processing batch of ${batch.length} documents...`, { prefix: "Transfer" });
415
-
416
- const batchPromises = batch.map(async (doc) => {
417
- const toCreateObject: Partial<typeof doc> = { ...doc };
418
- delete toCreateObject.$databaseId;
419
- delete toCreateObject.$collectionId;
420
- delete toCreateObject.$createdAt;
421
- delete toCreateObject.$updatedAt;
422
- delete toCreateObject.$id;
423
- delete toCreateObject.$permissions;
424
-
425
- const result = await transferDocumentWithRetry(
426
- db,
427
- dbId,
428
- collectionId,
429
- doc.$id,
430
- toCreateObject,
431
- doc.$permissions || []
432
- );
433
-
434
- return { docId: doc.$id, success: result };
435
- });
436
-
437
- const results = await Promise.allSettled(batchPromises);
438
-
439
- results.forEach((result, index) => {
440
- if (result.status === 'fulfilled') {
441
- if (result.value.success) {
442
- successful++;
443
- } else {
444
- failed++;
445
- }
446
- } else {
447
- MessageFormatter.error(`Batch promise rejected for document ${batch[index].$id}`, new Error(String(result.reason)), { prefix: "Transfer" });
448
- failed++;
449
- }
450
- });
451
-
452
- // Add delay between batches to avoid rate limiting
453
- if (documentBatches.indexOf(batch) < documentBatches.length - 1) {
454
- await delay(500);
455
- }
456
- }
457
-
458
- return { successful, failed };
459
- };
460
-
461
- /**
462
- * Enhanced batch document transfer with fault tolerance and bulk API support
463
- */
464
- const transferDocumentBatchWithRetry = async (
465
- db: Databases,
466
- client: any,
467
- dbId: string,
468
- collectionId: string,
469
- documents: any[],
470
- batchSize: number = 10
471
- ): Promise<{ successful: number; failed: number }> => {
472
- // Check if we can use bulk operations
473
- if (supportsBulkOperations(client.config.endpoint)) {
474
- MessageFormatter.info(`Using bulk upsert API for faster document transfer`, { prefix: "Transfer" });
475
-
476
- // Try with Scale plan limit first (2500), then Pro (1000), then Free (100)
477
- const batchSizes = [1000, 100]; // Start with Pro plan, fallback to Free
478
-
479
- for (const maxBatchSize of batchSizes) {
480
- try {
481
- return await transferDocumentsBulkUpsert(client, dbId, collectionId, documents, maxBatchSize);
482
- } catch (error: any) {
483
- MessageFormatter.progress(`Bulk upsert with batch size ${maxBatchSize} failed, trying smaller size...`, { prefix: "Transfer" });
484
- continue;
485
- }
486
- }
487
-
488
- // If all bulk operations fail, fall back to individual transfers
489
- MessageFormatter.progress(`All bulk operations failed, falling back to individual document transfers`, { prefix: "Transfer" });
490
- }
491
-
492
- // Fall back to individual document transfer
493
- return await transferDocumentBatchWithRetryFallback(db, dbId, collectionId, documents, batchSize);
494
- };
495
-
174
+
175
+ /**
176
+ * Enhanced document transfer with fault tolerance and exponential backoff
177
+ */
178
+ const transferDocumentWithRetry = async (
179
+ db: Databases,
180
+ dbId: string,
181
+ collectionId: string,
182
+ documentId: string,
183
+ documentData: any,
184
+ permissions: string[],
185
+ maxRetries: number = 3,
186
+ retryCount: number = 0
187
+ ): Promise<boolean> => {
188
+ try {
189
+ await db.createDocument(
190
+ dbId,
191
+ collectionId,
192
+ documentId,
193
+ documentData,
194
+ permissions
195
+ );
196
+ return true;
197
+ } catch (error: any) {
198
+ // Check if document already exists
199
+ if (error.code === 409 || error.message?.toLowerCase().includes('already exists')) {
200
+ await db.updateDocument(
201
+ dbId,
202
+ collectionId,
203
+ documentId,
204
+ documentData,
205
+ permissions
206
+ );
207
+ }
208
+
209
+ if (retryCount < maxRetries) {
210
+ // Calculate exponential backoff: 1s, 2s, 4s, max 8s
211
+ const exponentialDelay = calculateExponentialBackoff(retryCount, 1000, 8000);
212
+ MessageFormatter.progress(`Retrying document ${documentId} (attempt ${retryCount + 1}/${maxRetries}, backoff: ${exponentialDelay}ms)`, { prefix: "Transfer" });
213
+
214
+ await delay(exponentialDelay);
215
+
216
+ return await transferDocumentWithRetry(
217
+ db,
218
+ dbId,
219
+ collectionId,
220
+ documentId,
221
+ documentData,
222
+ permissions,
223
+ maxRetries,
224
+ retryCount + 1
225
+ );
226
+ }
227
+
228
+ MessageFormatter.error(`Failed to transfer document ${documentId} after ${maxRetries} retries`, error, { prefix: "Transfer" });
229
+ return false;
230
+ }
231
+ };
232
+
233
+ /**
234
+ * Check if endpoint supports bulk operations (cloud.appwrite.io)
235
+ */
236
+ const supportsBulkOperations = (endpoint: string): boolean => {
237
+ return endpoint.includes('cloud.appwrite.io');
238
+ };
239
+
240
+ /**
241
+ * Direct HTTP implementation of bulk upsert API
242
+ */
243
+ const bulkUpsertDocuments = async (
244
+ client: any,
245
+ dbId: string,
246
+ collectionId: string,
247
+ documents: any[]
248
+ ): Promise<any> => {
249
+ const apiPath = `/databases/${dbId}/collections/${collectionId}/documents`;
250
+ const url = new URL(client.config.endpoint + apiPath);
251
+
252
+ const headers = {
253
+ 'Content-Type': 'application/json',
254
+ 'X-Appwrite-Project': client.config.project,
255
+ 'X-Appwrite-Key': client.config.key
256
+ };
257
+
258
+ const response = await fetch(url.toString(), {
259
+ method: 'PUT',
260
+ headers,
261
+ body: JSON.stringify({ documents })
262
+ });
263
+
264
+ if (!response.ok) {
265
+ const errorData: any = await response.json().catch(() => ({ message: 'Unknown error' }));
266
+ throw new Error(`Bulk upsert failed: ${response.status} - ${errorData.message || 'Unknown error'}`);
267
+ }
268
+
269
+ return await response.json();
270
+ };
271
+
272
+ /**
273
+ * Direct HTTP implementation of bulk create API
274
+ */
275
+ const bulkCreateDocuments = async (
276
+ client: any,
277
+ dbId: string,
278
+ collectionId: string,
279
+ documents: any[]
280
+ ): Promise<any> => {
281
+ const apiPath = `/databases/${dbId}/collections/${collectionId}/documents`;
282
+ const url = new URL(client.config.endpoint + apiPath);
283
+
284
+ const headers = {
285
+ 'Content-Type': 'application/json',
286
+ 'X-Appwrite-Project': client.config.project,
287
+ 'X-Appwrite-Key': client.config.key
288
+ };
289
+
290
+ const response = await fetch(url.toString(), {
291
+ method: 'POST',
292
+ headers,
293
+ body: JSON.stringify({ documents })
294
+ });
295
+
296
+ if (!response.ok) {
297
+ const errorData: any = await response.json().catch(() => ({ message: 'Unknown error' }));
298
+ throw new Error(`Bulk create failed: ${response.status} - ${errorData.message || 'Unknown error'}`);
299
+ }
300
+
301
+ return await response.json();
302
+ };
303
+
304
+ /**
305
+ * Enhanced bulk document creation using direct HTTP calls
306
+ */
307
+ const transferDocumentsBulkUpsert = async (
308
+ client: any,
309
+ dbId: string,
310
+ collectionId: string,
311
+ documents: any[],
312
+ maxBatchSize: number = 1000
313
+ ): Promise<{ successful: number; failed: number }> => {
314
+ let successful = 0;
315
+ let failed = 0;
316
+
317
+ // Prepare documents for bulk upsert
318
+ const preparedDocs = documents.map(doc => {
319
+ const toCreateObject: any = { ...doc };
320
+ delete toCreateObject.$databaseId;
321
+ delete toCreateObject.$collectionId;
322
+ delete toCreateObject.$createdAt;
323
+ delete toCreateObject.$updatedAt;
324
+
325
+ // Keep $id and $permissions for upsert functionality
326
+ return toCreateObject;
327
+ });
328
+
329
+ // Process in batches based on plan limits
330
+ const documentBatches = chunk(preparedDocs, maxBatchSize);
331
+
332
+ for (const batch of documentBatches) {
333
+ MessageFormatter.progress(`Bulk upserting ${batch.length} documents...`, { prefix: "Transfer" });
334
+
335
+ try {
336
+ // Try bulk upsert with direct HTTP call
337
+ const result = await bulkUpsertDocuments(client, dbId, collectionId, batch);
338
+ successful += result.documents?.length || batch.length;
339
+ MessageFormatter.success(`Bulk upserted ${result.documents?.length || batch.length} documents`, { prefix: "Transfer" });
340
+
341
+ } catch (error: any) {
342
+ MessageFormatter.progress(`Bulk upsert failed, trying smaller batch size...`, { prefix: "Transfer" });
343
+
344
+ // If bulk upsert fails, try with smaller batch size (Pro plan limit)
345
+ if (maxBatchSize > 100) {
346
+ const smallerBatches = chunk(batch, 100);
347
+
348
+ for (const smallBatch of smallerBatches) {
349
+ try {
350
+ const result = await bulkUpsertDocuments(client, dbId, collectionId, smallBatch);
351
+ successful += result.documents?.length || smallBatch.length;
352
+ MessageFormatter.success(`Bulk upserted ${result.documents?.length || smallBatch.length} documents (smaller batch)`, { prefix: "Transfer" });
353
+ } catch (smallBatchError: any) {
354
+ MessageFormatter.progress(`Smaller batch failed, falling back to individual transfers...`, { prefix: "Transfer" });
355
+
356
+ // Fall back to individual document transfer for this batch
357
+ const db = new Databases(client);
358
+ const { successful: indivSuccessful, failed: indivFailed } = await transferDocumentBatchWithRetryFallback(
359
+ db, dbId, collectionId, smallBatch.map((doc, index) => ({
360
+ ...doc,
361
+ $id: documents[documentBatches.indexOf(batch) * maxBatchSize + smallerBatches.indexOf(smallBatch) * 100 + index]?.$id || ID.unique(),
362
+ $permissions: documents[documentBatches.indexOf(batch) * maxBatchSize + smallerBatches.indexOf(smallBatch) * 100 + index]?.$permissions || []
363
+ }))
364
+ );
365
+ successful += indivSuccessful;
366
+ failed += indivFailed;
367
+ }
368
+
369
+ // Add delay between batches
370
+ await delay(200);
371
+ }
372
+ } else {
373
+ // Fall back to individual document transfer
374
+ const db = new Databases(client);
375
+ const { successful: indivSuccessful, failed: indivFailed } = await transferDocumentBatchWithRetryFallback(
376
+ db, dbId, collectionId, batch.map((doc, index) => ({
377
+ ...doc,
378
+ $id: documents[documentBatches.indexOf(batch) * maxBatchSize + index]?.$id || ID.unique(),
379
+ $permissions: documents[documentBatches.indexOf(batch) * maxBatchSize + index]?.$permissions || []
380
+ }))
381
+ );
382
+ successful += indivSuccessful;
383
+ failed += indivFailed;
384
+ }
385
+ }
386
+
387
+ // Add delay between major batches
388
+ if (documentBatches.indexOf(batch) < documentBatches.length - 1) {
389
+ await delay(500);
390
+ }
391
+ }
392
+
393
+ return { successful, failed };
394
+ };
395
+
396
+ /**
397
+ * Fallback batch document transfer with individual retry logic
398
+ */
399
+ const transferDocumentBatchWithRetryFallback = async (
400
+ db: Databases,
401
+ dbId: string,
402
+ collectionId: string,
403
+ documents: any[],
404
+ batchSize: number = 10
405
+ ): Promise<{ successful: number; failed: number }> => {
406
+ let successful = 0;
407
+ let failed = 0;
408
+
409
+ // Process documents in smaller batches to avoid overwhelming the server
410
+ const documentBatches = chunk(documents, batchSize);
411
+
412
+ for (const batch of documentBatches) {
413
+ MessageFormatter.progress(`Processing batch of ${batch.length} documents...`, { prefix: "Transfer" });
414
+
415
+ const batchPromises = batch.map(async (doc) => {
416
+ const toCreateObject: Partial<typeof doc> = { ...doc };
417
+ delete toCreateObject.$databaseId;
418
+ delete toCreateObject.$collectionId;
419
+ delete toCreateObject.$createdAt;
420
+ delete toCreateObject.$updatedAt;
421
+ delete toCreateObject.$id;
422
+ delete toCreateObject.$permissions;
423
+
424
+ const result = await transferDocumentWithRetry(
425
+ db,
426
+ dbId,
427
+ collectionId,
428
+ doc.$id,
429
+ toCreateObject,
430
+ doc.$permissions || []
431
+ );
432
+
433
+ return { docId: doc.$id, success: result };
434
+ });
435
+
436
+ const results = await Promise.allSettled(batchPromises);
437
+
438
+ results.forEach((result, index) => {
439
+ if (result.status === 'fulfilled') {
440
+ if (result.value.success) {
441
+ successful++;
442
+ } else {
443
+ failed++;
444
+ }
445
+ } else {
446
+ MessageFormatter.error(`Batch promise rejected for document ${batch[index].$id}`, new Error(String(result.reason)), { prefix: "Transfer" });
447
+ failed++;
448
+ }
449
+ });
450
+
451
+ // Add delay between batches to avoid rate limiting
452
+ if (documentBatches.indexOf(batch) < documentBatches.length - 1) {
453
+ await delay(500);
454
+ }
455
+ }
456
+
457
+ return { successful, failed };
458
+ };
459
+
460
+ /**
461
+ * Enhanced batch document transfer with fault tolerance and bulk API support
462
+ */
463
+ const transferDocumentBatchWithRetry = async (
464
+ db: Databases,
465
+ client: any,
466
+ dbId: string,
467
+ collectionId: string,
468
+ documents: any[],
469
+ batchSize: number = 10
470
+ ): Promise<{ successful: number; failed: number }> => {
471
+ // Check if we can use bulk operations
472
+ if (supportsBulkOperations(client.config.endpoint)) {
473
+ MessageFormatter.info(`Using bulk upsert API for faster document transfer`, { prefix: "Transfer" });
474
+
475
+ // Try with Scale plan limit first (2500), then Pro (1000), then Free (100)
476
+ const batchSizes = [1000, 100]; // Start with Pro plan, fallback to Free
477
+
478
+ for (const maxBatchSize of batchSizes) {
479
+ try {
480
+ return await transferDocumentsBulkUpsert(client, dbId, collectionId, documents, maxBatchSize);
481
+ } catch (error: any) {
482
+ MessageFormatter.progress(`Bulk upsert with batch size ${maxBatchSize} failed, trying smaller size...`, { prefix: "Transfer" });
483
+ continue;
484
+ }
485
+ }
486
+
487
+ // If all bulk operations fail, fall back to individual transfers
488
+ MessageFormatter.progress(`All bulk operations failed, falling back to individual document transfers`, { prefix: "Transfer" });
489
+ }
490
+
491
+ // Fall back to individual document transfer
492
+ return await transferDocumentBatchWithRetryFallback(db, dbId, collectionId, documents, batchSize);
493
+ };
494
+
496
495
  export const transferDocumentsBetweenDbsLocalToRemote = async (
497
496
  localDb: Databases | DatabaseAdapter,
498
497
  endpoint: string,
@@ -511,17 +510,17 @@ export const transferDocumentsBetweenDbsLocalToRemote = async (
511
510
  let totalDocumentsProcessed = 0;
512
511
  let totalSuccessful = 0;
513
512
  let totalFailed = 0;
514
-
515
- // Fetch documents in larger batches (1000 at a time)
516
- let hasMoreDocuments = true;
517
- let lastDocumentId: string | undefined;
518
-
519
- while (hasMoreDocuments) {
520
- const queries = [Query.limit(1000)]; // Fetch 1000 documents at a time
521
- if (lastDocumentId) {
522
- queries.push(Query.cursorAfter(lastDocumentId));
523
- }
524
-
513
+
514
+ // Fetch documents in larger batches (1000 at a time)
515
+ let hasMoreDocuments = true;
516
+ let lastDocumentId: string | undefined;
517
+
518
+ while (hasMoreDocuments) {
519
+ const queries = [Query.limit(1000)]; // Fetch 1000 documents at a time
520
+ if (lastDocumentId) {
521
+ queries.push(Query.cursorAfter(lastDocumentId));
522
+ }
523
+
525
524
  const fromCollDocs = await tryAwaitWithRetry(async () => {
526
525
  if (isLegacyDatabases(localDb)) {
527
526
  return localDb.listDocuments(fromDbId, fromCollId, queries);
@@ -531,14 +530,14 @@ export const transferDocumentsBetweenDbsLocalToRemote = async (
531
530
  return { documents: rows } as any;
532
531
  }
533
532
  });
534
-
535
- if (fromCollDocs.documents.length === 0) {
536
- hasMoreDocuments = false;
537
- break;
538
- }
539
-
540
- MessageFormatter.progress(`Fetched ${fromCollDocs.documents.length} documents, processing for transfer...`, { prefix: "Transfer" });
541
-
533
+
534
+ if (fromCollDocs.documents.length === 0) {
535
+ hasMoreDocuments = false;
536
+ break;
537
+ }
538
+
539
+ MessageFormatter.progress(`Fetched ${fromCollDocs.documents.length} documents, processing for transfer...`, { prefix: "Transfer" });
540
+
542
541
  // Prefer remote adapter bulk upsert if available
543
542
  const prepared = fromCollDocs.documents.map((doc: any) => {
544
543
  const data: any = { ...doc };
@@ -560,31 +559,31 @@ export const transferDocumentsBetweenDbsLocalToRemote = async (
560
559
  const res = await transferDocumentBatchWithRetry(remoteDb, client, toDbId, toCollId, fromCollDocs.documents);
561
560
  successful = res.successful; failed = res.failed;
562
561
  }
563
-
564
- totalDocumentsProcessed += fromCollDocs.documents.length;
565
- totalSuccessful += successful;
566
- totalFailed += failed;
567
-
568
- // Check if we have more documents to process
569
- if (fromCollDocs.documents.length < 1000) {
570
- hasMoreDocuments = false;
571
- } else {
572
- lastDocumentId = fromCollDocs.documents[fromCollDocs.documents.length - 1].$id;
573
- }
574
-
575
- MessageFormatter.debug(`Batch complete: ${successful} successful, ${failed} failed`, undefined, { prefix: "Transfer" });
576
- }
577
-
578
- if (totalDocumentsProcessed === 0) {
579
- MessageFormatter.info(`No documents found in collection ${fromCollId}`, { prefix: "Transfer" });
580
- return;
581
- }
582
-
583
- const message = `Total documents processed: ${totalDocumentsProcessed}, successful: ${totalSuccessful}, failed: ${totalFailed}`;
584
-
585
- if (totalFailed > 0) {
586
- MessageFormatter.warning(message, { prefix: "Transfer" });
587
- } else {
588
- MessageFormatter.success(message, { prefix: "Transfer" });
589
- }
562
+
563
+ totalDocumentsProcessed += fromCollDocs.documents.length;
564
+ totalSuccessful += successful;
565
+ totalFailed += failed;
566
+
567
+ // Check if we have more documents to process
568
+ if (fromCollDocs.documents.length < 1000) {
569
+ hasMoreDocuments = false;
570
+ } else {
571
+ lastDocumentId = fromCollDocs.documents[fromCollDocs.documents.length - 1].$id;
572
+ }
573
+
574
+ MessageFormatter.debug(`Batch complete: ${successful} successful, ${failed} failed`, undefined, { prefix: "Transfer" });
575
+ }
576
+
577
+ if (totalDocumentsProcessed === 0) {
578
+ MessageFormatter.info(`No documents found in collection ${fromCollId}`, { prefix: "Transfer" });
579
+ return;
580
+ }
581
+
582
+ const message = `Total documents processed: ${totalDocumentsProcessed}, successful: ${totalSuccessful}, failed: ${totalFailed}`;
583
+
584
+ if (totalFailed > 0) {
585
+ MessageFormatter.warning(message, { prefix: "Transfer" });
586
+ } else {
587
+ MessageFormatter.success(message, { prefix: "Transfer" });
588
+ }
590
589
  };