appwrite-utils-cli 1.9.7 → 1.12.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 (376) hide show
  1. package/README.md +1004 -1004
  2. package/dist/adapters/index.d.ts +7 -8
  3. package/dist/adapters/index.js +7 -9
  4. package/dist/backups/operations/bucketBackup.js +2 -2
  5. package/dist/backups/operations/collectionBackup.d.ts +1 -1
  6. package/dist/backups/operations/collectionBackup.js +3 -3
  7. package/dist/backups/operations/comprehensiveBackup.d.ts +1 -1
  8. package/dist/backups/operations/comprehensiveBackup.js +2 -2
  9. package/dist/backups/tracking/centralizedTracking.d.ts +1 -1
  10. package/dist/backups/tracking/centralizedTracking.js +2 -2
  11. package/dist/cli/commands/configCommands.js +51 -7
  12. package/dist/cli/commands/databaseCommands.js +156 -104
  13. package/dist/cli/commands/functionCommands.js +3 -3
  14. package/dist/cli/commands/importFileCommands.d.ts +7 -0
  15. package/dist/cli/commands/importFileCommands.js +674 -0
  16. package/dist/cli/commands/schemaCommands.js +3 -3
  17. package/dist/cli/commands/storageCommands.js +2 -3
  18. package/dist/cli/commands/transferCommands.js +3 -5
  19. package/dist/collections/{attributes.d.ts → columns.d.ts} +1 -1
  20. package/dist/collections/{attributes.js → columns.js} +15 -9
  21. package/dist/collections/indexes.js +1 -3
  22. package/dist/collections/methods.d.ts +1 -1
  23. package/dist/collections/methods.js +38 -20
  24. package/dist/collections/tableOperations.d.ts +1 -0
  25. package/dist/collections/tableOperations.js +30 -11
  26. package/dist/collections/transferOperations.d.ts +1 -1
  27. package/dist/collections/transferOperations.js +3 -4
  28. package/dist/collections/wipeOperations.d.ts +4 -3
  29. package/dist/collections/wipeOperations.js +112 -39
  30. package/dist/databases/methods.js +2 -2
  31. package/dist/databases/setup.js +2 -2
  32. package/dist/examples/yamlTerminologyExample.js +2 -2
  33. package/dist/functions/deployments.d.ts +1 -1
  34. package/dist/functions/deployments.js +6 -6
  35. package/dist/functions/fnConfigDiscovery.js +2 -2
  36. package/dist/functions/methods.js +2 -2
  37. package/dist/functions/templates/count-docs-in-collection/README.md +53 -53
  38. package/dist/functions/templates/count-docs-in-collection/src/main.ts +159 -159
  39. package/dist/functions/templates/count-docs-in-collection/src/request.ts +8 -8
  40. package/dist/functions/templates/hono-typescript/README.md +285 -285
  41. package/dist/functions/templates/hono-typescript/src/adapters/request.ts +73 -73
  42. package/dist/functions/templates/hono-typescript/src/adapters/response.ts +105 -105
  43. package/dist/functions/templates/hono-typescript/src/app.ts +179 -179
  44. package/dist/functions/templates/hono-typescript/src/context.ts +102 -102
  45. package/{src/functions/templates/hono-typescript/src/index.ts → dist/functions/templates/hono-typescript/src/main.ts} +53 -53
  46. package/dist/functions/templates/hono-typescript/src/middleware/appwrite.ts +118 -118
  47. package/dist/functions/templates/typescript-node/README.md +31 -31
  48. package/dist/functions/templates/typescript-node/src/context.ts +102 -102
  49. package/dist/functions/templates/typescript-node/src/{index.ts → main.ts} +29 -29
  50. package/dist/functions/templates/uv/README.md +30 -30
  51. package/dist/functions/templates/uv/pyproject.toml +29 -29
  52. package/dist/functions/templates/uv/src/context.py +124 -124
  53. package/dist/functions/templates/uv/src/{index.py → main.py} +45 -45
  54. package/dist/init.js +1 -1
  55. package/dist/interactiveCLI.d.ts +6 -1
  56. package/dist/interactiveCLI.js +79 -25
  57. package/dist/main.js +125 -180
  58. package/dist/migrations/afterImportActions.js +2 -3
  59. package/dist/migrations/appwriteToX.d.ts +1 -1
  60. package/dist/migrations/appwriteToX.js +10 -8
  61. package/dist/migrations/comprehensiveTransfer.js +3 -5
  62. package/dist/migrations/dataLoader.d.ts +4 -2
  63. package/dist/migrations/dataLoader.js +42 -20
  64. package/dist/migrations/importController.d.ts +2 -0
  65. package/dist/migrations/importController.js +39 -24
  66. package/dist/migrations/importDataActions.js +3 -3
  67. package/dist/migrations/relationships.js +1 -2
  68. package/dist/migrations/services/DataTransformationService.js +2 -2
  69. package/dist/migrations/services/FileHandlerService.js +1 -1
  70. package/dist/migrations/services/ImportOrchestrator.d.ts +2 -0
  71. package/dist/migrations/services/ImportOrchestrator.js +15 -7
  72. package/dist/migrations/services/RateLimitManager.js +1 -1
  73. package/dist/migrations/services/RelationshipResolver.js +1 -1
  74. package/dist/migrations/services/UserMappingService.js +1 -1
  75. package/dist/migrations/services/ValidationService.js +1 -1
  76. package/dist/migrations/transfer.d.ts +8 -4
  77. package/dist/migrations/transfer.js +108 -55
  78. package/dist/migrations/yaml/YamlImportConfigLoader.js +52 -52
  79. package/dist/migrations/yaml/YamlImportIntegration.js +2 -2
  80. package/dist/migrations/yaml/generateImportSchemas.js +174 -174
  81. package/dist/setupCommands.d.ts +1 -1
  82. package/dist/setupCommands.js +5 -6
  83. package/dist/setupController.js +1 -1
  84. package/dist/shared/backupTracking.d.ts +1 -1
  85. package/dist/shared/backupTracking.js +2 -2
  86. package/dist/shared/confirmationDialogs.js +1 -1
  87. package/dist/shared/migrationHelpers.d.ts +1 -1
  88. package/dist/shared/migrationHelpers.js +4 -4
  89. package/dist/shared/operationQueue.d.ts +1 -1
  90. package/dist/shared/operationQueue.js +3 -4
  91. package/dist/shared/operationsTable.d.ts +1 -1
  92. package/dist/shared/operationsTable.js +35 -34
  93. package/dist/shared/operationsTableSchema.d.ts +3 -3
  94. package/dist/shared/operationsTableSchema.js +2 -2
  95. package/dist/shared/progressManager.js +1 -1
  96. package/dist/shared/selectionDialogs.d.ts +6 -0
  97. package/dist/shared/selectionDialogs.js +56 -12
  98. package/dist/storage/methods.d.ts +12 -0
  99. package/dist/storage/methods.js +92 -89
  100. package/dist/storage/schemas.d.ts +2 -2
  101. package/dist/tables/indexManager.d.ts +1 -1
  102. package/dist/tables/indexManager.js +2 -2
  103. package/dist/types.d.ts +2 -2
  104. package/dist/types.js +1 -1
  105. package/dist/users/methods.js +2 -3
  106. package/dist/utils/configMigration.js +1 -1
  107. package/dist/utils/index.d.ts +1 -1
  108. package/dist/utils/index.js +1 -1
  109. package/dist/utils/loadConfigs.d.ts +2 -2
  110. package/dist/utils/loadConfigs.js +6 -7
  111. package/dist/utils/setupFiles.js +139 -141
  112. package/dist/utilsController.d.ts +16 -9
  113. package/dist/utilsController.js +93 -68
  114. package/package.json +9 -3
  115. package/.appwrite/.yaml_schemas/appwrite-config.schema.json +0 -380
  116. package/.appwrite/.yaml_schemas/collection.schema.json +0 -255
  117. package/.appwrite/collections/Categories.yaml +0 -182
  118. package/.appwrite/collections/ExampleCollection.yaml +0 -36
  119. package/.appwrite/collections/Posts.yaml +0 -227
  120. package/.appwrite/collections/Users.yaml +0 -149
  121. package/.appwrite/config.yaml +0 -109
  122. package/.appwrite/import/README.md +0 -148
  123. package/.appwrite/import/categories-import.yaml +0 -129
  124. package/.appwrite/import/posts-import.yaml +0 -208
  125. package/.appwrite/import/users-import.yaml +0 -130
  126. package/.appwrite/importData/categories.json +0 -194
  127. package/.appwrite/importData/posts.json +0 -270
  128. package/.appwrite/importData/users.json +0 -220
  129. package/.appwrite/schemas/categories.json +0 -128
  130. package/.appwrite/schemas/exampleCollection.json +0 -52
  131. package/.appwrite/schemas/posts.json +0 -173
  132. package/.appwrite/schemas/users.json +0 -125
  133. package/CHANGELOG.md +0 -35
  134. package/CONFIG_TODO.md +0 -1189
  135. package/SELECTION_DIALOGS.md +0 -146
  136. package/SERVICE_IMPLEMENTATION_REPORT.md +0 -462
  137. package/dist/adapters/AdapterFactory.d.ts +0 -94
  138. package/dist/adapters/AdapterFactory.js +0 -420
  139. package/dist/adapters/DatabaseAdapter.d.ts +0 -243
  140. package/dist/adapters/DatabaseAdapter.js +0 -50
  141. package/dist/adapters/LegacyAdapter.d.ts +0 -50
  142. package/dist/adapters/LegacyAdapter.js +0 -615
  143. package/dist/adapters/TablesDBAdapter.d.ts +0 -45
  144. package/dist/adapters/TablesDBAdapter.js +0 -611
  145. package/dist/config/ConfigManager.d.ts +0 -450
  146. package/dist/config/ConfigManager.js +0 -650
  147. package/dist/config/configMigration.d.ts +0 -87
  148. package/dist/config/configMigration.js +0 -390
  149. package/dist/config/configValidation.d.ts +0 -66
  150. package/dist/config/configValidation.js +0 -358
  151. package/dist/config/index.d.ts +0 -8
  152. package/dist/config/index.js +0 -7
  153. package/dist/config/services/ConfigDiscoveryService.d.ts +0 -122
  154. package/dist/config/services/ConfigDiscoveryService.js +0 -322
  155. package/dist/config/services/ConfigLoaderService.d.ts +0 -129
  156. package/dist/config/services/ConfigLoaderService.js +0 -535
  157. package/dist/config/services/ConfigMergeService.d.ts +0 -208
  158. package/dist/config/services/ConfigMergeService.js +0 -308
  159. package/dist/config/services/ConfigValidationService.d.ts +0 -214
  160. package/dist/config/services/ConfigValidationService.js +0 -310
  161. package/dist/config/services/SessionAuthService.d.ts +0 -225
  162. package/dist/config/services/SessionAuthService.js +0 -456
  163. package/dist/config/services/__tests__/ConfigMergeService.test.d.ts +0 -1
  164. package/dist/config/services/__tests__/ConfigMergeService.test.js +0 -271
  165. package/dist/config/services/index.d.ts +0 -13
  166. package/dist/config/services/index.js +0 -10
  167. package/dist/config/yamlConfig.d.ts +0 -722
  168. package/dist/config/yamlConfig.js +0 -702
  169. package/dist/functions/pathResolution.d.ts +0 -37
  170. package/dist/functions/pathResolution.js +0 -185
  171. package/dist/functions/templates/count-docs-in-collection/package.json +0 -25
  172. package/dist/functions/templates/count-docs-in-collection/tsconfig.json +0 -28
  173. package/dist/functions/templates/hono-typescript/package.json +0 -26
  174. package/dist/functions/templates/hono-typescript/src/index.ts +0 -54
  175. package/dist/functions/templates/hono-typescript/tsconfig.json +0 -20
  176. package/dist/functions/templates/typescript-node/package.json +0 -25
  177. package/dist/functions/templates/typescript-node/tsconfig.json +0 -28
  178. package/dist/shared/attributeMapper.d.ts +0 -20
  179. package/dist/shared/attributeMapper.js +0 -203
  180. package/dist/shared/errorUtils.d.ts +0 -54
  181. package/dist/shared/errorUtils.js +0 -95
  182. package/dist/shared/functionManager.d.ts +0 -48
  183. package/dist/shared/functionManager.js +0 -348
  184. package/dist/shared/jsonSchemaGenerator.d.ts +0 -50
  185. package/dist/shared/jsonSchemaGenerator.js +0 -290
  186. package/dist/shared/logging.d.ts +0 -61
  187. package/dist/shared/logging.js +0 -116
  188. package/dist/shared/messageFormatter.d.ts +0 -39
  189. package/dist/shared/messageFormatter.js +0 -162
  190. package/dist/shared/pydanticModelGenerator.d.ts +0 -17
  191. package/dist/shared/pydanticModelGenerator.js +0 -615
  192. package/dist/shared/schemaGenerator.d.ts +0 -40
  193. package/dist/shared/schemaGenerator.js +0 -556
  194. package/dist/utils/ClientFactory.d.ts +0 -87
  195. package/dist/utils/ClientFactory.js +0 -212
  196. package/dist/utils/configDiscovery.d.ts +0 -78
  197. package/dist/utils/configDiscovery.js +0 -472
  198. package/dist/utils/constantsGenerator.d.ts +0 -31
  199. package/dist/utils/constantsGenerator.js +0 -321
  200. package/dist/utils/dataConverters.d.ts +0 -46
  201. package/dist/utils/dataConverters.js +0 -139
  202. package/dist/utils/directoryUtils.d.ts +0 -22
  203. package/dist/utils/directoryUtils.js +0 -59
  204. package/dist/utils/getClientFromConfig.d.ts +0 -39
  205. package/dist/utils/getClientFromConfig.js +0 -199
  206. package/dist/utils/helperFunctions.d.ts +0 -63
  207. package/dist/utils/helperFunctions.js +0 -156
  208. package/dist/utils/pathResolvers.d.ts +0 -53
  209. package/dist/utils/pathResolvers.js +0 -72
  210. package/dist/utils/projectConfig.d.ts +0 -122
  211. package/dist/utils/projectConfig.js +0 -206
  212. package/dist/utils/retryFailedPromises.d.ts +0 -2
  213. package/dist/utils/retryFailedPromises.js +0 -23
  214. package/dist/utils/sessionAuth.d.ts +0 -48
  215. package/dist/utils/sessionAuth.js +0 -164
  216. package/dist/utils/typeGuards.d.ts +0 -35
  217. package/dist/utils/typeGuards.js +0 -57
  218. package/dist/utils/validationRules.d.ts +0 -43
  219. package/dist/utils/validationRules.js +0 -42
  220. package/dist/utils/versionDetection.d.ts +0 -58
  221. package/dist/utils/versionDetection.js +0 -251
  222. package/dist/utils/yamlConverter.d.ts +0 -100
  223. package/dist/utils/yamlConverter.js +0 -428
  224. package/dist/utils/yamlLoader.d.ts +0 -70
  225. package/dist/utils/yamlLoader.js +0 -267
  226. package/scripts/copy-templates.ts +0 -23
  227. package/src/adapters/AdapterFactory.ts +0 -529
  228. package/src/adapters/DatabaseAdapter.ts +0 -319
  229. package/src/adapters/LegacyAdapter.ts +0 -844
  230. package/src/adapters/TablesDBAdapter.ts +0 -823
  231. package/src/adapters/index.ts +0 -37
  232. package/src/backups/operations/bucketBackup.ts +0 -277
  233. package/src/backups/operations/collectionBackup.ts +0 -310
  234. package/src/backups/operations/comprehensiveBackup.ts +0 -342
  235. package/src/backups/schemas/bucketManifest.ts +0 -78
  236. package/src/backups/schemas/comprehensiveManifest.ts +0 -76
  237. package/src/backups/tracking/centralizedTracking.ts +0 -352
  238. package/src/cli/commands/configCommands.ts +0 -201
  239. package/src/cli/commands/databaseCommands.ts +0 -879
  240. package/src/cli/commands/functionCommands.ts +0 -418
  241. package/src/cli/commands/schemaCommands.ts +0 -200
  242. package/src/cli/commands/storageCommands.ts +0 -152
  243. package/src/cli/commands/transferCommands.ts +0 -457
  244. package/src/collections/attributes.ts +0 -2020
  245. package/src/collections/attributes.ts.backup +0 -1555
  246. package/src/collections/indexes.ts +0 -352
  247. package/src/collections/methods.ts +0 -700
  248. package/src/collections/tableOperations.ts +0 -521
  249. package/src/collections/transferOperations.ts +0 -590
  250. package/src/collections/wipeOperations.ts +0 -346
  251. package/src/config/ConfigManager.ts +0 -849
  252. package/src/config/README.md +0 -274
  253. package/src/config/configMigration.ts +0 -575
  254. package/src/config/configValidation.ts +0 -445
  255. package/src/config/index.ts +0 -10
  256. package/src/config/services/ConfigDiscoveryService.ts +0 -410
  257. package/src/config/services/ConfigLoaderService.ts +0 -732
  258. package/src/config/services/ConfigMergeService.ts +0 -388
  259. package/src/config/services/ConfigValidationService.ts +0 -394
  260. package/src/config/services/SessionAuthService.ts +0 -565
  261. package/src/config/services/__tests__/ConfigMergeService.test.ts +0 -351
  262. package/src/config/services/index.ts +0 -29
  263. package/src/config/yamlConfig.ts +0 -761
  264. package/src/databases/methods.ts +0 -49
  265. package/src/databases/setup.ts +0 -77
  266. package/src/examples/yamlTerminologyExample.ts +0 -346
  267. package/src/functions/deployments.ts +0 -220
  268. package/src/functions/fnConfigDiscovery.ts +0 -103
  269. package/src/functions/methods.ts +0 -284
  270. package/src/functions/pathResolution.ts +0 -227
  271. package/src/functions/templates/count-docs-in-collection/README.md +0 -54
  272. package/src/functions/templates/count-docs-in-collection/package.json +0 -25
  273. package/src/functions/templates/count-docs-in-collection/src/main.ts +0 -159
  274. package/src/functions/templates/count-docs-in-collection/src/request.ts +0 -9
  275. package/src/functions/templates/count-docs-in-collection/tsconfig.json +0 -28
  276. package/src/functions/templates/hono-typescript/README.md +0 -286
  277. package/src/functions/templates/hono-typescript/package.json +0 -26
  278. package/src/functions/templates/hono-typescript/src/adapters/request.ts +0 -74
  279. package/src/functions/templates/hono-typescript/src/adapters/response.ts +0 -106
  280. package/src/functions/templates/hono-typescript/src/app.ts +0 -180
  281. package/src/functions/templates/hono-typescript/src/context.ts +0 -103
  282. package/src/functions/templates/hono-typescript/src/middleware/appwrite.ts +0 -119
  283. package/src/functions/templates/hono-typescript/tsconfig.json +0 -20
  284. package/src/functions/templates/typescript-node/README.md +0 -32
  285. package/src/functions/templates/typescript-node/package.json +0 -25
  286. package/src/functions/templates/typescript-node/src/context.ts +0 -103
  287. package/src/functions/templates/typescript-node/src/index.ts +0 -29
  288. package/src/functions/templates/typescript-node/tsconfig.json +0 -28
  289. package/src/functions/templates/uv/README.md +0 -31
  290. package/src/functions/templates/uv/pyproject.toml +0 -30
  291. package/src/functions/templates/uv/src/__init__.py +0 -0
  292. package/src/functions/templates/uv/src/context.py +0 -125
  293. package/src/functions/templates/uv/src/index.py +0 -46
  294. package/src/init.ts +0 -62
  295. package/src/interactiveCLI.ts +0 -1136
  296. package/src/main.ts +0 -1670
  297. package/src/migrations/afterImportActions.ts +0 -580
  298. package/src/migrations/appwriteToX.ts +0 -664
  299. package/src/migrations/comprehensiveTransfer.ts +0 -2285
  300. package/src/migrations/dataLoader.ts +0 -1702
  301. package/src/migrations/importController.ts +0 -428
  302. package/src/migrations/importDataActions.ts +0 -315
  303. package/src/migrations/relationships.ts +0 -334
  304. package/src/migrations/services/DataTransformationService.ts +0 -196
  305. package/src/migrations/services/FileHandlerService.ts +0 -311
  306. package/src/migrations/services/ImportOrchestrator.ts +0 -666
  307. package/src/migrations/services/RateLimitManager.ts +0 -363
  308. package/src/migrations/services/RelationshipResolver.ts +0 -461
  309. package/src/migrations/services/UserMappingService.ts +0 -345
  310. package/src/migrations/services/ValidationService.ts +0 -349
  311. package/src/migrations/transfer.ts +0 -1068
  312. package/src/migrations/yaml/YamlImportConfigLoader.ts +0 -439
  313. package/src/migrations/yaml/YamlImportIntegration.ts +0 -446
  314. package/src/migrations/yaml/generateImportSchemas.ts +0 -1354
  315. package/src/schemas/authUser.ts +0 -23
  316. package/src/setup.ts +0 -8
  317. package/src/setupCommands.ts +0 -603
  318. package/src/setupController.ts +0 -43
  319. package/src/shared/attributeMapper.ts +0 -229
  320. package/src/shared/backupMetadataSchema.ts +0 -93
  321. package/src/shared/backupTracking.ts +0 -211
  322. package/src/shared/confirmationDialogs.ts +0 -327
  323. package/src/shared/errorUtils.ts +0 -110
  324. package/src/shared/functionManager.ts +0 -537
  325. package/src/shared/jsonSchemaGenerator.ts +0 -383
  326. package/src/shared/logging.ts +0 -149
  327. package/src/shared/messageFormatter.ts +0 -208
  328. package/src/shared/migrationHelpers.ts +0 -232
  329. package/src/shared/operationLogger.ts +0 -20
  330. package/src/shared/operationQueue.ts +0 -377
  331. package/src/shared/operationsTable.ts +0 -338
  332. package/src/shared/operationsTableSchema.ts +0 -60
  333. package/src/shared/progressManager.ts +0 -278
  334. package/src/shared/pydanticModelGenerator.ts +0 -618
  335. package/src/shared/relationshipExtractor.ts +0 -214
  336. package/src/shared/schemaGenerator.ts +0 -644
  337. package/src/shared/selectionDialogs.ts +0 -749
  338. package/src/storage/backupCompression.ts +0 -88
  339. package/src/storage/methods.ts +0 -698
  340. package/src/storage/schemas.ts +0 -205
  341. package/src/tables/indexManager.ts +0 -409
  342. package/src/types/node-appwrite-tablesdb.d.ts +0 -44
  343. package/src/types.ts +0 -9
  344. package/src/users/methods.ts +0 -359
  345. package/src/utils/ClientFactory.ts +0 -240
  346. package/src/utils/configDiscovery.ts +0 -557
  347. package/src/utils/configMigration.ts +0 -348
  348. package/src/utils/constantsGenerator.ts +0 -369
  349. package/src/utils/dataConverters.ts +0 -159
  350. package/src/utils/directoryUtils.ts +0 -61
  351. package/src/utils/getClientFromConfig.ts +0 -257
  352. package/src/utils/helperFunctions.ts +0 -228
  353. package/src/utils/index.ts +0 -2
  354. package/src/utils/loadConfigs.ts +0 -449
  355. package/src/utils/pathResolvers.ts +0 -81
  356. package/src/utils/projectConfig.ts +0 -340
  357. package/src/utils/retryFailedPromises.ts +0 -29
  358. package/src/utils/sessionAuth.ts +0 -230
  359. package/src/utils/setupFiles.ts +0 -1238
  360. package/src/utils/typeGuards.ts +0 -65
  361. package/src/utils/validationRules.ts +0 -88
  362. package/src/utils/versionDetection.ts +0 -292
  363. package/src/utils/yamlConverter.ts +0 -542
  364. package/src/utils/yamlLoader.ts +0 -371
  365. package/src/utilsController.ts +0 -1213
  366. package/tests/README.md +0 -497
  367. package/tests/adapters/AdapterFactory.test.ts +0 -277
  368. package/tests/integration/syncOperations.test.ts +0 -463
  369. package/tests/jest.config.js +0 -25
  370. package/tests/migration/configMigration.test.ts +0 -546
  371. package/tests/setup.ts +0 -62
  372. package/tests/testUtils.ts +0 -340
  373. package/tests/utils/loadConfigs.test.ts +0 -350
  374. package/tests/validation/configValidation.test.ts +0 -412
  375. package/tmp-sync-test/.appwrite/collections/TestCollection.yaml +0 -7
  376. package/tsconfig.json +0 -44
@@ -1,428 +0,0 @@
1
- import {
2
- AppwriteException,
3
- ID,
4
- Query,
5
- type Databases,
6
- type Models,
7
- type Storage,
8
- } from "node-appwrite";
9
- import type {
10
- AppwriteConfig,
11
- ConfigCollection,
12
- ConfigDatabase,
13
- AttributeMappings,
14
- } from "appwrite-utils";
15
- import type { ImportDataActions } from "./importDataActions.js";
16
- import { areCollectionNamesSame, tryAwaitWithRetry } from "../utils/index.js";
17
- import type { SetupOptions } from "../utilsController.js";
18
- import { resolveAndUpdateRelationships } from "./relationships.js";
19
- import { UsersController } from "../users/methods.js";
20
- import { logger } from "../shared/logging.js";
21
- import { updateOperation } from "../shared/migrationHelpers.js";
22
- import { LegacyAdapter } from "../adapters/LegacyAdapter.js";
23
- import {
24
- BatchSchema,
25
- OperationCreateSchema,
26
- OperationSchema,
27
- } from "../storage/schemas.js";
28
- import { DataLoader, type CollectionImportData } from "./dataLoader.js";
29
- import {
30
- transferDatabaseLocalToLocal,
31
- transferStorageLocalToLocal,
32
- } from "./transfer.js";
33
- import { MessageFormatter } from "../shared/messageFormatter.js";
34
- import { ProgressManager } from "../shared/progressManager.js";
35
-
36
- export class ImportController {
37
- private config: AppwriteConfig;
38
- private database: Databases;
39
- private storage: Storage;
40
- private appwriteFolderPath: string;
41
- private importDataActions: ImportDataActions;
42
- private setupOptions: SetupOptions;
43
- private documentCache: Map<string, any>;
44
- private batchLimit: number = 25; // Define batch size limit
45
- private hasImportedUsers = false;
46
- private postImportActionsQueue: {
47
- context: any;
48
- finalItem: any;
49
- attributeMappings: AttributeMappings;
50
- }[] = [];
51
- private databasesToRun: Models.Database[];
52
-
53
- constructor(
54
- config: AppwriteConfig,
55
- database: Databases,
56
- storage: Storage,
57
- appwriteFolderPath: string,
58
- importDataActions: ImportDataActions,
59
- setupOptions: SetupOptions,
60
- databasesToRun?: Models.Database[]
61
- ) {
62
- this.config = config;
63
- this.database = database;
64
- this.storage = storage;
65
- this.appwriteFolderPath = appwriteFolderPath;
66
- this.importDataActions = importDataActions;
67
- this.setupOptions = setupOptions;
68
- this.documentCache = new Map();
69
- this.databasesToRun = databasesToRun || [];
70
- }
71
-
72
- async run(specificCollections?: string[]) {
73
- let databasesToProcess: Models.Database[];
74
-
75
- if (this.databasesToRun.length > 0) {
76
- // Use the provided databases
77
- databasesToProcess = this.databasesToRun;
78
- } else {
79
- // If no databases are specified, fetch all databases
80
- const allDatabases = await this.database.list();
81
- databasesToProcess = allDatabases.databases;
82
- }
83
-
84
- let dataLoader: DataLoader | undefined;
85
- let databaseRan: Models.Database | undefined;
86
-
87
- for (let db of databasesToProcess) {
88
- MessageFormatter.banner(`Starting import data for database: ${db.name}`, "Database Import");
89
-
90
- if (!databaseRan) {
91
- databaseRan = db;
92
- dataLoader = new DataLoader(
93
- this.appwriteFolderPath,
94
- this.importDataActions,
95
- this.database,
96
- this.config,
97
- this.setupOptions.shouldWriteFile
98
- );
99
- await dataLoader.setupMaps(db.$id);
100
- await dataLoader.start(db.$id);
101
- await this.importCollections(db, dataLoader, specificCollections);
102
- await resolveAndUpdateRelationships(db.$id, this.database, this.config);
103
- await this.executePostImportActions(
104
- db.$id,
105
- dataLoader,
106
- specificCollections
107
- );
108
- } else if (databaseRan.$id !== db.$id) {
109
- await this.updateOthersToFinalData(databaseRan, db);
110
- }
111
-
112
- MessageFormatter.divider();
113
- MessageFormatter.success(`Finished import data for database: ${db.name}`, { prefix: "Import" });
114
- MessageFormatter.divider();
115
- }
116
- }
117
-
118
- async updateOthersToFinalData(
119
- updatedDb: Models.Database,
120
- targetDb: Models.Database
121
- ) {
122
- if (this.database) {
123
- await transferDatabaseLocalToLocal(
124
- this.database,
125
- updatedDb.$id,
126
- targetDb.$id
127
- );
128
- }
129
-
130
- if (this.storage) {
131
- // Find the corresponding database configs
132
- const updatedDbConfig = this.config.databases.find(
133
- (db) => db.$id === updatedDb.$id
134
- );
135
- const targetDbConfig = this.config.databases.find(
136
- (db) => db.$id === targetDb.$id
137
- );
138
-
139
- const allBuckets = await this.storage.listBuckets([Query.limit(1000)]);
140
- const bucketsWithDbIdInThem = allBuckets.buckets.filter((bucket) =>
141
- bucket.name.toLowerCase().includes(updatedDb.$id.toLowerCase())
142
- );
143
- const configuredUpdatedBucketId = `${
144
- this.config.documentBucketId
145
- }_${updatedDb.$id.toLowerCase().trim().replace(" ", "")}`;
146
- const configuredTargetBucketId = `${
147
- this.config.documentBucketId
148
- }_${targetDb.$id.toLowerCase().trim().replace(" ", "")}`;
149
-
150
- let sourceBucketId: string | undefined;
151
- let targetBucketId: string | undefined;
152
-
153
- if (
154
- bucketsWithDbIdInThem.find(
155
- (bucket) => bucket.$id === configuredUpdatedBucketId
156
- )
157
- ) {
158
- sourceBucketId = configuredUpdatedBucketId;
159
- } else if (
160
- bucketsWithDbIdInThem.find(
161
- (bucket) => bucket.$id === configuredTargetBucketId
162
- )
163
- ) {
164
- targetBucketId = configuredTargetBucketId;
165
- }
166
-
167
- if (!sourceBucketId) {
168
- sourceBucketId =
169
- updatedDbConfig?.bucket?.$id || bucketsWithDbIdInThem[0]?.$id;
170
- }
171
-
172
- if (!targetBucketId) {
173
- targetBucketId =
174
- targetDbConfig?.bucket?.$id || bucketsWithDbIdInThem[0]?.$id;
175
- }
176
-
177
- if (sourceBucketId && targetBucketId) {
178
- await transferStorageLocalToLocal(
179
- this.storage,
180
- sourceBucketId,
181
- targetBucketId
182
- );
183
- }
184
- }
185
- }
186
-
187
- async importCollections(
188
- db: ConfigDatabase,
189
- dataLoader: DataLoader,
190
- specificCollections?: string[]
191
- ) {
192
- const collectionsToImport =
193
- specificCollections ||
194
- (this.config.collections
195
- ? this.config.collections.map((c) => c.name)
196
- : []);
197
-
198
- for (const collection of this.config.collections || []) {
199
- if (collectionsToImport.includes(collection.name)) {
200
- let isUsersCollection =
201
- this.config.usersCollectionName &&
202
- dataLoader.getCollectionKey(this.config.usersCollectionName) ===
203
- dataLoader.getCollectionKey(collection.name);
204
- const importOperationId = dataLoader.collectionImportOperations.get(
205
- dataLoader.getCollectionKey(collection.name)
206
- );
207
- const createBatches = (finalData: CollectionImportData["data"]) => {
208
- let maxBatchLength = 50;
209
- const finalBatches: CollectionImportData["data"][] = [];
210
- for (let i = 0; i < finalData.length; i++) {
211
- if (i % maxBatchLength === 0) {
212
- finalBatches.push([]);
213
- }
214
- finalBatches[finalBatches.length - 1].push(finalData[i]);
215
- }
216
- return finalBatches;
217
- };
218
-
219
- if (isUsersCollection && !this.hasImportedUsers) {
220
- const usersDataMap = dataLoader.importMap.get(
221
- dataLoader.getCollectionKey("users")
222
- );
223
- const usersData = usersDataMap?.data;
224
- const usersController = new UsersController(
225
- this.config,
226
- this.database
227
- );
228
- if (usersData) {
229
- console.log("Found users data", usersData.length);
230
- const userDataBatches = createBatches(usersData);
231
- for (const batch of userDataBatches) {
232
- console.log("Importing users batch", batch.length);
233
- const userBatchPromises = batch
234
- .filter((item) => {
235
- let itemId: string | undefined;
236
- if (item.finalData.userId) {
237
- itemId = item.finalData.userId;
238
- } else if (item.finalData.docId) {
239
- itemId = item.finalData.docId;
240
- }
241
- if (!itemId) {
242
- return false;
243
- }
244
- return (
245
- item &&
246
- item.finalData &&
247
- !dataLoader.userExistsMap.has(itemId)
248
- );
249
- })
250
- .map((item) => {
251
- dataLoader.userExistsMap.set(
252
- item.finalData.userId ||
253
- item.finalData.docId ||
254
- item.context.userId ||
255
- item.context.docId,
256
- true
257
- );
258
- return usersController.createUserAndReturn(item.finalData);
259
- });
260
- const promiseResults = await Promise.allSettled(
261
- userBatchPromises
262
- );
263
- for (const item of batch) {
264
- if (item && item.finalData) {
265
- dataLoader.userExistsMap.set(
266
- item.finalData.userId ||
267
- item.finalData.docId ||
268
- item.context.userId ||
269
- item.context.docId,
270
- true
271
- );
272
- }
273
- }
274
- MessageFormatter.success("Finished importing users batch", { prefix: "Import" });
275
- }
276
- this.hasImportedUsers = true;
277
- MessageFormatter.success("Finished importing users", { prefix: "Import" });
278
- }
279
- }
280
-
281
- if (!importOperationId) {
282
- // Skip further processing if no import operation is found
283
- continue;
284
- }
285
-
286
- let importOperation: any = null;
287
- importOperation = await this.database.getDocument(
288
- "migrations",
289
- "currentOperations",
290
- importOperationId
291
- );
292
- const adapter = new LegacyAdapter(this.database.client);
293
- await updateOperation(adapter, db.$id, importOperation.$id, {
294
- status: "in_progress",
295
- });
296
-
297
- const collectionData = dataLoader.importMap.get(
298
- dataLoader.getCollectionKey(collection.name)
299
- );
300
- MessageFormatter.processing(`Processing collection: ${collection.name}...`, { prefix: "Import" });
301
- if (!collectionData) {
302
- MessageFormatter.warning(`No collection data for ${collection.name}`, { prefix: "Import" });
303
- continue;
304
- }
305
-
306
- const dataSplit = createBatches(collectionData.data);
307
- let processedItems = 0;
308
- for (let i = 0; i < dataSplit.length; i++) {
309
- const batches = dataSplit[i];
310
- MessageFormatter.progress(`Processing batch ${i + 1} of ${dataSplit.length}`, { prefix: "Import" });
311
-
312
- const batchPromises = batches.map((item, index) => {
313
- try {
314
- const id =
315
- item.finalData.docId ||
316
- item.finalData.userId ||
317
- item.context.docId ||
318
- item.context.userId;
319
-
320
- if (item.finalData.hasOwnProperty("userId")) {
321
- delete item.finalData.userId;
322
- }
323
- if (item.finalData.hasOwnProperty("docId")) {
324
- delete item.finalData.docId;
325
- }
326
- if (!item.finalData) {
327
- return Promise.resolve();
328
- }
329
- return tryAwaitWithRetry(
330
- async () =>
331
- await this.database.createDocument(
332
- db.$id,
333
- collection.$id!,
334
- id,
335
- item.finalData
336
- )
337
- );
338
- } catch (error) {
339
- MessageFormatter.error(
340
- "Error creating document",
341
- error instanceof Error ? error : new Error(String(error)),
342
- { prefix: "Import" }
343
- );
344
- return Promise.resolve();
345
- }
346
- });
347
-
348
- // Wait for all promises in the current batch to resolve
349
- await Promise.all(batchPromises);
350
- MessageFormatter.success(`Completed batch ${i + 1} of ${dataSplit.length}`, { prefix: "Import" });
351
- if (importOperation) {
352
- const adapter = new LegacyAdapter(this.database.client);
353
- await updateOperation(adapter, db.$id, importOperation.$id, {
354
- progress: processedItems,
355
- });
356
- }
357
- }
358
- // After all batches are processed, update the operation status to completed
359
- if (importOperation) {
360
- const adapter = new LegacyAdapter(this.database.client);
361
- await updateOperation(adapter, db.$id, importOperation.$id, {
362
- status: "completed",
363
- });
364
- }
365
- }
366
- }
367
- }
368
-
369
- async executePostImportActions(
370
- dbId: string,
371
- dataLoader: DataLoader,
372
- specificCollections?: string[]
373
- ) {
374
- MessageFormatter.info("Executing post-import actions...", { prefix: "Import" });
375
- const collectionsToProcess =
376
- specificCollections && specificCollections.length > 0
377
- ? specificCollections
378
- : this.config.collections
379
- ? this.config.collections.map((c) => c.name)
380
- : Array.from(dataLoader.importMap.keys());
381
- MessageFormatter.info(`Collections to process: ${collectionsToProcess.join(", ")}`, { prefix: "Import" });
382
- // Iterate over each collection in the importMap
383
- for (const [
384
- collectionKey,
385
- collectionData,
386
- ] of dataLoader.importMap.entries()) {
387
- const allCollectionKeys = collectionsToProcess.map((c) =>
388
- dataLoader.getCollectionKey(c)
389
- );
390
- if (allCollectionKeys.includes(collectionKey)) {
391
- MessageFormatter.processing(
392
- `Processing post-import actions for collection: ${collectionKey}`,
393
- { prefix: "Import" }
394
- );
395
-
396
- // Iterate over each item in the collectionData.data
397
- for (const item of collectionData.data) {
398
- // Assuming each item has attributeMappings that contain actions to be executed
399
- if (item.importDef && item.importDef.attributeMappings) {
400
- // Use item.context as the context for action execution
401
- const context = item.context; // Directly use item.context as the context for action execution
402
- // Iterate through attributeMappings to execute actions
403
- try {
404
- // Execute post-import actions for the current attributeMapping
405
- // Pass item.finalData as the data to be processed along with the context
406
- await this.importDataActions.executeAfterImportActions(
407
- item.finalData,
408
- item.importDef.attributeMappings,
409
- context
410
- );
411
- } catch (error) {
412
- MessageFormatter.error(
413
- `Failed to execute post-import actions for item in collection ${collectionKey}`,
414
- error instanceof Error ? error : new Error(String(error)),
415
- { prefix: "Import" }
416
- );
417
- }
418
- }
419
- }
420
- } else {
421
- MessageFormatter.info(
422
- `Skipping collection: ${collectionKey} because it's not valid for post-import actions`,
423
- { prefix: "Import" }
424
- );
425
- }
426
- }
427
- }
428
- }