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,348 +0,0 @@
1
- import { promises as fs } from "fs";
2
- import path from "path";
3
- import { existsSync } from "fs";
4
- import { MessageFormatter } from "../shared/messageFormatter.js";
5
- import { ConfirmationDialogs } from "../shared/confirmationDialogs.js";
6
- import yaml from "js-yaml";
7
-
8
- interface AppwriteConfigTS {
9
- appwriteEndpoint: string;
10
- appwriteProject: string;
11
- appwriteKey: string;
12
- enableBackups?: boolean;
13
- backupInterval?: number;
14
- backupRetention?: number;
15
- enableBackupCleanup?: boolean;
16
- enableMockData?: boolean;
17
- documentBucketId?: string;
18
- usersCollectionName?: string;
19
- databases: Array<{ $id: string; name: string }>;
20
- buckets: Array<any>;
21
- [key: string]: any;
22
- }
23
-
24
- interface AppwriteConfigYAML {
25
- appwrite: {
26
- endpoint: string;
27
- project: string;
28
- key: string;
29
- };
30
- logging: {
31
- enabled: boolean;
32
- level: string;
33
- console: boolean;
34
- logDirectory: string;
35
- };
36
- backups: {
37
- enabled: boolean;
38
- interval: number;
39
- retention: number;
40
- cleanup: boolean;
41
- };
42
- data: {
43
- enableMockData: boolean;
44
- documentBucketId: string;
45
- usersCollectionName: string;
46
- importDirectory: string;
47
- };
48
- schemas: {
49
- outputDirectory: string;
50
- yamlSchemaDirectory: string;
51
- };
52
- migrations: {
53
- enabled: boolean;
54
- };
55
- databases: Array<{ id: string; name: string; collections?: string[] }>;
56
- buckets: Array<any>;
57
- functions: Array<any>;
58
- }
59
-
60
- export async function migrateConfig(workingDir: string): Promise<void> {
61
- try {
62
- // Look for appwriteConfig.ts files in the working directory and subdirectories
63
- const configFiles = await findAppwriteConfigFiles(workingDir);
64
-
65
- if (configFiles.length === 0) {
66
- MessageFormatter.info("No appwriteConfig.ts files found to migrate", { prefix: "Migration" });
67
- return;
68
- }
69
-
70
- MessageFormatter.info(`Found ${configFiles.length} appwriteConfig.ts file(s) to migrate`, { prefix: "Migration" });
71
-
72
- for (const configFile of configFiles) {
73
- await migrateConfigFile(configFile, workingDir);
74
- }
75
-
76
- MessageFormatter.success("Migration completed successfully", { prefix: "Migration" });
77
- } catch (error) {
78
- MessageFormatter.error("Migration failed", error instanceof Error ? error : new Error(String(error)), { prefix: "Migration" });
79
- throw error;
80
- }
81
- }
82
-
83
- async function findAppwriteConfigFiles(dir: string): Promise<string[]> {
84
- const configFiles: string[] = [];
85
-
86
- const checkDir = async (currentDir: string) => {
87
- try {
88
- const entries = await fs.readdir(currentDir, { withFileTypes: true });
89
-
90
- for (const entry of entries) {
91
- const fullPath = path.join(currentDir, entry.name);
92
-
93
- if (entry.isDirectory() && !entry.name.startsWith('.') && entry.name !== 'node_modules') {
94
- await checkDir(fullPath);
95
- } else if (entry.isFile() && entry.name === 'appwriteConfig.ts') {
96
- configFiles.push(fullPath);
97
- }
98
- }
99
- } catch (error) {
100
- // Ignore directory access errors
101
- }
102
- };
103
-
104
- await checkDir(dir);
105
- return configFiles;
106
- }
107
-
108
- async function migrateConfigFile(configFilePath: string, workingDir: string): Promise<void> {
109
- const configDir = path.dirname(configFilePath);
110
- const appwriteDir = path.join(path.dirname(configDir), '.appwrite');
111
-
112
- MessageFormatter.info(`Migrating ${path.relative(workingDir, configFilePath)}`, { prefix: "Migration" });
113
-
114
- // Check if .appwrite directory already exists
115
- if (existsSync(appwriteDir)) {
116
- const shouldOverwrite = await ConfirmationDialogs.confirmOverwrite(
117
- `.appwrite directory already exists at ${path.relative(workingDir, appwriteDir)}`
118
- );
119
- if (!shouldOverwrite) {
120
- MessageFormatter.info("Skipping migration for this config", { prefix: "Migration" });
121
- return;
122
- }
123
- }
124
-
125
- // Load and parse the TypeScript config
126
- const config = await parseTypeScriptConfig(configFilePath);
127
-
128
- // Create .appwrite directory
129
- await fs.mkdir(appwriteDir, { recursive: true });
130
-
131
- // Convert config to YAML and save
132
- const yamlConfig = convertToYAMLConfig(config);
133
- const yamlContent = yaml.dump(yamlConfig, {
134
- indent: 2,
135
- lineWidth: 120,
136
- noRefs: true
137
- });
138
- await fs.writeFile(path.join(appwriteDir, 'config.yaml'), yamlContent);
139
-
140
- // Copy all directories except collections and schemas (we handle collections separately, skip schemas entirely)
141
- const entries = await fs.readdir(configDir, { withFileTypes: true });
142
- for (const entry of entries) {
143
- if (entry.isDirectory() && entry.name !== 'collections' && entry.name !== 'schemas') {
144
- const sourcePath = path.join(configDir, entry.name);
145
- const targetPath = path.join(appwriteDir, entry.name);
146
-
147
- await fs.cp(sourcePath, targetPath, { recursive: true });
148
- MessageFormatter.info(`Copied ${entry.name}/ to .appwrite/${entry.name}/`, { prefix: "Migration" });
149
- }
150
- }
151
-
152
- // Convert TypeScript collections to YAML collections
153
- const collectionsPath = path.join(configDir, 'collections');
154
- if (existsSync(collectionsPath)) {
155
- const targetCollectionsPath = path.join(appwriteDir, 'collections');
156
- await fs.mkdir(targetCollectionsPath, { recursive: true });
157
-
158
- const collectionFiles = await fs.readdir(collectionsPath);
159
- for (const file of collectionFiles) {
160
- if (file.endsWith('.ts')) {
161
- await convertCollectionToYaml(path.join(collectionsPath, file), targetCollectionsPath);
162
- }
163
- }
164
- MessageFormatter.info(`Converted TypeScript collections to YAML in .appwrite/collections/`, { prefix: "Migration" });
165
- }
166
-
167
- // Keep original config file in place (no backup needed since we're not deleting it)
168
-
169
- MessageFormatter.success(`Migration completed for ${path.relative(workingDir, configFilePath)}`, { prefix: "Migration" });
170
- }
171
-
172
- async function parseTypeScriptConfig(configFilePath: string): Promise<AppwriteConfigTS> {
173
- try {
174
- // Use tsx to import the TypeScript config file directly
175
- const { register } = await import("tsx/esm/api");
176
- const { pathToFileURL } = await import("node:url");
177
-
178
- const unregister = register();
179
-
180
- try {
181
- const configUrl = pathToFileURL(configFilePath).href;
182
- const configModule = await import(configUrl);
183
- const config = configModule.default?.default || configModule.default || configModule;
184
-
185
- if (!config) {
186
- throw new Error("Failed to load config from TypeScript file");
187
- }
188
-
189
- return config as AppwriteConfigTS;
190
- } finally {
191
- unregister();
192
- }
193
- } catch (error) {
194
- MessageFormatter.error("Could not load TypeScript config", error instanceof Error ? error : new Error(String(error)), { prefix: "Migration" });
195
- throw new Error('Failed to load TypeScript configuration file. Please ensure it exports a valid config object.');
196
- }
197
- }
198
-
199
- function convertToYAMLConfig(config: AppwriteConfigTS): AppwriteConfigYAML {
200
- // Convert the config to the nested YAML structure
201
- const yamlConfig: AppwriteConfigYAML = {
202
- appwrite: {
203
- endpoint: config.appwriteEndpoint,
204
- project: config.appwriteProject,
205
- key: config.appwriteKey
206
- },
207
- logging: {
208
- enabled: config.logging?.enabled ?? false,
209
- level: config.logging?.level ?? "info",
210
- console: config.logging?.console ?? false,
211
- logDirectory: "./logs"
212
- },
213
- backups: {
214
- enabled: config.enableBackups ?? false,
215
- interval: config.backupInterval ?? 3600,
216
- retention: config.backupRetention ?? 30,
217
- cleanup: config.enableBackupCleanup ?? false
218
- },
219
- data: {
220
- enableMockData: config.enableMockData ?? false,
221
- documentBucketId: config.documentBucketId ?? "documents",
222
- usersCollectionName: config.usersCollectionName ?? "Users",
223
- importDirectory: "importData"
224
- },
225
- schemas: {
226
- outputDirectory: "schemas",
227
- yamlSchemaDirectory: ".yaml_schemas"
228
- },
229
- migrations: {
230
- enabled: true
231
- },
232
- databases: (config.databases || []).map(db => ({
233
- id: db.$id,
234
- name: db.name,
235
- collections: [] // Collections will be handled separately
236
- })),
237
- buckets: (config.buckets || []).map(bucket => ({
238
- id: bucket.$id,
239
- name: bucket.name,
240
- permissions: bucket.$permissions?.map((p: any) => ({
241
- permission: p.permission,
242
- target: p.target
243
- })) || [],
244
- fileSecurity: bucket.fileSecurity ?? false,
245
- enabled: bucket.enabled ?? true,
246
- maximumFileSize: bucket.maximumFileSize ?? 30000000,
247
- allowedFileExtensions: bucket.allowedFileExtensions || [],
248
- compression: bucket.compression || "gzip",
249
- encryption: bucket.encryption ?? false,
250
- antivirus: bucket.antivirus ?? false
251
- })),
252
- functions: (config.functions || []).map((func: any) => ({
253
- id: func.$id,
254
- name: func.name,
255
- runtime: func.runtime,
256
- execute: func.execute || [],
257
- events: func.events || [],
258
- schedule: func.schedule || "",
259
- timeout: func.timeout ?? 15,
260
- enabled: func.enabled ?? true,
261
- logging: func.logging ?? false,
262
- entrypoint: func.entrypoint || "src/main.js",
263
- commands: func.commands || "",
264
- scopes: func.scopes || [],
265
- specification: func.specification || "s-1vcpu-512mb"
266
- }))
267
- };
268
-
269
- return yamlConfig;
270
- }
271
-
272
- async function convertCollectionToYaml(tsFilePath: string, targetDir: string): Promise<void> {
273
- try {
274
- // Load the TypeScript collection using tsx
275
- const { register } = await import("tsx/esm/api");
276
- const { pathToFileURL } = await import("node:url");
277
-
278
- const unregister = register();
279
-
280
- try {
281
- const configUrl = pathToFileURL(tsFilePath).href;
282
- const collectionModule = await import(configUrl);
283
- const collection = collectionModule.default?.default || collectionModule.default || collectionModule;
284
-
285
- if (!collection) {
286
- throw new Error("Failed to load collection from TypeScript file");
287
- }
288
-
289
- // Convert collection to YAML format
290
- const yamlCollection = {
291
- name: collection.name,
292
- id: collection.$id,
293
- documentSecurity: collection.documentSecurity ?? false,
294
- enabled: collection.enabled ?? true,
295
- permissions: (collection.permissions || collection.$permissions || []).map((p: any) => ({
296
- permission: p.permission,
297
- target: p.target
298
- })),
299
- attributes: (collection.attributes || []).map((attr: any) => ({
300
- key: attr.key,
301
- type: attr.type,
302
- size: attr.size,
303
- required: attr.required ?? false,
304
- array: attr.array,
305
- default: attr.xdefault || attr.default,
306
- min: attr.min,
307
- max: attr.max,
308
- elements: attr.elements,
309
- relatedCollection: attr.relatedCollection,
310
- relationType: attr.relationType,
311
- twoWay: attr.twoWay,
312
- twoWayKey: attr.twoWayKey,
313
- onDelete: attr.onDelete,
314
- side: attr.side
315
- })),
316
- indexes: (collection.indexes || []).map((idx: any) => ({
317
- key: idx.key,
318
- type: idx.type,
319
- attributes: idx.attributes,
320
- orders: idx.orders
321
- })),
322
- importDefs: collection.importDefs || []
323
- };
324
-
325
- // Remove undefined values
326
- const cleanYamlCollection = JSON.parse(JSON.stringify(yamlCollection, (key, value) =>
327
- value === undefined ? undefined : value
328
- ));
329
-
330
- // Write YAML file
331
- const fileName = path.basename(tsFilePath, '.ts') + '.yaml';
332
- const targetPath = path.join(targetDir, fileName);
333
- const yamlContent = yaml.dump(cleanYamlCollection, {
334
- indent: 2,
335
- lineWidth: 120,
336
- noRefs: true
337
- });
338
-
339
- await fs.writeFile(targetPath, yamlContent);
340
- MessageFormatter.info(`Converted ${path.basename(tsFilePath)} to ${fileName}`, { prefix: "Migration" });
341
-
342
- } finally {
343
- unregister();
344
- }
345
- } catch (error) {
346
- MessageFormatter.error(`Failed to convert collection ${path.basename(tsFilePath)}`, error instanceof Error ? error : new Error(String(error)), { prefix: "Migration" });
347
- }
348
- }