appwrite-utils-cli 1.9.7 → 1.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (376) hide show
  1. package/README.md +1004 -1004
  2. package/dist/adapters/index.d.ts +7 -8
  3. package/dist/adapters/index.js +7 -9
  4. package/dist/backups/operations/bucketBackup.js +2 -2
  5. package/dist/backups/operations/collectionBackup.d.ts +1 -1
  6. package/dist/backups/operations/collectionBackup.js +3 -3
  7. package/dist/backups/operations/comprehensiveBackup.d.ts +1 -1
  8. package/dist/backups/operations/comprehensiveBackup.js +2 -2
  9. package/dist/backups/tracking/centralizedTracking.d.ts +1 -1
  10. package/dist/backups/tracking/centralizedTracking.js +2 -2
  11. package/dist/cli/commands/configCommands.js +51 -7
  12. package/dist/cli/commands/databaseCommands.js +156 -104
  13. package/dist/cli/commands/functionCommands.js +3 -3
  14. package/dist/cli/commands/importFileCommands.d.ts +7 -0
  15. package/dist/cli/commands/importFileCommands.js +674 -0
  16. package/dist/cli/commands/schemaCommands.js +3 -3
  17. package/dist/cli/commands/storageCommands.js +2 -3
  18. package/dist/cli/commands/transferCommands.js +3 -5
  19. package/dist/collections/{attributes.d.ts → columns.d.ts} +1 -1
  20. package/dist/collections/{attributes.js → columns.js} +15 -9
  21. package/dist/collections/indexes.js +1 -3
  22. package/dist/collections/methods.d.ts +1 -1
  23. package/dist/collections/methods.js +38 -20
  24. package/dist/collections/tableOperations.d.ts +1 -0
  25. package/dist/collections/tableOperations.js +30 -11
  26. package/dist/collections/transferOperations.d.ts +1 -1
  27. package/dist/collections/transferOperations.js +3 -4
  28. package/dist/collections/wipeOperations.d.ts +4 -3
  29. package/dist/collections/wipeOperations.js +112 -39
  30. package/dist/databases/methods.js +2 -2
  31. package/dist/databases/setup.js +2 -2
  32. package/dist/examples/yamlTerminologyExample.js +2 -2
  33. package/dist/functions/deployments.d.ts +1 -1
  34. package/dist/functions/deployments.js +6 -6
  35. package/dist/functions/fnConfigDiscovery.js +2 -2
  36. package/dist/functions/methods.js +2 -2
  37. package/dist/functions/templates/count-docs-in-collection/README.md +53 -53
  38. package/dist/functions/templates/count-docs-in-collection/src/main.ts +159 -159
  39. package/dist/functions/templates/count-docs-in-collection/src/request.ts +8 -8
  40. package/dist/functions/templates/hono-typescript/README.md +285 -285
  41. package/dist/functions/templates/hono-typescript/src/adapters/request.ts +73 -73
  42. package/dist/functions/templates/hono-typescript/src/adapters/response.ts +105 -105
  43. package/dist/functions/templates/hono-typescript/src/app.ts +179 -179
  44. package/dist/functions/templates/hono-typescript/src/context.ts +102 -102
  45. package/{src/functions/templates/hono-typescript/src/index.ts → dist/functions/templates/hono-typescript/src/main.ts} +53 -53
  46. package/dist/functions/templates/hono-typescript/src/middleware/appwrite.ts +118 -118
  47. package/dist/functions/templates/typescript-node/README.md +31 -31
  48. package/dist/functions/templates/typescript-node/src/context.ts +102 -102
  49. package/dist/functions/templates/typescript-node/src/{index.ts → main.ts} +29 -29
  50. package/dist/functions/templates/uv/README.md +30 -30
  51. package/dist/functions/templates/uv/pyproject.toml +29 -29
  52. package/dist/functions/templates/uv/src/context.py +124 -124
  53. package/dist/functions/templates/uv/src/{index.py → main.py} +45 -45
  54. package/dist/init.js +1 -1
  55. package/dist/interactiveCLI.d.ts +6 -1
  56. package/dist/interactiveCLI.js +79 -25
  57. package/dist/main.js +125 -180
  58. package/dist/migrations/afterImportActions.js +2 -3
  59. package/dist/migrations/appwriteToX.d.ts +1 -1
  60. package/dist/migrations/appwriteToX.js +10 -8
  61. package/dist/migrations/comprehensiveTransfer.js +3 -5
  62. package/dist/migrations/dataLoader.d.ts +4 -2
  63. package/dist/migrations/dataLoader.js +42 -20
  64. package/dist/migrations/importController.d.ts +2 -0
  65. package/dist/migrations/importController.js +39 -24
  66. package/dist/migrations/importDataActions.js +3 -3
  67. package/dist/migrations/relationships.js +1 -2
  68. package/dist/migrations/services/DataTransformationService.js +2 -2
  69. package/dist/migrations/services/FileHandlerService.js +1 -1
  70. package/dist/migrations/services/ImportOrchestrator.d.ts +2 -0
  71. package/dist/migrations/services/ImportOrchestrator.js +15 -7
  72. package/dist/migrations/services/RateLimitManager.js +1 -1
  73. package/dist/migrations/services/RelationshipResolver.js +1 -1
  74. package/dist/migrations/services/UserMappingService.js +1 -1
  75. package/dist/migrations/services/ValidationService.js +1 -1
  76. package/dist/migrations/transfer.d.ts +8 -4
  77. package/dist/migrations/transfer.js +108 -55
  78. package/dist/migrations/yaml/YamlImportConfigLoader.js +52 -52
  79. package/dist/migrations/yaml/YamlImportIntegration.js +2 -2
  80. package/dist/migrations/yaml/generateImportSchemas.js +174 -174
  81. package/dist/setupCommands.d.ts +1 -1
  82. package/dist/setupCommands.js +5 -6
  83. package/dist/setupController.js +1 -1
  84. package/dist/shared/backupTracking.d.ts +1 -1
  85. package/dist/shared/backupTracking.js +2 -2
  86. package/dist/shared/confirmationDialogs.js +1 -1
  87. package/dist/shared/migrationHelpers.d.ts +1 -1
  88. package/dist/shared/migrationHelpers.js +4 -4
  89. package/dist/shared/operationQueue.d.ts +1 -1
  90. package/dist/shared/operationQueue.js +3 -4
  91. package/dist/shared/operationsTable.d.ts +1 -1
  92. package/dist/shared/operationsTable.js +35 -34
  93. package/dist/shared/operationsTableSchema.d.ts +3 -3
  94. package/dist/shared/operationsTableSchema.js +2 -2
  95. package/dist/shared/progressManager.js +1 -1
  96. package/dist/shared/selectionDialogs.d.ts +6 -0
  97. package/dist/shared/selectionDialogs.js +56 -12
  98. package/dist/storage/methods.d.ts +12 -0
  99. package/dist/storage/methods.js +92 -89
  100. package/dist/storage/schemas.d.ts +2 -2
  101. package/dist/tables/indexManager.d.ts +1 -1
  102. package/dist/tables/indexManager.js +2 -2
  103. package/dist/types.d.ts +2 -2
  104. package/dist/types.js +1 -1
  105. package/dist/users/methods.js +2 -3
  106. package/dist/utils/configMigration.js +1 -1
  107. package/dist/utils/index.d.ts +1 -1
  108. package/dist/utils/index.js +1 -1
  109. package/dist/utils/loadConfigs.d.ts +2 -2
  110. package/dist/utils/loadConfigs.js +6 -7
  111. package/dist/utils/setupFiles.js +139 -141
  112. package/dist/utilsController.d.ts +16 -9
  113. package/dist/utilsController.js +93 -68
  114. package/package.json +9 -3
  115. package/.appwrite/.yaml_schemas/appwrite-config.schema.json +0 -380
  116. package/.appwrite/.yaml_schemas/collection.schema.json +0 -255
  117. package/.appwrite/collections/Categories.yaml +0 -182
  118. package/.appwrite/collections/ExampleCollection.yaml +0 -36
  119. package/.appwrite/collections/Posts.yaml +0 -227
  120. package/.appwrite/collections/Users.yaml +0 -149
  121. package/.appwrite/config.yaml +0 -109
  122. package/.appwrite/import/README.md +0 -148
  123. package/.appwrite/import/categories-import.yaml +0 -129
  124. package/.appwrite/import/posts-import.yaml +0 -208
  125. package/.appwrite/import/users-import.yaml +0 -130
  126. package/.appwrite/importData/categories.json +0 -194
  127. package/.appwrite/importData/posts.json +0 -270
  128. package/.appwrite/importData/users.json +0 -220
  129. package/.appwrite/schemas/categories.json +0 -128
  130. package/.appwrite/schemas/exampleCollection.json +0 -52
  131. package/.appwrite/schemas/posts.json +0 -173
  132. package/.appwrite/schemas/users.json +0 -125
  133. package/CHANGELOG.md +0 -35
  134. package/CONFIG_TODO.md +0 -1189
  135. package/SELECTION_DIALOGS.md +0 -146
  136. package/SERVICE_IMPLEMENTATION_REPORT.md +0 -462
  137. package/dist/adapters/AdapterFactory.d.ts +0 -94
  138. package/dist/adapters/AdapterFactory.js +0 -420
  139. package/dist/adapters/DatabaseAdapter.d.ts +0 -243
  140. package/dist/adapters/DatabaseAdapter.js +0 -50
  141. package/dist/adapters/LegacyAdapter.d.ts +0 -50
  142. package/dist/adapters/LegacyAdapter.js +0 -615
  143. package/dist/adapters/TablesDBAdapter.d.ts +0 -45
  144. package/dist/adapters/TablesDBAdapter.js +0 -611
  145. package/dist/config/ConfigManager.d.ts +0 -450
  146. package/dist/config/ConfigManager.js +0 -650
  147. package/dist/config/configMigration.d.ts +0 -87
  148. package/dist/config/configMigration.js +0 -390
  149. package/dist/config/configValidation.d.ts +0 -66
  150. package/dist/config/configValidation.js +0 -358
  151. package/dist/config/index.d.ts +0 -8
  152. package/dist/config/index.js +0 -7
  153. package/dist/config/services/ConfigDiscoveryService.d.ts +0 -122
  154. package/dist/config/services/ConfigDiscoveryService.js +0 -322
  155. package/dist/config/services/ConfigLoaderService.d.ts +0 -129
  156. package/dist/config/services/ConfigLoaderService.js +0 -535
  157. package/dist/config/services/ConfigMergeService.d.ts +0 -208
  158. package/dist/config/services/ConfigMergeService.js +0 -308
  159. package/dist/config/services/ConfigValidationService.d.ts +0 -214
  160. package/dist/config/services/ConfigValidationService.js +0 -310
  161. package/dist/config/services/SessionAuthService.d.ts +0 -225
  162. package/dist/config/services/SessionAuthService.js +0 -456
  163. package/dist/config/services/__tests__/ConfigMergeService.test.d.ts +0 -1
  164. package/dist/config/services/__tests__/ConfigMergeService.test.js +0 -271
  165. package/dist/config/services/index.d.ts +0 -13
  166. package/dist/config/services/index.js +0 -10
  167. package/dist/config/yamlConfig.d.ts +0 -722
  168. package/dist/config/yamlConfig.js +0 -702
  169. package/dist/functions/pathResolution.d.ts +0 -37
  170. package/dist/functions/pathResolution.js +0 -185
  171. package/dist/functions/templates/count-docs-in-collection/package.json +0 -25
  172. package/dist/functions/templates/count-docs-in-collection/tsconfig.json +0 -28
  173. package/dist/functions/templates/hono-typescript/package.json +0 -26
  174. package/dist/functions/templates/hono-typescript/src/index.ts +0 -54
  175. package/dist/functions/templates/hono-typescript/tsconfig.json +0 -20
  176. package/dist/functions/templates/typescript-node/package.json +0 -25
  177. package/dist/functions/templates/typescript-node/tsconfig.json +0 -28
  178. package/dist/shared/attributeMapper.d.ts +0 -20
  179. package/dist/shared/attributeMapper.js +0 -203
  180. package/dist/shared/errorUtils.d.ts +0 -54
  181. package/dist/shared/errorUtils.js +0 -95
  182. package/dist/shared/functionManager.d.ts +0 -48
  183. package/dist/shared/functionManager.js +0 -348
  184. package/dist/shared/jsonSchemaGenerator.d.ts +0 -50
  185. package/dist/shared/jsonSchemaGenerator.js +0 -290
  186. package/dist/shared/logging.d.ts +0 -61
  187. package/dist/shared/logging.js +0 -116
  188. package/dist/shared/messageFormatter.d.ts +0 -39
  189. package/dist/shared/messageFormatter.js +0 -162
  190. package/dist/shared/pydanticModelGenerator.d.ts +0 -17
  191. package/dist/shared/pydanticModelGenerator.js +0 -615
  192. package/dist/shared/schemaGenerator.d.ts +0 -40
  193. package/dist/shared/schemaGenerator.js +0 -556
  194. package/dist/utils/ClientFactory.d.ts +0 -87
  195. package/dist/utils/ClientFactory.js +0 -212
  196. package/dist/utils/configDiscovery.d.ts +0 -78
  197. package/dist/utils/configDiscovery.js +0 -472
  198. package/dist/utils/constantsGenerator.d.ts +0 -31
  199. package/dist/utils/constantsGenerator.js +0 -321
  200. package/dist/utils/dataConverters.d.ts +0 -46
  201. package/dist/utils/dataConverters.js +0 -139
  202. package/dist/utils/directoryUtils.d.ts +0 -22
  203. package/dist/utils/directoryUtils.js +0 -59
  204. package/dist/utils/getClientFromConfig.d.ts +0 -39
  205. package/dist/utils/getClientFromConfig.js +0 -199
  206. package/dist/utils/helperFunctions.d.ts +0 -63
  207. package/dist/utils/helperFunctions.js +0 -156
  208. package/dist/utils/pathResolvers.d.ts +0 -53
  209. package/dist/utils/pathResolvers.js +0 -72
  210. package/dist/utils/projectConfig.d.ts +0 -122
  211. package/dist/utils/projectConfig.js +0 -206
  212. package/dist/utils/retryFailedPromises.d.ts +0 -2
  213. package/dist/utils/retryFailedPromises.js +0 -23
  214. package/dist/utils/sessionAuth.d.ts +0 -48
  215. package/dist/utils/sessionAuth.js +0 -164
  216. package/dist/utils/typeGuards.d.ts +0 -35
  217. package/dist/utils/typeGuards.js +0 -57
  218. package/dist/utils/validationRules.d.ts +0 -43
  219. package/dist/utils/validationRules.js +0 -42
  220. package/dist/utils/versionDetection.d.ts +0 -58
  221. package/dist/utils/versionDetection.js +0 -251
  222. package/dist/utils/yamlConverter.d.ts +0 -100
  223. package/dist/utils/yamlConverter.js +0 -428
  224. package/dist/utils/yamlLoader.d.ts +0 -70
  225. package/dist/utils/yamlLoader.js +0 -267
  226. package/scripts/copy-templates.ts +0 -23
  227. package/src/adapters/AdapterFactory.ts +0 -529
  228. package/src/adapters/DatabaseAdapter.ts +0 -319
  229. package/src/adapters/LegacyAdapter.ts +0 -844
  230. package/src/adapters/TablesDBAdapter.ts +0 -823
  231. package/src/adapters/index.ts +0 -37
  232. package/src/backups/operations/bucketBackup.ts +0 -277
  233. package/src/backups/operations/collectionBackup.ts +0 -310
  234. package/src/backups/operations/comprehensiveBackup.ts +0 -342
  235. package/src/backups/schemas/bucketManifest.ts +0 -78
  236. package/src/backups/schemas/comprehensiveManifest.ts +0 -76
  237. package/src/backups/tracking/centralizedTracking.ts +0 -352
  238. package/src/cli/commands/configCommands.ts +0 -201
  239. package/src/cli/commands/databaseCommands.ts +0 -879
  240. package/src/cli/commands/functionCommands.ts +0 -418
  241. package/src/cli/commands/schemaCommands.ts +0 -200
  242. package/src/cli/commands/storageCommands.ts +0 -152
  243. package/src/cli/commands/transferCommands.ts +0 -457
  244. package/src/collections/attributes.ts +0 -2020
  245. package/src/collections/attributes.ts.backup +0 -1555
  246. package/src/collections/indexes.ts +0 -352
  247. package/src/collections/methods.ts +0 -700
  248. package/src/collections/tableOperations.ts +0 -521
  249. package/src/collections/transferOperations.ts +0 -590
  250. package/src/collections/wipeOperations.ts +0 -346
  251. package/src/config/ConfigManager.ts +0 -849
  252. package/src/config/README.md +0 -274
  253. package/src/config/configMigration.ts +0 -575
  254. package/src/config/configValidation.ts +0 -445
  255. package/src/config/index.ts +0 -10
  256. package/src/config/services/ConfigDiscoveryService.ts +0 -410
  257. package/src/config/services/ConfigLoaderService.ts +0 -732
  258. package/src/config/services/ConfigMergeService.ts +0 -388
  259. package/src/config/services/ConfigValidationService.ts +0 -394
  260. package/src/config/services/SessionAuthService.ts +0 -565
  261. package/src/config/services/__tests__/ConfigMergeService.test.ts +0 -351
  262. package/src/config/services/index.ts +0 -29
  263. package/src/config/yamlConfig.ts +0 -761
  264. package/src/databases/methods.ts +0 -49
  265. package/src/databases/setup.ts +0 -77
  266. package/src/examples/yamlTerminologyExample.ts +0 -346
  267. package/src/functions/deployments.ts +0 -220
  268. package/src/functions/fnConfigDiscovery.ts +0 -103
  269. package/src/functions/methods.ts +0 -284
  270. package/src/functions/pathResolution.ts +0 -227
  271. package/src/functions/templates/count-docs-in-collection/README.md +0 -54
  272. package/src/functions/templates/count-docs-in-collection/package.json +0 -25
  273. package/src/functions/templates/count-docs-in-collection/src/main.ts +0 -159
  274. package/src/functions/templates/count-docs-in-collection/src/request.ts +0 -9
  275. package/src/functions/templates/count-docs-in-collection/tsconfig.json +0 -28
  276. package/src/functions/templates/hono-typescript/README.md +0 -286
  277. package/src/functions/templates/hono-typescript/package.json +0 -26
  278. package/src/functions/templates/hono-typescript/src/adapters/request.ts +0 -74
  279. package/src/functions/templates/hono-typescript/src/adapters/response.ts +0 -106
  280. package/src/functions/templates/hono-typescript/src/app.ts +0 -180
  281. package/src/functions/templates/hono-typescript/src/context.ts +0 -103
  282. package/src/functions/templates/hono-typescript/src/middleware/appwrite.ts +0 -119
  283. package/src/functions/templates/hono-typescript/tsconfig.json +0 -20
  284. package/src/functions/templates/typescript-node/README.md +0 -32
  285. package/src/functions/templates/typescript-node/package.json +0 -25
  286. package/src/functions/templates/typescript-node/src/context.ts +0 -103
  287. package/src/functions/templates/typescript-node/src/index.ts +0 -29
  288. package/src/functions/templates/typescript-node/tsconfig.json +0 -28
  289. package/src/functions/templates/uv/README.md +0 -31
  290. package/src/functions/templates/uv/pyproject.toml +0 -30
  291. package/src/functions/templates/uv/src/__init__.py +0 -0
  292. package/src/functions/templates/uv/src/context.py +0 -125
  293. package/src/functions/templates/uv/src/index.py +0 -46
  294. package/src/init.ts +0 -62
  295. package/src/interactiveCLI.ts +0 -1136
  296. package/src/main.ts +0 -1670
  297. package/src/migrations/afterImportActions.ts +0 -580
  298. package/src/migrations/appwriteToX.ts +0 -664
  299. package/src/migrations/comprehensiveTransfer.ts +0 -2285
  300. package/src/migrations/dataLoader.ts +0 -1702
  301. package/src/migrations/importController.ts +0 -428
  302. package/src/migrations/importDataActions.ts +0 -315
  303. package/src/migrations/relationships.ts +0 -334
  304. package/src/migrations/services/DataTransformationService.ts +0 -196
  305. package/src/migrations/services/FileHandlerService.ts +0 -311
  306. package/src/migrations/services/ImportOrchestrator.ts +0 -666
  307. package/src/migrations/services/RateLimitManager.ts +0 -363
  308. package/src/migrations/services/RelationshipResolver.ts +0 -461
  309. package/src/migrations/services/UserMappingService.ts +0 -345
  310. package/src/migrations/services/ValidationService.ts +0 -349
  311. package/src/migrations/transfer.ts +0 -1068
  312. package/src/migrations/yaml/YamlImportConfigLoader.ts +0 -439
  313. package/src/migrations/yaml/YamlImportIntegration.ts +0 -446
  314. package/src/migrations/yaml/generateImportSchemas.ts +0 -1354
  315. package/src/schemas/authUser.ts +0 -23
  316. package/src/setup.ts +0 -8
  317. package/src/setupCommands.ts +0 -603
  318. package/src/setupController.ts +0 -43
  319. package/src/shared/attributeMapper.ts +0 -229
  320. package/src/shared/backupMetadataSchema.ts +0 -93
  321. package/src/shared/backupTracking.ts +0 -211
  322. package/src/shared/confirmationDialogs.ts +0 -327
  323. package/src/shared/errorUtils.ts +0 -110
  324. package/src/shared/functionManager.ts +0 -537
  325. package/src/shared/jsonSchemaGenerator.ts +0 -383
  326. package/src/shared/logging.ts +0 -149
  327. package/src/shared/messageFormatter.ts +0 -208
  328. package/src/shared/migrationHelpers.ts +0 -232
  329. package/src/shared/operationLogger.ts +0 -20
  330. package/src/shared/operationQueue.ts +0 -377
  331. package/src/shared/operationsTable.ts +0 -338
  332. package/src/shared/operationsTableSchema.ts +0 -60
  333. package/src/shared/progressManager.ts +0 -278
  334. package/src/shared/pydanticModelGenerator.ts +0 -618
  335. package/src/shared/relationshipExtractor.ts +0 -214
  336. package/src/shared/schemaGenerator.ts +0 -644
  337. package/src/shared/selectionDialogs.ts +0 -749
  338. package/src/storage/backupCompression.ts +0 -88
  339. package/src/storage/methods.ts +0 -698
  340. package/src/storage/schemas.ts +0 -205
  341. package/src/tables/indexManager.ts +0 -409
  342. package/src/types/node-appwrite-tablesdb.d.ts +0 -44
  343. package/src/types.ts +0 -9
  344. package/src/users/methods.ts +0 -359
  345. package/src/utils/ClientFactory.ts +0 -240
  346. package/src/utils/configDiscovery.ts +0 -557
  347. package/src/utils/configMigration.ts +0 -348
  348. package/src/utils/constantsGenerator.ts +0 -369
  349. package/src/utils/dataConverters.ts +0 -159
  350. package/src/utils/directoryUtils.ts +0 -61
  351. package/src/utils/getClientFromConfig.ts +0 -257
  352. package/src/utils/helperFunctions.ts +0 -228
  353. package/src/utils/index.ts +0 -2
  354. package/src/utils/loadConfigs.ts +0 -449
  355. package/src/utils/pathResolvers.ts +0 -81
  356. package/src/utils/projectConfig.ts +0 -340
  357. package/src/utils/retryFailedPromises.ts +0 -29
  358. package/src/utils/sessionAuth.ts +0 -230
  359. package/src/utils/setupFiles.ts +0 -1238
  360. package/src/utils/typeGuards.ts +0 -65
  361. package/src/utils/validationRules.ts +0 -88
  362. package/src/utils/versionDetection.ts +0 -292
  363. package/src/utils/yamlConverter.ts +0 -542
  364. package/src/utils/yamlLoader.ts +0 -371
  365. package/src/utilsController.ts +0 -1213
  366. package/tests/README.md +0 -497
  367. package/tests/adapters/AdapterFactory.test.ts +0 -277
  368. package/tests/integration/syncOperations.test.ts +0 -463
  369. package/tests/jest.config.js +0 -25
  370. package/tests/migration/configMigration.test.ts +0 -546
  371. package/tests/setup.ts +0 -62
  372. package/tests/testUtils.ts +0 -340
  373. package/tests/utils/loadConfigs.test.ts +0 -350
  374. package/tests/validation/configValidation.test.ts +0 -412
  375. package/tmp-sync-test/.appwrite/collections/TestCollection.yaml +0 -7
  376. package/tsconfig.json +0 -44
@@ -1,844 +0,0 @@
1
- /**
2
- * LegacyAdapter - Translation Layer for Legacy Appwrite API
3
- *
4
- * This adapter translates TablesDB-style calls (object notation) to legacy
5
- * Appwrite Databases API calls (positional parameters). It ensures all internal
6
- * code can use modern TablesDB patterns while maintaining compatibility with
7
- * older Appwrite instances.
8
- */
9
-
10
- import { Client, Databases, IndexType, Query, type Models, RelationshipType, RelationMutate } from "node-appwrite";
11
- import { chunk } from "es-toolkit";
12
- import {
13
- BaseAdapter,
14
- type CreateRowParams,
15
- type UpdateRowParams,
16
- type ListRowsParams,
17
- type DeleteRowParams,
18
- type CreateTableParams,
19
- type UpdateTableParams,
20
- type ListTablesParams,
21
- type DeleteTableParams,
22
- type GetTableParams,
23
- type BulkCreateRowsParams,
24
- type BulkUpsertRowsParams,
25
- type BulkDeleteRowsParams,
26
- type CreateIndexParams,
27
- type ListIndexesParams,
28
- type DeleteIndexParams,
29
- type CreateAttributeParams,
30
- type UpdateAttributeParams,
31
- type DeleteAttributeParams,
32
- type ApiResponse,
33
- type AdapterMetadata,
34
- AdapterError,
35
- UnsupportedOperationError
36
- } from './DatabaseAdapter.js';
37
-
38
- /**
39
- * LegacyAdapter - Translates TablesDB calls to legacy Databases API
40
- */
41
- export class LegacyAdapter extends BaseAdapter {
42
- private databases: Databases;
43
-
44
- constructor(client: Client) {
45
- super(client, 'legacy');
46
- // Assuming Databases service is available on the client
47
- this.databases = new Databases(client);
48
- }
49
-
50
- // Row (Document) Operations - Translate object notation to positional parameters
51
-
52
- async listRows(params: ListRowsParams): Promise<ApiResponse> {
53
- try {
54
- // TablesDB: listRows({ databaseId, tableId, queries })
55
- // Legacy: listDocuments(databaseId, collectionId, queries)
56
- const result = await this.databases.listDocuments(
57
- params.databaseId,
58
- params.tableId, // Maps tableId to collectionId
59
- params.queries || []
60
- );
61
-
62
- return {
63
- data: result.documents,
64
- rows: result.documents, // Alias for TablesDB compatibility
65
- documents: result.documents, // Legacy format
66
- total: result.total
67
- };
68
- } catch (error) {
69
- throw new AdapterError(
70
- `Failed to list rows (legacy): ${error instanceof Error ? error.message : 'Unknown error'}`,
71
- 'LIST_ROWS_FAILED',
72
- error instanceof Error ? error : undefined
73
- );
74
- }
75
- }
76
-
77
- async createRow(params: CreateRowParams): Promise<ApiResponse> {
78
- try {
79
- // TablesDB: createRow({ databaseId, tableId, id, data, permissions })
80
- // Legacy: createDocument(databaseId, collectionId, id, data, permissions)
81
- const result = await this.databases.createDocument(
82
- params.databaseId,
83
- params.tableId, // Maps to collectionId
84
- params.id,
85
- params.data,
86
- params.permissions || []
87
- );
88
-
89
- return {
90
- data: result,
91
- rows: [result],
92
- documents: [result] // Legacy compatibility
93
- };
94
- } catch (error) {
95
- throw new AdapterError(
96
- `Failed to create row (legacy): ${error instanceof Error ? error.message : 'Unknown error'}`,
97
- 'CREATE_ROW_FAILED',
98
- error instanceof Error ? error : undefined
99
- );
100
- }
101
- }
102
-
103
- async updateRow(params: UpdateRowParams): Promise<ApiResponse> {
104
- try {
105
- // TablesDB: updateRow({ databaseId, tableId, id, data, permissions })
106
- // Legacy: updateDocument(databaseId, collectionId, id, data, permissions)
107
- const result = await this.databases.updateDocument(
108
- params.databaseId,
109
- params.tableId,
110
- params.id,
111
- params.data,
112
- params.permissions || []
113
- );
114
-
115
- return {
116
- data: result,
117
- rows: [result],
118
- documents: [result]
119
- };
120
- } catch (error) {
121
- throw new AdapterError(
122
- `Failed to update row (legacy): ${error instanceof Error ? error.message : 'Unknown error'}`,
123
- 'UPDATE_ROW_FAILED',
124
- error instanceof Error ? error : undefined
125
- );
126
- }
127
- }
128
-
129
- async deleteRow(params: DeleteRowParams): Promise<ApiResponse> {
130
- try {
131
- // TablesDB: deleteRow({ databaseId, tableId, id })
132
- // Legacy: deleteDocument(databaseId, collectionId, id)
133
- const result = await this.databases.deleteDocument(
134
- params.databaseId,
135
- params.tableId,
136
- params.id
137
- );
138
-
139
- return { data: result };
140
- } catch (error) {
141
- throw new AdapterError(
142
- `Failed to delete row (legacy): ${error instanceof Error ? error.message : 'Unknown error'}`,
143
- 'DELETE_ROW_FAILED',
144
- error instanceof Error ? error : undefined
145
- );
146
- }
147
- }
148
-
149
- async getRow(params: { databaseId: string; tableId: string; id: string }): Promise<ApiResponse> {
150
- try {
151
- // TablesDB: getRow({ databaseId, tableId, id })
152
- // Legacy: getDocument(databaseId, collectionId, id)
153
- const result = await this.databases.getDocument(
154
- params.databaseId,
155
- params.tableId,
156
- params.id
157
- );
158
-
159
- return {
160
- data: result,
161
- rows: [result],
162
- documents: [result]
163
- };
164
- } catch (error) {
165
- throw new AdapterError(
166
- `Failed to get row (legacy): ${error instanceof Error ? error.message : 'Unknown error'}`,
167
- 'GET_ROW_FAILED',
168
- error instanceof Error ? error : undefined
169
- );
170
- }
171
- }
172
-
173
- // Table (Collection) Operations
174
-
175
- async listTables(params: ListTablesParams): Promise<ApiResponse> {
176
- try {
177
- // TablesDB: listTables({ databaseId, queries })
178
- // Legacy: listCollections(databaseId, queries)
179
- const result = await this.databases.listCollections(
180
- params.databaseId,
181
- params.queries || []
182
- );
183
-
184
- return {
185
- data: result.collections,
186
- tables: result.collections, // Alias for TablesDB compatibility
187
- collections: result.collections, // Legacy format
188
- total: result.total
189
- };
190
- } catch (error) {
191
- throw new AdapterError(
192
- `Failed to list tables (legacy): ${error instanceof Error ? error.message : 'Unknown error'}`,
193
- 'LIST_TABLES_FAILED',
194
- error instanceof Error ? error : undefined
195
- );
196
- }
197
- }
198
-
199
- async createTable(params: CreateTableParams): Promise<ApiResponse> {
200
- try {
201
- // TablesDB: createTable({ databaseId, id, name, permissions, documentSecurity, enabled })
202
- // Legacy: createCollection(databaseId, id, name, permissions, documentSecurity, enabled)
203
- const result = await this.databases.createCollection(
204
- params.databaseId,
205
- params.id,
206
- params.name,
207
- params.permissions || [],
208
- params.documentSecurity ?? false,
209
- params.enabled ?? true
210
- );
211
-
212
- return {
213
- data: result,
214
- tables: [result],
215
- collections: [result]
216
- };
217
- } catch (error) {
218
- throw new AdapterError(
219
- `Failed to create table (legacy): ${error instanceof Error ? error.message : 'Unknown error'}`,
220
- 'CREATE_TABLE_FAILED',
221
- error instanceof Error ? error : undefined
222
- );
223
- }
224
- }
225
-
226
- async updateTable(params: UpdateTableParams): Promise<ApiResponse> {
227
- try {
228
- // TablesDB: updateTable({ databaseId, id, name, permissions, documentSecurity, enabled })
229
- // Legacy: updateCollection(databaseId, id, name, permissions, documentSecurity, enabled)
230
- const result = await this.databases.updateCollection(
231
- params.databaseId,
232
- params.id,
233
- params.name,
234
- params.permissions || [],
235
- params.documentSecurity ?? false,
236
- params.enabled ?? true
237
- );
238
-
239
- return {
240
- data: result,
241
- tables: [result],
242
- collections: [result]
243
- };
244
- } catch (error) {
245
- throw new AdapterError(
246
- `Failed to update table (legacy): ${error instanceof Error ? error.message : 'Unknown error'}`,
247
- 'UPDATE_TABLE_FAILED',
248
- error instanceof Error ? error : undefined
249
- );
250
- }
251
- }
252
-
253
- async deleteTable(params: DeleteTableParams): Promise<ApiResponse> {
254
- try {
255
- // TablesDB: deleteTable({ databaseId, tableId })
256
- // Legacy: deleteCollection(databaseId, collectionId)
257
- const result = await this.databases.deleteCollection(
258
- params.databaseId,
259
- params.tableId
260
- );
261
-
262
- return { data: result };
263
- } catch (error) {
264
- throw new AdapterError(
265
- `Failed to delete table (legacy): ${error instanceof Error ? error.message : 'Unknown error'}`,
266
- 'DELETE_TABLE_FAILED',
267
- error instanceof Error ? error : undefined
268
- );
269
- }
270
- }
271
-
272
- async getTable(params: GetTableParams): Promise<ApiResponse> {
273
- try {
274
- // TablesDB: getTable({ databaseId, tableId })
275
- // Legacy: getCollection(databaseId, collectionId)
276
- const result = await this.databases.getCollection(
277
- params.databaseId,
278
- params.tableId
279
- );
280
-
281
- return {
282
- data: result,
283
- tables: [result],
284
- collections: [result]
285
- };
286
- } catch (error) {
287
- throw new AdapterError(
288
- `Failed to get table (legacy): ${error instanceof Error ? error.message : 'Unknown error'}`,
289
- 'GET_TABLE_FAILED',
290
- error instanceof Error ? error : undefined
291
- );
292
- }
293
- }
294
-
295
- // Index Operations
296
-
297
- async listIndexes(params: ListIndexesParams): Promise<ApiResponse> {
298
- try {
299
- // TablesDB: listIndexes({ databaseId, tableId, queries })
300
- // Legacy: listIndexes(databaseId, collectionId, queries)
301
- const result = await this.databases.listIndexes(
302
- params.databaseId,
303
- params.tableId,
304
- params.queries || []
305
- );
306
-
307
- return {
308
- data: result.indexes,
309
- total: result.total
310
- };
311
- } catch (error) {
312
- throw new AdapterError(
313
- `Failed to list indexes (legacy): ${error instanceof Error ? error.message : 'Unknown error'}`,
314
- 'LIST_INDEXES_FAILED',
315
- error instanceof Error ? error : undefined
316
- );
317
- }
318
- }
319
-
320
- async createIndex(params: CreateIndexParams): Promise<ApiResponse> {
321
- try {
322
- // TablesDB: createIndex({ databaseId, tableId, key, type, attributes, orders })
323
- // Legacy: createIndex(databaseId, collectionId, key, type, attributes, orders)
324
- const result = await this.databases.createIndex(
325
- params.databaseId,
326
- params.tableId,
327
- params.key,
328
- params.type as IndexType,
329
- params.attributes,
330
- params.orders || []
331
- );
332
-
333
- return { data: result };
334
- } catch (error) {
335
- throw new AdapterError(
336
- `Failed to create index (legacy): ${error instanceof Error ? error.message : 'Unknown error'}`,
337
- 'CREATE_INDEX_FAILED',
338
- error instanceof Error ? error : undefined
339
- );
340
- }
341
- }
342
-
343
- async deleteIndex(params: DeleteIndexParams): Promise<ApiResponse> {
344
- try {
345
- // TablesDB: deleteIndex({ databaseId, tableId, key })
346
- // Legacy: deleteIndex(databaseId, collectionId, key)
347
- const result = await this.databases.deleteIndex(
348
- params.databaseId,
349
- params.tableId,
350
- params.key
351
- );
352
-
353
- return { data: result };
354
- } catch (error) {
355
- throw new AdapterError(
356
- `Failed to delete index (legacy): ${error instanceof Error ? error.message : 'Unknown error'}`,
357
- 'DELETE_INDEX_FAILED',
358
- error instanceof Error ? error : undefined
359
- );
360
- }
361
- }
362
-
363
- // Attribute Operations
364
-
365
- async createAttribute(params: CreateAttributeParams): Promise<ApiResponse> {
366
- try {
367
- // Legacy attribute creation varies by type, need to map different methods
368
- let result;
369
-
370
- switch (params.type.toLowerCase()) {
371
- case 'string':
372
- result = await this.databases.createStringAttribute({
373
- databaseId: params.databaseId,
374
- collectionId: params.tableId,
375
- key: params.key,
376
- size: params.size || 255,
377
- required: params.required ?? false,
378
- xdefault: params.default,
379
- array: params.array ?? false,
380
- encrypt: params.encrypt ?? false
381
- });
382
- break;
383
-
384
- case 'integer':
385
- result = await this.databases.createIntegerAttribute({
386
- databaseId: params.databaseId,
387
- collectionId: params.tableId,
388
- key: params.key,
389
- required: params.required ?? false,
390
- min: params.min,
391
- max: params.max,
392
- xdefault: params.default,
393
- array: params.array ?? false
394
- });
395
- break;
396
-
397
- case 'float':
398
- case 'double':
399
- result = await this.databases.createFloatAttribute({
400
- databaseId: params.databaseId,
401
- collectionId: params.tableId,
402
- key: params.key,
403
- required: params.required ?? false,
404
- min: params.min,
405
- max: params.max,
406
- xdefault: params.default,
407
- array: params.array ?? false
408
- });
409
- break;
410
-
411
- case 'boolean':
412
- result = await this.databases.createBooleanAttribute({
413
- databaseId: params.databaseId,
414
- collectionId: params.tableId,
415
- key: params.key,
416
- required: params.required ?? false,
417
- xdefault: params.default,
418
- array: params.array ?? false
419
- });
420
- break;
421
-
422
- case 'datetime':
423
- result = await this.databases.createDatetimeAttribute({
424
- databaseId: params.databaseId,
425
- collectionId: params.tableId,
426
- key: params.key,
427
- required: params.required ?? false,
428
- xdefault: params.default,
429
- array: params.array ?? false
430
- });
431
- break;
432
-
433
- case 'email':
434
- result = await this.databases.createEmailAttribute({
435
- databaseId: params.databaseId,
436
- collectionId: params.tableId,
437
- key: params.key,
438
- required: params.required ?? false,
439
- xdefault: params.default,
440
- array: params.array ?? false
441
- });
442
- break;
443
-
444
- case 'enum':
445
- result = await this.databases.createEnumAttribute({
446
- databaseId: params.databaseId,
447
- collectionId: params.tableId,
448
- key: params.key,
449
- elements: params.elements || [],
450
- required: params.required ?? false,
451
- xdefault: params.default,
452
- array: params.array ?? false
453
- });
454
- break;
455
-
456
- case 'ip':
457
- result = await this.databases.createIpAttribute({
458
- databaseId: params.databaseId,
459
- collectionId: params.tableId,
460
- key: params.key,
461
- required: params.required ?? false,
462
- xdefault: params.default,
463
- array: params.array ?? false
464
- });
465
- break;
466
-
467
- case 'url':
468
- result = await this.databases.createUrlAttribute({
469
- databaseId: params.databaseId,
470
- collectionId: params.tableId,
471
- key: params.key,
472
- required: params.required ?? false,
473
- xdefault: params.default,
474
- array: params.array ?? false
475
- });
476
- break;
477
-
478
- case 'relationship':
479
- result = await this.databases.createRelationshipAttribute({
480
- databaseId: params.databaseId,
481
- collectionId: params.tableId,
482
- key: params.key,
483
- relatedCollectionId: params.relatedCollection || '',
484
- type: (params.type || 'oneToOne') as RelationshipType,
485
- twoWay: params.twoWay ?? false,
486
- onDelete: (params.onDelete || 'restrict') as RelationMutate
487
- });
488
- break;
489
-
490
- default:
491
- throw new AdapterError(
492
- `Unsupported attribute type: ${params.type}`,
493
- 'UNSUPPORTED_ATTRIBUTE_TYPE'
494
- );
495
- }
496
-
497
- return { data: result };
498
- } catch (error) {
499
- throw new AdapterError(
500
- `Failed to create attribute (legacy): ${error instanceof Error ? error.message : 'Unknown error'}`,
501
- 'CREATE_ATTRIBUTE_FAILED',
502
- error instanceof Error ? error : undefined
503
- );
504
- }
505
- }
506
-
507
- async updateAttribute(params: UpdateAttributeParams): Promise<ApiResponse> {
508
- try {
509
- // Get the current collection to determine the attribute type
510
- const collection = await this.databases.getCollection(params.databaseId, params.tableId);
511
- const existingAttr = collection.attributes.find((attr: any) => attr.key === params.key);
512
-
513
- if (!existingAttr) {
514
- throw new AdapterError(
515
- `Attribute '${params.key}' not found in collection '${params.tableId}'`,
516
- 'ATTRIBUTE_NOT_FOUND'
517
- );
518
- }
519
-
520
- let result;
521
- const attributeType = existingAttr.type.toLowerCase();
522
-
523
- // Use type-specific update methods based on attribute type with object notation
524
- switch (attributeType) {
525
- case 'string':
526
- const stringAttr = existingAttr as Models.AttributeString;
527
- result = await this.databases.updateStringAttribute({
528
- databaseId: params.databaseId,
529
- collectionId: params.tableId,
530
- key: params.key,
531
- required: params.required ?? stringAttr.required,
532
- xdefault: params.default !== undefined ? params.default : stringAttr.default,
533
- size: stringAttr.size
534
- });
535
- break;
536
-
537
- case 'integer':
538
- const integerAttr = existingAttr as Models.AttributeInteger;
539
- result = await this.databases.updateIntegerAttribute({
540
- databaseId: params.databaseId,
541
- collectionId: params.tableId,
542
- key: params.key,
543
- required: params.required ?? integerAttr.required,
544
- xdefault: params.default !== undefined ? params.default : integerAttr.default,
545
- // Only include when explicitly provided to avoid resubmitting extreme values
546
- ...(params.min !== undefined ? { min: params.min } : {}),
547
- ...(params.max !== undefined ? { max: params.max } : {}),
548
- });
549
- break;
550
-
551
- case 'float':
552
- case 'double':
553
- const floatAttr = existingAttr as Models.AttributeFloat;
554
- result = await this.databases.updateFloatAttribute({
555
- databaseId: params.databaseId,
556
- collectionId: params.tableId,
557
- key: params.key,
558
- required: params.required ?? floatAttr.required,
559
- xdefault: params.default !== undefined ? params.default : floatAttr.default,
560
- ...(params.min !== undefined ? { min: params.min } : {}),
561
- ...(params.max !== undefined ? { max: params.max } : {}),
562
- });
563
- break;
564
-
565
- case 'boolean':
566
- const booleanAttr = existingAttr as Models.AttributeBoolean;
567
- result = await this.databases.updateBooleanAttribute({
568
- databaseId: params.databaseId,
569
- collectionId: params.tableId,
570
- key: params.key,
571
- required: params.required ?? booleanAttr.required,
572
- xdefault: params.default !== undefined ? params.default : booleanAttr.default
573
- });
574
- break;
575
-
576
- case 'datetime':
577
- const datetimeAttr = existingAttr as Models.AttributeDatetime;
578
- result = await this.databases.updateDatetimeAttribute({
579
- databaseId: params.databaseId,
580
- collectionId: params.tableId,
581
- key: params.key,
582
- required: params.required ?? datetimeAttr.required,
583
- xdefault: params.default !== undefined ? params.default : datetimeAttr.default
584
- });
585
- break;
586
-
587
- case 'email':
588
- const emailAttr = existingAttr as Models.AttributeEmail;
589
- result = await this.databases.updateEmailAttribute({
590
- databaseId: params.databaseId,
591
- collectionId: params.tableId,
592
- key: params.key,
593
- required: params.required ?? emailAttr.required,
594
- xdefault: params.default !== undefined ? params.default : emailAttr.default
595
- });
596
- break;
597
-
598
- case 'enum':
599
- const enumAttr = existingAttr as Models.AttributeEnum;
600
- // Choose elements to send only when provided, otherwise preserve existing
601
- const provided = params.elements;
602
- const existing = (enumAttr as any)?.elements;
603
- const nextElements = (Array.isArray(provided) && provided.length > 0) ? provided : existing;
604
- result = await this.databases.updateEnumAttribute({
605
- databaseId: params.databaseId,
606
- collectionId: params.tableId,
607
- key: params.key,
608
- elements: nextElements,
609
- required: params.required ?? enumAttr.required,
610
- xdefault: params.default !== undefined ? params.default : enumAttr.default
611
- });
612
- break;
613
-
614
- case 'ip':
615
- const ipAttr = existingAttr as Models.AttributeIp;
616
- result = await this.databases.updateIpAttribute({
617
- databaseId: params.databaseId,
618
- collectionId: params.tableId,
619
- key: params.key,
620
- required: params.required ?? ipAttr.required,
621
- xdefault: params.default !== undefined ? params.default : ipAttr.default
622
- });
623
- break;
624
-
625
- case 'url':
626
- const urlAttr = existingAttr as Models.AttributeUrl;
627
- result = await this.databases.updateUrlAttribute({
628
- databaseId: params.databaseId,
629
- collectionId: params.tableId,
630
- key: params.key,
631
- required: params.required ?? urlAttr.required,
632
- xdefault: params.default !== undefined ? params.default : urlAttr.default
633
- });
634
- break;
635
-
636
- case 'relationship':
637
- // Relationship attributes have different update method signature
638
- const relationshipAttr = existingAttr as Models.AttributeRelationship;
639
- result = await this.databases.updateRelationshipAttribute({
640
- databaseId: params.databaseId,
641
- collectionId: params.tableId,
642
- key: params.key,
643
- onDelete: relationshipAttr.onDelete as RelationMutate
644
- });
645
- break;
646
-
647
- default:
648
- throw new AdapterError(
649
- `Unsupported attribute type for update: ${attributeType}`,
650
- 'UNSUPPORTED_ATTRIBUTE_TYPE'
651
- );
652
- }
653
-
654
- return { data: result };
655
- } catch (error) {
656
- throw new AdapterError(
657
- `Failed to update attribute (legacy): ${error instanceof Error ? error.message : 'Unknown error'}`,
658
- 'UPDATE_ATTRIBUTE_FAILED',
659
- error instanceof Error ? error : undefined
660
- );
661
- }
662
- }
663
-
664
- async deleteAttribute(params: DeleteAttributeParams): Promise<ApiResponse> {
665
- try {
666
- // TablesDB: deleteAttribute({ databaseId, tableId, key })
667
- // Legacy: deleteAttribute(databaseId, collectionId, key)
668
- const result = await this.databases.deleteAttribute(
669
- params.databaseId,
670
- params.tableId,
671
- params.key
672
- );
673
-
674
- return { data: result };
675
- } catch (error) {
676
- throw new AdapterError(
677
- `Failed to delete attribute (legacy): ${error instanceof Error ? error.message : 'Unknown error'}`,
678
- 'DELETE_ATTRIBUTE_FAILED',
679
- error instanceof Error ? error : undefined
680
- );
681
- }
682
- }
683
-
684
- // Bulk Operations - Not natively supported in legacy, provide fallback
685
-
686
- async bulkCreateRows(params: BulkCreateRowsParams): Promise<ApiResponse> {
687
- // Legacy doesn't support bulk operations, fallback to individual creates
688
- const results = [];
689
- const errors = [];
690
-
691
- for (const row of params.rows) {
692
- try {
693
- const result = await this.createRow({
694
- databaseId: params.databaseId,
695
- tableId: params.tableId,
696
- id: row.$id || 'unique()', // Generate unique ID if not provided
697
- data: row,
698
- permissions: row.$permissions
699
- });
700
- results.push(result.data);
701
- } catch (error) {
702
- errors.push({
703
- row,
704
- error: error instanceof Error ? error.message : 'Unknown error'
705
- });
706
- }
707
- }
708
-
709
- if (errors.length > 0) {
710
- console.warn(`Bulk create had ${errors.length} failures out of ${params.rows.length} total rows`);
711
- }
712
-
713
- return {
714
- data: results,
715
- rows: results,
716
- total: results.length,
717
- errors: errors.length > 0 ? errors : undefined
718
- };
719
- }
720
-
721
- async bulkUpsertRows(params: BulkUpsertRowsParams): Promise<ApiResponse> {
722
- throw new UnsupportedOperationError('bulkUpsertRows', 'legacy');
723
- }
724
-
725
- async bulkDeleteRows(params: BulkDeleteRowsParams): Promise<ApiResponse> {
726
- try {
727
- let queries: string[];
728
-
729
- // Wipe mode: use Query.limit for deleting without fetching
730
- if (params.rowIds.length === 0) {
731
- const batchSize = params.batchSize || 250;
732
- queries = [Query.limit(batchSize)];
733
- }
734
- // Specific IDs mode: chunk into batches of 80-90 to stay within Appwrite limits
735
- // (max 100 IDs per Query.equal, and queries must be < 4096 chars total)
736
- else {
737
- const ID_BATCH_SIZE = 85; // Safe batch size for Query.equal
738
- const idBatches = chunk(params.rowIds, ID_BATCH_SIZE);
739
- queries = idBatches.map(batch => Query.equal('$id', batch));
740
- }
741
-
742
- const result = await this.databases.deleteDocuments(
743
- params.databaseId,
744
- params.tableId, // Maps tableId to collectionId
745
- queries
746
- );
747
-
748
- return {
749
- data: result,
750
- total: params.rowIds.length || (result as any).total || 0
751
- };
752
- } catch (error) {
753
- // If deleteDocuments with queries fails, fall back to individual deletes
754
- const errorMessage = error instanceof Error ? error.message : String(error);
755
-
756
- // Check if the error indicates that deleteDocuments with queries is not supported
757
- if (errorMessage.includes('not supported') || errorMessage.includes('invalid') || errorMessage.includes('queries')) {
758
- // Fall back to individual deletions
759
- const results = [];
760
- const errors = [];
761
-
762
- for (const rowId of params.rowIds) {
763
- try {
764
- await this.deleteRow({
765
- databaseId: params.databaseId,
766
- tableId: params.tableId,
767
- id: rowId
768
- });
769
- results.push({ id: rowId, deleted: true });
770
- } catch (individualError) {
771
- errors.push({
772
- rowId,
773
- error: individualError instanceof Error ? individualError.message : 'Unknown error'
774
- });
775
- }
776
- }
777
-
778
- return {
779
- data: results,
780
- total: results.length,
781
- errors: errors.length > 0 ? errors : undefined
782
- };
783
- } else {
784
- // Re-throw the original error if it's not a support issue
785
- throw new AdapterError(
786
- `Failed to bulk delete rows (legacy): ${errorMessage}`,
787
- 'BULK_DELETE_ROWS_FAILED',
788
- error instanceof Error ? error : undefined
789
- );
790
- }
791
- }
792
- }
793
-
794
- // Metadata and Capabilities
795
-
796
- getMetadata(): AdapterMetadata {
797
- return {
798
- apiMode: 'legacy',
799
- terminology: {
800
- container: 'collection',
801
- item: 'document',
802
- service: 'Databases'
803
- },
804
- capabilities: {
805
- bulkOperations: false, // Legacy doesn't support native bulk ops
806
- advancedQueries: true,
807
- realtime: true,
808
- transactions: false
809
- }
810
- };
811
- }
812
-
813
- supportsBulkOperations(): boolean {
814
- return false; // Legacy uses individual operation fallbacks
815
- }
816
-
817
- // Legacy-specific helper methods
818
-
819
- /**
820
- * Check if endpoint supports bulk operations via HTTP (for cloud instances)
821
- */
822
- private supportsHttpBulkOperations(endpoint: string): boolean {
823
- return endpoint.includes('cloud.appwrite.io');
824
- }
825
-
826
- /**
827
- * Normalize response format to be consistent with TablesDB
828
- */
829
- private normalizeResponse(response: any, type: 'row' | 'table'): ApiResponse {
830
- if (type === 'row') {
831
- return {
832
- data: response,
833
- rows: Array.isArray(response) ? response : [response],
834
- documents: Array.isArray(response) ? response : [response]
835
- };
836
- } else {
837
- return {
838
- data: response,
839
- tables: Array.isArray(response) ? response : [response],
840
- collections: Array.isArray(response) ? response : [response]
841
- };
842
- }
843
- }
844
- }