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,346 +1,449 @@
1
- import {
2
- Databases,
3
- Query,
4
- type Models,
5
- } from "node-appwrite";
6
- import type { DatabaseAdapter } from "../adapters/DatabaseAdapter.js";
7
- import { tryAwaitWithRetry } from "../utils/helperFunctions.js";
8
- import { MessageFormatter } from "../shared/messageFormatter.js";
9
- import { ProgressManager } from "../shared/progressManager.js";
10
- import { isRetryableError, isCriticalError } from "../shared/errorUtils.js";
11
- import { delay } from "../utils/helperFunctions.js";
12
- import { chunk } from "es-toolkit";
13
- import pLimit from "p-limit";
14
- import { fetchAllCollections } from "./methods.js";
15
-
16
- /**
17
- * Optimized streaming deletion of all documents from a collection
18
- * Uses memory-efficient pagination instead of loading all documents into memory
19
- */
20
- async function wipeDocumentsFromCollection(
21
- database: Databases,
22
- databaseId: string,
23
- collectionId: string
24
- ) {
25
- try {
26
- // Use streaming deletion pattern - fetch and delete in batches without accumulating
27
- const FETCH_BATCH_SIZE = 1000; // How many to fetch per query
28
- const DELETE_BATCH_SIZE = 200; // How many to delete concurrently
29
- const MAX_CONCURRENT_DELETIONS = 10; // Concurrent deletion operations
30
-
31
- let totalDeleted = 0;
32
- let cursor: string | undefined;
33
- let hasMoreDocuments = true;
34
-
35
- MessageFormatter.info("Starting optimized document deletion...", { prefix: "Wipe" });
36
-
37
- // Create progress tracker (we'll update the total as we discover more documents)
38
- const progress = ProgressManager.create(
39
- `delete-${collectionId}`,
40
- 1, // Start with 1, will update as we go
41
- { title: "Deleting documents" }
42
- );
43
-
44
- while (hasMoreDocuments) {
45
- // Fetch next batch of documents
46
- const queries = [Query.limit(FETCH_BATCH_SIZE)];
47
- if (cursor) {
48
- queries.push(Query.cursorAfter(cursor));
49
- }
50
-
51
- const response = await database.listDocuments(databaseId, collectionId, queries);
52
- const documents = response.documents;
53
-
54
- if (documents.length === 0) {
55
- hasMoreDocuments = false;
56
- break;
57
- }
58
-
59
- // Update progress total as we discover more documents
60
- if (documents.length === FETCH_BATCH_SIZE) {
61
- // There might be more documents, update progress total
62
- progress.setTotal(totalDeleted + documents.length + 1000); // Estimate more
63
- }
64
-
65
- MessageFormatter.progress(
66
- `Processing batch: ${documents.length} documents (${totalDeleted + documents.length} total so far)`,
67
- { prefix: "Wipe" }
68
- );
69
-
70
- // Delete this batch using optimized concurrent deletion
71
- const documentBatches = chunk(documents, DELETE_BATCH_SIZE);
72
- const limit = pLimit(MAX_CONCURRENT_DELETIONS);
73
-
74
- const deletePromises = documentBatches.map((batch) =>
75
- limit(async () => {
76
- const batchDeletePromises = batch.map(async (doc) => {
77
- try {
78
- await tryAwaitWithRetry(async () =>
79
- database.deleteDocument(databaseId, collectionId, doc.$id)
80
- );
81
- totalDeleted++;
82
- progress.update(totalDeleted);
83
- } catch (error: any) {
84
- const errorMessage = error.message || String(error);
85
-
86
- // Enhanced error handling for document deletion
87
- if (errorMessage.includes("Document with the requested ID could not be found")) {
88
- // Document already deleted, skip silently
89
- totalDeleted++;
90
- progress.update(totalDeleted);
91
- } else if (isCriticalError(errorMessage)) {
92
- // Critical error, log and rethrow to stop operation
93
- MessageFormatter.error(
94
- `Critical error deleting document ${doc.$id}: ${errorMessage}`,
95
- error,
96
- { prefix: "Wipe" }
97
- );
98
- throw error;
99
- } else if (isRetryableError(errorMessage)) {
100
- // Retryable error, will be handled by tryAwaitWithRetry
101
- MessageFormatter.progress(
102
- `Retryable error for document ${doc.$id}, will retry`,
103
- { prefix: "Wipe" }
104
- );
105
- totalDeleted++;
106
- progress.update(totalDeleted);
107
- } else {
108
- // Other non-critical errors, log but continue
109
- MessageFormatter.error(
110
- `Failed to delete document ${doc.$id}: ${errorMessage}`,
111
- error,
112
- { prefix: "Wipe" }
113
- );
114
- totalDeleted++;
115
- progress.update(totalDeleted);
116
- }
117
- }
118
- });
119
-
120
- await Promise.all(batchDeletePromises);
121
- })
122
- );
123
-
124
- await Promise.all(deletePromises);
125
-
126
- // Set up cursor for next iteration
127
- if (documents.length < FETCH_BATCH_SIZE) {
128
- hasMoreDocuments = false;
129
- } else {
130
- cursor = documents[documents.length - 1].$id;
131
- }
132
-
133
- // Small delay between fetch cycles to be respectful to the API
134
- await delay(10);
135
- }
136
-
137
- // Update final progress total
138
- progress.setTotal(totalDeleted);
139
- progress.stop();
140
-
141
- if (totalDeleted === 0) {
142
- MessageFormatter.info("No documents found to delete", { prefix: "Wipe" });
143
- } else {
144
- MessageFormatter.success(
145
- `Successfully deleted ${totalDeleted} documents from collection ${collectionId}`,
146
- { prefix: "Wipe" }
147
- );
148
- }
149
-
150
- } catch (error) {
151
- MessageFormatter.error(
152
- `Error wiping documents from collection ${collectionId}`,
153
- error instanceof Error ? error : new Error(String(error)),
154
- { prefix: "Wipe" }
155
- );
156
- throw error;
157
- }
158
- }
159
-
160
- export const wipeDatabase = async (
161
- database: Databases,
162
- databaseId: string
163
- ): Promise<{ collectionId: string; collectionName: string }[]> => {
164
- MessageFormatter.info(`Wiping database: ${databaseId}`, { prefix: "Wipe" });
165
- const existingCollections = await fetchAllCollections(databaseId, database);
166
- let collectionsDeleted: { collectionId: string; collectionName: string }[] =
167
- [];
168
-
169
- if (existingCollections.length === 0) {
170
- MessageFormatter.info("No collections to delete", { prefix: "Wipe" });
171
- return collectionsDeleted;
172
- }
173
-
174
- const progress = ProgressManager.create(
175
- `wipe-db-${databaseId}`,
176
- existingCollections.length,
177
- { title: "Deleting collections" }
178
- );
179
-
180
- let processed = 0;
181
- for (const { $id: collectionId, name: name } of existingCollections) {
182
- MessageFormatter.progress(`Deleting collection: ${collectionId}`, { prefix: "Wipe" });
183
- collectionsDeleted.push({
184
- collectionId: collectionId,
185
- collectionName: name,
186
- });
187
- tryAwaitWithRetry(
188
- async () => await database.deleteCollection(databaseId, collectionId)
189
- ); // Try to delete the collection and ignore errors if it doesn't exist or if it's already being deleted
190
- processed++;
191
- progress.update(processed);
192
- await delay(100);
193
- }
194
-
195
- progress.stop();
196
- MessageFormatter.success(`Deleted ${collectionsDeleted.length} collections from database`, { prefix: "Wipe" });
197
- return collectionsDeleted;
198
- };
199
-
200
- export const wipeCollection = async (
201
- database: Databases,
202
- databaseId: string,
203
- collectionId: string
204
- ): Promise<void> => {
205
- const collections = await database.listCollections(databaseId, [
206
- Query.equal("$id", collectionId),
207
- ]);
208
- if (collections.total === 0) {
209
- MessageFormatter.warning(`Collection ${collectionId} not found`, { prefix: "Wipe" });
210
- return;
211
- }
212
- const collection = collections.collections[0];
213
- await wipeDocumentsFromCollection(database, databaseId, collection.$id);
214
- };
215
-
216
- // TablesDB helpers for wiping
217
- export const wipeAllTables = async (
218
- adapter: DatabaseAdapter,
219
- databaseId: string
220
- ): Promise<{ tableId: string; tableName: string }[]> => {
221
- MessageFormatter.info(`Wiping tables in database: ${databaseId}`, { prefix: 'Wipe' });
222
- const res = await adapter.listTables({ databaseId, queries: [Query.limit(500)] });
223
- const tables: any[] = (res as any).tables || [];
224
- const deleted: { tableId: string; tableName: string }[] = [];
225
- const progress = ProgressManager.create(`wipe-db-${databaseId}`, tables.length, { title: 'Deleting tables' });
226
- let processed = 0;
227
- for (const t of tables) {
228
- try {
229
- await adapter.deleteTable({ databaseId, tableId: t.$id });
230
- deleted.push({ tableId: t.$id, tableName: t.name });
231
- } catch (e) {
232
- MessageFormatter.error(`Failed deleting table ${t.$id}`, e instanceof Error ? e : new Error(String(e)), { prefix: 'Wipe' });
233
- }
234
- processed++; progress.update(processed);
235
- await delay(100);
236
- }
237
- progress.stop();
238
- return deleted;
239
- };
240
-
241
- /**
242
- * Optimized deletion of all rows from a table using direct bulk deletion
243
- * Uses Query.limit() to delete rows without fetching IDs first
244
- */
245
- export const wipeTableRows = async (
246
- adapter: DatabaseAdapter,
247
- databaseId: string,
248
- tableId: string
249
- ): Promise<void> => {
250
- try {
251
- // Check if bulk deletion is available
252
- if (!adapter.bulkDeleteRows) {
253
- MessageFormatter.error(
254
- "Bulk deletion not available for this adapter - wipe operation not supported",
255
- new Error("bulkDeleteRows not available"),
256
- { prefix: "Wipe" }
257
- );
258
- throw new Error("Bulk deletion required for wipe operations");
259
- }
260
-
261
- const DELETE_BATCH_SIZE = 250; // How many rows to delete per batch
262
- let totalDeleted = 0;
263
- let hasMoreRows = true;
264
-
265
- MessageFormatter.info("Starting optimized table row deletion...", { prefix: "Wipe" });
266
-
267
- const progress = ProgressManager.create(
268
- `delete-${tableId}`,
269
- 1, // Start with 1, will update as we discover more
270
- { title: "Deleting table rows" }
271
- );
272
-
273
- while (hasMoreRows) {
274
- try {
275
- // Delete next batch using Query.limit() - no fetching needed!
276
- const result = await tryAwaitWithRetry(async () =>
277
- adapter.bulkDeleteRows!({
278
- databaseId,
279
- tableId,
280
- rowIds: [], // Empty array signals we want to use Query.limit instead
281
- batchSize: DELETE_BATCH_SIZE
282
- })
283
- );
284
-
285
- const deletedCount = (result as any).total || 0;
286
-
287
- if (deletedCount === 0) {
288
- hasMoreRows = false;
289
- break;
290
- }
291
-
292
- totalDeleted += deletedCount;
293
- progress.setTotal(totalDeleted + 100); // Estimate more rows exist
294
- progress.update(totalDeleted);
295
-
296
- MessageFormatter.progress(
297
- `Deleted ${deletedCount} rows (${totalDeleted} total so far)`,
298
- { prefix: "Wipe" }
299
- );
300
-
301
- // Small delay between batches to be respectful to the API
302
- await delay(10);
303
-
304
- } catch (error: any) {
305
- const errorMessage = error.message || String(error);
306
-
307
- if (isCriticalError(errorMessage)) {
308
- MessageFormatter.error(
309
- `Critical error during bulk deletion: ${errorMessage}`,
310
- error,
311
- { prefix: "Wipe" }
312
- );
313
- throw error;
314
- } else {
315
- MessageFormatter.error(
316
- `Error during deletion batch: ${errorMessage}`,
317
- error,
318
- { prefix: "Wipe" }
319
- );
320
- // Continue trying with next batch
321
- }
322
- }
323
- }
324
-
325
- // Update final progress total
326
- progress.setTotal(totalDeleted);
327
- progress.stop();
328
-
329
- if (totalDeleted === 0) {
330
- MessageFormatter.info("No rows found to delete", { prefix: "Wipe" });
331
- } else {
332
- MessageFormatter.success(
333
- `Successfully deleted ${totalDeleted} rows from table ${tableId}`,
334
- { prefix: "Wipe" }
335
- );
336
- }
337
-
338
- } catch (error) {
339
- MessageFormatter.error(
340
- `Error wiping rows from table ${tableId}`,
341
- error instanceof Error ? error : new Error(String(error)),
342
- { prefix: "Wipe" }
343
- );
344
- throw error;
345
- }
346
- };
1
+ import {
2
+ Databases,
3
+ Query,
4
+ type Models,
5
+ } from "node-appwrite";
6
+ import type { DatabaseAdapter } from "appwrite-utils-helpers";
7
+ import { tryAwaitWithRetry } from "appwrite-utils-helpers";
8
+ import { MessageFormatter, isRetryableError, isCriticalError } from "appwrite-utils-helpers";
9
+ import { ProgressManager } from "../shared/progressManager.js";
10
+ import { delay } from "appwrite-utils-helpers";
11
+ import { chunk } from "es-toolkit";
12
+ import pLimit from "p-limit";
13
+ import { fetchAllCollections } from "./methods.js";
14
+
15
+ /**
16
+ * Optimized streaming deletion of all documents from a collection
17
+ * Uses memory-efficient pagination instead of loading all documents into memory
18
+ */
19
+ async function wipeDocumentsFromCollection(
20
+ database: Databases,
21
+ databaseId: string,
22
+ collectionId: string
23
+ ) {
24
+ try {
25
+ // Use streaming deletion pattern - fetch and delete in batches without accumulating
26
+ const FETCH_BATCH_SIZE = 1000; // How many to fetch per query
27
+ const DELETE_BATCH_SIZE = 200; // How many to delete concurrently
28
+ const MAX_CONCURRENT_DELETIONS = 10; // Concurrent deletion operations
29
+
30
+ let totalDeleted = 0;
31
+ let cursor: string | undefined;
32
+ let hasMoreDocuments = true;
33
+
34
+ MessageFormatter.info("Starting optimized document deletion...", { prefix: "Wipe" });
35
+
36
+ // Create progress tracker (we'll update the total as we discover more documents)
37
+ const progress = ProgressManager.create(
38
+ `delete-${collectionId}`,
39
+ 1, // Start with 1, will update as we go
40
+ { title: "Deleting documents" }
41
+ );
42
+
43
+ while (hasMoreDocuments) {
44
+ // Fetch next batch of documents
45
+ const queries = [Query.limit(FETCH_BATCH_SIZE)];
46
+ if (cursor) {
47
+ queries.push(Query.cursorAfter(cursor));
48
+ }
49
+
50
+ const response = await database.listDocuments(databaseId, collectionId, queries);
51
+ const documents = response.documents;
52
+
53
+ if (documents.length === 0) {
54
+ hasMoreDocuments = false;
55
+ break;
56
+ }
57
+
58
+ // Update progress total as we discover more documents
59
+ if (documents.length === FETCH_BATCH_SIZE) {
60
+ // There might be more documents, update progress total
61
+ progress.setTotal(totalDeleted + documents.length + 1000); // Estimate more
62
+ }
63
+
64
+ MessageFormatter.progress(
65
+ `Processing batch: ${documents.length} documents (${totalDeleted + documents.length} total so far)`,
66
+ { prefix: "Wipe" }
67
+ );
68
+
69
+ // Delete this batch using optimized concurrent deletion
70
+ const documentBatches = chunk(documents, DELETE_BATCH_SIZE);
71
+ const limit = pLimit(MAX_CONCURRENT_DELETIONS);
72
+
73
+ const deletePromises = documentBatches.map((batch) =>
74
+ limit(async () => {
75
+ const batchDeletePromises = batch.map(async (doc) => {
76
+ try {
77
+ await tryAwaitWithRetry(async () =>
78
+ database.deleteDocument(databaseId, collectionId, doc.$id)
79
+ );
80
+ totalDeleted++;
81
+ progress.update(totalDeleted);
82
+ } catch (error: any) {
83
+ const errorMessage = error.message || String(error);
84
+
85
+ // Enhanced error handling for document deletion
86
+ if (errorMessage.includes("Document with the requested ID could not be found")) {
87
+ // Document already deleted, skip silently
88
+ totalDeleted++;
89
+ progress.update(totalDeleted);
90
+ } else if (isCriticalError(errorMessage)) {
91
+ // Critical error, log and rethrow to stop operation
92
+ MessageFormatter.error(
93
+ `Critical error deleting document ${doc.$id}: ${errorMessage}`,
94
+ error,
95
+ { prefix: "Wipe" }
96
+ );
97
+ throw error;
98
+ } else if (isRetryableError(errorMessage)) {
99
+ // Retryable error, will be handled by tryAwaitWithRetry
100
+ MessageFormatter.progress(
101
+ `Retryable error for document ${doc.$id}, will retry`,
102
+ { prefix: "Wipe" }
103
+ );
104
+ totalDeleted++;
105
+ progress.update(totalDeleted);
106
+ } else {
107
+ // Other non-critical errors, log but continue
108
+ MessageFormatter.error(
109
+ `Failed to delete document ${doc.$id}: ${errorMessage}`,
110
+ error,
111
+ { prefix: "Wipe" }
112
+ );
113
+ totalDeleted++;
114
+ progress.update(totalDeleted);
115
+ }
116
+ }
117
+ });
118
+
119
+ await Promise.all(batchDeletePromises);
120
+ })
121
+ );
122
+
123
+ await Promise.all(deletePromises);
124
+
125
+ // Set up cursor for next iteration
126
+ if (documents.length < FETCH_BATCH_SIZE) {
127
+ hasMoreDocuments = false;
128
+ } else {
129
+ cursor = documents[documents.length - 1].$id;
130
+ }
131
+
132
+ // Small delay between fetch cycles to be respectful to the API
133
+ await delay(10);
134
+ }
135
+
136
+ // Update final progress total
137
+ progress.setTotal(totalDeleted);
138
+ progress.stop();
139
+
140
+ if (totalDeleted === 0) {
141
+ MessageFormatter.info("No documents found to delete", { prefix: "Wipe" });
142
+ } else {
143
+ MessageFormatter.success(
144
+ `Successfully deleted ${totalDeleted} documents from collection ${collectionId}`,
145
+ { prefix: "Wipe" }
146
+ );
147
+ }
148
+
149
+ } catch (error) {
150
+ MessageFormatter.error(
151
+ `Error wiping documents from collection ${collectionId}`,
152
+ error instanceof Error ? error : new Error(String(error)),
153
+ { prefix: "Wipe" }
154
+ );
155
+ throw error;
156
+ }
157
+ }
158
+
159
+ export const wipeDatabase = async (
160
+ database: Databases,
161
+ databaseId: string
162
+ ): Promise<{ collectionId: string; collectionName: string }[]> => {
163
+ MessageFormatter.info(`Wiping database: ${databaseId}`, { prefix: "Wipe" });
164
+ const existingCollections = await fetchAllCollections(databaseId, database);
165
+ let collectionsDeleted: { collectionId: string; collectionName: string }[] =
166
+ [];
167
+
168
+ if (existingCollections.length === 0) {
169
+ MessageFormatter.info("No collections to delete", { prefix: "Wipe" });
170
+ return collectionsDeleted;
171
+ }
172
+
173
+ const progress = ProgressManager.create(
174
+ `wipe-db-${databaseId}`,
175
+ existingCollections.length,
176
+ { title: "Deleting collections" }
177
+ );
178
+
179
+ let processed = 0;
180
+ for (const { $id: collectionId, name: name } of existingCollections) {
181
+ MessageFormatter.progress(`Deleting collection: ${collectionId}`, { prefix: "Wipe" });
182
+ collectionsDeleted.push({
183
+ collectionId: collectionId,
184
+ collectionName: name,
185
+ });
186
+ tryAwaitWithRetry(
187
+ async () => await database.deleteCollection(databaseId, collectionId)
188
+ ); // Try to delete the collection and ignore errors if it doesn't exist or if it's already being deleted
189
+ processed++;
190
+ progress.update(processed);
191
+ await delay(100);
192
+ }
193
+
194
+ progress.stop();
195
+ MessageFormatter.success(`Deleted ${collectionsDeleted.length} collections from database`, { prefix: "Wipe" });
196
+ return collectionsDeleted;
197
+ };
198
+
199
+ export const wipeCollection = async (
200
+ database: Databases,
201
+ databaseId: string,
202
+ collectionId: string
203
+ ): Promise<void> => {
204
+ const collections = await database.listCollections(databaseId, [
205
+ Query.equal("$id", collectionId),
206
+ ]);
207
+ if (collections.total === 0) {
208
+ MessageFormatter.warning(`Collection ${collectionId} not found`, { prefix: "Wipe" });
209
+ return;
210
+ }
211
+ const collection = collections.collections[0];
212
+ await wipeDocumentsFromCollection(database, databaseId, collection.$id);
213
+ };
214
+
215
+ // TablesDB helpers for wiping
216
+ export const wipeAllTables = async (
217
+ adapter: DatabaseAdapter,
218
+ databaseId: string
219
+ ): Promise<{ tableId: string; tableName: string }[]> => {
220
+ MessageFormatter.info(`Wiping tables in database: ${databaseId}`, { prefix: 'Wipe' });
221
+ const res = await adapter.listTables({ databaseId, queries: [Query.limit(500)] });
222
+ const tables: any[] = (res as any).tables || [];
223
+ const deleted: { tableId: string; tableName: string }[] = [];
224
+ const progress = ProgressManager.create(`wipe-db-${databaseId}`, tables.length, { title: 'Deleting tables' });
225
+ let processed = 0;
226
+ for (const t of tables) {
227
+ try {
228
+ await adapter.deleteTable({ databaseId, tableId: t.$id });
229
+ deleted.push({ tableId: t.$id, tableName: t.name });
230
+ } catch (e) {
231
+ MessageFormatter.error(`Failed deleting table ${t.$id}`, e instanceof Error ? e : new Error(String(e)), { prefix: 'Wipe' });
232
+ }
233
+ processed++; progress.update(processed);
234
+ await delay(100);
235
+ }
236
+ progress.stop();
237
+ return deleted;
238
+ };
239
+
240
+ /**
241
+ * Optimized deletion of all rows from a table.
242
+ * Uses bulk deletion when possible, but falls back to individual row deletion
243
+ * for tables with relationship columns (bulk delete not supported for those).
244
+ */
245
+ export const wipeTableRows = async (
246
+ adapter: DatabaseAdapter,
247
+ databaseId: string,
248
+ tableId: string
249
+ ): Promise<void> => {
250
+ try {
251
+ // Check if the table has relationship columns — bulk delete is not supported for those
252
+ const tableInfo = await adapter.getTable({ databaseId, tableId });
253
+ const columns: any[] = (tableInfo.data as any)?.columns || [];
254
+ const hasRelationships = columns.some((col: any) => col.type === "relationship");
255
+
256
+ const DELETE_BATCH_SIZE = 250;
257
+ let totalDeleted = 0;
258
+ let hasMoreRows = true;
259
+
260
+ const progress = ProgressManager.create(
261
+ `delete-${tableId}`,
262
+ 1,
263
+ { title: "Deleting table rows" }
264
+ );
265
+
266
+ if (hasRelationships) {
267
+ // ── Relationship table: fetch rows then delete individually ──
268
+ MessageFormatter.info(
269
+ "Table has relationship columns using individual row deletion (bulk delete not supported)",
270
+ { prefix: "Wipe" }
271
+ );
272
+
273
+ const FETCH_BATCH_SIZE = 1000;
274
+ const MAX_CONCURRENT_DELETES = 25;
275
+ const limit = pLimit(MAX_CONCURRENT_DELETES);
276
+
277
+ // Pipeline: prefetch the first batch, then overlap fetch+delete
278
+ let pendingRows: any[] = [];
279
+ let totalDiscovered = 0;
280
+
281
+ // Fetch helper — always fetches from the top since we're deleting everything
282
+ const fetchBatch = async (): Promise<any[]> => {
283
+ const queries: any[] = [Query.limit(FETCH_BATCH_SIZE)];
284
+ const response = await tryAwaitWithRetry(async () =>
285
+ adapter.listRows({ databaseId, tableId, queries })
286
+ );
287
+ return (response as any).rows || (response as any).data || [];
288
+ };
289
+
290
+ // Kick off the first fetch
291
+ let nextFetchPromise: Promise<any[]> | null = fetchBatch();
292
+
293
+ while (hasMoreRows) {
294
+ // Await the prefetched batch
295
+ const rows = nextFetchPromise ? await nextFetchPromise : [];
296
+ nextFetchPromise = null;
297
+
298
+ if (rows.length === 0) {
299
+ hasMoreRows = false;
300
+ break;
301
+ }
302
+
303
+ totalDiscovered += rows.length;
304
+ const isLastBatch = rows.length < FETCH_BATCH_SIZE;
305
+
306
+ if (!isLastBatch) {
307
+ progress.setTotal(totalDiscovered + 1000);
308
+ } else {
309
+ progress.setTotal(totalDiscovered);
310
+ }
311
+
312
+ MessageFormatter.progress(
313
+ `Fetched ${rows.length} rows (${totalDiscovered} discovered, ${totalDeleted} deleted so far)`,
314
+ { prefix: "Wipe" }
315
+ );
316
+
317
+ // Start deleting this batch — and prefetch the next one concurrently
318
+ // (only prefetch if we expect more rows)
319
+ if (!isLastBatch) {
320
+ // Wait a moment before prefetching so the first few deletes free up API capacity
321
+ nextFetchPromise = delay(200).then(() => fetchBatch());
322
+ }
323
+
324
+ // Delete each row with concurrency limit
325
+ const deletePromises = rows.map((row: any) =>
326
+ limit(async () => {
327
+ try {
328
+ await tryAwaitWithRetry(async () =>
329
+ adapter.deleteRow({ databaseId, tableId, id: row.$id })
330
+ );
331
+ totalDeleted++;
332
+ progress.update(totalDeleted);
333
+ } catch (error: any) {
334
+ const errorMessage = error.message || String(error);
335
+ if (errorMessage.includes("could not be found")) {
336
+ totalDeleted++;
337
+ progress.update(totalDeleted);
338
+ } else if (isCriticalError(errorMessage)) {
339
+ MessageFormatter.error(
340
+ `Critical error deleting row ${row.$id}: ${errorMessage}`,
341
+ error,
342
+ { prefix: "Wipe" }
343
+ );
344
+ throw error;
345
+ } else {
346
+ MessageFormatter.error(
347
+ `Failed to delete row ${row.$id}: ${errorMessage}`,
348
+ error,
349
+ { prefix: "Wipe" }
350
+ );
351
+ totalDeleted++;
352
+ progress.update(totalDeleted);
353
+ }
354
+ }
355
+ })
356
+ );
357
+
358
+ await Promise.all(deletePromises);
359
+
360
+ if (isLastBatch) {
361
+ hasMoreRows = false;
362
+ }
363
+
364
+ await delay(10);
365
+ }
366
+ } else {
367
+ // ── No relationships: use fast bulk deletion ──
368
+ if (!adapter.bulkDeleteRows) {
369
+ MessageFormatter.error(
370
+ "Bulk deletion not available for this adapter - wipe operation not supported",
371
+ new Error("bulkDeleteRows not available"),
372
+ { prefix: "Wipe" }
373
+ );
374
+ throw new Error("Bulk deletion required for wipe operations");
375
+ }
376
+
377
+ MessageFormatter.info("Starting optimized table row deletion...", { prefix: "Wipe" });
378
+
379
+ while (hasMoreRows) {
380
+ try {
381
+ const result = await tryAwaitWithRetry(async () =>
382
+ adapter.bulkDeleteRows!({
383
+ databaseId,
384
+ tableId,
385
+ rowIds: [],
386
+ batchSize: DELETE_BATCH_SIZE
387
+ })
388
+ );
389
+
390
+ const deletedCount = (result as any).total || 0;
391
+
392
+ if (deletedCount === 0) {
393
+ hasMoreRows = false;
394
+ break;
395
+ }
396
+
397
+ totalDeleted += deletedCount;
398
+ progress.setTotal(totalDeleted + 100);
399
+ progress.update(totalDeleted);
400
+
401
+ MessageFormatter.progress(
402
+ `Deleted ${deletedCount} rows (${totalDeleted} total so far)`,
403
+ { prefix: "Wipe" }
404
+ );
405
+
406
+ await delay(10);
407
+ } catch (error: any) {
408
+ const errorMessage = error.message || String(error);
409
+
410
+ if (isCriticalError(errorMessage)) {
411
+ MessageFormatter.error(
412
+ `Critical error during bulk deletion: ${errorMessage}`,
413
+ error,
414
+ { prefix: "Wipe" }
415
+ );
416
+ throw error;
417
+ } else {
418
+ MessageFormatter.error(
419
+ `Error during deletion batch: ${errorMessage}`,
420
+ error,
421
+ { prefix: "Wipe" }
422
+ );
423
+ }
424
+ }
425
+ }
426
+ }
427
+
428
+ // Update final progress total
429
+ progress.setTotal(totalDeleted);
430
+ progress.stop();
431
+
432
+ if (totalDeleted === 0) {
433
+ MessageFormatter.info("No rows found to delete", { prefix: "Wipe" });
434
+ } else {
435
+ MessageFormatter.success(
436
+ `Successfully deleted ${totalDeleted} rows from table ${tableId}`,
437
+ { prefix: "Wipe" }
438
+ );
439
+ }
440
+
441
+ } catch (error) {
442
+ MessageFormatter.error(
443
+ `Error wiping rows from table ${tableId}`,
444
+ error instanceof Error ? error : new Error(String(error)),
445
+ { prefix: "Wipe" }
446
+ );
447
+ throw error;
448
+ }
449
+ };