@njdamstra/appwrite-utils-cli 1.8.9 → 1.10.1

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 (285) hide show
  1. package/CHANGELOG.md +16 -0
  2. package/CONFIG_TODO.md +1189 -0
  3. package/SELECTION_DIALOGS.md +146 -0
  4. package/SERVICE_IMPLEMENTATION_REPORT.md +462 -0
  5. package/dist/adapters/index.d.ts +7 -8
  6. package/dist/adapters/index.js +7 -9
  7. package/dist/backups/operations/bucketBackup.js +2 -2
  8. package/dist/backups/operations/collectionBackup.d.ts +1 -1
  9. package/dist/backups/operations/collectionBackup.js +3 -3
  10. package/dist/backups/operations/comprehensiveBackup.d.ts +1 -1
  11. package/dist/backups/operations/comprehensiveBackup.js +2 -2
  12. package/dist/backups/tracking/centralizedTracking.d.ts +1 -1
  13. package/dist/backups/tracking/centralizedTracking.js +2 -2
  14. package/dist/cli/commands/configCommands.js +51 -7
  15. package/dist/cli/commands/databaseCommands.d.ts +1 -0
  16. package/dist/cli/commands/databaseCommands.js +119 -9
  17. package/dist/cli/commands/functionCommands.js +3 -3
  18. package/dist/cli/commands/importFileCommands.d.ts +7 -0
  19. package/dist/cli/commands/importFileCommands.js +674 -0
  20. package/dist/cli/commands/schemaCommands.js +3 -3
  21. package/dist/cli/commands/storageCommands.js +2 -3
  22. package/dist/cli/commands/transferCommands.js +3 -5
  23. package/dist/collections/attributes.d.ts +1 -1
  24. package/dist/collections/attributes.js +85 -35
  25. package/dist/collections/indexes.js +2 -4
  26. package/dist/collections/methods.d.ts +1 -1
  27. package/dist/collections/methods.js +111 -192
  28. package/dist/collections/tableOperations.d.ts +1 -0
  29. package/dist/collections/tableOperations.js +90 -23
  30. package/dist/collections/transferOperations.d.ts +1 -1
  31. package/dist/collections/transferOperations.js +3 -4
  32. package/dist/collections/wipeOperations.d.ts +4 -3
  33. package/dist/collections/wipeOperations.js +112 -39
  34. package/dist/databases/methods.js +2 -2
  35. package/dist/databases/setup.js +2 -2
  36. package/dist/examples/yamlTerminologyExample.js +2 -2
  37. package/dist/functions/deployments.d.ts +1 -1
  38. package/dist/functions/deployments.js +5 -5
  39. package/dist/functions/fnConfigDiscovery.js +2 -2
  40. package/dist/functions/methods.js +16 -4
  41. package/dist/init.js +1 -1
  42. package/dist/interactiveCLI.d.ts +6 -1
  43. package/dist/interactiveCLI.js +64 -10
  44. package/dist/main.js +130 -177
  45. package/dist/migrations/afterImportActions.js +2 -3
  46. package/dist/migrations/appwriteToX.d.ts +97 -1
  47. package/dist/migrations/appwriteToX.js +9 -7
  48. package/dist/migrations/comprehensiveTransfer.js +3 -5
  49. package/dist/migrations/dataLoader.d.ts +194 -2
  50. package/dist/migrations/dataLoader.js +2 -5
  51. package/dist/migrations/importController.js +3 -4
  52. package/dist/migrations/importDataActions.js +3 -3
  53. package/dist/migrations/relationships.js +1 -2
  54. package/dist/migrations/services/DataTransformationService.js +2 -2
  55. package/dist/migrations/services/FileHandlerService.js +1 -1
  56. package/dist/migrations/services/ImportOrchestrator.js +4 -4
  57. package/dist/migrations/services/RateLimitManager.js +1 -1
  58. package/dist/migrations/services/RelationshipResolver.js +1 -1
  59. package/dist/migrations/services/UserMappingService.js +1 -1
  60. package/dist/migrations/services/ValidationService.js +1 -1
  61. package/dist/migrations/transfer.d.ts +8 -4
  62. package/dist/migrations/transfer.js +106 -55
  63. package/dist/migrations/yaml/YamlImportConfigLoader.js +1 -1
  64. package/dist/migrations/yaml/YamlImportIntegration.js +2 -2
  65. package/dist/migrations/yaml/generateImportSchemas.js +1 -1
  66. package/dist/setupCommands.d.ts +1 -1
  67. package/dist/setupCommands.js +5 -6
  68. package/dist/setupController.js +1 -1
  69. package/dist/shared/backupTracking.d.ts +1 -1
  70. package/dist/shared/backupTracking.js +2 -2
  71. package/dist/shared/confirmationDialogs.js +1 -1
  72. package/dist/shared/migrationHelpers.d.ts +1 -1
  73. package/dist/shared/migrationHelpers.js +3 -3
  74. package/dist/shared/operationQueue.d.ts +1 -1
  75. package/dist/shared/operationQueue.js +2 -3
  76. package/dist/shared/operationsTable.d.ts +1 -1
  77. package/dist/shared/operationsTable.js +2 -2
  78. package/dist/shared/progressManager.js +1 -1
  79. package/dist/shared/selectionDialogs.js +9 -8
  80. package/dist/storage/methods.js +4 -4
  81. package/dist/storage/schemas.d.ts +386 -2
  82. package/dist/tables/indexManager.d.ts +65 -0
  83. package/dist/tables/indexManager.js +294 -0
  84. package/dist/types.d.ts +2 -2
  85. package/dist/types.js +1 -1
  86. package/dist/users/methods.js +2 -3
  87. package/dist/utils/configMigration.js +1 -1
  88. package/dist/utils/index.d.ts +1 -1
  89. package/dist/utils/index.js +1 -1
  90. package/dist/utils/loadConfigs.d.ts +2 -2
  91. package/dist/utils/loadConfigs.js +6 -7
  92. package/dist/utils/setupFiles.js +5 -7
  93. package/dist/utilsController.d.ts +15 -8
  94. package/dist/utilsController.js +57 -28
  95. package/package.json +8 -4
  96. package/src/adapters/index.ts +8 -34
  97. package/src/backups/operations/bucketBackup.ts +2 -2
  98. package/src/backups/operations/collectionBackup.ts +4 -4
  99. package/src/backups/operations/comprehensiveBackup.ts +3 -3
  100. package/src/backups/tracking/centralizedTracking.ts +3 -3
  101. package/src/cli/commands/configCommands.ts +72 -8
  102. package/src/cli/commands/databaseCommands.ts +161 -9
  103. package/src/cli/commands/functionCommands.ts +4 -3
  104. package/src/cli/commands/importFileCommands.ts +815 -0
  105. package/src/cli/commands/schemaCommands.ts +3 -3
  106. package/src/cli/commands/storageCommands.ts +2 -3
  107. package/src/cli/commands/transferCommands.ts +3 -6
  108. package/src/collections/attributes.ts +155 -39
  109. package/src/collections/indexes.ts +5 -7
  110. package/src/collections/methods.ts +115 -150
  111. package/src/collections/tableOperations.ts +92 -21
  112. package/src/collections/transferOperations.ts +4 -5
  113. package/src/collections/wipeOperations.ts +154 -51
  114. package/src/databases/methods.ts +2 -2
  115. package/src/databases/setup.ts +2 -2
  116. package/src/examples/yamlTerminologyExample.ts +2 -2
  117. package/src/functions/deployments.ts +6 -5
  118. package/src/functions/fnConfigDiscovery.ts +2 -2
  119. package/src/functions/methods.ts +19 -6
  120. package/src/init.ts +1 -1
  121. package/src/interactiveCLI.ts +78 -13
  122. package/src/main.ts +143 -287
  123. package/src/migrations/afterImportActions.ts +2 -3
  124. package/src/migrations/appwriteToX.ts +12 -8
  125. package/src/migrations/comprehensiveTransfer.ts +6 -6
  126. package/src/migrations/dataLoader.ts +2 -5
  127. package/src/migrations/importController.ts +3 -4
  128. package/src/migrations/importDataActions.ts +3 -3
  129. package/src/migrations/relationships.ts +1 -2
  130. package/src/migrations/services/DataTransformationService.ts +2 -2
  131. package/src/migrations/services/FileHandlerService.ts +1 -1
  132. package/src/migrations/services/ImportOrchestrator.ts +4 -4
  133. package/src/migrations/services/RateLimitManager.ts +1 -1
  134. package/src/migrations/services/RelationshipResolver.ts +1 -1
  135. package/src/migrations/services/UserMappingService.ts +1 -1
  136. package/src/migrations/services/ValidationService.ts +1 -1
  137. package/src/migrations/transfer.ts +126 -83
  138. package/src/migrations/yaml/YamlImportConfigLoader.ts +1 -1
  139. package/src/migrations/yaml/YamlImportIntegration.ts +2 -2
  140. package/src/migrations/yaml/generateImportSchemas.ts +1 -1
  141. package/src/setupCommands.ts +5 -6
  142. package/src/setupController.ts +1 -1
  143. package/src/shared/backupTracking.ts +3 -3
  144. package/src/shared/confirmationDialogs.ts +1 -1
  145. package/src/shared/migrationHelpers.ts +4 -4
  146. package/src/shared/operationQueue.ts +3 -4
  147. package/src/shared/operationsTable.ts +3 -3
  148. package/src/shared/progressManager.ts +1 -1
  149. package/src/shared/selectionDialogs.ts +9 -8
  150. package/src/storage/methods.ts +4 -4
  151. package/src/tables/indexManager.ts +409 -0
  152. package/src/types.ts +2 -2
  153. package/src/users/methods.ts +2 -3
  154. package/src/utils/configMigration.ts +1 -1
  155. package/src/utils/index.ts +1 -1
  156. package/src/utils/loadConfigs.ts +15 -7
  157. package/src/utils/setupFiles.ts +5 -7
  158. package/src/utilsController.ts +86 -32
  159. package/dist/adapters/AdapterFactory.d.ts +0 -94
  160. package/dist/adapters/AdapterFactory.js +0 -405
  161. package/dist/adapters/DatabaseAdapter.d.ts +0 -233
  162. package/dist/adapters/DatabaseAdapter.js +0 -50
  163. package/dist/adapters/LegacyAdapter.d.ts +0 -50
  164. package/dist/adapters/LegacyAdapter.js +0 -612
  165. package/dist/adapters/TablesDBAdapter.d.ts +0 -45
  166. package/dist/adapters/TablesDBAdapter.js +0 -571
  167. package/dist/config/ConfigManager.d.ts +0 -445
  168. package/dist/config/ConfigManager.js +0 -625
  169. package/dist/config/configMigration.d.ts +0 -87
  170. package/dist/config/configMigration.js +0 -390
  171. package/dist/config/configValidation.d.ts +0 -66
  172. package/dist/config/configValidation.js +0 -358
  173. package/dist/config/index.d.ts +0 -8
  174. package/dist/config/index.js +0 -7
  175. package/dist/config/services/ConfigDiscoveryService.d.ts +0 -126
  176. package/dist/config/services/ConfigDiscoveryService.js +0 -374
  177. package/dist/config/services/ConfigLoaderService.d.ts +0 -129
  178. package/dist/config/services/ConfigLoaderService.js +0 -540
  179. package/dist/config/services/ConfigMergeService.d.ts +0 -208
  180. package/dist/config/services/ConfigMergeService.js +0 -308
  181. package/dist/config/services/ConfigValidationService.d.ts +0 -214
  182. package/dist/config/services/ConfigValidationService.js +0 -310
  183. package/dist/config/services/SessionAuthService.d.ts +0 -225
  184. package/dist/config/services/SessionAuthService.js +0 -456
  185. package/dist/config/services/__tests__/ConfigMergeService.test.d.ts +0 -1
  186. package/dist/config/services/__tests__/ConfigMergeService.test.js +0 -271
  187. package/dist/config/services/index.d.ts +0 -13
  188. package/dist/config/services/index.js +0 -10
  189. package/dist/config/yamlConfig.d.ts +0 -722
  190. package/dist/config/yamlConfig.js +0 -702
  191. package/dist/functions/pathResolution.d.ts +0 -37
  192. package/dist/functions/pathResolution.js +0 -185
  193. package/dist/shared/attributeMapper.d.ts +0 -20
  194. package/dist/shared/attributeMapper.js +0 -203
  195. package/dist/shared/errorUtils.d.ts +0 -54
  196. package/dist/shared/errorUtils.js +0 -95
  197. package/dist/shared/functionManager.d.ts +0 -48
  198. package/dist/shared/functionManager.js +0 -336
  199. package/dist/shared/indexManager.d.ts +0 -24
  200. package/dist/shared/indexManager.js +0 -151
  201. package/dist/shared/jsonSchemaGenerator.d.ts +0 -50
  202. package/dist/shared/jsonSchemaGenerator.js +0 -290
  203. package/dist/shared/logging.d.ts +0 -61
  204. package/dist/shared/logging.js +0 -116
  205. package/dist/shared/messageFormatter.d.ts +0 -39
  206. package/dist/shared/messageFormatter.js +0 -162
  207. package/dist/shared/pydanticModelGenerator.d.ts +0 -17
  208. package/dist/shared/pydanticModelGenerator.js +0 -615
  209. package/dist/shared/schemaGenerator.d.ts +0 -40
  210. package/dist/shared/schemaGenerator.js +0 -556
  211. package/dist/utils/ClientFactory.d.ts +0 -87
  212. package/dist/utils/ClientFactory.js +0 -212
  213. package/dist/utils/configDiscovery.d.ts +0 -78
  214. package/dist/utils/configDiscovery.js +0 -472
  215. package/dist/utils/constantsGenerator.d.ts +0 -31
  216. package/dist/utils/constantsGenerator.js +0 -321
  217. package/dist/utils/dataConverters.d.ts +0 -46
  218. package/dist/utils/dataConverters.js +0 -139
  219. package/dist/utils/directoryUtils.d.ts +0 -22
  220. package/dist/utils/directoryUtils.js +0 -59
  221. package/dist/utils/getClientFromConfig.d.ts +0 -39
  222. package/dist/utils/getClientFromConfig.js +0 -199
  223. package/dist/utils/helperFunctions.d.ts +0 -63
  224. package/dist/utils/helperFunctions.js +0 -156
  225. package/dist/utils/pathResolvers.d.ts +0 -53
  226. package/dist/utils/pathResolvers.js +0 -72
  227. package/dist/utils/projectConfig.d.ts +0 -119
  228. package/dist/utils/projectConfig.js +0 -171
  229. package/dist/utils/retryFailedPromises.d.ts +0 -2
  230. package/dist/utils/retryFailedPromises.js +0 -23
  231. package/dist/utils/sessionAuth.d.ts +0 -48
  232. package/dist/utils/sessionAuth.js +0 -164
  233. package/dist/utils/typeGuards.d.ts +0 -35
  234. package/dist/utils/typeGuards.js +0 -57
  235. package/dist/utils/validationRules.d.ts +0 -43
  236. package/dist/utils/validationRules.js +0 -42
  237. package/dist/utils/versionDetection.d.ts +0 -58
  238. package/dist/utils/versionDetection.js +0 -251
  239. package/dist/utils/yamlConverter.d.ts +0 -100
  240. package/dist/utils/yamlConverter.js +0 -428
  241. package/dist/utils/yamlLoader.d.ts +0 -70
  242. package/dist/utils/yamlLoader.js +0 -267
  243. package/src/adapters/AdapterFactory.ts +0 -510
  244. package/src/adapters/DatabaseAdapter.ts +0 -306
  245. package/src/adapters/LegacyAdapter.ts +0 -841
  246. package/src/adapters/TablesDBAdapter.ts +0 -773
  247. package/src/config/ConfigManager.ts +0 -808
  248. package/src/config/README.md +0 -274
  249. package/src/config/configMigration.ts +0 -575
  250. package/src/config/configValidation.ts +0 -445
  251. package/src/config/index.ts +0 -10
  252. package/src/config/services/ConfigDiscoveryService.ts +0 -463
  253. package/src/config/services/ConfigLoaderService.ts +0 -740
  254. package/src/config/services/ConfigMergeService.ts +0 -388
  255. package/src/config/services/ConfigValidationService.ts +0 -394
  256. package/src/config/services/SessionAuthService.ts +0 -565
  257. package/src/config/services/__tests__/ConfigMergeService.test.ts +0 -351
  258. package/src/config/services/index.ts +0 -29
  259. package/src/config/yamlConfig.ts +0 -761
  260. package/src/functions/pathResolution.ts +0 -227
  261. package/src/shared/attributeMapper.ts +0 -229
  262. package/src/shared/errorUtils.ts +0 -110
  263. package/src/shared/functionManager.ts +0 -525
  264. package/src/shared/indexManager.ts +0 -254
  265. package/src/shared/jsonSchemaGenerator.ts +0 -383
  266. package/src/shared/logging.ts +0 -149
  267. package/src/shared/messageFormatter.ts +0 -208
  268. package/src/shared/pydanticModelGenerator.ts +0 -618
  269. package/src/shared/schemaGenerator.ts +0 -644
  270. package/src/utils/ClientFactory.ts +0 -240
  271. package/src/utils/configDiscovery.ts +0 -557
  272. package/src/utils/constantsGenerator.ts +0 -369
  273. package/src/utils/dataConverters.ts +0 -159
  274. package/src/utils/directoryUtils.ts +0 -61
  275. package/src/utils/getClientFromConfig.ts +0 -257
  276. package/src/utils/helperFunctions.ts +0 -228
  277. package/src/utils/pathResolvers.ts +0 -81
  278. package/src/utils/projectConfig.ts +0 -299
  279. package/src/utils/retryFailedPromises.ts +0 -29
  280. package/src/utils/sessionAuth.ts +0 -230
  281. package/src/utils/typeGuards.ts +0 -65
  282. package/src/utils/validationRules.ts +0 -88
  283. package/src/utils/versionDetection.ts +0 -292
  284. package/src/utils/yamlConverter.ts +0 -542
  285. package/src/utils/yamlLoader.ts +0 -371
@@ -1,50 +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
- import { Client } from "node-appwrite";
10
- 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';
11
- /**
12
- * LegacyAdapter - Translates TablesDB calls to legacy Databases API
13
- */
14
- export declare class LegacyAdapter extends BaseAdapter {
15
- private databases;
16
- constructor(client: Client);
17
- listRows(params: ListRowsParams): Promise<ApiResponse>;
18
- createRow(params: CreateRowParams): Promise<ApiResponse>;
19
- updateRow(params: UpdateRowParams): Promise<ApiResponse>;
20
- deleteRow(params: DeleteRowParams): Promise<ApiResponse>;
21
- getRow(params: {
22
- databaseId: string;
23
- tableId: string;
24
- id: string;
25
- }): Promise<ApiResponse>;
26
- listTables(params: ListTablesParams): Promise<ApiResponse>;
27
- createTable(params: CreateTableParams): Promise<ApiResponse>;
28
- updateTable(params: UpdateTableParams): Promise<ApiResponse>;
29
- deleteTable(params: DeleteTableParams): Promise<ApiResponse>;
30
- getTable(params: GetTableParams): Promise<ApiResponse>;
31
- listIndexes(params: ListIndexesParams): Promise<ApiResponse>;
32
- createIndex(params: CreateIndexParams): Promise<ApiResponse>;
33
- deleteIndex(params: DeleteIndexParams): Promise<ApiResponse>;
34
- createAttribute(params: CreateAttributeParams): Promise<ApiResponse>;
35
- updateAttribute(params: UpdateAttributeParams): Promise<ApiResponse>;
36
- deleteAttribute(params: DeleteAttributeParams): Promise<ApiResponse>;
37
- bulkCreateRows(params: BulkCreateRowsParams): Promise<ApiResponse>;
38
- bulkUpsertRows(params: BulkUpsertRowsParams): Promise<ApiResponse>;
39
- bulkDeleteRows(params: BulkDeleteRowsParams): Promise<ApiResponse>;
40
- getMetadata(): AdapterMetadata;
41
- supportsBulkOperations(): boolean;
42
- /**
43
- * Check if endpoint supports bulk operations via HTTP (for cloud instances)
44
- */
45
- private supportsHttpBulkOperations;
46
- /**
47
- * Normalize response format to be consistent with TablesDB
48
- */
49
- private normalizeResponse;
50
- }
@@ -1,612 +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
- 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
- }