appwrite-utils-cli 1.9.6 → 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 (426) 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 -44
  23. package/src/collections/indexes.ts +350 -352
  24. package/src/collections/methods.ts +714 -815
  25. package/src/collections/tableOperations.ts +57 -21
  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 +409 -0
  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 -405
  129. package/dist/adapters/DatabaseAdapter.d.ts +0 -242
  130. package/dist/adapters/DatabaseAdapter.js +0 -50
  131. package/dist/adapters/LegacyAdapter.d.ts +0 -50
  132. package/dist/adapters/LegacyAdapter.js +0 -612
  133. package/dist/adapters/TablesDBAdapter.d.ts +0 -45
  134. package/dist/adapters/TablesDBAdapter.js +0 -596
  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 -1364
  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 -734
  167. package/dist/collections/tableOperations.d.ts +0 -86
  168. package/dist/collections/tableOperations.js +0 -434
  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 -625
  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/indexManager.d.ts +0 -24
  298. package/dist/shared/indexManager.js +0 -151
  299. package/dist/shared/jsonSchemaGenerator.d.ts +0 -50
  300. package/dist/shared/jsonSchemaGenerator.js +0 -290
  301. package/dist/shared/logging.d.ts +0 -61
  302. package/dist/shared/logging.js +0 -116
  303. package/dist/shared/messageFormatter.d.ts +0 -39
  304. package/dist/shared/messageFormatter.js +0 -162
  305. package/dist/shared/migrationHelpers.d.ts +0 -61
  306. package/dist/shared/migrationHelpers.js +0 -145
  307. package/dist/shared/operationLogger.d.ts +0 -10
  308. package/dist/shared/operationLogger.js +0 -12
  309. package/dist/shared/operationQueue.d.ts +0 -40
  310. package/dist/shared/operationQueue.js +0 -311
  311. package/dist/shared/operationsTable.d.ts +0 -26
  312. package/dist/shared/operationsTable.js +0 -286
  313. package/dist/shared/operationsTableSchema.d.ts +0 -48
  314. package/dist/shared/operationsTableSchema.js +0 -35
  315. package/dist/shared/progressManager.d.ts +0 -62
  316. package/dist/shared/progressManager.js +0 -215
  317. package/dist/shared/pydanticModelGenerator.d.ts +0 -17
  318. package/dist/shared/pydanticModelGenerator.js +0 -615
  319. package/dist/shared/relationshipExtractor.d.ts +0 -56
  320. package/dist/shared/relationshipExtractor.js +0 -138
  321. package/dist/shared/schemaGenerator.d.ts +0 -40
  322. package/dist/shared/schemaGenerator.js +0 -556
  323. package/dist/shared/selectionDialogs.d.ts +0 -214
  324. package/dist/shared/selectionDialogs.js +0 -544
  325. package/dist/storage/backupCompression.d.ts +0 -20
  326. package/dist/storage/backupCompression.js +0 -67
  327. package/dist/storage/methods.d.ts +0 -32
  328. package/dist/storage/methods.js +0 -472
  329. package/dist/storage/schemas.d.ts +0 -842
  330. package/dist/storage/schemas.js +0 -175
  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 -510
  378. package/src/adapters/DatabaseAdapter.ts +0 -318
  379. package/src/adapters/LegacyAdapter.ts +0 -841
  380. package/src/adapters/TablesDBAdapter.ts +0 -815
  381. package/src/config/ConfigManager.ts +0 -817
  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/indexManager.ts +0 -254
  405. package/src/shared/jsonSchemaGenerator.ts +0 -383
  406. package/src/shared/logging.ts +0 -149
  407. package/src/shared/messageFormatter.ts +0 -208
  408. package/src/shared/pydanticModelGenerator.ts +0 -618
  409. package/src/shared/schemaGenerator.ts +0 -644
  410. package/src/utils/ClientFactory.ts +0 -240
  411. package/src/utils/configDiscovery.ts +0 -557
  412. package/src/utils/constantsGenerator.ts +0 -369
  413. package/src/utils/dataConverters.ts +0 -159
  414. package/src/utils/directoryUtils.ts +0 -61
  415. package/src/utils/getClientFromConfig.ts +0 -257
  416. package/src/utils/helperFunctions.ts +0 -228
  417. package/src/utils/pathResolvers.ts +0 -81
  418. package/src/utils/projectConfig.ts +0 -340
  419. package/src/utils/retryFailedPromises.ts +0 -29
  420. package/src/utils/sessionAuth.ts +0 -230
  421. package/src/utils/typeGuards.ts +0 -65
  422. package/src/utils/validationRules.ts +0 -88
  423. package/src/utils/versionDetection.ts +0 -292
  424. package/src/utils/yamlConverter.ts +0 -542
  425. package/src/utils/yamlLoader.ts +0 -371
  426. package/tmp-sync-test/.appwrite/collections/TestCollection.yaml +0 -7
@@ -1,544 +0,0 @@
1
- import inquirer from "inquirer";
2
- import chalk from "chalk";
3
- import { MessageFormatter } from "./messageFormatter.js";
4
- import { logger } from "./logging.js";
5
- /**
6
- * Comprehensive selection dialog system for enhanced sync flow
7
- *
8
- * This class provides interactive dialogs for selecting databases, tables/collections,
9
- * and storage buckets during sync operations. It supports both new and existing
10
- * configurations with visual indicators and comprehensive confirmation flows.
11
- *
12
- * @example
13
- * ```typescript
14
- * import { SelectionDialogs } from './shared/selectionDialogs.js';
15
- * import type { Models } from 'node-appwrite';
16
- *
17
- * // Example usage in a sync command
18
- * const availableDatabases: Models.Database[] = await getAvailableDatabases();
19
- * const configuredDatabases = config.databases || [];
20
- *
21
- * // Prompt about existing configuration
22
- * const { syncExisting, modifyConfiguration } = await SelectionDialogs.promptForExistingConfig(configuredDatabases);
23
- *
24
- * if (modifyConfiguration) {
25
- * // Select databases
26
- * const selectedDatabaseIds = await SelectionDialogs.selectDatabases(
27
- * availableDatabases,
28
- * configuredDatabases,
29
- * { showSelectAll: true, allowNewOnly: !syncExisting }
30
- * );
31
- *
32
- * // For each database, select tables
33
- * const tableSelectionsMap = new Map<string, string[]>();
34
- * const availableTablesMap = new Map<string, any[]>();
35
- *
36
- * for (const databaseId of selectedDatabaseIds) {
37
- * const database = availableDatabases.find(db => db.$id === databaseId)!;
38
- * const availableTables = await getTablesForDatabase(databaseId);
39
- * const configuredTables = getConfiguredTablesForDatabase(databaseId);
40
- *
41
- * availableTablesMap.set(databaseId, availableTables);
42
- *
43
- * const selectedTableIds = await SelectionDialogs.selectTablesForDatabase(
44
- * databaseId,
45
- * database.name,
46
- * availableTables,
47
- * configuredTables,
48
- * { showSelectAll: true, allowNewOnly: !syncExisting }
49
- * );
50
- *
51
- * tableSelectionsMap.set(databaseId, selectedTableIds);
52
- * }
53
- *
54
- * // Select buckets
55
- * const availableBuckets = await getAvailableBuckets();
56
- * const configuredBuckets = config.buckets || [];
57
- * const selectedBucketIds = await SelectionDialogs.selectBucketsForDatabases(
58
- * selectedDatabaseIds,
59
- * availableBuckets,
60
- * configuredBuckets,
61
- * { showSelectAll: true, groupByDatabase: true }
62
- * );
63
- *
64
- * // Create selection objects
65
- * const databaseSelections = SelectionDialogs.createDatabaseSelection(
66
- * selectedDatabaseIds,
67
- * availableDatabases,
68
- * tableSelectionsMap,
69
- * configuredDatabases,
70
- * availableTablesMap
71
- * );
72
- *
73
- * const bucketSelections = SelectionDialogs.createBucketSelection(
74
- * selectedBucketIds,
75
- * availableBuckets,
76
- * configuredBuckets,
77
- * availableDatabases
78
- * );
79
- *
80
- * // Show final confirmation
81
- * const selectionSummary = SelectionDialogs.createSyncSelectionSummary(
82
- * databaseSelections,
83
- * bucketSelections
84
- * );
85
- *
86
- * const confirmed = await SelectionDialogs.confirmSyncSelection(selectionSummary);
87
- *
88
- * if (confirmed) {
89
- * // Proceed with sync operation
90
- * await performSync(databaseSelections, bucketSelections);
91
- * }
92
- * }
93
- * ```
94
- */
95
- export class SelectionDialogs {
96
- /**
97
- * Prompts user about existing configuration
98
- */
99
- static async promptForExistingConfig(configuredItems) {
100
- if (configuredItems.length === 0) {
101
- return { syncExisting: false, modifyConfiguration: true };
102
- }
103
- MessageFormatter.section("Existing Configuration Found");
104
- MessageFormatter.info(`Found ${configuredItems.length} configured items.`, { skipLogging: true });
105
- const { syncExisting } = await inquirer.prompt([{
106
- type: 'confirm',
107
- name: 'syncExisting',
108
- message: 'Sync existing configured items?',
109
- default: true
110
- }]);
111
- if (!syncExisting) {
112
- return { syncExisting: false, modifyConfiguration: true };
113
- }
114
- const { modifyConfiguration } = await inquirer.prompt([{
115
- type: 'confirm',
116
- name: 'modifyConfiguration',
117
- message: 'Add/remove items from configuration?',
118
- default: false
119
- }]);
120
- return { syncExisting, modifyConfiguration };
121
- }
122
- /**
123
- * Shows database selection dialog with indicators for configured vs new databases
124
- */
125
- static async selectDatabases(availableDatabases, configuredDatabases, options = {}) {
126
- const { showSelectAll = true, allowNewOnly = false, defaultSelected = [] } = options;
127
- MessageFormatter.section("Database Selection");
128
- const configuredIds = new Set(configuredDatabases.map(db => db.$id || db.id));
129
- let choices = [];
130
- if (showSelectAll && availableDatabases.length > 1) {
131
- choices.push({
132
- name: chalk.green.bold('📋 Select All Databases'),
133
- value: '__SELECT_ALL__',
134
- short: 'All databases'
135
- });
136
- }
137
- availableDatabases.forEach(database => {
138
- const isConfigured = configuredIds.has(database.$id);
139
- const status = isConfigured ? chalk.green('✅') : chalk.blue('○');
140
- const name = `${status} ${database.name} (${database.$id})`;
141
- if (allowNewOnly && isConfigured) {
142
- return; // Skip configured databases if only allowing new ones
143
- }
144
- choices.push({
145
- name,
146
- value: database.$id,
147
- short: database.name,
148
- // Do not preselect anything unless explicitly provided
149
- checked: defaultSelected.includes(database.$id)
150
- });
151
- });
152
- if (choices.length === 0) {
153
- MessageFormatter.warning("No databases available for selection.", { skipLogging: true });
154
- return [];
155
- }
156
- const { selectedDatabaseIds } = await inquirer.prompt([{
157
- type: 'checkbox',
158
- name: 'selectedDatabaseIds',
159
- message: 'Select databases to sync:',
160
- choices,
161
- validate: (input) => {
162
- if (input.length === 0) {
163
- return chalk.red('Please select at least one database.');
164
- }
165
- if (input.includes('__SELECT_ALL__') && input.length > 1) {
166
- return chalk.red('Cannot select "Select All" with individual databases.');
167
- }
168
- return true;
169
- }
170
- }]);
171
- // Handle select all
172
- if (selectedDatabaseIds.includes('__SELECT_ALL__')) {
173
- const allIds = availableDatabases.map(db => db.$id);
174
- if (allowNewOnly) {
175
- return allIds.filter(id => !configuredIds.has(id));
176
- }
177
- return allIds;
178
- }
179
- return selectedDatabaseIds;
180
- }
181
- /**
182
- * Shows table/collection selection dialog for a specific database
183
- */
184
- static async selectTablesForDatabase(databaseId, databaseName, availableTables, configuredTables, options = {}) {
185
- const { showSelectAll = true, allowNewOnly = false, defaultSelected = [], showDatabaseContext = true } = options;
186
- if (showDatabaseContext) {
187
- MessageFormatter.section(`Table Selection for ${databaseName}`);
188
- }
189
- const configuredIds = new Set(configuredTables.map(table => table.$id || table.id));
190
- let choices = [];
191
- if (showSelectAll && availableTables.length > 1) {
192
- choices.push({
193
- name: chalk.green.bold('📋 Select All Tables'),
194
- value: '__SELECT_ALL__',
195
- short: 'All tables'
196
- });
197
- }
198
- availableTables.forEach(table => {
199
- const isConfigured = configuredIds.has(table.$id);
200
- const status = isConfigured ? chalk.green('✅') : chalk.blue('○');
201
- const name = `${status} ${table.name} (${table.$id})`;
202
- if (allowNewOnly && isConfigured) {
203
- return; // Skip configured tables if only allowing new ones
204
- }
205
- choices.push({
206
- name,
207
- value: table.$id,
208
- short: table.name,
209
- // Do not preselect anything unless explicitly provided
210
- checked: defaultSelected.includes(table.$id)
211
- });
212
- });
213
- if (choices.length === 0) {
214
- MessageFormatter.warning(`No tables available for database: ${databaseName}`, { skipLogging: true });
215
- return [];
216
- }
217
- const { selectedTableIds } = await inquirer.prompt([{
218
- type: 'checkbox',
219
- name: 'selectedTableIds',
220
- message: `Select tables to sync for ${databaseName}:`,
221
- choices,
222
- validate: (input) => {
223
- if (input.length === 0) {
224
- return chalk.red('Please select at least one table.');
225
- }
226
- if (input.includes('__SELECT_ALL__') && input.length > 1) {
227
- return chalk.red('Cannot select "Select All" with individual tables.');
228
- }
229
- return true;
230
- }
231
- }]);
232
- // Handle select all
233
- if (selectedTableIds.includes('__SELECT_ALL__')) {
234
- const allIds = availableTables.map(table => table.$id);
235
- if (allowNewOnly) {
236
- return allIds.filter(id => !configuredIds.has(id));
237
- }
238
- return allIds;
239
- }
240
- return selectedTableIds;
241
- }
242
- /**
243
- * Shows bucket selection dialog for selected databases
244
- */
245
- static async selectBucketsForDatabases(selectedDatabaseIds, availableBuckets, configuredBuckets, options = {}) {
246
- const { showSelectAll = true, allowNewOnly = false, defaultSelected = [], groupByDatabase = true } = options;
247
- MessageFormatter.section("Storage Bucket Selection");
248
- const configuredIds = new Set(configuredBuckets.map(bucket => bucket.$id || bucket.id));
249
- // Filter buckets that are associated with selected databases
250
- const relevantBuckets = availableBuckets.filter(bucket => {
251
- if (selectedDatabaseIds.length === 0)
252
- return true; // If no databases selected, show all buckets
253
- return selectedDatabaseIds.includes(bucket.databaseId) || !bucket.databaseId;
254
- });
255
- if (relevantBuckets.length === 0) {
256
- MessageFormatter.warning("No storage buckets available for selected databases.", { skipLogging: true });
257
- return [];
258
- }
259
- let choices = [];
260
- if (showSelectAll && relevantBuckets.length > 1) {
261
- choices.push({
262
- name: chalk.green.bold('📋 Select All Buckets'),
263
- value: '__SELECT_ALL__',
264
- short: 'All buckets'
265
- });
266
- }
267
- if (groupByDatabase) {
268
- // Group buckets by database
269
- const bucketsByDatabase = new Map();
270
- relevantBuckets.forEach(bucket => {
271
- const dbId = bucket.databaseId || 'ungrouped';
272
- if (!bucketsByDatabase.has(dbId)) {
273
- bucketsByDatabase.set(dbId, []);
274
- }
275
- bucketsByDatabase.get(dbId).push(bucket);
276
- });
277
- // Add buckets grouped by database
278
- selectedDatabaseIds.forEach(dbId => {
279
- const buckets = bucketsByDatabase.get(dbId) || [];
280
- if (buckets.length > 0) {
281
- choices.push(new inquirer.Separator(chalk.cyan(`📁 Database: ${dbId}`)));
282
- buckets.forEach(bucket => {
283
- const isConfigured = configuredIds.has(bucket.$id);
284
- const status = isConfigured ? chalk.green('✅') : chalk.blue('○');
285
- const name = `${status} ${bucket.name} (${bucket.$id})`;
286
- if (allowNewOnly && isConfigured) {
287
- return; // Skip configured buckets if only allowing new ones
288
- }
289
- choices.push({
290
- name: ` ${name}`,
291
- value: bucket.$id,
292
- short: bucket.name,
293
- // Do not preselect anything unless explicitly provided
294
- checked: defaultSelected.includes(bucket.$id)
295
- });
296
- });
297
- }
298
- });
299
- // Add ungrouped buckets
300
- const ungroupedBuckets = bucketsByDatabase.get('ungrouped') || [];
301
- if (ungroupedBuckets.length > 0) {
302
- choices.push(new inquirer.Separator(chalk.cyan('📁 General Storage')));
303
- ungroupedBuckets.forEach(bucket => {
304
- const isConfigured = configuredIds.has(bucket.$id);
305
- const status = isConfigured ? chalk.green('✅') : chalk.blue('○');
306
- const name = `${status} ${bucket.name} (${bucket.$id})`;
307
- if (allowNewOnly && isConfigured) {
308
- return; // Skip configured buckets if only allowing new ones
309
- }
310
- choices.push({
311
- name: ` ${name}`,
312
- value: bucket.$id,
313
- short: bucket.name,
314
- checked: defaultSelected.includes(bucket.$id) || (!allowNewOnly && isConfigured)
315
- });
316
- });
317
- }
318
- }
319
- else {
320
- // Flat list of buckets
321
- relevantBuckets.forEach(bucket => {
322
- const isConfigured = configuredIds.has(bucket.$id);
323
- const status = isConfigured ? chalk.green('✅') : chalk.blue('○');
324
- const dbContext = bucket.databaseId ? ` [${bucket.databaseId}]` : '';
325
- const name = `${status} ${bucket.name} (${bucket.$id})${dbContext}`;
326
- if (allowNewOnly && isConfigured) {
327
- return; // Skip configured buckets if only allowing new ones
328
- }
329
- choices.push({
330
- name,
331
- value: bucket.$id,
332
- short: bucket.name,
333
- // Do not preselect anything unless explicitly provided
334
- checked: defaultSelected.includes(bucket.$id)
335
- });
336
- });
337
- }
338
- const { selectedBucketIds } = await inquirer.prompt([{
339
- type: 'checkbox',
340
- name: 'selectedBucketIds',
341
- message: 'Select storage buckets to sync:',
342
- choices,
343
- validate: (input) => {
344
- if (input.length === 0) {
345
- return chalk.yellow('No storage buckets selected. Continue with databases only?') || true;
346
- }
347
- if (input.includes('__SELECT_ALL__') && input.length > 1) {
348
- return chalk.red('Cannot select "Select All" with individual buckets.');
349
- }
350
- return true;
351
- }
352
- }]);
353
- // Handle select all
354
- if (selectedBucketIds && selectedBucketIds.includes('__SELECT_ALL__')) {
355
- const allIds = relevantBuckets.map(bucket => bucket.$id);
356
- if (allowNewOnly) {
357
- return allIds.filter(id => !configuredIds.has(id));
358
- }
359
- return allIds;
360
- }
361
- return selectedBucketIds || [];
362
- }
363
- /**
364
- * Shows final confirmation dialog with sync selection summary
365
- */
366
- static async confirmSyncSelection(selectionSummary, operationType = 'sync') {
367
- const labels = {
368
- push: {
369
- banner: "Push Selection Summary",
370
- subtitle: "Review selections before pushing to Appwrite",
371
- confirm: "Proceed with push operation?",
372
- success: "Push operation confirmed.",
373
- cancel: "Push operation cancelled."
374
- },
375
- pull: {
376
- banner: "Pull Selection Summary",
377
- subtitle: "Review selections before pulling from Appwrite",
378
- confirm: "Proceed with pull operation?",
379
- success: "Pull operation confirmed.",
380
- cancel: "Pull operation cancelled."
381
- },
382
- sync: {
383
- banner: "Sync Selection Summary",
384
- subtitle: "Review your selections before proceeding",
385
- confirm: "Proceed with sync operation?",
386
- success: "Sync operation confirmed.",
387
- cancel: "Sync operation cancelled."
388
- }
389
- };
390
- const label = labels[operationType];
391
- MessageFormatter.banner(label.banner, label.subtitle);
392
- // Database summary
393
- console.log(chalk.bold.cyan("\n📊 Databases:"));
394
- console.log(` Total: ${selectionSummary.totalDatabases}`);
395
- console.log(` ${chalk.green('✅ Configured')}: ${selectionSummary.existingItems.databases}`);
396
- console.log(` ${chalk.blue('○ New')}: ${selectionSummary.newItems.databases}`);
397
- if (selectionSummary.databases.length > 0) {
398
- console.log(chalk.gray("\n Selected databases:"));
399
- selectionSummary.databases.forEach(db => {
400
- const status = db.isNew ? chalk.blue('○') : chalk.green('✅');
401
- console.log(` ${status} ${db.databaseName} (${db.tableNames.length} tables)`);
402
- });
403
- }
404
- // Table summary
405
- console.log(chalk.bold.cyan("\n📋 Tables/Collections:"));
406
- console.log(` Total: ${selectionSummary.totalTables}`);
407
- console.log(` ${chalk.green('✅ Configured')}: ${selectionSummary.existingItems.tables}`);
408
- console.log(` ${chalk.blue('○ New')}: ${selectionSummary.newItems.tables}`);
409
- // Bucket summary
410
- console.log(chalk.bold.cyan("\n🪣 Storage Buckets:"));
411
- console.log(` Total: ${selectionSummary.totalBuckets}`);
412
- console.log(` ${chalk.green('✅ Configured')}: ${selectionSummary.existingItems.buckets}`);
413
- console.log(` ${chalk.blue('○ New')}: ${selectionSummary.newItems.buckets}`);
414
- if (selectionSummary.buckets.length > 0) {
415
- console.log(chalk.gray("\n Selected buckets:"));
416
- selectionSummary.buckets.forEach(bucket => {
417
- const status = bucket.isNew ? chalk.blue('○') : chalk.green('✅');
418
- const dbContext = bucket.databaseName ? ` [${bucket.databaseName}]` : '';
419
- console.log(` ${status} ${bucket.bucketName}${dbContext}`);
420
- });
421
- }
422
- console.log(); // Add spacing
423
- const { confirmed } = await inquirer.prompt([{
424
- type: 'confirm',
425
- name: 'confirmed',
426
- message: chalk.green.bold(label.confirm),
427
- default: true
428
- }]);
429
- if (confirmed) {
430
- MessageFormatter.success(label.success, { skipLogging: true });
431
- logger.info(`${operationType} selection confirmed`, {
432
- databases: selectionSummary.totalDatabases,
433
- tables: selectionSummary.totalTables,
434
- buckets: selectionSummary.totalBuckets
435
- });
436
- }
437
- else {
438
- MessageFormatter.warning(label.cancel, { skipLogging: true });
439
- logger.info(`${operationType} selection cancelled by user`);
440
- }
441
- return confirmed;
442
- }
443
- /**
444
- * Creates a sync selection summary from selected items
445
- */
446
- static createSyncSelectionSummary(databaseSelections, bucketSelections) {
447
- const totalDatabases = databaseSelections.length;
448
- const totalTables = databaseSelections.reduce((sum, db) => sum + db.tableIds.length, 0);
449
- const totalBuckets = bucketSelections.length;
450
- const newDatabases = databaseSelections.filter(db => db.isNew).length;
451
- const newTables = databaseSelections.reduce((sum, db) => sum + db.tableIds.length, 0); // TODO: Track which tables are new
452
- const newBuckets = bucketSelections.filter(bucket => bucket.isNew).length;
453
- const existingDatabases = totalDatabases - newDatabases;
454
- const existingTables = totalTables - newTables;
455
- const existingBuckets = totalBuckets - newBuckets;
456
- return {
457
- databases: databaseSelections,
458
- buckets: bucketSelections,
459
- totalDatabases,
460
- totalTables,
461
- totalBuckets,
462
- newItems: {
463
- databases: newDatabases,
464
- tables: newTables,
465
- buckets: newBuckets
466
- },
467
- existingItems: {
468
- databases: existingDatabases,
469
- tables: existingTables,
470
- buckets: existingBuckets
471
- }
472
- };
473
- }
474
- /**
475
- * Helper method to create database selection objects
476
- */
477
- static createDatabaseSelection(selectedDatabaseIds, availableDatabases, tableSelectionsMap, configuredDatabases, availableTablesMap = new Map()) {
478
- const configuredIds = new Set(configuredDatabases.map(db => db.$id || db.id));
479
- return selectedDatabaseIds.map(databaseId => {
480
- const database = availableDatabases.find(db => db.$id === databaseId);
481
- if (!database) {
482
- throw new Error(`Database with ID ${databaseId} not found in available databases`);
483
- }
484
- const tableIds = tableSelectionsMap.get(databaseId) || [];
485
- const tables = availableTablesMap.get(databaseId) || [];
486
- const tableNames = tables.map(table => table.name || table.$id || `Table-${table.$id}`);
487
- return {
488
- databaseId,
489
- databaseName: database.name,
490
- tableIds,
491
- tableNames,
492
- isNew: !configuredIds.has(databaseId)
493
- };
494
- });
495
- }
496
- /**
497
- * Helper method to create bucket selection objects
498
- */
499
- static createBucketSelection(selectedBucketIds, availableBuckets, configuredBuckets, availableDatabases) {
500
- const configuredIds = new Set(configuredBuckets.map(bucket => bucket.$id || bucket.id));
501
- return selectedBucketIds.map(bucketId => {
502
- const bucket = availableBuckets.find(b => b.$id === bucketId);
503
- if (!bucket) {
504
- throw new Error(`Bucket with ID ${bucketId} not found in available buckets`);
505
- }
506
- const database = bucket.databaseId ?
507
- availableDatabases.find(db => db.$id === bucket.databaseId) : undefined;
508
- return {
509
- bucketId,
510
- bucketName: bucket.name,
511
- databaseId: bucket.databaseId,
512
- databaseName: database?.name,
513
- isNew: !configuredIds.has(bucketId)
514
- };
515
- });
516
- }
517
- /**
518
- * Shows a progress message during selection operations
519
- */
520
- static showProgress(message) {
521
- MessageFormatter.progress(message, { skipLogging: true });
522
- }
523
- /**
524
- * Shows an error message and handles graceful cancellation
525
- */
526
- static showError(message, error) {
527
- MessageFormatter.error(message, error, { skipLogging: true });
528
- logger.error(`Selection dialog error: ${message}`, { error: error?.message });
529
- }
530
- /**
531
- * Shows a warning message
532
- */
533
- static showWarning(message) {
534
- MessageFormatter.warning(message, { skipLogging: true });
535
- logger.warn(`Selection dialog warning: ${message}`);
536
- }
537
- /**
538
- * Shows a success message
539
- */
540
- static showSuccess(message) {
541
- MessageFormatter.success(message, { skipLogging: true });
542
- logger.info(`Selection dialog success: ${message}`);
543
- }
544
- }
@@ -1,20 +0,0 @@
1
- import type { BackupCreate } from "./schemas.js";
2
- export interface BackupCompressionOptions {
3
- includeFiles?: boolean;
4
- compressionLevel?: number;
5
- }
6
- /**
7
- * Creates a compressed ZIP backup from backup data
8
- *
9
- * Structure:
10
- * - metadata.json (backup metadata)
11
- * - database.json (database config)
12
- * - collections/*.json (one file per collection)
13
- * - documents/*.json (one file per collection's documents)
14
- * - files/ (optional, if includeFiles is true)
15
- */
16
- export declare function createBackupZip(backupData: BackupCreate, options?: BackupCompressionOptions): Promise<Buffer>;
17
- /**
18
- * Estimates compression ratio for backup data
19
- */
20
- export declare function estimateCompressedSize(uncompressedSize: number, format?: string): number;
@@ -1,67 +0,0 @@
1
- import JSZip from "jszip";
2
- /**
3
- * Creates a compressed ZIP backup from backup data
4
- *
5
- * Structure:
6
- * - metadata.json (backup metadata)
7
- * - database.json (database config)
8
- * - collections/*.json (one file per collection)
9
- * - documents/*.json (one file per collection's documents)
10
- * - files/ (optional, if includeFiles is true)
11
- */
12
- export async function createBackupZip(backupData, options = {}) {
13
- const zip = new JSZip();
14
- const compressionLevel = options.compressionLevel ?? 6;
15
- // Add metadata.json
16
- const metadata = {
17
- version: "1.0",
18
- createdAt: new Date().toISOString(),
19
- databaseId: JSON.parse(backupData.database).$id,
20
- format: "zip",
21
- includesFiles: options.includeFiles ?? false
22
- };
23
- zip.file("metadata.json", JSON.stringify(metadata, null, 2));
24
- // Add database.json
25
- zip.file("database.json", backupData.database);
26
- // Add collections/*.json
27
- const collectionsFolder = zip.folder("collections");
28
- if (collectionsFolder) {
29
- backupData.collections.forEach((collectionStr, index) => {
30
- const collection = JSON.parse(collectionStr);
31
- collectionsFolder.file(`${collection.$id || `collection_${index}`}.json`, collectionStr);
32
- });
33
- }
34
- // Add documents/*.json
35
- const documentsFolder = zip.folder("documents");
36
- if (documentsFolder) {
37
- backupData.documents.forEach((docBatch) => {
38
- const collectionId = docBatch.collectionId;
39
- documentsFolder.file(`${collectionId}.json`, docBatch.data);
40
- });
41
- }
42
- // TODO: Add files support in future task (C3.5)
43
- if (options.includeFiles) {
44
- // Placeholder for file backup support
45
- const filesFolder = zip.folder("files");
46
- if (filesFolder) {
47
- filesFolder.file("file-manifest.json", JSON.stringify({
48
- note: "File backup not yet implemented"
49
- }, null, 2));
50
- }
51
- }
52
- // Generate ZIP buffer
53
- const buffer = await zip.generateAsync({
54
- type: "nodebuffer",
55
- compression: "DEFLATE",
56
- compressionOptions: { level: compressionLevel }
57
- });
58
- return buffer;
59
- }
60
- /**
61
- * Estimates compression ratio for backup data
62
- */
63
- export function estimateCompressedSize(uncompressedSize, format = "json") {
64
- // JSON typically compresses to 20-30% of original size with gzip
65
- const compressionRatio = format === "json" ? 0.25 : 0.5;
66
- return Math.ceil(uncompressedSize * compressionRatio);
67
- }
@@ -1,32 +0,0 @@
1
- import { Databases, Storage, type Models } from "node-appwrite";
2
- import { type AppwriteConfig } from "appwrite-utils";
3
- export declare const getStorage: (config: AppwriteConfig) => Storage;
4
- export declare const listBuckets: (storage: Storage, queries?: string[], search?: string) => Promise<Models.BucketList>;
5
- export declare const getBucket: (storage: Storage, bucketId: string) => Promise<Models.Bucket>;
6
- export declare const createBucket: (storage: Storage, bucket: Omit<Models.Bucket, "$id" | "$createdAt" | "$updatedAt">, bucketId?: string) => Promise<Models.Bucket>;
7
- export declare const updateBucket: (storage: Storage, bucket: Models.Bucket, bucketId: string) => Promise<Models.Bucket>;
8
- export declare const deleteBucket: (storage: Storage, bucketId: string) => Promise<{}>;
9
- export declare const getFile: (storage: Storage, bucketId: string, fileId: string) => Promise<Models.File>;
10
- export declare const listFiles: (storage: Storage, bucketId: string, queries?: string[], search?: string) => Promise<Models.FileList>;
11
- export declare const deleteFile: (storage: Storage, bucketId: string, fileId: string) => Promise<{}>;
12
- export declare const ensureDatabaseConfigBucketsExist: (storage: Storage, config: AppwriteConfig, databases?: Models.Database[]) => Promise<void>;
13
- export declare const wipeDocumentStorage: (storage: Storage, bucketId: string, options?: {
14
- skipConfirmation?: boolean;
15
- }) => Promise<void>;
16
- export declare const initOrGetDocumentStorage: (storage: Storage, config: AppwriteConfig, dbId: string, bucketName?: string) => Promise<Models.Bucket>;
17
- /**
18
- * Initializes or gets the centralized backup bucket
19
- * All backups are stored in a single "appwrite-backups" bucket
20
- */
21
- export declare const initBackupBucket: (storage: Storage) => Promise<Models.Bucket | undefined>;
22
- export interface DatabaseBackupResult {
23
- backupFileId: string;
24
- backupFileName: string;
25
- backupSizeBytes: number;
26
- databaseId: string;
27
- databaseName: string;
28
- collectionCount: number;
29
- documentCount: number;
30
- format: 'json' | 'zip';
31
- }
32
- export declare const backupDatabase: (config: AppwriteConfig, database: Databases, databaseId: string, storage: Storage, format?: "json" | "zip") => Promise<DatabaseBackupResult>;