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
@@ -1,491 +0,0 @@
1
- import { SchemaGenerator } from "../shared/schemaGenerator.js";
2
- import { findYamlConfig } from "../config/yamlConfig.js";
3
- import { Client, Compression, Databases, Query, Storage, } from "node-appwrite";
4
- import { fetchAllCollections } from "../collections/methods.js";
5
- import { fetchAllDatabases } from "../databases/methods.js";
6
- import { CollectionSchema, attributeSchema, AppwriteConfigSchema, permissionsSchema, attributesSchema, indexesSchema, parseAttribute, } from "appwrite-utils";
7
- import { getDatabaseFromConfig } from "./afterImportActions.js";
8
- import { getAdapterFromConfig } from "../utils/getClientFromConfig.js";
9
- import { listBuckets } from "../storage/methods.js";
10
- import { listFunctions, listFunctionDeployments, getFunction } from "../functions/methods.js";
11
- import { MessageFormatter } from "../shared/messageFormatter.js";
12
- import { isLegacyDatabases } from "../utils/typeGuards.js";
13
- /**
14
- * Convert between collection and table terminology based on data structure
15
- */
16
- function normalizeCollectionOrTable(collection) {
17
- // Check if this is a table (has columns) or collection (has attributes)
18
- const isTable = collection.columns && Array.isArray(collection.columns);
19
- if (isTable) {
20
- // Table structure - convert columns to attributes
21
- MessageFormatter.debug(`Detected table structure: ${collection.name || collection.tableName}`, { prefix: "Migration" });
22
- return {
23
- ...collection,
24
- attributes: collection.columns || [],
25
- permissions: collection.$permissions || collection.permissions || [],
26
- name: collection.name || collection.tableName,
27
- $id: collection.$id || collection.tableId,
28
- enabled: collection.enabled ?? true
29
- };
30
- }
31
- else {
32
- // Collection structure - use as-is with fallbacks
33
- MessageFormatter.debug(`Detected collection structure: ${collection.name}`, { prefix: "Migration" });
34
- return {
35
- ...collection,
36
- attributes: collection.attributes || [],
37
- permissions: collection.$permissions || collection.permissions || [],
38
- name: collection.name,
39
- $id: collection.$id,
40
- enabled: collection.enabled ?? true
41
- };
42
- }
43
- }
44
- export class AppwriteToX {
45
- config;
46
- storage;
47
- updatedConfig;
48
- collToAttributeMap = new Map();
49
- appwriteFolderPath;
50
- adapter;
51
- apiMode;
52
- databaseApiModes = new Map();
53
- constructor(config, appwriteFolderPath, storage) {
54
- this.config = config;
55
- this.updatedConfig = config;
56
- this.storage = storage;
57
- this.appwriteFolderPath = appwriteFolderPath;
58
- this.ensureClientInitialized();
59
- }
60
- /**
61
- * Initialize adapter for database operations with API mode detection
62
- */
63
- async initializeAdapter() {
64
- if (!this.adapter) {
65
- try {
66
- const { adapter, apiMode } = await getAdapterFromConfig(this.config);
67
- this.adapter = adapter;
68
- this.apiMode = apiMode;
69
- MessageFormatter.info(`Initialized database adapter with API mode: ${apiMode}`, { prefix: "Migration" });
70
- }
71
- catch (error) {
72
- MessageFormatter.warning(`Failed to initialize adapter, falling back to legacy client: ${error instanceof Error ? error.message : 'Unknown error'}`, { prefix: "Migration" });
73
- // Fallback to legacy client initialization
74
- this.ensureClientInitialized();
75
- }
76
- }
77
- }
78
- ensureClientInitialized() {
79
- if (!this.config.appwriteClient) {
80
- const client = new Client();
81
- client
82
- .setEndpoint(this.config.appwriteEndpoint)
83
- .setProject(this.config.appwriteProject)
84
- .setKey(this.config.appwriteKey);
85
- this.config.appwriteClient = client;
86
- }
87
- }
88
- // Function to parse a single permission string
89
- parsePermissionString = (permissionString) => {
90
- const match = permissionString.match(/^(\w+)\('([^']+)'\)$/);
91
- if (!match) {
92
- throw new Error(`Invalid permission format: ${permissionString}`);
93
- }
94
- return {
95
- permission: match[1],
96
- target: match[2],
97
- };
98
- };
99
- // Function to parse an array of permission strings
100
- parsePermissionsArray = (permissions) => {
101
- if (permissions.length === 0) {
102
- return [];
103
- }
104
- const parsedPermissions = permissionsSchema.parse(permissions);
105
- // Validate the parsed permissions using Zod
106
- return parsedPermissions ?? [];
107
- };
108
- updateCollectionConfigAttributes = (collection) => {
109
- // Normalize collection/table structure to handle both TablesDB and Legacy formats
110
- const normalizedCollection = normalizeCollectionOrTable(collection);
111
- for (const attribute of normalizedCollection.attributes) {
112
- if (!attribute) {
113
- MessageFormatter.warning("Skipping null/undefined attribute in updateCollectionConfigAttributes", { prefix: "Migration" });
114
- continue;
115
- }
116
- const attributeParsed = attributeSchema.parse(attribute);
117
- this.collToAttributeMap
118
- .get(normalizedCollection.name)
119
- ?.push(attributeParsed);
120
- }
121
- };
122
- /**
123
- * Fetch collections/tables using the appropriate adapter or legacy client
124
- */
125
- async fetchCollectionsOrTables(databaseId, db) {
126
- // Try to use adapter first
127
- if (this.adapter) {
128
- try {
129
- const result = await this.adapter.listTables({ databaseId });
130
- const items = result.tables || result.collections || [];
131
- MessageFormatter.info(`Fetched ${items.length} items using ${this.apiMode} adapter`, { prefix: "Migration" });
132
- return items;
133
- }
134
- catch (error) {
135
- MessageFormatter.warning(`Adapter fetch failed, falling back to legacy: ${error instanceof Error ? error.message : 'Unknown error'}`, { prefix: "Migration" });
136
- }
137
- }
138
- // Fallback to legacy method
139
- try {
140
- const collections = await fetchAllCollections(databaseId, db);
141
- MessageFormatter.info(`Fetched ${collections.length} collections using legacy client`, { prefix: "Migration" });
142
- return collections;
143
- }
144
- catch (error) {
145
- MessageFormatter.error("Failed to fetch collections with both adapter and legacy methods", error instanceof Error ? error : new Error(String(error)), { prefix: "Migration" });
146
- throw error;
147
- }
148
- }
149
- /**
150
- * Get collection/table using the appropriate adapter or legacy client
151
- */
152
- async getCollectionOrTable(databaseId, collectionId) {
153
- // Try to use adapter first
154
- if (this.adapter) {
155
- try {
156
- const result = await this.adapter.getTable({ databaseId, tableId: collectionId });
157
- return result;
158
- }
159
- catch (error) {
160
- MessageFormatter.warning(`Adapter get failed, falling back to legacy: ${error instanceof Error ? error.message : 'Unknown error'}`, { prefix: "Migration" });
161
- }
162
- }
163
- // Fallback to legacy method
164
- const db = getDatabaseFromConfig(this.config);
165
- return await db.getCollection(databaseId, collectionId);
166
- }
167
- /**
168
- * Detect API mode for a specific database by testing adapter capabilities
169
- */
170
- async detectDatabaseApiMode(databaseId) {
171
- // If we already detected this database, return cached result
172
- if (this.databaseApiModes.has(databaseId)) {
173
- return this.databaseApiModes.get(databaseId);
174
- }
175
- // If we have a global adapter, use its API mode as default
176
- if (this.apiMode) {
177
- this.databaseApiModes.set(databaseId, this.apiMode);
178
- MessageFormatter.debug(`Using global API mode for database ${databaseId}: ${this.apiMode}`, { prefix: "Migration" });
179
- return this.apiMode;
180
- }
181
- // Default to legacy if no adapter available
182
- const defaultMode = 'legacy';
183
- this.databaseApiModes.set(databaseId, defaultMode);
184
- MessageFormatter.debug(`Defaulting to legacy mode for database ${databaseId}`, { prefix: "Migration" });
185
- return defaultMode;
186
- }
187
- /**
188
- * Get API mode context for schema generation
189
- */
190
- getSchemaGeneratorApiContext() {
191
- const databaseModes = {};
192
- // Get API mode for each database
193
- for (const db of this.updatedConfig.databases || []) {
194
- const apiMode = this.databaseApiModes.get(db.$id) || this.apiMode || 'legacy';
195
- databaseModes[db.$id] = apiMode;
196
- }
197
- return {
198
- apiMode: this.apiMode || 'legacy',
199
- databaseApiModes: databaseModes,
200
- adapterMetadata: this.adapter?.getMetadata()
201
- };
202
- }
203
- async appwriteSync(config, databases, databaseSelections, bucketSelections) {
204
- // Initialize adapter for proper API mode detection and usage
205
- await this.initializeAdapter();
206
- const db = getDatabaseFromConfig(config);
207
- if (!databases) {
208
- try {
209
- MessageFormatter.info("Fetching remote databases...", { prefix: "Migration" });
210
- databases = await fetchAllDatabases(db);
211
- MessageFormatter.info(`Found ${databases.length} remote databases`, { prefix: "Migration" });
212
- }
213
- catch (error) {
214
- MessageFormatter.error("Failed to fetch remote databases", error instanceof Error ? error : new Error(String(error)), { prefix: "Migration" });
215
- throw new Error(`Database fetch failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
216
- }
217
- }
218
- // Filter databases based on selection if provided
219
- let databasesToProcess = databases;
220
- if (databaseSelections && databaseSelections.length > 0) {
221
- databasesToProcess = databases?.filter(db => databaseSelections.some(selection => selection.databaseId === db.$id)) || [];
222
- MessageFormatter.info(`Filtered to ${databasesToProcess.length} selected databases`, { prefix: "Migration" });
223
- }
224
- let updatedConfig = { ...config };
225
- // Initialize databases array if it doesn't exist
226
- if (!updatedConfig.databases) {
227
- updatedConfig.databases = [];
228
- }
229
- // Sync remote databases to local config - add missing ones
230
- MessageFormatter.info(`Syncing ${databasesToProcess.length} remote databases with local config...`, { prefix: "Migration" });
231
- let addedCount = 0;
232
- let updatedCount = 0;
233
- for (const remoteDb of databasesToProcess) {
234
- // Check if this database already exists in the config
235
- const existingDbIndex = updatedConfig.databases.findIndex((localDb) => localDb.$id === remoteDb.$id);
236
- if (existingDbIndex === -1) {
237
- // Database doesn't exist locally, add it
238
- MessageFormatter.success(`Adding new database to config: ${remoteDb.name} (${remoteDb.$id})`, { prefix: "Migration" });
239
- updatedConfig.databases.push({
240
- $id: remoteDb.$id,
241
- name: remoteDb.name,
242
- });
243
- addedCount++;
244
- }
245
- else {
246
- // Database exists, update name if different
247
- if (updatedConfig.databases[existingDbIndex].name !== remoteDb.name) {
248
- MessageFormatter.info(`Updating database name: ${updatedConfig.databases[existingDbIndex].name} -> ${remoteDb.name}`, { prefix: "Migration" });
249
- updatedConfig.databases[existingDbIndex].name = remoteDb.name;
250
- updatedCount++;
251
- }
252
- }
253
- }
254
- MessageFormatter.success(`Database sync summary: ${addedCount} added, ${updatedCount} updated, ${updatedConfig.databases.length} total`, { prefix: "Migration" });
255
- // Fetch all buckets
256
- const allBuckets = await listBuckets(this.storage);
257
- // Filter buckets based on selection if provided
258
- let matchedBuckets = allBuckets.buckets;
259
- if (bucketSelections && bucketSelections.length > 0) {
260
- matchedBuckets = allBuckets.buckets.filter(bucket => bucketSelections.some(selection => selection.bucketId === bucket.$id));
261
- MessageFormatter.info(`Filtered to ${matchedBuckets.length} selected buckets`, { prefix: "Migration" });
262
- }
263
- // Loop through each database
264
- for (const database of databasesToProcess) {
265
- // Detect API mode for this specific database
266
- const dbApiMode = await this.detectDatabaseApiMode(database.$id);
267
- MessageFormatter.info(`Processing database '${database.name}' with API mode: ${dbApiMode}`, { prefix: "Migration" });
268
- // Match bucket to database (from filtered buckets if selections provided)
269
- const matchedBucket = matchedBuckets.find((bucket) => bucket.$id.toLowerCase().includes(database.$id.toLowerCase()));
270
- if (matchedBucket) {
271
- const dbConfig = updatedConfig.databases.find((db) => db.$id === database.$id);
272
- if (dbConfig) {
273
- dbConfig.bucket = {
274
- $id: matchedBucket.$id,
275
- name: matchedBucket.name,
276
- enabled: matchedBucket.enabled,
277
- maximumFileSize: matchedBucket.maximumFileSize,
278
- allowedFileExtensions: matchedBucket.allowedFileExtensions,
279
- compression: matchedBucket.compression,
280
- encryption: matchedBucket.encryption,
281
- antivirus: matchedBucket.antivirus,
282
- };
283
- }
284
- }
285
- // Use adapter-aware collection/table fetching with proper API mode detection
286
- const collections = await this.fetchCollectionsOrTables(database.$id, db);
287
- // Filter collections based on table selection if provided
288
- let collectionsToProcess = collections;
289
- if (databaseSelections && databaseSelections.length > 0) {
290
- const dbSelection = databaseSelections.find(selection => selection.databaseId === database.$id);
291
- if (dbSelection && dbSelection.tableIds.length > 0) {
292
- collectionsToProcess = collections.filter(collection => dbSelection.tableIds.includes(collection.$id));
293
- MessageFormatter.info(`Filtered to ${collectionsToProcess.length} selected tables for database '${database.name}'`, { prefix: "Migration" });
294
- }
295
- }
296
- // Loop through each collection in the current database
297
- if (!updatedConfig.collections) {
298
- updatedConfig.collections = [];
299
- }
300
- MessageFormatter.info(`Processing ${collectionsToProcess.length} collections/tables in database '${database.name}'`, { prefix: "Migration" });
301
- let processedCount = 0;
302
- let errorCount = 0;
303
- for (const collection of collectionsToProcess) {
304
- try {
305
- if (!collection) {
306
- MessageFormatter.warning("Skipping null/undefined collection", { prefix: "Migration" });
307
- errorCount++;
308
- continue;
309
- }
310
- // Normalize collection/table structure to handle both TablesDB and Legacy formats
311
- const normalizedCollection = normalizeCollectionOrTable(collection);
312
- MessageFormatter.processing(`Processing ${normalizedCollection.name} (${normalizedCollection.$id})`, { prefix: "Migration" });
313
- const existingCollectionIndex = updatedConfig.collections.findIndex((c) => c.name === normalizedCollection.name);
314
- // Parse the collection permissions and attributes using normalized structure
315
- const collPermissions = this.parsePermissionsArray(normalizedCollection.permissions);
316
- // Process attributes with proper error handling
317
- let collAttributes = [];
318
- try {
319
- collAttributes = normalizedCollection.attributes
320
- .map((attr) => {
321
- if (!attr) {
322
- MessageFormatter.warning("Skipping null/undefined attribute", { prefix: "Migration" });
323
- return null;
324
- }
325
- return parseAttribute(attr);
326
- })
327
- .filter((attribute) => attribute !== null &&
328
- (attribute.type !== "relationship" ? true : attribute.side !== "child"));
329
- }
330
- catch (error) {
331
- MessageFormatter.error(`Error processing attributes for ${normalizedCollection.name}`, error instanceof Error ? error : new Error(String(error)), { prefix: "Migration" });
332
- // Continue with empty attributes array
333
- collAttributes = [];
334
- }
335
- for (const attribute of collAttributes) {
336
- if (attribute.type === "relationship" &&
337
- attribute.relatedCollection) {
338
- MessageFormatter.info(`Fetching related collection for ID: ${attribute.relatedCollection}`, { prefix: "Migration" });
339
- try {
340
- const relatedCollectionPulled = await this.getCollectionOrTable(database.$id, attribute.relatedCollection);
341
- MessageFormatter.info(`Fetched Collection Name: ${relatedCollectionPulled.name}`, { prefix: "Migration" });
342
- attribute.relatedCollection = relatedCollectionPulled.name;
343
- MessageFormatter.info(`Updated attribute.relatedCollection to: ${attribute.relatedCollection}`, { prefix: "Migration" });
344
- }
345
- catch (error) {
346
- MessageFormatter.error("Error fetching related collection", error instanceof Error ? error : new Error(String(error)), { prefix: "Migration" });
347
- }
348
- }
349
- }
350
- this.collToAttributeMap.set(normalizedCollection.name, collAttributes);
351
- // Process indexes with proper error handling using normalized collection
352
- let collIndexes = [];
353
- try {
354
- const finalIndexes = (normalizedCollection.indexes || collection.indexes || []).map((index) => {
355
- if (!index) {
356
- MessageFormatter.warning("Skipping null/undefined index", { prefix: "Migration" });
357
- return null;
358
- }
359
- return {
360
- ...index,
361
- // Convert TablesDB 'columns' to expected 'attributes' for schema validation
362
- attributes: index.attributes || index.columns || [],
363
- orders: index.orders?.filter((order) => {
364
- return order !== null && order;
365
- }),
366
- };
367
- }).filter((index) => index !== null);
368
- collIndexes = indexesSchema.parse(finalIndexes) ?? [];
369
- }
370
- catch (error) {
371
- MessageFormatter.error(`Error processing indexes for ${normalizedCollection.name}`, error instanceof Error ? error : new Error(String(error)), { prefix: "Migration" });
372
- // Continue with empty indexes array
373
- collIndexes = [];
374
- }
375
- // Prepare the collection object to be added or updated using normalized data
376
- const collToPush = CollectionSchema.parse({
377
- $id: normalizedCollection.$id,
378
- name: normalizedCollection.name,
379
- enabled: normalizedCollection.enabled,
380
- documentSecurity: collection.documentSecurity, // Use original collection for this field
381
- $createdAt: collection.$createdAt, // Use original collection for timestamps
382
- $updatedAt: collection.$updatedAt,
383
- $permissions: collPermissions.length > 0 ? collPermissions : undefined,
384
- indexes: collIndexes.length > 0 ? collIndexes : undefined,
385
- attributes: collAttributes.length > 0 ? collAttributes : undefined,
386
- });
387
- if (existingCollectionIndex !== -1) {
388
- // Update existing collection
389
- updatedConfig.collections[existingCollectionIndex] = collToPush;
390
- MessageFormatter.debug(`Updated existing collection: ${normalizedCollection.name}`, { prefix: "Migration" });
391
- }
392
- else {
393
- // Add new collection
394
- updatedConfig.collections.push(collToPush);
395
- MessageFormatter.debug(`Added new collection: ${normalizedCollection.name}`, { prefix: "Migration" });
396
- }
397
- processedCount++;
398
- }
399
- catch (error) {
400
- MessageFormatter.error(`Error processing collection: ${collection?.name || 'unknown'}`, error instanceof Error ? error : new Error(String(error)), { prefix: "Migration" });
401
- errorCount++;
402
- }
403
- }
404
- MessageFormatter.success(`Database '${database.name}' processing complete: ${processedCount} collections processed, ${errorCount} errors`, { prefix: "Migration" });
405
- }
406
- // Add unmatched buckets as global buckets
407
- // Use filtered buckets if selections provided, otherwise use all buckets
408
- const sourceBuckets = bucketSelections && bucketSelections.length > 0 ? matchedBuckets : allBuckets.buckets;
409
- const globalBuckets = sourceBuckets.filter((bucket) => !updatedConfig.databases.some((db) => db.bucket && db.bucket.$id === bucket.$id));
410
- updatedConfig.buckets = globalBuckets.map((bucket) => ({
411
- $id: bucket.$id,
412
- name: bucket.name,
413
- enabled: bucket.enabled,
414
- maximumFileSize: bucket.maximumFileSize,
415
- allowedFileExtensions: bucket.allowedFileExtensions,
416
- compression: bucket.compression,
417
- encryption: bucket.encryption,
418
- antivirus: bucket.antivirus,
419
- }));
420
- const remoteFunctions = await listFunctions(this.config.appwriteClient, [
421
- Query.limit(1000),
422
- ]);
423
- // Fetch full details per function to ensure 'scopes' and other fields are present
424
- const detailedFunctions = [];
425
- for (const f of remoteFunctions.functions) {
426
- try {
427
- const full = await getFunction(this.config.appwriteClient, f.$id);
428
- detailedFunctions.push(full);
429
- }
430
- catch {
431
- detailedFunctions.push(f);
432
- }
433
- }
434
- this.updatedConfig.functions = detailedFunctions.map((func) => ({
435
- $id: func.$id,
436
- name: func.name,
437
- runtime: func.runtime,
438
- execute: func.execute,
439
- events: func.events || [],
440
- schedule: func.schedule || "",
441
- timeout: func.timeout || 15,
442
- enabled: func.enabled !== false,
443
- logging: func.logging !== false,
444
- entrypoint: func.entrypoint || "src/index.ts",
445
- commands: func.commands || "npm install",
446
- scopes: Array.isArray(func.scopes) ? func.scopes : [],
447
- dirPath: `functions/${func.name}`,
448
- specification: func.specification,
449
- }));
450
- // Make sure to update the config with all changes including databases
451
- updatedConfig.functions = this.updatedConfig.functions;
452
- this.updatedConfig = updatedConfig;
453
- MessageFormatter.success(`Sync completed - ${updatedConfig.databases.length} databases, ${updatedConfig.collections?.length || 0} collections, ${updatedConfig.buckets?.length || 0} buckets, ${updatedConfig.functions?.length || 0} functions`, { prefix: "Migration" });
454
- }
455
- async toSchemas(databases, databaseSelections, bucketSelections) {
456
- try {
457
- MessageFormatter.info("Starting sync-from-Appwrite process...", { prefix: "Migration" });
458
- await this.appwriteSync(this.config, databases, databaseSelections, bucketSelections);
459
- const generator = new SchemaGenerator(this.updatedConfig, this.appwriteFolderPath);
460
- // Pass API mode context to the schema generator
461
- const apiContext = this.getSchemaGeneratorApiContext();
462
- // Extend the config with API mode information for schema generation
463
- const configWithApiContext = {
464
- ...this.updatedConfig,
465
- apiMode: apiContext.apiMode,
466
- databaseApiModes: apiContext.databaseApiModes,
467
- adapterMetadata: apiContext.adapterMetadata
468
- };
469
- // Check if this is a YAML-based project
470
- const yamlConfigPath = findYamlConfig(this.appwriteFolderPath);
471
- const isYamlProject = !!yamlConfigPath;
472
- if (isYamlProject) {
473
- MessageFormatter.info("Detected YAML configuration - generating YAML collection definitions", { prefix: "Migration" });
474
- generator.updateYamlCollections();
475
- await generator.updateConfig(configWithApiContext, true);
476
- }
477
- else {
478
- MessageFormatter.info("Generating TypeScript collection definitions", { prefix: "Migration" });
479
- generator.updateTsSchemas();
480
- await generator.updateConfig(configWithApiContext, false);
481
- }
482
- MessageFormatter.info("Generating Zod schemas from synced collections...", { prefix: "Migration" });
483
- await generator.generateSchemas();
484
- MessageFormatter.success("Sync-from-Appwrite process completed successfully", { prefix: "Migration" });
485
- }
486
- catch (error) {
487
- MessageFormatter.error("Error during sync-from-Appwrite process", error instanceof Error ? error : new Error(String(error)), { prefix: "Migration" });
488
- throw error;
489
- }
490
- }
491
- }
@@ -1,147 +0,0 @@
1
- export interface ComprehensiveTransferOptions {
2
- sourceEndpoint: string;
3
- sourceProject: string;
4
- sourceKey: string;
5
- targetEndpoint: string;
6
- targetProject: string;
7
- targetKey: string;
8
- transferUsers?: boolean;
9
- transferTeams?: boolean;
10
- transferDatabases?: boolean;
11
- transferBuckets?: boolean;
12
- transferFunctions?: boolean;
13
- concurrencyLimit?: number;
14
- dryRun?: boolean;
15
- }
16
- export interface TransferResults {
17
- users: {
18
- transferred: number;
19
- skipped: number;
20
- failed: number;
21
- };
22
- teams: {
23
- transferred: number;
24
- skipped: number;
25
- failed: number;
26
- };
27
- databases: {
28
- transferred: number;
29
- skipped: number;
30
- failed: number;
31
- };
32
- buckets: {
33
- transferred: number;
34
- skipped: number;
35
- failed: number;
36
- };
37
- functions: {
38
- transferred: number;
39
- skipped: number;
40
- failed: number;
41
- };
42
- totalTime: number;
43
- }
44
- export declare class ComprehensiveTransfer {
45
- private options;
46
- private sourceClient;
47
- private targetClient;
48
- private sourceUsers;
49
- private targetUsers;
50
- private sourceTeams;
51
- private targetTeams;
52
- private sourceDatabases;
53
- private targetDatabases;
54
- private sourceStorage;
55
- private targetStorage;
56
- private sourceFunctions;
57
- private targetFunctions;
58
- private limit;
59
- private userLimit;
60
- private fileLimit;
61
- private results;
62
- private startTime;
63
- private tempDir;
64
- private cachedMaxFileSize?;
65
- private sourceAdapter?;
66
- private targetAdapter?;
67
- constructor(options: ComprehensiveTransferOptions);
68
- execute(): Promise<TransferResults>;
69
- private transferAllUsers;
70
- private transferAllTeams;
71
- private transferAllDatabases;
72
- /**
73
- * Phase 1: Create database structure (collections, attributes, indexes) without transferring documents
74
- */
75
- private createDatabaseStructure;
76
- /**
77
- * Phase 2: Transfer documents to all collections in the database
78
- */
79
- private transferDatabaseDocuments;
80
- private transferAllBuckets;
81
- private createBucketWithFallback;
82
- private transferBucketFiles;
83
- private validateAndDownloadFile;
84
- private transferAllFunctions;
85
- private downloadFunction;
86
- /**
87
- * Helper method to fetch all collections from a database
88
- */
89
- private fetchAllCollections;
90
- /**
91
- * Helper method to fetch all buckets with pagination
92
- */
93
- private fetchAllBuckets;
94
- /**
95
- * Helper method to parse attribute objects (simplified version of parseAttribute)
96
- */
97
- private parseAttribute;
98
- /**
99
- * Helper method to create collection attributes with status checking
100
- */
101
- private createCollectionAttributesWithStatusCheck;
102
- /**
103
- * Helper method to create collection indexes with status checking
104
- */
105
- private createCollectionIndexesWithStatusCheck;
106
- /**
107
- * Helper method to transfer documents between databases using bulk operations with content and permission-based filtering
108
- */
109
- private transferDocumentsBetweenDatabases;
110
- /**
111
- * Fetch target documents by IDs in batches to check existence and permissions
112
- */
113
- private fetchTargetDocumentsBatch;
114
- /**
115
- * Transfer documents using bulk operations with proper batch size handling
116
- */
117
- private transferDocumentsBulk;
118
- /**
119
- * Direct HTTP implementation of bulk upsert API
120
- */
121
- private bulkUpsertDocuments;
122
- /**
123
- * Transfer documents individually with rate limiting
124
- */
125
- private transferDocumentsIndividual;
126
- /**
127
- * Update documents individually with content and/or permission changes
128
- */
129
- private updateDocumentsIndividual;
130
- /**
131
- * Utility method to chunk arrays
132
- */
133
- private chunkArray;
134
- /**
135
- * Helper method to fetch all teams with pagination
136
- */
137
- private fetchAllTeams;
138
- /**
139
- * Helper method to fetch all memberships for a team with pagination
140
- */
141
- private fetchAllMemberships;
142
- /**
143
- * Helper method to transfer team memberships
144
- */
145
- private transferTeamMemberships;
146
- private printSummary;
147
- }