appwrite-utils-cli 1.9.7 → 1.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (425) hide show
  1. package/CONFIG_TODO.md +1189 -1189
  2. package/README.md +1004 -1004
  3. package/SELECTION_DIALOGS.md +145 -145
  4. package/SERVICE_IMPLEMENTATION_REPORT.md +462 -462
  5. package/package.json +6 -3
  6. package/scripts/copy-templates.ts +23 -23
  7. package/src/adapters/index.ts +11 -37
  8. package/src/backups/operations/bucketBackup.ts +277 -277
  9. package/src/backups/operations/collectionBackup.ts +310 -310
  10. package/src/backups/operations/comprehensiveBackup.ts +342 -342
  11. package/src/backups/schemas/bucketManifest.ts +78 -78
  12. package/src/backups/schemas/comprehensiveManifest.ts +76 -76
  13. package/src/backups/tracking/centralizedTracking.ts +352 -352
  14. package/src/cli/commands/configCommands.ts +265 -201
  15. package/src/cli/commands/databaseCommands.ts +931 -879
  16. package/src/cli/commands/functionCommands.ts +333 -332
  17. package/src/cli/commands/importFileCommands.ts +815 -0
  18. package/src/cli/commands/schemaCommands.ts +141 -141
  19. package/src/cli/commands/storageCommands.ts +2 -3
  20. package/src/cli/commands/transferCommands.ts +454 -457
  21. package/src/collections/attributes.ts.backup +1555 -1555
  22. package/src/collections/{attributes.ts → columns.ts} +15 -10
  23. package/src/collections/indexes.ts +350 -352
  24. package/src/collections/methods.ts +714 -700
  25. package/src/collections/tableOperations.ts +29 -8
  26. package/src/collections/transferOperations.ts +376 -377
  27. package/src/collections/wipeOperations.ts +449 -346
  28. package/src/databases/methods.ts +49 -49
  29. package/src/databases/setup.ts +77 -77
  30. package/src/examples/yamlTerminologyExample.ts +346 -346
  31. package/src/functions/deployments.ts +221 -220
  32. package/src/functions/fnConfigDiscovery.ts +2 -2
  33. package/src/functions/methods.ts +284 -284
  34. package/src/functions/templates/count-docs-in-collection/README.md +53 -53
  35. package/src/functions/templates/count-docs-in-collection/src/main.ts +159 -159
  36. package/src/functions/templates/count-docs-in-collection/src/request.ts +8 -8
  37. package/src/functions/templates/hono-typescript/README.md +285 -285
  38. package/src/functions/templates/hono-typescript/src/adapters/request.ts +73 -73
  39. package/src/functions/templates/hono-typescript/src/adapters/response.ts +105 -105
  40. package/src/functions/templates/hono-typescript/src/app.ts +179 -179
  41. package/src/functions/templates/hono-typescript/src/context.ts +102 -102
  42. package/src/functions/templates/hono-typescript/src/{index.ts → main.ts} +53 -53
  43. package/src/functions/templates/hono-typescript/src/middleware/appwrite.ts +118 -118
  44. package/src/functions/templates/typescript-node/README.md +31 -31
  45. package/src/functions/templates/typescript-node/src/context.ts +102 -102
  46. package/src/functions/templates/typescript-node/src/{index.ts → main.ts} +29 -29
  47. package/src/functions/templates/uv/README.md +30 -30
  48. package/src/functions/templates/uv/pyproject.toml +29 -29
  49. package/src/functions/templates/uv/src/context.py +124 -124
  50. package/src/functions/templates/uv/src/{index.py → main.py} +45 -45
  51. package/src/init.ts +62 -62
  52. package/src/interactiveCLI.ts +1095 -1030
  53. package/src/main.ts +1517 -1670
  54. package/src/migrations/afterImportActions.ts +579 -580
  55. package/src/migrations/appwriteToX.ts +634 -630
  56. package/src/migrations/comprehensiveTransfer.ts +2149 -2149
  57. package/src/migrations/dataLoader.ts +1729 -1702
  58. package/src/migrations/importController.ts +440 -428
  59. package/src/migrations/importDataActions.ts +315 -315
  60. package/src/migrations/relationships.ts +333 -334
  61. package/src/migrations/services/DataTransformationService.ts +195 -195
  62. package/src/migrations/services/FileHandlerService.ts +310 -310
  63. package/src/migrations/services/ImportOrchestrator.ts +674 -665
  64. package/src/migrations/services/RateLimitManager.ts +362 -362
  65. package/src/migrations/services/RelationshipResolver.ts +460 -460
  66. package/src/migrations/services/UserMappingService.ts +344 -344
  67. package/src/migrations/services/ValidationService.ts +333 -333
  68. package/src/migrations/transfer.ts +987 -942
  69. package/src/migrations/yaml/YamlImportConfigLoader.ts +438 -438
  70. package/src/migrations/yaml/YamlImportIntegration.ts +438 -438
  71. package/src/migrations/yaml/generateImportSchemas.ts +1347 -1347
  72. package/src/schemas/authUser.ts +23 -23
  73. package/src/setup.ts +8 -8
  74. package/src/setupCommands.ts +5 -6
  75. package/src/setupController.ts +42 -42
  76. package/src/shared/backupMetadataSchema.ts +93 -93
  77. package/src/shared/backupTracking.ts +211 -211
  78. package/src/shared/confirmationDialogs.ts +326 -326
  79. package/src/shared/migrationHelpers.ts +232 -232
  80. package/src/shared/operationLogger.ts +20 -20
  81. package/src/shared/operationQueue.ts +326 -327
  82. package/src/shared/operationsTable.ts +338 -338
  83. package/src/shared/operationsTableSchema.ts +60 -60
  84. package/src/shared/progressManager.ts +277 -277
  85. package/src/shared/relationshipExtractor.ts +214 -214
  86. package/src/shared/selectionDialogs.ts +775 -722
  87. package/src/storage/backupCompression.ts +88 -88
  88. package/src/storage/methods.ts +695 -682
  89. package/src/storage/schemas.ts +205 -205
  90. package/src/tables/indexManager.ts +408 -408
  91. package/src/types/node-appwrite-tablesdb.d.ts +43 -43
  92. package/src/types.ts +9 -9
  93. package/src/users/methods.ts +358 -359
  94. package/src/utils/configMigration.ts +347 -347
  95. package/src/utils/index.ts +2 -2
  96. package/src/utils/loadConfigs.ts +457 -449
  97. package/src/utils/setupFiles.ts +1236 -1238
  98. package/src/utilsController.ts +1263 -1213
  99. package/tests/README.md +496 -496
  100. package/tests/adapters/AdapterFactory.test.ts +276 -276
  101. package/tests/integration/syncOperations.test.ts +462 -462
  102. package/tests/jest.config.js +24 -24
  103. package/tests/migration/configMigration.test.ts +545 -545
  104. package/tests/setup.ts +61 -61
  105. package/tests/testUtils.ts +339 -339
  106. package/tests/utils/loadConfigs.test.ts +349 -349
  107. package/tests/validation/configValidation.test.ts +411 -411
  108. package/tsconfig.json +44 -44
  109. package/.appwrite/.yaml_schemas/appwrite-config.schema.json +0 -380
  110. package/.appwrite/.yaml_schemas/collection.schema.json +0 -255
  111. package/.appwrite/collections/Categories.yaml +0 -182
  112. package/.appwrite/collections/ExampleCollection.yaml +0 -36
  113. package/.appwrite/collections/Posts.yaml +0 -227
  114. package/.appwrite/collections/Users.yaml +0 -149
  115. package/.appwrite/config.yaml +0 -109
  116. package/.appwrite/import/README.md +0 -148
  117. package/.appwrite/import/categories-import.yaml +0 -129
  118. package/.appwrite/import/posts-import.yaml +0 -208
  119. package/.appwrite/import/users-import.yaml +0 -130
  120. package/.appwrite/importData/categories.json +0 -194
  121. package/.appwrite/importData/posts.json +0 -270
  122. package/.appwrite/importData/users.json +0 -220
  123. package/.appwrite/schemas/categories.json +0 -128
  124. package/.appwrite/schemas/exampleCollection.json +0 -52
  125. package/.appwrite/schemas/posts.json +0 -173
  126. package/.appwrite/schemas/users.json +0 -125
  127. package/dist/adapters/AdapterFactory.d.ts +0 -94
  128. package/dist/adapters/AdapterFactory.js +0 -420
  129. package/dist/adapters/DatabaseAdapter.d.ts +0 -243
  130. package/dist/adapters/DatabaseAdapter.js +0 -50
  131. package/dist/adapters/LegacyAdapter.d.ts +0 -50
  132. package/dist/adapters/LegacyAdapter.js +0 -615
  133. package/dist/adapters/TablesDBAdapter.d.ts +0 -45
  134. package/dist/adapters/TablesDBAdapter.js +0 -611
  135. package/dist/adapters/index.d.ts +0 -11
  136. package/dist/adapters/index.js +0 -12
  137. package/dist/backups/operations/bucketBackup.d.ts +0 -19
  138. package/dist/backups/operations/bucketBackup.js +0 -197
  139. package/dist/backups/operations/collectionBackup.d.ts +0 -30
  140. package/dist/backups/operations/collectionBackup.js +0 -201
  141. package/dist/backups/operations/comprehensiveBackup.d.ts +0 -25
  142. package/dist/backups/operations/comprehensiveBackup.js +0 -238
  143. package/dist/backups/schemas/bucketManifest.d.ts +0 -93
  144. package/dist/backups/schemas/bucketManifest.js +0 -33
  145. package/dist/backups/schemas/comprehensiveManifest.d.ts +0 -108
  146. package/dist/backups/schemas/comprehensiveManifest.js +0 -32
  147. package/dist/backups/tracking/centralizedTracking.d.ts +0 -34
  148. package/dist/backups/tracking/centralizedTracking.js +0 -274
  149. package/dist/cli/commands/configCommands.d.ts +0 -8
  150. package/dist/cli/commands/configCommands.js +0 -166
  151. package/dist/cli/commands/databaseCommands.d.ts +0 -14
  152. package/dist/cli/commands/databaseCommands.js +0 -644
  153. package/dist/cli/commands/functionCommands.d.ts +0 -7
  154. package/dist/cli/commands/functionCommands.js +0 -330
  155. package/dist/cli/commands/schemaCommands.d.ts +0 -7
  156. package/dist/cli/commands/schemaCommands.js +0 -169
  157. package/dist/cli/commands/storageCommands.d.ts +0 -5
  158. package/dist/cli/commands/storageCommands.js +0 -143
  159. package/dist/cli/commands/transferCommands.d.ts +0 -5
  160. package/dist/cli/commands/transferCommands.js +0 -384
  161. package/dist/collections/attributes.d.ts +0 -13
  162. package/dist/collections/attributes.js +0 -1333
  163. package/dist/collections/indexes.d.ts +0 -12
  164. package/dist/collections/indexes.js +0 -217
  165. package/dist/collections/methods.d.ts +0 -19
  166. package/dist/collections/methods.js +0 -587
  167. package/dist/collections/tableOperations.d.ts +0 -86
  168. package/dist/collections/tableOperations.js +0 -447
  169. package/dist/collections/transferOperations.d.ts +0 -8
  170. package/dist/collections/transferOperations.js +0 -412
  171. package/dist/collections/wipeOperations.d.ts +0 -16
  172. package/dist/collections/wipeOperations.js +0 -233
  173. package/dist/config/ConfigManager.d.ts +0 -450
  174. package/dist/config/ConfigManager.js +0 -650
  175. package/dist/config/configMigration.d.ts +0 -87
  176. package/dist/config/configMigration.js +0 -390
  177. package/dist/config/configValidation.d.ts +0 -66
  178. package/dist/config/configValidation.js +0 -358
  179. package/dist/config/index.d.ts +0 -8
  180. package/dist/config/index.js +0 -7
  181. package/dist/config/services/ConfigDiscoveryService.d.ts +0 -122
  182. package/dist/config/services/ConfigDiscoveryService.js +0 -322
  183. package/dist/config/services/ConfigLoaderService.d.ts +0 -129
  184. package/dist/config/services/ConfigLoaderService.js +0 -535
  185. package/dist/config/services/ConfigMergeService.d.ts +0 -208
  186. package/dist/config/services/ConfigMergeService.js +0 -308
  187. package/dist/config/services/ConfigValidationService.d.ts +0 -214
  188. package/dist/config/services/ConfigValidationService.js +0 -310
  189. package/dist/config/services/SessionAuthService.d.ts +0 -225
  190. package/dist/config/services/SessionAuthService.js +0 -456
  191. package/dist/config/services/__tests__/ConfigMergeService.test.d.ts +0 -1
  192. package/dist/config/services/__tests__/ConfigMergeService.test.js +0 -271
  193. package/dist/config/services/index.d.ts +0 -13
  194. package/dist/config/services/index.js +0 -10
  195. package/dist/config/yamlConfig.d.ts +0 -722
  196. package/dist/config/yamlConfig.js +0 -702
  197. package/dist/databases/methods.d.ts +0 -6
  198. package/dist/databases/methods.js +0 -35
  199. package/dist/databases/setup.d.ts +0 -5
  200. package/dist/databases/setup.js +0 -45
  201. package/dist/examples/yamlTerminologyExample.d.ts +0 -42
  202. package/dist/examples/yamlTerminologyExample.js +0 -272
  203. package/dist/functions/deployments.d.ts +0 -4
  204. package/dist/functions/deployments.js +0 -146
  205. package/dist/functions/fnConfigDiscovery.d.ts +0 -3
  206. package/dist/functions/fnConfigDiscovery.js +0 -108
  207. package/dist/functions/methods.d.ts +0 -16
  208. package/dist/functions/methods.js +0 -174
  209. package/dist/functions/pathResolution.d.ts +0 -37
  210. package/dist/functions/pathResolution.js +0 -185
  211. package/dist/functions/templates/count-docs-in-collection/README.md +0 -54
  212. package/dist/functions/templates/count-docs-in-collection/package.json +0 -25
  213. package/dist/functions/templates/count-docs-in-collection/src/main.ts +0 -159
  214. package/dist/functions/templates/count-docs-in-collection/src/request.ts +0 -9
  215. package/dist/functions/templates/count-docs-in-collection/tsconfig.json +0 -28
  216. package/dist/functions/templates/hono-typescript/README.md +0 -286
  217. package/dist/functions/templates/hono-typescript/package.json +0 -26
  218. package/dist/functions/templates/hono-typescript/src/adapters/request.ts +0 -74
  219. package/dist/functions/templates/hono-typescript/src/adapters/response.ts +0 -106
  220. package/dist/functions/templates/hono-typescript/src/app.ts +0 -180
  221. package/dist/functions/templates/hono-typescript/src/context.ts +0 -103
  222. package/dist/functions/templates/hono-typescript/src/index.ts +0 -54
  223. package/dist/functions/templates/hono-typescript/src/middleware/appwrite.ts +0 -119
  224. package/dist/functions/templates/hono-typescript/tsconfig.json +0 -20
  225. package/dist/functions/templates/typescript-node/README.md +0 -32
  226. package/dist/functions/templates/typescript-node/package.json +0 -25
  227. package/dist/functions/templates/typescript-node/src/context.ts +0 -103
  228. package/dist/functions/templates/typescript-node/src/index.ts +0 -29
  229. package/dist/functions/templates/typescript-node/tsconfig.json +0 -28
  230. package/dist/functions/templates/uv/README.md +0 -31
  231. package/dist/functions/templates/uv/pyproject.toml +0 -30
  232. package/dist/functions/templates/uv/src/__init__.py +0 -0
  233. package/dist/functions/templates/uv/src/context.py +0 -125
  234. package/dist/functions/templates/uv/src/index.py +0 -46
  235. package/dist/init.d.ts +0 -2
  236. package/dist/init.js +0 -57
  237. package/dist/interactiveCLI.d.ts +0 -31
  238. package/dist/interactiveCLI.js +0 -898
  239. package/dist/main.d.ts +0 -2
  240. package/dist/main.js +0 -1180
  241. package/dist/migrations/afterImportActions.d.ts +0 -17
  242. package/dist/migrations/afterImportActions.js +0 -306
  243. package/dist/migrations/appwriteToX.d.ts +0 -211
  244. package/dist/migrations/appwriteToX.js +0 -491
  245. package/dist/migrations/comprehensiveTransfer.d.ts +0 -147
  246. package/dist/migrations/comprehensiveTransfer.js +0 -1317
  247. package/dist/migrations/dataLoader.d.ts +0 -753
  248. package/dist/migrations/dataLoader.js +0 -1250
  249. package/dist/migrations/importController.d.ts +0 -23
  250. package/dist/migrations/importController.js +0 -268
  251. package/dist/migrations/importDataActions.d.ts +0 -50
  252. package/dist/migrations/importDataActions.js +0 -230
  253. package/dist/migrations/relationships.d.ts +0 -29
  254. package/dist/migrations/relationships.js +0 -204
  255. package/dist/migrations/services/DataTransformationService.d.ts +0 -55
  256. package/dist/migrations/services/DataTransformationService.js +0 -158
  257. package/dist/migrations/services/FileHandlerService.d.ts +0 -75
  258. package/dist/migrations/services/FileHandlerService.js +0 -236
  259. package/dist/migrations/services/ImportOrchestrator.d.ts +0 -97
  260. package/dist/migrations/services/ImportOrchestrator.js +0 -485
  261. package/dist/migrations/services/RateLimitManager.d.ts +0 -138
  262. package/dist/migrations/services/RateLimitManager.js +0 -279
  263. package/dist/migrations/services/RelationshipResolver.d.ts +0 -120
  264. package/dist/migrations/services/RelationshipResolver.js +0 -332
  265. package/dist/migrations/services/UserMappingService.d.ts +0 -109
  266. package/dist/migrations/services/UserMappingService.js +0 -277
  267. package/dist/migrations/services/ValidationService.d.ts +0 -74
  268. package/dist/migrations/services/ValidationService.js +0 -260
  269. package/dist/migrations/transfer.d.ts +0 -26
  270. package/dist/migrations/transfer.js +0 -608
  271. package/dist/migrations/yaml/YamlImportConfigLoader.d.ts +0 -131
  272. package/dist/migrations/yaml/YamlImportConfigLoader.js +0 -383
  273. package/dist/migrations/yaml/YamlImportIntegration.d.ts +0 -93
  274. package/dist/migrations/yaml/YamlImportIntegration.js +0 -341
  275. package/dist/migrations/yaml/generateImportSchemas.d.ts +0 -30
  276. package/dist/migrations/yaml/generateImportSchemas.js +0 -1327
  277. package/dist/schemas/authUser.d.ts +0 -24
  278. package/dist/schemas/authUser.js +0 -17
  279. package/dist/setup.d.ts +0 -2
  280. package/dist/setup.js +0 -5
  281. package/dist/setupCommands.d.ts +0 -58
  282. package/dist/setupCommands.js +0 -490
  283. package/dist/setupController.d.ts +0 -9
  284. package/dist/setupController.js +0 -34
  285. package/dist/shared/attributeMapper.d.ts +0 -20
  286. package/dist/shared/attributeMapper.js +0 -203
  287. package/dist/shared/backupMetadataSchema.d.ts +0 -94
  288. package/dist/shared/backupMetadataSchema.js +0 -38
  289. package/dist/shared/backupTracking.d.ts +0 -18
  290. package/dist/shared/backupTracking.js +0 -176
  291. package/dist/shared/confirmationDialogs.d.ts +0 -75
  292. package/dist/shared/confirmationDialogs.js +0 -236
  293. package/dist/shared/errorUtils.d.ts +0 -54
  294. package/dist/shared/errorUtils.js +0 -95
  295. package/dist/shared/functionManager.d.ts +0 -48
  296. package/dist/shared/functionManager.js +0 -348
  297. package/dist/shared/jsonSchemaGenerator.d.ts +0 -50
  298. package/dist/shared/jsonSchemaGenerator.js +0 -290
  299. package/dist/shared/logging.d.ts +0 -61
  300. package/dist/shared/logging.js +0 -116
  301. package/dist/shared/messageFormatter.d.ts +0 -39
  302. package/dist/shared/messageFormatter.js +0 -162
  303. package/dist/shared/migrationHelpers.d.ts +0 -61
  304. package/dist/shared/migrationHelpers.js +0 -145
  305. package/dist/shared/operationLogger.d.ts +0 -10
  306. package/dist/shared/operationLogger.js +0 -12
  307. package/dist/shared/operationQueue.d.ts +0 -40
  308. package/dist/shared/operationQueue.js +0 -311
  309. package/dist/shared/operationsTable.d.ts +0 -26
  310. package/dist/shared/operationsTable.js +0 -286
  311. package/dist/shared/operationsTableSchema.d.ts +0 -48
  312. package/dist/shared/operationsTableSchema.js +0 -35
  313. package/dist/shared/progressManager.d.ts +0 -62
  314. package/dist/shared/progressManager.js +0 -215
  315. package/dist/shared/pydanticModelGenerator.d.ts +0 -17
  316. package/dist/shared/pydanticModelGenerator.js +0 -615
  317. package/dist/shared/relationshipExtractor.d.ts +0 -56
  318. package/dist/shared/relationshipExtractor.js +0 -138
  319. package/dist/shared/schemaGenerator.d.ts +0 -40
  320. package/dist/shared/schemaGenerator.js +0 -556
  321. package/dist/shared/selectionDialogs.d.ts +0 -214
  322. package/dist/shared/selectionDialogs.js +0 -544
  323. package/dist/storage/backupCompression.d.ts +0 -20
  324. package/dist/storage/backupCompression.js +0 -67
  325. package/dist/storage/methods.d.ts +0 -32
  326. package/dist/storage/methods.js +0 -472
  327. package/dist/storage/schemas.d.ts +0 -842
  328. package/dist/storage/schemas.js +0 -175
  329. package/dist/tables/indexManager.d.ts +0 -65
  330. package/dist/tables/indexManager.js +0 -294
  331. package/dist/types.d.ts +0 -4
  332. package/dist/types.js +0 -3
  333. package/dist/users/methods.d.ts +0 -16
  334. package/dist/users/methods.js +0 -277
  335. package/dist/utils/ClientFactory.d.ts +0 -87
  336. package/dist/utils/ClientFactory.js +0 -212
  337. package/dist/utils/configDiscovery.d.ts +0 -78
  338. package/dist/utils/configDiscovery.js +0 -472
  339. package/dist/utils/configMigration.d.ts +0 -1
  340. package/dist/utils/configMigration.js +0 -261
  341. package/dist/utils/constantsGenerator.d.ts +0 -31
  342. package/dist/utils/constantsGenerator.js +0 -321
  343. package/dist/utils/dataConverters.d.ts +0 -46
  344. package/dist/utils/dataConverters.js +0 -139
  345. package/dist/utils/directoryUtils.d.ts +0 -22
  346. package/dist/utils/directoryUtils.js +0 -59
  347. package/dist/utils/getClientFromConfig.d.ts +0 -39
  348. package/dist/utils/getClientFromConfig.js +0 -199
  349. package/dist/utils/helperFunctions.d.ts +0 -63
  350. package/dist/utils/helperFunctions.js +0 -156
  351. package/dist/utils/index.d.ts +0 -2
  352. package/dist/utils/index.js +0 -2
  353. package/dist/utils/loadConfigs.d.ts +0 -50
  354. package/dist/utils/loadConfigs.js +0 -358
  355. package/dist/utils/pathResolvers.d.ts +0 -53
  356. package/dist/utils/pathResolvers.js +0 -72
  357. package/dist/utils/projectConfig.d.ts +0 -122
  358. package/dist/utils/projectConfig.js +0 -206
  359. package/dist/utils/retryFailedPromises.d.ts +0 -2
  360. package/dist/utils/retryFailedPromises.js +0 -23
  361. package/dist/utils/sessionAuth.d.ts +0 -48
  362. package/dist/utils/sessionAuth.js +0 -164
  363. package/dist/utils/setupFiles.d.ts +0 -4
  364. package/dist/utils/setupFiles.js +0 -1192
  365. package/dist/utils/typeGuards.d.ts +0 -35
  366. package/dist/utils/typeGuards.js +0 -57
  367. package/dist/utils/validationRules.d.ts +0 -43
  368. package/dist/utils/validationRules.js +0 -42
  369. package/dist/utils/versionDetection.d.ts +0 -58
  370. package/dist/utils/versionDetection.js +0 -251
  371. package/dist/utils/yamlConverter.d.ts +0 -100
  372. package/dist/utils/yamlConverter.js +0 -428
  373. package/dist/utils/yamlLoader.d.ts +0 -70
  374. package/dist/utils/yamlLoader.js +0 -267
  375. package/dist/utilsController.d.ts +0 -107
  376. package/dist/utilsController.js +0 -873
  377. package/src/adapters/AdapterFactory.ts +0 -529
  378. package/src/adapters/DatabaseAdapter.ts +0 -319
  379. package/src/adapters/LegacyAdapter.ts +0 -844
  380. package/src/adapters/TablesDBAdapter.ts +0 -823
  381. package/src/config/ConfigManager.ts +0 -849
  382. package/src/config/README.md +0 -274
  383. package/src/config/configMigration.ts +0 -575
  384. package/src/config/configValidation.ts +0 -445
  385. package/src/config/index.ts +0 -10
  386. package/src/config/services/ConfigDiscoveryService.ts +0 -410
  387. package/src/config/services/ConfigLoaderService.ts +0 -732
  388. package/src/config/services/ConfigMergeService.ts +0 -388
  389. package/src/config/services/ConfigValidationService.ts +0 -394
  390. package/src/config/services/SessionAuthService.ts +0 -565
  391. package/src/config/services/__tests__/ConfigMergeService.test.ts +0 -351
  392. package/src/config/services/index.ts +0 -29
  393. package/src/config/yamlConfig.ts +0 -761
  394. package/src/functions/pathResolution.ts +0 -227
  395. package/src/functions/templates/count-docs-in-collection/package.json +0 -25
  396. package/src/functions/templates/count-docs-in-collection/tsconfig.json +0 -28
  397. package/src/functions/templates/hono-typescript/package.json +0 -26
  398. package/src/functions/templates/hono-typescript/tsconfig.json +0 -20
  399. package/src/functions/templates/typescript-node/package.json +0 -25
  400. package/src/functions/templates/typescript-node/tsconfig.json +0 -28
  401. package/src/shared/attributeMapper.ts +0 -229
  402. package/src/shared/errorUtils.ts +0 -110
  403. package/src/shared/functionManager.ts +0 -537
  404. package/src/shared/jsonSchemaGenerator.ts +0 -383
  405. package/src/shared/logging.ts +0 -149
  406. package/src/shared/messageFormatter.ts +0 -208
  407. package/src/shared/pydanticModelGenerator.ts +0 -618
  408. package/src/shared/schemaGenerator.ts +0 -644
  409. package/src/utils/ClientFactory.ts +0 -240
  410. package/src/utils/configDiscovery.ts +0 -557
  411. package/src/utils/constantsGenerator.ts +0 -369
  412. package/src/utils/dataConverters.ts +0 -159
  413. package/src/utils/directoryUtils.ts +0 -61
  414. package/src/utils/getClientFromConfig.ts +0 -257
  415. package/src/utils/helperFunctions.ts +0 -228
  416. package/src/utils/pathResolvers.ts +0 -81
  417. package/src/utils/projectConfig.ts +0 -340
  418. package/src/utils/retryFailedPromises.ts +0 -29
  419. package/src/utils/sessionAuth.ts +0 -230
  420. package/src/utils/typeGuards.ts +0 -65
  421. package/src/utils/validationRules.ts +0 -88
  422. package/src/utils/versionDetection.ts +0 -292
  423. package/src/utils/yamlConverter.ts +0 -542
  424. package/src/utils/yamlLoader.ts +0 -371
  425. package/tmp-sync-test/.appwrite/collections/TestCollection.yaml +0 -7
@@ -1,16 +0,0 @@
1
- import { Client } from "node-appwrite";
2
- import { type AppwriteFunction, type Specification } from "appwrite-utils";
3
- export declare const listFunctions: (client: Client, queries?: string[], search?: string) => Promise<import("node-appwrite").Models.FunctionList>;
4
- export declare const getFunction: (client: Client, functionId: string) => Promise<import("node-appwrite").Models.Function>;
5
- export declare const downloadLatestFunctionDeployment: (client: Client, functionId: string, basePath?: string) => Promise<{
6
- path: string;
7
- function: import("node-appwrite").Models.Function;
8
- deployment: import("node-appwrite").Models.Deployment;
9
- }>;
10
- export declare const deleteFunction: (client: Client, functionId: string) => Promise<{}>;
11
- export declare const createFunction: (client: Client, functionConfig: AppwriteFunction) => Promise<import("node-appwrite").Models.Function>;
12
- export declare const updateFunctionSpecifications: (client: Client, functionId: string, specification: Specification) => Promise<import("node-appwrite").Models.Function | undefined>;
13
- export declare const listSpecifications: (client: Client) => Promise<import("node-appwrite").Models.SpecificationList>;
14
- export declare const listFunctionDeployments: (client: Client, functionId: string, queries?: string[]) => Promise<import("node-appwrite").Models.DeploymentList>;
15
- export declare const updateFunction: (client: Client, functionConfig: AppwriteFunction) => Promise<import("node-appwrite").Models.Function>;
16
- export declare const createFunctionTemplate: (templateType: "typescript-node" | "uv" | "count-docs-in-collection" | "hono-typescript", functionName: string, basePath?: string) => Promise<string>;
@@ -1,174 +0,0 @@
1
- import { AppwriteException, Client, Functions, Query, Runtime, } from "node-appwrite";
2
- import { join, dirname } from "node:path";
3
- import { fileURLToPath } from "node:url";
4
- import fs from "node:fs";
5
- import { EventTypeSchema, } from "appwrite-utils";
6
- import chalk from "chalk";
7
- import { extract as extractTar } from "tar";
8
- import { MessageFormatter } from "../shared/messageFormatter.js";
9
- import { expandTildePath, normalizeFunctionName } from "./pathResolution.js";
10
- /**
11
- * Validates and filters events array for Appwrite functions
12
- * - Filters out empty/invalid strings
13
- * - Validates against EventTypeSchema
14
- * - Limits to 100 items maximum (Appwrite limit)
15
- * - Returns empty array if input is invalid
16
- */
17
- const validateEvents = (events) => {
18
- if (!events || !Array.isArray(events))
19
- return [];
20
- return events
21
- .filter(event => {
22
- if (!event || typeof event !== 'string' || event.trim().length === 0) {
23
- return false;
24
- }
25
- // Validate against EventTypeSchema
26
- const result = EventTypeSchema.safeParse(event);
27
- if (!result.success) {
28
- MessageFormatter.warning(`Invalid event type "${event}" will be filtered out`, { prefix: "Functions" });
29
- return false;
30
- }
31
- return true;
32
- })
33
- .slice(0, 100);
34
- };
35
- export const listFunctions = async (client, queries, search) => {
36
- const functions = new Functions(client);
37
- const functionsList = await functions.list(queries, search);
38
- return functionsList;
39
- };
40
- export const getFunction = async (client, functionId) => {
41
- const functions = new Functions(client);
42
- const functionResponse = await functions.get(functionId);
43
- return functionResponse;
44
- };
45
- export const downloadLatestFunctionDeployment = async (client, functionId, basePath = process.cwd()) => {
46
- const functions = new Functions(client);
47
- const functionInfo = await getFunction(client, functionId);
48
- const functionDeployments = await functions.listDeployments(functionId, [
49
- Query.orderDesc("$createdAt"),
50
- ]);
51
- if (functionDeployments.deployments.length === 0) {
52
- throw new Error("No deployments found for function");
53
- }
54
- const latestDeployment = functionDeployments.deployments[0];
55
- const deploymentData = await functions.getDeploymentDownload(functionId, latestDeployment.$id);
56
- // Create function directory using provided basePath
57
- const functionDir = join(basePath, normalizeFunctionName(functionInfo.name));
58
- await fs.promises.mkdir(functionDir, { recursive: true });
59
- // Create temporary file for tar extraction
60
- const tarPath = join(functionDir, "temp.tar.gz");
61
- const uint8Array = new Uint8Array(deploymentData);
62
- await fs.promises.writeFile(tarPath, uint8Array);
63
- try {
64
- // Extract tar file
65
- extractTar({
66
- C: functionDir,
67
- file: tarPath,
68
- sync: true,
69
- });
70
- return {
71
- path: functionDir,
72
- function: functionInfo,
73
- deployment: latestDeployment,
74
- };
75
- }
76
- finally {
77
- // Clean up tar file
78
- await fs.promises.unlink(tarPath).catch(() => { });
79
- }
80
- };
81
- export const deleteFunction = async (client, functionId) => {
82
- const functions = new Functions(client);
83
- const functionResponse = await functions.delete(functionId);
84
- return functionResponse;
85
- };
86
- export const createFunction = async (client, functionConfig) => {
87
- const functions = new Functions(client);
88
- const functionResponse = await functions.create(functionConfig.$id, functionConfig.name, functionConfig.runtime, functionConfig.execute, validateEvents(functionConfig.events), functionConfig.schedule, functionConfig.timeout, functionConfig.enabled, functionConfig.logging, functionConfig.entrypoint, functionConfig.commands, functionConfig.scopes, functionConfig.installationId, functionConfig.providerRepositoryId, functionConfig.providerBranch, functionConfig.providerSilentMode, functionConfig.providerRootDirectory);
89
- return functionResponse;
90
- };
91
- export const updateFunctionSpecifications = async (client, functionId, specification) => {
92
- const curFunction = await listFunctions(client, [
93
- Query.equal("$id", functionId),
94
- ]);
95
- if (curFunction.functions.length === 0) {
96
- throw new Error("Function not found");
97
- }
98
- const functionFound = curFunction.functions[0];
99
- try {
100
- const functionResponse = await updateFunction(client, {
101
- ...functionFound,
102
- runtime: functionFound.runtime,
103
- scopes: functionFound.scopes,
104
- specification: specification,
105
- });
106
- return functionResponse;
107
- }
108
- catch (error) {
109
- if (error instanceof AppwriteException &&
110
- error.message.includes("Invalid `specification`")) {
111
- MessageFormatter.error("Error updating function specifications, please try setting the env variable `_FUNCTIONS_CPUS` and `_FUNCTIONS_RAM` to non-zero values", undefined, { prefix: "Functions" });
112
- }
113
- else {
114
- MessageFormatter.error("Error updating function specifications", error instanceof Error ? error : undefined, { prefix: "Functions" });
115
- throw error;
116
- }
117
- }
118
- };
119
- export const listSpecifications = async (client) => {
120
- const functions = new Functions(client);
121
- const specifications = await functions.listSpecifications();
122
- return specifications;
123
- };
124
- export const listFunctionDeployments = async (client, functionId, queries) => {
125
- const functions = new Functions(client);
126
- const deployments = await functions.listDeployments(functionId, queries);
127
- return deployments;
128
- };
129
- export const updateFunction = async (client, functionConfig) => {
130
- const functions = new Functions(client);
131
- const functionResponse = await functions.update(functionConfig.$id, functionConfig.name, functionConfig.runtime, functionConfig.execute, validateEvents(functionConfig.events), functionConfig.schedule, functionConfig.timeout, functionConfig.enabled, functionConfig.logging, functionConfig.entrypoint, functionConfig.commands, functionConfig.scopes, functionConfig.installationId, functionConfig.providerRepositoryId, functionConfig.providerBranch, functionConfig.providerSilentMode, functionConfig.providerRootDirectory, functionConfig.specification);
132
- return functionResponse;
133
- };
134
- export const createFunctionTemplate = async (templateType, functionName, basePath = "./functions") => {
135
- const expandedBasePath = expandTildePath(basePath);
136
- const functionPath = join(expandedBasePath, functionName);
137
- const currentFileUrl = import.meta.url;
138
- const currentDir = dirname(fileURLToPath(currentFileUrl));
139
- const templatesPath = join(currentDir, "templates", templateType);
140
- // Create function directory
141
- await fs.promises.mkdir(functionPath, { recursive: true });
142
- // Copy template files recursively
143
- const copyTemplateFiles = async (sourcePath, targetPath) => {
144
- const entries = await fs.promises.readdir(sourcePath, {
145
- withFileTypes: true,
146
- });
147
- for (const entry of entries) {
148
- const srcPath = join(sourcePath, entry.name);
149
- const destPath = join(targetPath, entry.name);
150
- if (entry.isDirectory()) {
151
- await fs.promises.mkdir(destPath, { recursive: true });
152
- await copyTemplateFiles(srcPath, destPath);
153
- }
154
- else {
155
- let content = await fs.promises.readFile(srcPath, "utf-8");
156
- // Replace template variables
157
- content = content
158
- .replace(/\{\{functionName\}\}/g, functionName)
159
- .replace(/\{\{databaseId\}\}/g, "{{databaseId}}")
160
- .replace(/\{\{collectionId\}\}/g, "{{collectionId}}");
161
- await fs.promises.writeFile(destPath, content);
162
- }
163
- }
164
- };
165
- try {
166
- await copyTemplateFiles(templatesPath, functionPath);
167
- MessageFormatter.success(`Created ${templateType} function template at ${functionPath}`, { prefix: "Functions" });
168
- }
169
- catch (error) {
170
- MessageFormatter.error("Failed to create function template", error instanceof Error ? error : undefined, { prefix: "Functions" });
171
- throw error;
172
- }
173
- return functionPath;
174
- };
@@ -1,37 +0,0 @@
1
- /**
2
- * Expands tilde (~) in paths to the user's home directory
3
- * @param pathStr - Path string that may contain ~
4
- * @returns Expanded path with home directory
5
- */
6
- export declare function expandTildePath(pathStr: string): string;
7
- /**
8
- * Normalizes function name to standard format (lowercase, dashes instead of spaces)
9
- * @param name - Function name to normalize
10
- * @returns Normalized function name
11
- */
12
- export declare function normalizeFunctionName(name: string): string;
13
- /**
14
- * Validates that a directory exists and contains function markers
15
- * @param dirPath - Directory path to validate
16
- * @returns True if directory is a valid function directory
17
- */
18
- export declare function validateFunctionDirectory(dirPath: string): boolean;
19
- /**
20
- * Helper function to search for function in standard locations
21
- * @param configDirPath - Directory where config file is located
22
- * @param normalizedName - Normalized function name
23
- * @returns First valid function directory path or undefined
24
- */
25
- export declare function findFunctionInStandardLocations(configDirPath: string, normalizedName: string): string | undefined;
26
- /**
27
- * Resolves the absolute path to a function directory
28
- * Handles multiple resolution strategies with proper priority
29
- *
30
- * @param functionName - Name of the function
31
- * @param configDirPath - Directory where config file is located
32
- * @param dirPath - Optional explicit dirPath from config
33
- * @param explicitPath - Optional path passed as parameter (highest priority)
34
- * @returns Absolute path to the function directory
35
- * @throws Error if function directory cannot be found or is invalid
36
- */
37
- export declare function resolveFunctionDirectory(functionName: string, configDirPath: string, dirPath?: string, explicitPath?: string): string;
@@ -1,185 +0,0 @@
1
- import { existsSync, statSync, readdirSync } from 'node:fs';
2
- import { join, resolve, isAbsolute } from 'node:path';
3
- import { homedir } from 'node:os';
4
- import { MessageFormatter } from '../shared/messageFormatter.js';
5
- import { logger } from '../shared/logging.js';
6
- /**
7
- * Expands tilde (~) in paths to the user's home directory
8
- * @param pathStr - Path string that may contain ~
9
- * @returns Expanded path with home directory
10
- */
11
- export function expandTildePath(pathStr) {
12
- if (!pathStr)
13
- return pathStr;
14
- if (pathStr.startsWith('~/') || pathStr === '~') {
15
- const expandedPath = pathStr.replace(/^~(?=$|\/|\\)/, homedir());
16
- logger.debug('Expanded tilde path', { original: pathStr, expanded: expandedPath });
17
- return expandedPath;
18
- }
19
- return pathStr;
20
- }
21
- /**
22
- * Normalizes function name to standard format (lowercase, dashes instead of spaces)
23
- * @param name - Function name to normalize
24
- * @returns Normalized function name
25
- */
26
- export function normalizeFunctionName(name) {
27
- if (!name)
28
- return name;
29
- const normalized = name.toLowerCase().replace(/\s+/g, '-');
30
- if (normalized !== name) {
31
- logger.debug('Normalized function name', { original: name, normalized });
32
- }
33
- return normalized;
34
- }
35
- /**
36
- * Validates that a directory exists and contains function markers
37
- * @param dirPath - Directory path to validate
38
- * @returns True if directory is a valid function directory
39
- */
40
- export function validateFunctionDirectory(dirPath) {
41
- try {
42
- // Check if directory exists
43
- if (!existsSync(dirPath)) {
44
- logger.debug('Directory does not exist', { dirPath });
45
- return false;
46
- }
47
- // Check if it's actually a directory
48
- const stats = statSync(dirPath);
49
- if (!stats.isDirectory()) {
50
- logger.debug('Path is not a directory', { dirPath });
51
- return false;
52
- }
53
- // Check for function markers
54
- const contents = readdirSync(dirPath);
55
- const hasPackageJson = contents.includes('package.json');
56
- const hasPyprojectToml = contents.includes('pyproject.toml');
57
- const hasSrcDir = contents.includes('src');
58
- const isValid = hasPackageJson || hasPyprojectToml || hasSrcDir;
59
- logger.debug('Function directory validation', {
60
- dirPath,
61
- isValid,
62
- markers: {
63
- hasPackageJson,
64
- hasPyprojectToml,
65
- hasSrcDir
66
- }
67
- });
68
- return isValid;
69
- }
70
- catch (error) {
71
- logger.debug('Error validating function directory', {
72
- dirPath,
73
- error: error instanceof Error ? error.message : String(error)
74
- });
75
- return false;
76
- }
77
- }
78
- /**
79
- * Helper function to search for function in standard locations
80
- * @param configDirPath - Directory where config file is located
81
- * @param normalizedName - Normalized function name
82
- * @returns First valid function directory path or undefined
83
- */
84
- export function findFunctionInStandardLocations(configDirPath, normalizedName) {
85
- const searchPaths = [
86
- // Same directory as config
87
- join(configDirPath, 'functions', normalizedName),
88
- // Parent directory of config
89
- join(configDirPath, '..', 'functions', normalizedName),
90
- // Current working directory
91
- join(process.cwd(), 'functions', normalizedName),
92
- ];
93
- logger.debug('Searching for function in standard locations', {
94
- normalizedName,
95
- configDirPath,
96
- searchPaths
97
- });
98
- for (const searchPath of searchPaths) {
99
- const resolvedPath = resolve(searchPath);
100
- logger.debug('Checking search path', { searchPath, resolvedPath });
101
- if (validateFunctionDirectory(resolvedPath)) {
102
- logger.debug('Found function in standard location', { resolvedPath });
103
- return resolvedPath;
104
- }
105
- }
106
- logger.debug('Function not found in any standard location', { normalizedName });
107
- return undefined;
108
- }
109
- /**
110
- * Resolves the absolute path to a function directory
111
- * Handles multiple resolution strategies with proper priority
112
- *
113
- * @param functionName - Name of the function
114
- * @param configDirPath - Directory where config file is located
115
- * @param dirPath - Optional explicit dirPath from config
116
- * @param explicitPath - Optional path passed as parameter (highest priority)
117
- * @returns Absolute path to the function directory
118
- * @throws Error if function directory cannot be found or is invalid
119
- */
120
- export function resolveFunctionDirectory(functionName, configDirPath, dirPath, explicitPath) {
121
- logger.debug('Resolving function directory', {
122
- functionName,
123
- configDirPath,
124
- dirPath,
125
- explicitPath
126
- });
127
- const normalizedName = normalizeFunctionName(functionName);
128
- // Priority 1: Explicit path parameter (highest priority)
129
- if (explicitPath) {
130
- logger.debug('Using explicit path parameter');
131
- const expandedPath = expandTildePath(explicitPath);
132
- const resolvedPath = isAbsolute(expandedPath)
133
- ? expandedPath
134
- : resolve(process.cwd(), expandedPath);
135
- if (!validateFunctionDirectory(resolvedPath)) {
136
- const errorMsg = `Explicit path is not a valid function directory: ${resolvedPath}`;
137
- logger.error(errorMsg);
138
- MessageFormatter.error('Invalid function directory', errorMsg, { prefix: 'Path Resolution' });
139
- throw new Error(errorMsg);
140
- }
141
- logger.debug('Resolved using explicit path', { resolvedPath });
142
- MessageFormatter.debug(`Resolved function directory using explicit path: ${resolvedPath}`, undefined, { prefix: 'Path Resolution' });
143
- return resolvedPath;
144
- }
145
- // Priority 2: dirPath from config (relative to config location)
146
- if (dirPath) {
147
- logger.debug('Using dirPath from config');
148
- const expandedPath = expandTildePath(dirPath);
149
- const resolvedPath = isAbsolute(expandedPath)
150
- ? expandedPath
151
- : resolve(configDirPath, expandedPath);
152
- if (!validateFunctionDirectory(resolvedPath)) {
153
- const errorMsg = `Config dirPath is not a valid function directory: ${resolvedPath}`;
154
- logger.error(errorMsg);
155
- MessageFormatter.error('Invalid function directory', errorMsg, { prefix: 'Path Resolution' });
156
- throw new Error(errorMsg);
157
- }
158
- logger.debug('Resolved using config dirPath', { resolvedPath });
159
- MessageFormatter.debug(`Resolved function directory using config dirPath: ${resolvedPath}`, undefined, { prefix: 'Path Resolution' });
160
- return resolvedPath;
161
- }
162
- // Priority 3: Search standard locations
163
- logger.debug('Searching standard locations for function');
164
- const foundPath = findFunctionInStandardLocations(configDirPath, normalizedName);
165
- if (foundPath) {
166
- logger.debug('Resolved using standard location search', { foundPath });
167
- MessageFormatter.debug(`Found function directory in standard location: ${foundPath}`, undefined, { prefix: 'Path Resolution' });
168
- return foundPath;
169
- }
170
- // Priority 4: Not found - throw error
171
- const searchedLocations = [
172
- join(configDirPath, 'functions', normalizedName),
173
- join(configDirPath, '..', 'functions', normalizedName),
174
- join(process.cwd(), 'functions', normalizedName),
175
- ];
176
- const errorMsg = `Function directory not found for '${functionName}' (normalized: '${normalizedName}'). ` +
177
- `Searched locations:\n${searchedLocations.map(p => ` - ${p}`).join('\n')}`;
178
- logger.error('Function directory not found', {
179
- functionName,
180
- normalizedName,
181
- searchedLocations
182
- });
183
- MessageFormatter.error('Function directory not found', errorMsg, { prefix: 'Path Resolution' });
184
- throw new Error(errorMsg);
185
- }
@@ -1,54 +0,0 @@
1
- # Count Documents in Collection Function
2
-
3
- A utility function that accurately counts documents in an Appwrite collection, even when there are more than 5,000 documents.
4
-
5
- ## Features
6
- - Handles collections with any number of documents
7
- - Supports filtering using Appwrite queries
8
- - Uses efficient binary search algorithm for large collections
9
- - Provides detailed logging during the counting process
10
-
11
- ## Structure
12
- - `src/main.ts`: Main function implementation with counting logic
13
- - `src/request.ts`: Request validation schema using Zod
14
-
15
- ## Usage
16
- Send a POST request with:
17
- ```json
18
- {
19
- "databaseId": "your-database-id",
20
- "collectionId": "your-collection-id",
21
- "queries": [Query.orderDesc("$createdAt"), Query.contains("name", "John")] // Or put the string array from after this, they are the same
22
- }
23
- ```
24
-
25
- ## Response
26
- ```json
27
- {
28
- "success": true,
29
- "count": 12345
30
- }
31
- ```
32
-
33
- ## Development
34
- 1. Install dependencies: `npm|yarn|bun install`
35
- 2. Build: `npm|yarn|bun run build`
36
- 3. Deploy: Function will be built automatically during deployment
37
-
38
- ## Deployment
39
- Make sure it's inside `appwriteConfig.ts` functions array, and if you want to build it FIRST, before Appwrite (using your system), you can
40
- add the `predeployCommands` to the function in `appwriteConfig.ts`.
41
-
42
- ## Example Config
43
- ```typescript
44
- {
45
- $id: 'count-docs',
46
- name: 'Count Documents',
47
- runtime: 'node-18.0',
48
- path: 'functions/count-docs',
49
- entrypoint: './main.js',
50
- execute: ['any'],
51
- predeployCommands: ['npm install', 'npm run build'],
52
- deployDir: './dist'
53
- }
54
- ```
@@ -1,25 +0,0 @@
1
- {
2
- "name": "{{functionName}}",
3
- "version": "1.0.0",
4
- "description": "Appwrite function to count documents in a collection",
5
- "main": "src/main.ts",
6
- "type": "module",
7
- "scripts": {
8
- "build": "tsc",
9
- "start": "node dist/main.js",
10
- "dev": "tsx src/main.ts"
11
- },
12
- "dependencies": {
13
- "node-appwrite": "^13.0.0",
14
- "appwrite-utils": "latest",
15
- "zod": "^3.23.0"
16
- },
17
- "devDependencies": {
18
- "@types/node": "^20.0.0",
19
- "typescript": "^5.0.0",
20
- "tsx": "^4.0.0"
21
- },
22
- "engines": {
23
- "node": ">=18.0.0"
24
- }
25
- }
@@ -1,159 +0,0 @@
1
- import { Client, Databases, Query } from "node-appwrite";
2
- import { AppwriteRequest, type AppwriteResponse } from "appwrite-utils";
3
- import { requestSchema } from "./request.js";
4
-
5
- /**
6
- * Main function to handle document counting requests.
7
- * @param {Object} params - The function parameters.
8
- * @param {Object} params.req - The request object.
9
- * @param {Object} params.res - The response object.
10
- * @param {Function} params.log - Logging function.
11
- * @param {Function} params.error - Error logging function.
12
- * @returns {Promise<Object>} JSON response with count or error message.
13
- */
14
- export default async ({
15
- req,
16
- res,
17
- log,
18
- error,
19
- }: {
20
- req: AppwriteRequest;
21
- res: AppwriteResponse;
22
- log: (message: string) => void;
23
- error: (message: string) => void;
24
- }) => {
25
- // Initialize Appwrite client
26
- const client = new Client()
27
- .setEndpoint(process.env["APPWRITE_FUNCTION_ENDPOINT"]!)
28
- .setProject(process.env["APPWRITE_FUNCTION_PROJECT_ID"]!)
29
- .setKey(req.headers["x-appwrite-key"] || "");
30
-
31
- const databases = new Databases(client);
32
-
33
- try {
34
- if (req.method === "POST") {
35
- // Parse request body
36
- const body = requestSchema.safeParse(
37
- typeof req.body === "string" ? JSON.parse(req.body) : req.body
38
- );
39
-
40
- if (!body.success) {
41
- return res.json({ success: false, error: body.error }, 400);
42
- }
43
-
44
- const { databaseId, collectionId, queries = [] } = body.data;
45
-
46
- log(`Queries: ${JSON.stringify(queries)}`);
47
-
48
- // Count documents in the specified collection
49
- const count = await countAllDocuments(
50
- log,
51
- databases,
52
- databaseId,
53
- collectionId,
54
- queries
55
- );
56
-
57
- // Return successful response with document count
58
- return res.json({
59
- success: true,
60
- count: count,
61
- });
62
- } else {
63
- // Return error for non-POST requests
64
- return res.json({ success: false, error: "Method not allowed" }, 405);
65
- }
66
- } catch (err) {
67
- // Log and return any errors
68
- error(`Error processing request: ${err}`);
69
- return res.json({ success: false, error: (err as Error).message }, 500);
70
- }
71
- };
72
-
73
- /**
74
- * Counts all documents in a collection, handling large collections efficiently.
75
- * @param {Function} log - Logging function.
76
- * @param {Databases} databases - Appwrite Databases instance.
77
- * @param {string} databaseId - ID of the database.
78
- * @param {string} collectionId - ID of the collection.
79
- * @param {string[]} queries - Array of query strings to filter documents.
80
- * @param {number} batchSize - Size of batches for processing (default: 1000).
81
- * @returns {Promise<number>} Total count of documents.
82
- */
83
- async function countAllDocuments(
84
- log: any,
85
- databases: Databases,
86
- databaseId: string,
87
- collectionId: string,
88
- queries: string[] = [],
89
- batchSize: number = 1000
90
- ): Promise<number> {
91
- // Filter out limit and offset queries
92
- const initialQueries = queries.filter(
93
- (q) => !(q.includes("limit") || q.includes("offset"))
94
- );
95
-
96
- // Initial query to check if total is less than 5000
97
- const initialResponse = await databases.listDocuments(
98
- databaseId,
99
- collectionId,
100
- [...initialQueries, Query.limit(1)]
101
- );
102
-
103
- if (initialResponse.total < 5000) {
104
- log(`Total documents (from initial response): ${initialResponse.total}`);
105
- return initialResponse.total;
106
- }
107
-
108
- // If total is 5000 or more, we need to count manually
109
- let bound = 5000;
110
-
111
- // Exponential search to find an upper bound
112
- while (true) {
113
- log(`Querying for offset ${bound}`);
114
- try {
115
- const response = await databases.listDocuments(databaseId, collectionId, [
116
- ...initialQueries,
117
- Query.limit(1),
118
- Query.offset(bound),
119
- ]);
120
-
121
- if (response.documents.length === 0) {
122
- break;
123
- }
124
- bound *= 2;
125
- } catch (error) {
126
- break;
127
- }
128
- }
129
-
130
- // Binary search to find the exact count
131
- let low = Math.floor(bound / 2);
132
- let high = bound;
133
- let lastValidCount = low;
134
-
135
- while (low <= high) {
136
- const mid = Math.floor((low + high) / 2);
137
- log(`Binary search: Querying for offset ${mid}`);
138
-
139
- try {
140
- const response = await databases.listDocuments(databaseId, collectionId, [
141
- ...initialQueries,
142
- Query.limit(1),
143
- Query.offset(mid),
144
- ]);
145
-
146
- if (response.documents.length > 0) {
147
- lastValidCount = mid + 1; // +1 because offset is 0-based
148
- low = mid + 1;
149
- } else {
150
- high = mid - 1;
151
- }
152
- } catch (error) {
153
- high = mid - 1;
154
- }
155
- }
156
-
157
- log(`Total documents: ${lastValidCount}`);
158
- return lastValidCount;
159
- }
@@ -1,9 +0,0 @@
1
- import { z } from "zod";
2
-
3
- export const requestSchema = z.object({
4
- databaseId: z.string(),
5
- collectionId: z.string(),
6
- queries: z.array(z.string()).optional(),
7
- });
8
-
9
- export type Request = z.infer<typeof requestSchema>;