@njdamstra/appwrite-utils-cli 1.8.9

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