@njdamstra/appwrite-utils-cli 1.8.9

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 (392) hide show
  1. package/CHANGELOG.md +19 -0
  2. package/README.md +1133 -0
  3. package/dist/adapters/AdapterFactory.d.ts +94 -0
  4. package/dist/adapters/AdapterFactory.js +405 -0
  5. package/dist/adapters/DatabaseAdapter.d.ts +233 -0
  6. package/dist/adapters/DatabaseAdapter.js +50 -0
  7. package/dist/adapters/LegacyAdapter.d.ts +50 -0
  8. package/dist/adapters/LegacyAdapter.js +612 -0
  9. package/dist/adapters/TablesDBAdapter.d.ts +45 -0
  10. package/dist/adapters/TablesDBAdapter.js +571 -0
  11. package/dist/adapters/index.d.ts +11 -0
  12. package/dist/adapters/index.js +12 -0
  13. package/dist/backups/operations/bucketBackup.d.ts +19 -0
  14. package/dist/backups/operations/bucketBackup.js +197 -0
  15. package/dist/backups/operations/collectionBackup.d.ts +30 -0
  16. package/dist/backups/operations/collectionBackup.js +201 -0
  17. package/dist/backups/operations/comprehensiveBackup.d.ts +25 -0
  18. package/dist/backups/operations/comprehensiveBackup.js +238 -0
  19. package/dist/backups/schemas/bucketManifest.d.ts +93 -0
  20. package/dist/backups/schemas/bucketManifest.js +33 -0
  21. package/dist/backups/schemas/comprehensiveManifest.d.ts +108 -0
  22. package/dist/backups/schemas/comprehensiveManifest.js +32 -0
  23. package/dist/backups/tracking/centralizedTracking.d.ts +34 -0
  24. package/dist/backups/tracking/centralizedTracking.js +274 -0
  25. package/dist/cli/commands/configCommands.d.ts +8 -0
  26. package/dist/cli/commands/configCommands.js +166 -0
  27. package/dist/cli/commands/databaseCommands.d.ts +13 -0
  28. package/dist/cli/commands/databaseCommands.js +554 -0
  29. package/dist/cli/commands/functionCommands.d.ts +7 -0
  30. package/dist/cli/commands/functionCommands.js +330 -0
  31. package/dist/cli/commands/schemaCommands.d.ts +7 -0
  32. package/dist/cli/commands/schemaCommands.js +169 -0
  33. package/dist/cli/commands/storageCommands.d.ts +5 -0
  34. package/dist/cli/commands/storageCommands.js +143 -0
  35. package/dist/cli/commands/transferCommands.d.ts +5 -0
  36. package/dist/cli/commands/transferCommands.js +384 -0
  37. package/dist/collections/attributes.d.ts +13 -0
  38. package/dist/collections/attributes.js +1364 -0
  39. package/dist/collections/indexes.d.ts +12 -0
  40. package/dist/collections/indexes.js +217 -0
  41. package/dist/collections/methods.d.ts +19 -0
  42. package/dist/collections/methods.js +682 -0
  43. package/dist/collections/tableOperations.d.ts +86 -0
  44. package/dist/collections/tableOperations.js +434 -0
  45. package/dist/collections/transferOperations.d.ts +8 -0
  46. package/dist/collections/transferOperations.js +412 -0
  47. package/dist/collections/wipeOperations.d.ts +16 -0
  48. package/dist/collections/wipeOperations.js +233 -0
  49. package/dist/config/ConfigManager.d.ts +445 -0
  50. package/dist/config/ConfigManager.js +625 -0
  51. package/dist/config/configMigration.d.ts +87 -0
  52. package/dist/config/configMigration.js +390 -0
  53. package/dist/config/configValidation.d.ts +66 -0
  54. package/dist/config/configValidation.js +358 -0
  55. package/dist/config/index.d.ts +8 -0
  56. package/dist/config/index.js +7 -0
  57. package/dist/config/services/ConfigDiscoveryService.d.ts +126 -0
  58. package/dist/config/services/ConfigDiscoveryService.js +374 -0
  59. package/dist/config/services/ConfigLoaderService.d.ts +129 -0
  60. package/dist/config/services/ConfigLoaderService.js +540 -0
  61. package/dist/config/services/ConfigMergeService.d.ts +208 -0
  62. package/dist/config/services/ConfigMergeService.js +308 -0
  63. package/dist/config/services/ConfigValidationService.d.ts +214 -0
  64. package/dist/config/services/ConfigValidationService.js +310 -0
  65. package/dist/config/services/SessionAuthService.d.ts +225 -0
  66. package/dist/config/services/SessionAuthService.js +456 -0
  67. package/dist/config/services/__tests__/ConfigMergeService.test.d.ts +1 -0
  68. package/dist/config/services/__tests__/ConfigMergeService.test.js +271 -0
  69. package/dist/config/services/index.d.ts +13 -0
  70. package/dist/config/services/index.js +10 -0
  71. package/dist/config/yamlConfig.d.ts +722 -0
  72. package/dist/config/yamlConfig.js +702 -0
  73. package/dist/databases/methods.d.ts +6 -0
  74. package/dist/databases/methods.js +35 -0
  75. package/dist/databases/setup.d.ts +5 -0
  76. package/dist/databases/setup.js +45 -0
  77. package/dist/examples/yamlTerminologyExample.d.ts +42 -0
  78. package/dist/examples/yamlTerminologyExample.js +272 -0
  79. package/dist/functions/deployments.d.ts +4 -0
  80. package/dist/functions/deployments.js +146 -0
  81. package/dist/functions/fnConfigDiscovery.d.ts +3 -0
  82. package/dist/functions/fnConfigDiscovery.js +108 -0
  83. package/dist/functions/methods.d.ts +16 -0
  84. package/dist/functions/methods.js +162 -0
  85. package/dist/functions/pathResolution.d.ts +37 -0
  86. package/dist/functions/pathResolution.js +185 -0
  87. package/dist/functions/templates/count-docs-in-collection/README.md +54 -0
  88. package/dist/functions/templates/count-docs-in-collection/src/main.ts +159 -0
  89. package/dist/functions/templates/count-docs-in-collection/src/request.ts +9 -0
  90. package/dist/functions/templates/hono-typescript/README.md +286 -0
  91. package/dist/functions/templates/hono-typescript/src/adapters/request.ts +74 -0
  92. package/dist/functions/templates/hono-typescript/src/adapters/response.ts +106 -0
  93. package/dist/functions/templates/hono-typescript/src/app.ts +180 -0
  94. package/dist/functions/templates/hono-typescript/src/context.ts +103 -0
  95. package/dist/functions/templates/hono-typescript/src/index.ts +54 -0
  96. package/dist/functions/templates/hono-typescript/src/middleware/appwrite.ts +119 -0
  97. package/dist/functions/templates/typescript-node/README.md +32 -0
  98. package/dist/functions/templates/typescript-node/src/context.ts +103 -0
  99. package/dist/functions/templates/typescript-node/src/index.ts +29 -0
  100. package/dist/functions/templates/uv/README.md +31 -0
  101. package/dist/functions/templates/uv/pyproject.toml +30 -0
  102. package/dist/functions/templates/uv/src/__init__.py +0 -0
  103. package/dist/functions/templates/uv/src/context.py +125 -0
  104. package/dist/functions/templates/uv/src/index.py +46 -0
  105. package/dist/init.d.ts +2 -0
  106. package/dist/init.js +57 -0
  107. package/dist/interactiveCLI.d.ts +31 -0
  108. package/dist/interactiveCLI.js +898 -0
  109. package/dist/main.d.ts +2 -0
  110. package/dist/main.js +1172 -0
  111. package/dist/migrations/afterImportActions.d.ts +17 -0
  112. package/dist/migrations/afterImportActions.js +306 -0
  113. package/dist/migrations/appwriteToX.d.ts +211 -0
  114. package/dist/migrations/appwriteToX.js +491 -0
  115. package/dist/migrations/comprehensiveTransfer.d.ts +147 -0
  116. package/dist/migrations/comprehensiveTransfer.js +1317 -0
  117. package/dist/migrations/dataLoader.d.ts +753 -0
  118. package/dist/migrations/dataLoader.js +1250 -0
  119. package/dist/migrations/importController.d.ts +23 -0
  120. package/dist/migrations/importController.js +268 -0
  121. package/dist/migrations/importDataActions.d.ts +50 -0
  122. package/dist/migrations/importDataActions.js +230 -0
  123. package/dist/migrations/relationships.d.ts +29 -0
  124. package/dist/migrations/relationships.js +204 -0
  125. package/dist/migrations/services/DataTransformationService.d.ts +55 -0
  126. package/dist/migrations/services/DataTransformationService.js +158 -0
  127. package/dist/migrations/services/FileHandlerService.d.ts +75 -0
  128. package/dist/migrations/services/FileHandlerService.js +236 -0
  129. package/dist/migrations/services/ImportOrchestrator.d.ts +97 -0
  130. package/dist/migrations/services/ImportOrchestrator.js +485 -0
  131. package/dist/migrations/services/RateLimitManager.d.ts +138 -0
  132. package/dist/migrations/services/RateLimitManager.js +279 -0
  133. package/dist/migrations/services/RelationshipResolver.d.ts +120 -0
  134. package/dist/migrations/services/RelationshipResolver.js +332 -0
  135. package/dist/migrations/services/UserMappingService.d.ts +109 -0
  136. package/dist/migrations/services/UserMappingService.js +277 -0
  137. package/dist/migrations/services/ValidationService.d.ts +74 -0
  138. package/dist/migrations/services/ValidationService.js +260 -0
  139. package/dist/migrations/transfer.d.ts +26 -0
  140. package/dist/migrations/transfer.js +608 -0
  141. package/dist/migrations/yaml/YamlImportConfigLoader.d.ts +131 -0
  142. package/dist/migrations/yaml/YamlImportConfigLoader.js +383 -0
  143. package/dist/migrations/yaml/YamlImportIntegration.d.ts +93 -0
  144. package/dist/migrations/yaml/YamlImportIntegration.js +341 -0
  145. package/dist/migrations/yaml/generateImportSchemas.d.ts +30 -0
  146. package/dist/migrations/yaml/generateImportSchemas.js +1327 -0
  147. package/dist/schemas/authUser.d.ts +24 -0
  148. package/dist/schemas/authUser.js +17 -0
  149. package/dist/setup.d.ts +2 -0
  150. package/dist/setup.js +5 -0
  151. package/dist/setupCommands.d.ts +58 -0
  152. package/dist/setupCommands.js +490 -0
  153. package/dist/setupController.d.ts +9 -0
  154. package/dist/setupController.js +34 -0
  155. package/dist/shared/attributeMapper.d.ts +20 -0
  156. package/dist/shared/attributeMapper.js +203 -0
  157. package/dist/shared/backupMetadataSchema.d.ts +94 -0
  158. package/dist/shared/backupMetadataSchema.js +38 -0
  159. package/dist/shared/backupTracking.d.ts +18 -0
  160. package/dist/shared/backupTracking.js +176 -0
  161. package/dist/shared/confirmationDialogs.d.ts +75 -0
  162. package/dist/shared/confirmationDialogs.js +236 -0
  163. package/dist/shared/errorUtils.d.ts +54 -0
  164. package/dist/shared/errorUtils.js +95 -0
  165. package/dist/shared/functionManager.d.ts +48 -0
  166. package/dist/shared/functionManager.js +336 -0
  167. package/dist/shared/indexManager.d.ts +24 -0
  168. package/dist/shared/indexManager.js +151 -0
  169. package/dist/shared/jsonSchemaGenerator.d.ts +50 -0
  170. package/dist/shared/jsonSchemaGenerator.js +290 -0
  171. package/dist/shared/logging.d.ts +61 -0
  172. package/dist/shared/logging.js +116 -0
  173. package/dist/shared/messageFormatter.d.ts +39 -0
  174. package/dist/shared/messageFormatter.js +162 -0
  175. package/dist/shared/migrationHelpers.d.ts +61 -0
  176. package/dist/shared/migrationHelpers.js +145 -0
  177. package/dist/shared/operationLogger.d.ts +10 -0
  178. package/dist/shared/operationLogger.js +12 -0
  179. package/dist/shared/operationQueue.d.ts +40 -0
  180. package/dist/shared/operationQueue.js +311 -0
  181. package/dist/shared/operationsTable.d.ts +26 -0
  182. package/dist/shared/operationsTable.js +286 -0
  183. package/dist/shared/operationsTableSchema.d.ts +48 -0
  184. package/dist/shared/operationsTableSchema.js +35 -0
  185. package/dist/shared/progressManager.d.ts +62 -0
  186. package/dist/shared/progressManager.js +215 -0
  187. package/dist/shared/pydanticModelGenerator.d.ts +17 -0
  188. package/dist/shared/pydanticModelGenerator.js +615 -0
  189. package/dist/shared/relationshipExtractor.d.ts +56 -0
  190. package/dist/shared/relationshipExtractor.js +138 -0
  191. package/dist/shared/schemaGenerator.d.ts +40 -0
  192. package/dist/shared/schemaGenerator.js +556 -0
  193. package/dist/shared/selectionDialogs.d.ts +214 -0
  194. package/dist/shared/selectionDialogs.js +544 -0
  195. package/dist/storage/backupCompression.d.ts +20 -0
  196. package/dist/storage/backupCompression.js +67 -0
  197. package/dist/storage/methods.d.ts +32 -0
  198. package/dist/storage/methods.js +472 -0
  199. package/dist/storage/schemas.d.ts +842 -0
  200. package/dist/storage/schemas.js +175 -0
  201. package/dist/types.d.ts +4 -0
  202. package/dist/types.js +3 -0
  203. package/dist/users/methods.d.ts +16 -0
  204. package/dist/users/methods.js +277 -0
  205. package/dist/utils/ClientFactory.d.ts +87 -0
  206. package/dist/utils/ClientFactory.js +212 -0
  207. package/dist/utils/configDiscovery.d.ts +78 -0
  208. package/dist/utils/configDiscovery.js +472 -0
  209. package/dist/utils/configMigration.d.ts +1 -0
  210. package/dist/utils/configMigration.js +261 -0
  211. package/dist/utils/constantsGenerator.d.ts +31 -0
  212. package/dist/utils/constantsGenerator.js +321 -0
  213. package/dist/utils/dataConverters.d.ts +46 -0
  214. package/dist/utils/dataConverters.js +139 -0
  215. package/dist/utils/directoryUtils.d.ts +22 -0
  216. package/dist/utils/directoryUtils.js +59 -0
  217. package/dist/utils/getClientFromConfig.d.ts +39 -0
  218. package/dist/utils/getClientFromConfig.js +199 -0
  219. package/dist/utils/helperFunctions.d.ts +63 -0
  220. package/dist/utils/helperFunctions.js +156 -0
  221. package/dist/utils/index.d.ts +2 -0
  222. package/dist/utils/index.js +2 -0
  223. package/dist/utils/loadConfigs.d.ts +50 -0
  224. package/dist/utils/loadConfigs.js +358 -0
  225. package/dist/utils/pathResolvers.d.ts +53 -0
  226. package/dist/utils/pathResolvers.js +72 -0
  227. package/dist/utils/projectConfig.d.ts +119 -0
  228. package/dist/utils/projectConfig.js +171 -0
  229. package/dist/utils/retryFailedPromises.d.ts +2 -0
  230. package/dist/utils/retryFailedPromises.js +23 -0
  231. package/dist/utils/sessionAuth.d.ts +48 -0
  232. package/dist/utils/sessionAuth.js +164 -0
  233. package/dist/utils/setupFiles.d.ts +4 -0
  234. package/dist/utils/setupFiles.js +1192 -0
  235. package/dist/utils/typeGuards.d.ts +35 -0
  236. package/dist/utils/typeGuards.js +57 -0
  237. package/dist/utils/validationRules.d.ts +43 -0
  238. package/dist/utils/validationRules.js +42 -0
  239. package/dist/utils/versionDetection.d.ts +58 -0
  240. package/dist/utils/versionDetection.js +251 -0
  241. package/dist/utils/yamlConverter.d.ts +100 -0
  242. package/dist/utils/yamlConverter.js +428 -0
  243. package/dist/utils/yamlLoader.d.ts +70 -0
  244. package/dist/utils/yamlLoader.js +267 -0
  245. package/dist/utilsController.d.ts +106 -0
  246. package/dist/utilsController.js +863 -0
  247. package/package.json +75 -0
  248. package/scripts/copy-templates.ts +23 -0
  249. package/src/adapters/AdapterFactory.ts +510 -0
  250. package/src/adapters/DatabaseAdapter.ts +306 -0
  251. package/src/adapters/LegacyAdapter.ts +841 -0
  252. package/src/adapters/TablesDBAdapter.ts +773 -0
  253. package/src/adapters/index.ts +37 -0
  254. package/src/backups/operations/bucketBackup.ts +277 -0
  255. package/src/backups/operations/collectionBackup.ts +310 -0
  256. package/src/backups/operations/comprehensiveBackup.ts +342 -0
  257. package/src/backups/schemas/bucketManifest.ts +78 -0
  258. package/src/backups/schemas/comprehensiveManifest.ts +76 -0
  259. package/src/backups/tracking/centralizedTracking.ts +352 -0
  260. package/src/cli/commands/configCommands.ts +201 -0
  261. package/src/cli/commands/databaseCommands.ts +749 -0
  262. package/src/cli/commands/functionCommands.ts +418 -0
  263. package/src/cli/commands/schemaCommands.ts +200 -0
  264. package/src/cli/commands/storageCommands.ts +152 -0
  265. package/src/cli/commands/transferCommands.ts +457 -0
  266. package/src/collections/attributes.ts +2054 -0
  267. package/src/collections/attributes.ts.backup +1555 -0
  268. package/src/collections/indexes.ts +352 -0
  269. package/src/collections/methods.ts +745 -0
  270. package/src/collections/tableOperations.ts +506 -0
  271. package/src/collections/transferOperations.ts +590 -0
  272. package/src/collections/wipeOperations.ts +346 -0
  273. package/src/config/ConfigManager.ts +808 -0
  274. package/src/config/README.md +274 -0
  275. package/src/config/configMigration.ts +575 -0
  276. package/src/config/configValidation.ts +445 -0
  277. package/src/config/index.ts +10 -0
  278. package/src/config/services/ConfigDiscoveryService.ts +463 -0
  279. package/src/config/services/ConfigLoaderService.ts +740 -0
  280. package/src/config/services/ConfigMergeService.ts +388 -0
  281. package/src/config/services/ConfigValidationService.ts +394 -0
  282. package/src/config/services/SessionAuthService.ts +565 -0
  283. package/src/config/services/__tests__/ConfigMergeService.test.ts +351 -0
  284. package/src/config/services/index.ts +29 -0
  285. package/src/config/yamlConfig.ts +761 -0
  286. package/src/databases/methods.ts +49 -0
  287. package/src/databases/setup.ts +77 -0
  288. package/src/examples/yamlTerminologyExample.ts +346 -0
  289. package/src/functions/deployments.ts +220 -0
  290. package/src/functions/fnConfigDiscovery.ts +103 -0
  291. package/src/functions/methods.ts +271 -0
  292. package/src/functions/pathResolution.ts +227 -0
  293. package/src/functions/templates/count-docs-in-collection/README.md +54 -0
  294. package/src/functions/templates/count-docs-in-collection/src/main.ts +159 -0
  295. package/src/functions/templates/count-docs-in-collection/src/request.ts +9 -0
  296. package/src/functions/templates/hono-typescript/README.md +286 -0
  297. package/src/functions/templates/hono-typescript/src/adapters/request.ts +74 -0
  298. package/src/functions/templates/hono-typescript/src/adapters/response.ts +106 -0
  299. package/src/functions/templates/hono-typescript/src/app.ts +180 -0
  300. package/src/functions/templates/hono-typescript/src/context.ts +103 -0
  301. package/src/functions/templates/hono-typescript/src/index.ts +54 -0
  302. package/src/functions/templates/hono-typescript/src/middleware/appwrite.ts +119 -0
  303. package/src/functions/templates/typescript-node/README.md +32 -0
  304. package/src/functions/templates/typescript-node/src/context.ts +103 -0
  305. package/src/functions/templates/typescript-node/src/index.ts +29 -0
  306. package/src/functions/templates/uv/README.md +31 -0
  307. package/src/functions/templates/uv/pyproject.toml +30 -0
  308. package/src/functions/templates/uv/src/__init__.py +0 -0
  309. package/src/functions/templates/uv/src/context.py +125 -0
  310. package/src/functions/templates/uv/src/index.py +46 -0
  311. package/src/init.ts +62 -0
  312. package/src/interactiveCLI.ts +1136 -0
  313. package/src/main.ts +1661 -0
  314. package/src/migrations/afterImportActions.ts +580 -0
  315. package/src/migrations/appwriteToX.ts +664 -0
  316. package/src/migrations/comprehensiveTransfer.ts +2285 -0
  317. package/src/migrations/dataLoader.ts +1702 -0
  318. package/src/migrations/importController.ts +428 -0
  319. package/src/migrations/importDataActions.ts +315 -0
  320. package/src/migrations/relationships.ts +334 -0
  321. package/src/migrations/services/DataTransformationService.ts +196 -0
  322. package/src/migrations/services/FileHandlerService.ts +311 -0
  323. package/src/migrations/services/ImportOrchestrator.ts +666 -0
  324. package/src/migrations/services/RateLimitManager.ts +363 -0
  325. package/src/migrations/services/RelationshipResolver.ts +461 -0
  326. package/src/migrations/services/UserMappingService.ts +345 -0
  327. package/src/migrations/services/ValidationService.ts +349 -0
  328. package/src/migrations/transfer.ts +1068 -0
  329. package/src/migrations/yaml/YamlImportConfigLoader.ts +439 -0
  330. package/src/migrations/yaml/YamlImportIntegration.ts +446 -0
  331. package/src/migrations/yaml/generateImportSchemas.ts +1354 -0
  332. package/src/schemas/authUser.ts +23 -0
  333. package/src/setup.ts +8 -0
  334. package/src/setupCommands.ts +603 -0
  335. package/src/setupController.ts +43 -0
  336. package/src/shared/attributeMapper.ts +229 -0
  337. package/src/shared/backupMetadataSchema.ts +93 -0
  338. package/src/shared/backupTracking.ts +211 -0
  339. package/src/shared/confirmationDialogs.ts +327 -0
  340. package/src/shared/errorUtils.ts +110 -0
  341. package/src/shared/functionManager.ts +525 -0
  342. package/src/shared/indexManager.ts +254 -0
  343. package/src/shared/jsonSchemaGenerator.ts +383 -0
  344. package/src/shared/logging.ts +149 -0
  345. package/src/shared/messageFormatter.ts +208 -0
  346. package/src/shared/migrationHelpers.ts +232 -0
  347. package/src/shared/operationLogger.ts +20 -0
  348. package/src/shared/operationQueue.ts +377 -0
  349. package/src/shared/operationsTable.ts +338 -0
  350. package/src/shared/operationsTableSchema.ts +60 -0
  351. package/src/shared/progressManager.ts +278 -0
  352. package/src/shared/pydanticModelGenerator.ts +618 -0
  353. package/src/shared/relationshipExtractor.ts +214 -0
  354. package/src/shared/schemaGenerator.ts +644 -0
  355. package/src/shared/selectionDialogs.ts +749 -0
  356. package/src/storage/backupCompression.ts +88 -0
  357. package/src/storage/methods.ts +698 -0
  358. package/src/storage/schemas.ts +205 -0
  359. package/src/types/node-appwrite-tablesdb.d.ts +44 -0
  360. package/src/types.ts +9 -0
  361. package/src/users/methods.ts +359 -0
  362. package/src/utils/ClientFactory.ts +240 -0
  363. package/src/utils/configDiscovery.ts +557 -0
  364. package/src/utils/configMigration.ts +348 -0
  365. package/src/utils/constantsGenerator.ts +369 -0
  366. package/src/utils/dataConverters.ts +159 -0
  367. package/src/utils/directoryUtils.ts +61 -0
  368. package/src/utils/getClientFromConfig.ts +257 -0
  369. package/src/utils/helperFunctions.ts +228 -0
  370. package/src/utils/index.ts +2 -0
  371. package/src/utils/loadConfigs.ts +449 -0
  372. package/src/utils/pathResolvers.ts +81 -0
  373. package/src/utils/projectConfig.ts +299 -0
  374. package/src/utils/retryFailedPromises.ts +29 -0
  375. package/src/utils/sessionAuth.ts +230 -0
  376. package/src/utils/setupFiles.ts +1238 -0
  377. package/src/utils/typeGuards.ts +65 -0
  378. package/src/utils/validationRules.ts +88 -0
  379. package/src/utils/versionDetection.ts +292 -0
  380. package/src/utils/yamlConverter.ts +542 -0
  381. package/src/utils/yamlLoader.ts +371 -0
  382. package/src/utilsController.ts +1203 -0
  383. package/tests/README.md +497 -0
  384. package/tests/adapters/AdapterFactory.test.ts +277 -0
  385. package/tests/integration/syncOperations.test.ts +463 -0
  386. package/tests/jest.config.js +25 -0
  387. package/tests/migration/configMigration.test.ts +546 -0
  388. package/tests/setup.ts +62 -0
  389. package/tests/testUtils.ts +340 -0
  390. package/tests/utils/loadConfigs.test.ts +350 -0
  391. package/tests/validation/configValidation.test.ts +412 -0
  392. package/tsconfig.json +44 -0
@@ -0,0 +1,290 @@
1
+ import fs from "fs";
2
+ import path from "path";
3
+ import { toCamelCase, toPascalCase } from "../utils/index.js";
4
+ import chalk from "chalk";
5
+ import { extractSimpleRelationships, resolveCollectionName } from "./relationshipExtractor.js";
6
+ import { MessageFormatter } from "./messageFormatter.js";
7
+ export class JsonSchemaGenerator {
8
+ config;
9
+ appwriteFolderPath;
10
+ relationshipMap = new Map();
11
+ constructor(config, appwriteFolderPath) {
12
+ this.config = config;
13
+ this.appwriteFolderPath = appwriteFolderPath;
14
+ this.extractRelationships();
15
+ }
16
+ resolveCollectionName = (idOrName) => {
17
+ return resolveCollectionName(this.config, idOrName);
18
+ };
19
+ extractRelationships() {
20
+ this.relationshipMap = extractSimpleRelationships(this.config);
21
+ }
22
+ attributeToJsonSchemaProperty(attribute) {
23
+ const property = {
24
+ type: "string" // Default type
25
+ };
26
+ // Handle array attributes
27
+ if (attribute.array) {
28
+ property.type = "array";
29
+ property.items = this.getBaseTypeSchema(attribute);
30
+ }
31
+ else {
32
+ Object.assign(property, this.getBaseTypeSchema(attribute));
33
+ }
34
+ // Set default value (only for attributes that support it)
35
+ if (attribute.type !== "relationship" && "xdefault" in attribute &&
36
+ attribute.xdefault !== undefined && attribute.xdefault !== null) {
37
+ property.default = attribute.xdefault;
38
+ }
39
+ return property;
40
+ }
41
+ getBaseTypeSchema(attribute) {
42
+ const schema = {
43
+ type: "string" // Default type
44
+ };
45
+ switch (attribute.type) {
46
+ case "string":
47
+ schema.type = "string";
48
+ if (attribute.size) {
49
+ schema.maxLength = attribute.size;
50
+ }
51
+ break;
52
+ case "integer":
53
+ schema.type = "integer";
54
+ if (attribute.min !== undefined) {
55
+ schema.minimum = Number(attribute.min);
56
+ }
57
+ if (attribute.max !== undefined) {
58
+ schema.maximum = Number(attribute.max);
59
+ }
60
+ break;
61
+ case "double":
62
+ case "float": // Backward compatibility
63
+ schema.type = "number";
64
+ if (attribute.min !== undefined) {
65
+ schema.minimum = Number(attribute.min);
66
+ }
67
+ if (attribute.max !== undefined) {
68
+ schema.maximum = Number(attribute.max);
69
+ }
70
+ break;
71
+ case "boolean":
72
+ schema.type = "boolean";
73
+ break;
74
+ case "datetime":
75
+ schema.type = "string";
76
+ schema.format = "date-time";
77
+ break;
78
+ case "email":
79
+ schema.type = "string";
80
+ schema.format = "email";
81
+ break;
82
+ case "ip":
83
+ schema.type = "string";
84
+ schema.format = "ipv4";
85
+ break;
86
+ case "url":
87
+ schema.type = "string";
88
+ schema.format = "uri";
89
+ break;
90
+ case "enum":
91
+ schema.type = "string";
92
+ if (attribute.elements) {
93
+ schema.enum = attribute.elements;
94
+ }
95
+ break;
96
+ case "relationship":
97
+ if (attribute.relatedCollection) {
98
+ // For relationships, reference the related collection schema
99
+ schema.$ref = `#/definitions/${toPascalCase(this.resolveCollectionName(attribute.relatedCollection))}`;
100
+ }
101
+ else {
102
+ schema.type = "string";
103
+ }
104
+ break;
105
+ default:
106
+ schema.type = "string";
107
+ }
108
+ return schema;
109
+ }
110
+ createJsonSchema(collection) {
111
+ const pascalName = toPascalCase(collection.name);
112
+ const schema = {
113
+ $schema: "https://json-schema.org/draft/2020-12/schema",
114
+ $id: `https://example.com/schemas/${toCamelCase(collection.name)}.json`,
115
+ title: pascalName,
116
+ type: "object",
117
+ properties: {
118
+ // Standard Appwrite document fields
119
+ $id: {
120
+ type: "string",
121
+ pattern: "^[a-zA-Z0-9][a-zA-Z0-9._-]{0,35}$"
122
+ },
123
+ $createdAt: {
124
+ type: "string",
125
+ format: "date-time"
126
+ },
127
+ $updatedAt: {
128
+ type: "string",
129
+ format: "date-time"
130
+ },
131
+ $permissions: {
132
+ type: "array",
133
+ items: {
134
+ type: "string"
135
+ }
136
+ }
137
+ },
138
+ required: ["$id", "$createdAt", "$updatedAt"],
139
+ additionalProperties: false
140
+ };
141
+ // Add custom attributes
142
+ const requiredFields = [...schema.required];
143
+ if (collection.attributes) {
144
+ collection.attributes.forEach((attribute) => {
145
+ schema.properties[attribute.key] = this.attributeToJsonSchemaProperty(attribute);
146
+ if (attribute.required) {
147
+ requiredFields.push(attribute.key);
148
+ }
149
+ });
150
+ }
151
+ schema.required = requiredFields;
152
+ // Add relationship definitions if any exist
153
+ const relationships = this.relationshipMap.get(collection.name);
154
+ if (relationships && relationships.length > 0) {
155
+ schema.definitions = {};
156
+ relationships.forEach((rel) => {
157
+ const relatedPascalName = toPascalCase(rel.relatedCollection);
158
+ schema.definitions[relatedPascalName] = {
159
+ type: "object",
160
+ properties: {
161
+ $id: { type: "string" },
162
+ $createdAt: { type: "string", format: "date-time" },
163
+ $updatedAt: { type: "string", format: "date-time" }
164
+ },
165
+ additionalProperties: true
166
+ };
167
+ });
168
+ }
169
+ return schema;
170
+ }
171
+ generateJsonSchemas(options = {}) {
172
+ const { outputFormat = "both", outputDirectory = "schemas", verbose = false } = options;
173
+ if (!this.config.collections) {
174
+ if (verbose) {
175
+ MessageFormatter.warning("No collections found in config", { prefix: "Schema" });
176
+ }
177
+ return;
178
+ }
179
+ // Create JSON schemas directory using provided outputDirectory
180
+ const jsonSchemasPath = path.isAbsolute(outputDirectory)
181
+ ? outputDirectory
182
+ : path.join(this.appwriteFolderPath, outputDirectory);
183
+ if (!fs.existsSync(jsonSchemasPath)) {
184
+ fs.mkdirSync(jsonSchemasPath, { recursive: true });
185
+ }
186
+ if (verbose) {
187
+ MessageFormatter.processing(`Generating JSON schemas for ${this.config.collections.length} collections...`, { prefix: "Schema" });
188
+ }
189
+ this.config.collections.forEach((collection) => {
190
+ const schema = this.createJsonSchema(collection);
191
+ const camelCaseName = toCamelCase(collection.name);
192
+ // Generate JSON file
193
+ if (outputFormat === "json" || outputFormat === "both") {
194
+ const jsonPath = path.join(jsonSchemasPath, `${camelCaseName}.json`);
195
+ fs.writeFileSync(jsonPath, JSON.stringify(schema, null, 2), { encoding: "utf-8" });
196
+ if (verbose) {
197
+ MessageFormatter.success(`JSON schema written to ${jsonPath}`, { prefix: "Schema" });
198
+ }
199
+ }
200
+ // Generate TypeScript file
201
+ if (outputFormat === "typescript" || outputFormat === "both") {
202
+ const tsContent = this.generateTypeScriptSchema(schema, collection.name);
203
+ const tsPath = path.join(jsonSchemasPath, `${camelCaseName}.schema.ts`);
204
+ fs.writeFileSync(tsPath, tsContent, { encoding: "utf-8" });
205
+ if (verbose) {
206
+ MessageFormatter.success(`TypeScript schema written to ${tsPath}`, { prefix: "Schema" });
207
+ }
208
+ }
209
+ });
210
+ // Generate index file only for TypeScript output
211
+ if (outputFormat === "typescript" || outputFormat === "both") {
212
+ this.generateIndexFile(outputFormat, jsonSchemasPath, verbose);
213
+ }
214
+ if (verbose) {
215
+ MessageFormatter.success("JSON schema generation completed", { prefix: "Schema" });
216
+ }
217
+ }
218
+ generateTypeScriptSchema(schema, collectionName) {
219
+ const camelName = toCamelCase(collectionName);
220
+ return `// Auto-generated JSON schema for ${collectionName}
221
+ import type { JSONSchema7 } from "json-schema";
222
+
223
+ export const ${camelName}JsonSchema: JSONSchema7 = ${JSON.stringify(schema, null, 2)} as const;
224
+
225
+ export type ${toPascalCase(collectionName)}JsonSchema = typeof ${camelName}JsonSchema;
226
+
227
+ export default ${camelName}JsonSchema;
228
+ `;
229
+ }
230
+ generateIndexFile(outputFormat, jsonSchemasPath, verbose) {
231
+ if (!this.config.collections)
232
+ return;
233
+ const indexPath = path.join(jsonSchemasPath, "index.ts");
234
+ const imports = [];
235
+ const exports = [];
236
+ this.config.collections.forEach((collection) => {
237
+ const camelName = toCamelCase(collection.name);
238
+ const pascalName = toPascalCase(collection.name);
239
+ if (outputFormat === "typescript" || outputFormat === "both") {
240
+ imports.push(`import { ${camelName}JsonSchema } from "./${camelName}.schema.js";`);
241
+ exports.push(` ${camelName}: ${camelName}JsonSchema,`);
242
+ }
243
+ });
244
+ const indexContent = `// Auto-generated index for JSON schemas
245
+ ${imports.join('\n')}
246
+
247
+ export const jsonSchemas = {
248
+ ${exports.join('\n')}
249
+ };
250
+
251
+ export type JsonSchemas = typeof jsonSchemas;
252
+
253
+ // Individual schema exports
254
+ ${this.config.collections.map(collection => {
255
+ const camelName = toCamelCase(collection.name);
256
+ return `export { ${camelName}JsonSchema } from "./${camelName}.schema.js";`;
257
+ }).join('\n')}
258
+
259
+ export default jsonSchemas;
260
+ `;
261
+ fs.writeFileSync(indexPath, indexContent, { encoding: "utf-8" });
262
+ if (verbose) {
263
+ MessageFormatter.success(`Index file written to ${indexPath}`, { prefix: "Schema" });
264
+ }
265
+ }
266
+ validateSchema(schema) {
267
+ const errors = [];
268
+ // Basic validation
269
+ if (!schema.$schema) {
270
+ errors.push("Missing $schema property");
271
+ }
272
+ if (!schema.title) {
273
+ errors.push("Missing title property");
274
+ }
275
+ if (!schema.properties) {
276
+ errors.push("Missing properties");
277
+ }
278
+ if (!schema.required || !Array.isArray(schema.required)) {
279
+ errors.push("Missing or invalid required array");
280
+ }
281
+ // Validate required Appwrite fields
282
+ const requiredAppwriteFields = ["$id", "$createdAt", "$updatedAt"];
283
+ requiredAppwriteFields.forEach((field) => {
284
+ if (!schema.properties[field]) {
285
+ errors.push(`Missing required Appwrite field: ${field}`);
286
+ }
287
+ });
288
+ return { valid: errors.length === 0, errors };
289
+ }
290
+ }
@@ -0,0 +1,61 @@
1
+ import winston from "winston";
2
+ export interface LoggingConfig {
3
+ enabled: boolean;
4
+ level: string;
5
+ logDirectory?: string;
6
+ console: boolean;
7
+ }
8
+ /**
9
+ * Predefined logging configurations for common debugging scenarios
10
+ */
11
+ export declare const LOGGING_PRESETS: {
12
+ /** Minimal logging - errors only to console */
13
+ readonly minimal: {
14
+ readonly enabled: false;
15
+ readonly level: "error";
16
+ readonly console: true;
17
+ };
18
+ /** Standard logging - info level to file and console */
19
+ readonly standard: {
20
+ readonly enabled: true;
21
+ readonly level: "info";
22
+ readonly console: true;
23
+ };
24
+ /** Debug logging - verbose debug output for troubleshooting */
25
+ readonly debug: {
26
+ readonly enabled: true;
27
+ readonly level: "debug";
28
+ readonly console: true;
29
+ };
30
+ /** Silent - no logging output */
31
+ readonly silent: {
32
+ readonly enabled: false;
33
+ readonly level: "error";
34
+ readonly console: false;
35
+ };
36
+ };
37
+ export declare const configureLogging: (config?: Partial<LoggingConfig>) => void;
38
+ /**
39
+ * Configure logging using a preset
40
+ */
41
+ export declare const configureLoggingPreset: (preset: keyof typeof LOGGING_PRESETS, logDirectory?: string) => void;
42
+ export declare let logger: winston.Logger;
43
+ export declare const updateLogger: () => void;
44
+ /**
45
+ * Enable debug logging for troubleshooting push process issues
46
+ * This is a convenience function for quickly enabling comprehensive logging
47
+ */
48
+ export declare const enableDebugLogging: (logDirectory?: string) => void;
49
+ /**
50
+ * Disable logging (reset to default)
51
+ */
52
+ export declare const disableLogging: () => void;
53
+ /**
54
+ * Get current logging configuration
55
+ */
56
+ export declare const getLoggingConfig: () => {
57
+ enabled: boolean;
58
+ level: string;
59
+ logDirectory?: string;
60
+ console: boolean;
61
+ };
@@ -0,0 +1,116 @@
1
+ import winston from "winston";
2
+ import fs from "fs";
3
+ import path from "path";
4
+ /**
5
+ * Predefined logging configurations for common debugging scenarios
6
+ */
7
+ export const LOGGING_PRESETS = {
8
+ /** Minimal logging - errors only to console */
9
+ minimal: {
10
+ enabled: false,
11
+ level: 'error',
12
+ console: true
13
+ },
14
+ /** Standard logging - info level to file and console */
15
+ standard: {
16
+ enabled: true,
17
+ level: 'info',
18
+ console: true
19
+ },
20
+ /** Debug logging - verbose debug output for troubleshooting */
21
+ debug: {
22
+ enabled: true,
23
+ level: 'debug',
24
+ console: true
25
+ },
26
+ /** Silent - no logging output */
27
+ silent: {
28
+ enabled: false,
29
+ level: 'error',
30
+ console: false
31
+ }
32
+ };
33
+ const DEFAULT_LOGGING_CONFIG = {
34
+ enabled: false,
35
+ level: "info",
36
+ console: false,
37
+ };
38
+ let loggingConfig = DEFAULT_LOGGING_CONFIG;
39
+ export const configureLogging = (config = {}) => {
40
+ loggingConfig = { ...DEFAULT_LOGGING_CONFIG, ...config };
41
+ };
42
+ /**
43
+ * Configure logging using a preset
44
+ */
45
+ export const configureLoggingPreset = (preset, logDirectory) => {
46
+ const presetConfig = LOGGING_PRESETS[preset];
47
+ configureLogging({
48
+ ...presetConfig,
49
+ ...(logDirectory && { logDirectory })
50
+ });
51
+ updateLogger();
52
+ };
53
+ const createLogger = () => {
54
+ const transports = [];
55
+ // Add console transport if enabled
56
+ if (loggingConfig.console) {
57
+ transports.push(new winston.transports.Console({
58
+ format: winston.format.combine(winston.format.colorize(), winston.format.simple())
59
+ }));
60
+ }
61
+ // Add file transports if logging is enabled
62
+ if (loggingConfig.enabled) {
63
+ const logDir = loggingConfig.logDirectory || path.join(process.cwd(), "zlogs");
64
+ if (!fs.existsSync(logDir)) {
65
+ fs.mkdirSync(logDir, { recursive: true });
66
+ }
67
+ transports.push(new winston.transports.File({
68
+ filename: path.join(logDir, "error.log"),
69
+ level: "error",
70
+ }), new winston.transports.File({
71
+ filename: path.join(logDir, "combined.log"),
72
+ }));
73
+ }
74
+ return winston.createLogger({
75
+ level: loggingConfig.level,
76
+ format: winston.format.combine(winston.format.timestamp(), winston.format.errors({ stack: true }), winston.format.json()),
77
+ defaultMeta: { service: "@njdamstra/appwrite-utils-cli" },
78
+ transports,
79
+ silent: !loggingConfig.enabled && !loggingConfig.console,
80
+ });
81
+ };
82
+ export let logger = createLogger();
83
+ // Recreate logger when config changes
84
+ export const updateLogger = () => {
85
+ logger = createLogger();
86
+ };
87
+ /**
88
+ * Enable debug logging for troubleshooting push process issues
89
+ * This is a convenience function for quickly enabling comprehensive logging
90
+ */
91
+ export const enableDebugLogging = (logDirectory) => {
92
+ configureLogging({
93
+ enabled: true,
94
+ level: 'debug',
95
+ console: true,
96
+ logDirectory
97
+ });
98
+ updateLogger();
99
+ logger.info('Debug logging enabled for push process troubleshooting', {
100
+ level: 'debug',
101
+ console: true,
102
+ logDirectory: logDirectory || 'zlogs',
103
+ operation: 'enableDebugLogging'
104
+ });
105
+ };
106
+ /**
107
+ * Disable logging (reset to default)
108
+ */
109
+ export const disableLogging = () => {
110
+ configureLogging(DEFAULT_LOGGING_CONFIG);
111
+ updateLogger();
112
+ };
113
+ /**
114
+ * Get current logging configuration
115
+ */
116
+ export const getLoggingConfig = () => ({ ...loggingConfig });
@@ -0,0 +1,39 @@
1
+ export interface MessageOptions {
2
+ prefix?: string;
3
+ skipLogging?: boolean;
4
+ logLevel?: "info" | "warn" | "error" | "debug";
5
+ }
6
+ export declare class MessageFormatter {
7
+ static success(message: string, options?: MessageOptions): void;
8
+ static error(message: string, error?: Error | string, options?: MessageOptions): void;
9
+ static warning(message: string, options?: MessageOptions): void;
10
+ static info(message: string, options?: MessageOptions): void;
11
+ static step(step: number, total: number, message: string, options?: MessageOptions): void;
12
+ static progress(message: string, options?: MessageOptions): void;
13
+ static debug(message: string, data?: any, options?: MessageOptions): void;
14
+ static processing(message: string, options?: MessageOptions): void;
15
+ static divider(): void;
16
+ static banner(title: string, subtitle?: string): void;
17
+ static section(title: string): void;
18
+ static list(items: string[], title?: string): void;
19
+ static table(data: Record<string, string | number>[], headers?: string[]): void;
20
+ static operationSummary(title: string, stats: Record<string, string | number>, duration?: number): void;
21
+ static formatBytes(bytes: number): string;
22
+ static formatDuration(ms: number): string;
23
+ static formatNumber(num: number): string;
24
+ }
25
+ export declare const Messages: {
26
+ readonly CONFIG_NOT_FOUND: "Appwrite configuration not found. Run 'appwrite-migrate setup' first.";
27
+ readonly CONFIG_LOADED: (type: string, path: string) => string;
28
+ readonly DATABASE_CONNECTION_FAILED: "Failed to connect to Appwrite. Check your endpoint and API key.";
29
+ readonly OPERATION_CANCELLED: "Operation cancelled by user.";
30
+ readonly OPERATION_COMPLETED: (operation: string) => string;
31
+ readonly BACKUP_STARTED: (database: string) => string;
32
+ readonly BACKUP_COMPLETED: (database: string, size: number) => string;
33
+ readonly IMPORT_STARTED: (collections: number) => string;
34
+ readonly IMPORT_COMPLETED: (documents: number) => string;
35
+ readonly FUNCTION_DEPLOYED: (name: string) => string;
36
+ readonly FUNCTION_DEPLOYMENT_FAILED: (name: string, error: string) => string;
37
+ readonly TRANSFER_STARTED: (source: string, target: string) => string;
38
+ readonly TRANSFER_COMPLETED: (items: number) => string;
39
+ };
@@ -0,0 +1,162 @@
1
+ import chalk from "chalk";
2
+ import { logger } from "./logging.js";
3
+ export class MessageFormatter {
4
+ static success(message, options = {}) {
5
+ const formatted = `${chalk.green("✅")} ${options.prefix ? `${options.prefix}: ` : ""}${message}`;
6
+ console.log(formatted);
7
+ if (!options.skipLogging) {
8
+ logger.info(`SUCCESS: ${options.prefix ? `${options.prefix}: ` : ""}${message}`);
9
+ }
10
+ }
11
+ static error(message, error, options = {}) {
12
+ const errorDetails = error instanceof Error ? error.message : error;
13
+ const formatted = `${chalk.red("❌")} ${options.prefix ? `${options.prefix}: ` : ""}${message}${errorDetails ? `\n ${chalk.gray(errorDetails)}` : ""}`;
14
+ console.error(formatted);
15
+ if (!options.skipLogging) {
16
+ logger.error(`ERROR: ${options.prefix ? `${options.prefix}: ` : ""}${message}`, {
17
+ error: errorDetails,
18
+ stack: error instanceof Error ? error.stack : undefined,
19
+ });
20
+ }
21
+ }
22
+ static warning(message, options = {}) {
23
+ const formatted = `${chalk.yellow("⚠️")} ${options.prefix ? `${options.prefix}: ` : ""}${message}`;
24
+ console.log(formatted);
25
+ if (!options.skipLogging) {
26
+ logger.warn(`WARNING: ${options.prefix ? `${options.prefix}: ` : ""}${message}`);
27
+ }
28
+ }
29
+ static info(message, options = {}) {
30
+ const formatted = `${chalk.blue("ℹ️")} ${options.prefix ? `${options.prefix}: ` : ""}${message}`;
31
+ console.log(formatted);
32
+ if (!options.skipLogging) {
33
+ logger.info(`INFO: ${options.prefix ? `${options.prefix}: ` : ""}${message}`);
34
+ }
35
+ }
36
+ static step(step, total, message, options = {}) {
37
+ const formatted = `${chalk.cyan(`[${step}/${total}]`)} ${options.prefix ? `${options.prefix}: ` : ""}${message}`;
38
+ console.log(formatted);
39
+ if (!options.skipLogging) {
40
+ logger.info(`STEP ${step}/${total}: ${options.prefix ? `${options.prefix}: ` : ""}${message}`);
41
+ }
42
+ }
43
+ static progress(message, options = {}) {
44
+ const formatted = `${chalk.gray("⏳")} ${options.prefix ? `${options.prefix}: ` : ""}${message}`;
45
+ console.log(formatted);
46
+ if (!options.skipLogging) {
47
+ logger.debug(`PROGRESS: ${options.prefix ? `${options.prefix}: ` : ""}${message}`);
48
+ }
49
+ }
50
+ static debug(message, data, options = {}) {
51
+ if (process.env.NODE_ENV === "development" || process.env.DEBUG) {
52
+ const formatted = `${chalk.magenta("🔍")} ${options.prefix ? `${options.prefix}: ` : ""}${message}`;
53
+ console.log(formatted);
54
+ if (data) {
55
+ console.log(chalk.gray(JSON.stringify(data, null, 2)));
56
+ }
57
+ }
58
+ if (!options.skipLogging) {
59
+ logger.debug(`DEBUG: ${options.prefix ? `${options.prefix}: ` : ""}${message}`, data);
60
+ }
61
+ }
62
+ static processing(message, options = {}) {
63
+ const formatted = `${chalk.cyan("⚙️")} ${options.prefix ? `${options.prefix}: ` : ""}${message}`;
64
+ console.log(formatted);
65
+ if (!options.skipLogging) {
66
+ logger.info(`PROCESSING: ${options.prefix ? `${options.prefix}: ` : ""}${message}`);
67
+ }
68
+ }
69
+ static divider() {
70
+ console.log(chalk.gray("─".repeat(60)));
71
+ }
72
+ static banner(title, subtitle) {
73
+ const divider = chalk.cyan("═".repeat(60));
74
+ console.log(`\n${divider}`);
75
+ console.log(chalk.cyan.bold(` ${title}`));
76
+ if (subtitle) {
77
+ console.log(chalk.gray(` ${subtitle}`));
78
+ }
79
+ console.log(`${divider}\n`);
80
+ }
81
+ static section(title) {
82
+ console.log(`\n${chalk.bold.underline(title)}`);
83
+ }
84
+ static list(items, title) {
85
+ if (title) {
86
+ console.log(chalk.bold(title));
87
+ }
88
+ items.forEach((item, index) => {
89
+ console.log(`${chalk.gray(` ${index + 1}.`)} ${item}`);
90
+ });
91
+ }
92
+ static table(data, headers) {
93
+ if (data.length === 0)
94
+ return;
95
+ const keys = headers || Object.keys(data[0]);
96
+ const maxWidths = keys.map(key => Math.max(key.length, ...data.map(row => String(row[key]).length)));
97
+ // Header
98
+ const headerRow = keys.map((key, i) => chalk.bold(key.padEnd(maxWidths[i]))).join(" │ ");
99
+ console.log(`┌─${keys.map((_, i) => "─".repeat(maxWidths[i])).join("─┼─")}─┐`);
100
+ console.log(`│ ${headerRow} │`);
101
+ console.log(`├─${keys.map((_, i) => "─".repeat(maxWidths[i])).join("─┼─")}─┤`);
102
+ // Rows
103
+ data.forEach(row => {
104
+ const dataRow = keys.map((key, i) => String(row[key]).padEnd(maxWidths[i])).join(" │ ");
105
+ console.log(`│ ${dataRow} │`);
106
+ });
107
+ console.log(`└─${keys.map((_, i) => "─".repeat(maxWidths[i])).join("─┴─")}─┘`);
108
+ }
109
+ static operationSummary(title, stats, duration) {
110
+ this.section(`${title} Summary`);
111
+ Object.entries(stats).forEach(([key, value]) => {
112
+ const formattedKey = key.replace(/([A-Z])/g, ' $1').replace(/^./, str => str.toUpperCase());
113
+ console.log(`${chalk.gray("●")} ${formattedKey}: ${chalk.cyan(String(value))}`);
114
+ });
115
+ if (duration) {
116
+ console.log(`${chalk.gray("●")} Duration: ${chalk.cyan(this.formatDuration(duration))}`);
117
+ }
118
+ console.log();
119
+ }
120
+ static formatBytes(bytes) {
121
+ const units = ['B', 'KB', 'MB', 'GB', 'TB'];
122
+ let size = bytes;
123
+ let unitIndex = 0;
124
+ while (size >= 1024 && unitIndex < units.length - 1) {
125
+ size /= 1024;
126
+ unitIndex++;
127
+ }
128
+ return `${size.toFixed(1)} ${units[unitIndex]}`;
129
+ }
130
+ static formatDuration(ms) {
131
+ const seconds = Math.floor(ms / 1000);
132
+ const minutes = Math.floor(seconds / 60);
133
+ const hours = Math.floor(minutes / 60);
134
+ if (hours > 0) {
135
+ return `${hours}h ${minutes % 60}m ${seconds % 60}s`;
136
+ }
137
+ else if (minutes > 0) {
138
+ return `${minutes}m ${seconds % 60}s`;
139
+ }
140
+ else {
141
+ return `${seconds}s`;
142
+ }
143
+ }
144
+ static formatNumber(num) {
145
+ return num.toLocaleString();
146
+ }
147
+ }
148
+ export const Messages = {
149
+ CONFIG_NOT_FOUND: "Appwrite configuration not found. Run 'appwrite-migrate setup' first.",
150
+ CONFIG_LOADED: (type, path) => `Loaded ${type} configuration from ${path}`,
151
+ DATABASE_CONNECTION_FAILED: "Failed to connect to Appwrite. Check your endpoint and API key.",
152
+ OPERATION_CANCELLED: "Operation cancelled by user.",
153
+ OPERATION_COMPLETED: (operation) => `${operation} completed successfully`,
154
+ BACKUP_STARTED: (database) => `Starting backup for database: ${database}`,
155
+ BACKUP_COMPLETED: (database, size) => `Backup completed for ${database} (${MessageFormatter.formatBytes(size)})`,
156
+ IMPORT_STARTED: (collections) => `Starting import process for ${collections} collection(s)`,
157
+ IMPORT_COMPLETED: (documents) => `Import completed. Processed ${MessageFormatter.formatNumber(documents)} documents`,
158
+ FUNCTION_DEPLOYED: (name) => `Function '${name}' deployed successfully`,
159
+ FUNCTION_DEPLOYMENT_FAILED: (name, error) => `Function '${name}' deployment failed: ${error}`,
160
+ TRANSFER_STARTED: (source, target) => `Starting transfer from ${source} to ${target}`,
161
+ TRANSFER_COMPLETED: (items) => `Transfer completed. Moved ${MessageFormatter.formatNumber(items)} items`,
162
+ };