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,6 +0,0 @@
1
- import { Databases, type Models } from "node-appwrite";
2
- export declare const fetchAllDatabases: (database: Databases) => Promise<Models.Database[]>;
3
- export declare const wipeDatabase: (database: Databases, databaseId: string) => Promise<{
4
- collectionId: string;
5
- collectionName: string;
6
- }[]>;
@@ -1,35 +0,0 @@
1
- import { Databases, Query } from "node-appwrite";
2
- import { delay, tryAwaitWithRetry } from "../utils/helperFunctions.js";
3
- import { fetchAllCollections } from "../collections/methods.js";
4
- import { MessageFormatter } from "../shared/messageFormatter.js";
5
- export const fetchAllDatabases = async (database) => {
6
- const databases = await tryAwaitWithRetry(async () => await database.list([Query.limit(25)]));
7
- const allDatabases = databases.databases;
8
- if (allDatabases.length === 0)
9
- return [];
10
- let lastDatabaseId = allDatabases[allDatabases.length - 1].$id;
11
- while (databases.databases.length === 25) {
12
- const moreDatabases = await database.list([
13
- Query.limit(25),
14
- Query.cursorAfter(lastDatabaseId),
15
- ]);
16
- allDatabases.push(...moreDatabases.databases);
17
- if (moreDatabases.databases.length < 25)
18
- break;
19
- lastDatabaseId =
20
- moreDatabases.databases[moreDatabases.databases.length - 1].$id;
21
- }
22
- return allDatabases;
23
- };
24
- export const wipeDatabase = async (database, databaseId) => {
25
- MessageFormatter.info(`Wiping database: ${databaseId}`, { prefix: "Database" });
26
- const existingCollections = await fetchAllCollections(databaseId, database);
27
- let collectionsDeleted = [];
28
- for (const { $id: collectionId, name } of existingCollections) {
29
- MessageFormatter.info(`Deleting collection: ${collectionId}`, { prefix: "Database" });
30
- collectionsDeleted.push({ collectionId, collectionName: name });
31
- await tryAwaitWithRetry(async () => await database.deleteCollection(databaseId, collectionId));
32
- await delay(100);
33
- }
34
- return collectionsDeleted;
35
- };
@@ -1,5 +0,0 @@
1
- import { Databases, type Models } from "node-appwrite";
2
- import { type AppwriteConfig } from "appwrite-utils";
3
- export declare const ensureDatabasesExist: (config: AppwriteConfig, databasesToEnsure?: Models.Database[]) => Promise<void>;
4
- export declare const wipeOtherDatabases: (database: Databases, databasesToKeep: Models.Database[]) => Promise<void>;
5
- export declare const ensureCollectionsExist: (config: AppwriteConfig, database: Models.Database, collectionsToEnsure?: Models.Collection[]) => Promise<void>;
@@ -1,45 +0,0 @@
1
- import { Databases, Query } from "node-appwrite";
2
- import { tryAwaitWithRetry } from "../utils/index.js";
3
- import {} from "appwrite-utils";
4
- import { ulid } from "ulidx";
5
- import { MessageFormatter } from "../shared/messageFormatter.js";
6
- export const ensureDatabasesExist = async (config, databasesToEnsure) => {
7
- if (!config.appwriteClient) {
8
- throw new Error("Appwrite client is not initialized in the config");
9
- }
10
- const database = new Databases(config.appwriteClient);
11
- const databasesToCreate = databasesToEnsure || config.databases || [];
12
- if (!databasesToCreate.length) {
13
- MessageFormatter.info("No databases to create");
14
- return;
15
- }
16
- const existingDatabases = await tryAwaitWithRetry(async () => await database.list([Query.limit(500)]));
17
- for (const db of databasesToCreate) {
18
- if (!existingDatabases.databases.some((d) => d.name === db.name)) {
19
- await tryAwaitWithRetry(async () => await database.create(db.$id || ulid(), db.name, true));
20
- MessageFormatter.success(`${db.name} database created`);
21
- }
22
- }
23
- };
24
- export const wipeOtherDatabases = async (database, databasesToKeep) => {
25
- MessageFormatter.info(`Databases to keep: ${databasesToKeep.map(db => db.name).join(", ")}`);
26
- const allDatabases = await tryAwaitWithRetry(async () => await database.list([Query.limit(500)]));
27
- for (const db of allDatabases.databases) {
28
- if (!databasesToKeep.some((d) => d.name === db.name)) {
29
- await tryAwaitWithRetry(async () => await database.delete(db.$id));
30
- MessageFormatter.success(`Deleted database: ${db.name}`);
31
- }
32
- }
33
- };
34
- export const ensureCollectionsExist = async (config, database, collectionsToEnsure) => {
35
- const databaseClient = new Databases(config.appwriteClient);
36
- const collectionsToCreate = collectionsToEnsure ||
37
- (config.collections ? config.collections : []);
38
- const existingCollections = await tryAwaitWithRetry(async () => await databaseClient.listCollections(database.$id, [Query.limit(500)]));
39
- for (const collection of collectionsToCreate) {
40
- if (!existingCollections.collections.some((c) => c.name === collection.name)) {
41
- await tryAwaitWithRetry(async () => await databaseClient.createCollection(database.$id, ulid(), collection.name, undefined, true, true));
42
- MessageFormatter.success(`${collection.name} collection created in ${database.name}`);
43
- }
44
- }
45
- };
@@ -1,42 +0,0 @@
1
- /**
2
- * Example demonstrating YAML import/export with dual terminology support
3
- *
4
- * This example shows how to:
5
- * 1. Generate YAML files for both collections and tables
6
- * 2. Load and convert between terminologies
7
- * 3. Validate terminology consistency
8
- * 4. Migrate between formats
9
- */
10
- import { type CollectionCreate } from "appwrite-utils";
11
- /**
12
- * Example 1: Generate YAML templates for both collection and table formats
13
- */
14
- export declare function generateTemplateExamples(outputDir: string): Promise<void>;
15
- /**
16
- * Example 2: Convert existing collection definition to different formats
17
- */
18
- export declare function convertCollectionFormats(collection: CollectionCreate): void;
19
- /**
20
- * Example 3: Load and process YAML files with mixed terminologies
21
- */
22
- export declare function processYamlFiles(baseDir: string): Promise<void>;
23
- /**
24
- * Example 4: Migrate between terminologies
25
- */
26
- export declare function migrateTerminology(baseDir: string): Promise<void>;
27
- /**
28
- * Example 5: Validate terminology consistency
29
- */
30
- export declare function validateTerminology(baseDir: string): Promise<void>;
31
- /**
32
- * Example 6: Import configuration with terminology support
33
- */
34
- export declare function importConfigurationExample(appwriteFolderPath: string): Promise<void>;
35
- /**
36
- * Example 7: Manual terminology conversion
37
- */
38
- export declare function manualTerminologyConversion(): void;
39
- /**
40
- * Main example runner
41
- */
42
- export declare function runYamlTerminologyExamples(outputDir: string): Promise<void>;
@@ -1,272 +0,0 @@
1
- /**
2
- * Example demonstrating YAML import/export with dual terminology support
3
- *
4
- * This example shows how to:
5
- * 1. Generate YAML files for both collections and tables
6
- * 2. Load and convert between terminologies
7
- * 3. Validate terminology consistency
8
- * 4. Migrate between formats
9
- */
10
- import { collectionToYaml, generateYamlTemplate, generateExampleYamls, convertTerminology, normalizeYamlData, usesTableTerminology } from "../utils/yamlConverter.js";
11
- import { createYamlLoader } from "../utils/yamlLoader.js";
12
- import { YamlImportIntegration } from "../migrations/yaml/YamlImportIntegration.js";
13
- import { createImportSchemas } from "../migrations/yaml/generateImportSchemas.js";
14
- import { CollectionCreateSchema } from "appwrite-utils";
15
- import fs from "fs";
16
- import path from "path";
17
- /**
18
- * Example 1: Generate YAML templates for both collection and table formats
19
- */
20
- export async function generateTemplateExamples(outputDir) {
21
- console.log("🚀 Generating YAML template examples...");
22
- // Ensure output directories exist
23
- const collectionsDir = path.join(outputDir, "collections");
24
- const tablesDir = path.join(outputDir, "tables");
25
- [collectionsDir, tablesDir].forEach(dir => {
26
- if (!fs.existsSync(dir)) {
27
- fs.mkdirSync(dir, { recursive: true });
28
- }
29
- });
30
- // Generate schemas first
31
- await createImportSchemas(outputDir);
32
- // Generate examples for both formats
33
- const examples = generateExampleYamls("Product");
34
- // Save collection format
35
- const collectionPath = path.join(collectionsDir, "Product.yaml");
36
- fs.writeFileSync(collectionPath, examples.collection);
37
- console.log(`✅ Generated collection YAML: ${collectionPath}`);
38
- // Save table format
39
- const tablePath = path.join(tablesDir, "Product.yaml");
40
- fs.writeFileSync(tablePath, examples.table);
41
- console.log(`✅ Generated table YAML: ${tablePath}`);
42
- }
43
- /**
44
- * Example 2: Convert existing collection definition to different formats
45
- */
46
- export function convertCollectionFormats(collection) {
47
- console.log("🔄 Converting collection to different YAML formats...");
48
- // Generate collection format YAML
49
- const collectionConfig = {
50
- useTableTerminology: false,
51
- entityType: 'collection',
52
- schemaPath: "../.yaml_schemas/collection.schema.json"
53
- };
54
- const collectionYaml = collectionToYaml(collection, collectionConfig);
55
- console.log("📄 Collection Format YAML:");
56
- console.log(collectionYaml);
57
- console.log("");
58
- // Generate table format YAML
59
- const tableConfig = {
60
- useTableTerminology: true,
61
- entityType: 'table',
62
- schemaPath: "../.yaml_schemas/table.schema.json"
63
- };
64
- const tableYaml = collectionToYaml(collection, tableConfig);
65
- console.log("📄 Table Format YAML:");
66
- console.log(tableYaml);
67
- }
68
- /**
69
- * Example 3: Load and process YAML files with mixed terminologies
70
- */
71
- export async function processYamlFiles(baseDir) {
72
- console.log("📂 Processing YAML files with terminology support...");
73
- const yamlLoader = createYamlLoader(baseDir);
74
- // Load all YAML files from collections directory
75
- const collectionsResult = await yamlLoader.loadDirectoryYamls("collections");
76
- console.log(`📊 Collections Summary:`, collectionsResult.summary);
77
- // Load all YAML files from tables directory
78
- const tablesResult = await yamlLoader.loadDirectoryYamls("tables");
79
- console.log(`📊 Tables Summary:`, tablesResult.summary);
80
- // Process each file and show terminology detection
81
- console.log("\\n🔍 File Analysis:");
82
- [...collectionsResult.collections, ...tablesResult.collections].forEach(file => {
83
- const terminology = file.originalTerminology;
84
- const hasColumns = usesTableTerminology(file.data);
85
- console.log(` ${file.filePath}: ${terminology} format (uses table terminology: ${hasColumns})`);
86
- });
87
- }
88
- /**
89
- * Example 4: Migrate between terminologies
90
- */
91
- export async function migrateTerminology(baseDir) {
92
- console.log("🔄 Migrating between terminologies...");
93
- const yamlLoader = createYamlLoader(baseDir);
94
- // Migrate collections to table format
95
- console.log("\\n📤 Migrating collections to table format...");
96
- const collectionToTableResult = await yamlLoader.migrateTerminology("collections", "migrated/tables", true // to table terminology
97
- );
98
- console.log(`✅ Migration complete: ${collectionToTableResult.migrated} migrated, ${collectionToTableResult.skipped} skipped`);
99
- if (collectionToTableResult.errors.length > 0) {
100
- console.log(`❌ Errors:`, collectionToTableResult.errors);
101
- }
102
- // Migrate tables to collection format
103
- console.log("\\n📤 Migrating tables to collection format...");
104
- const tableToCollectionResult = await yamlLoader.migrateTerminology("tables", "migrated/collections", false // to collection terminology
105
- );
106
- console.log(`✅ Migration complete: ${tableToCollectionResult.migrated} migrated, ${tableToCollectionResult.skipped} skipped`);
107
- if (tableToCollectionResult.errors.length > 0) {
108
- console.log(`❌ Errors:`, tableToCollectionResult.errors);
109
- }
110
- }
111
- /**
112
- * Example 5: Validate terminology consistency
113
- */
114
- export async function validateTerminology(baseDir) {
115
- console.log("🔍 Validating terminology consistency...");
116
- const yamlLoader = createYamlLoader(baseDir);
117
- // Validate collections directory
118
- const collectionsValidation = await yamlLoader.validateTerminologyConsistency("collections");
119
- console.log("\\n📂 Collections Directory:");
120
- console.log(` Consistent: ${collectionsValidation.isConsistent}`);
121
- console.log(` Summary:`, collectionsValidation.summary);
122
- if (collectionsValidation.issues.length > 0) {
123
- console.log(` Issues:`);
124
- collectionsValidation.issues.forEach(issue => {
125
- console.log(` ${issue.severity.toUpperCase()}: ${issue.file} - ${issue.issue}`);
126
- });
127
- }
128
- // Validate tables directory
129
- const tablesValidation = await yamlLoader.validateTerminologyConsistency("tables");
130
- console.log("\\n📂 Tables Directory:");
131
- console.log(` Consistent: ${tablesValidation.isConsistent}`);
132
- console.log(` Summary:`, tablesValidation.summary);
133
- if (tablesValidation.issues.length > 0) {
134
- console.log(` Issues:`);
135
- tablesValidation.issues.forEach(issue => {
136
- console.log(` ${issue.severity.toUpperCase()}: ${issue.file} - ${issue.issue}`);
137
- });
138
- }
139
- }
140
- /**
141
- * Example 6: Import configuration with terminology support
142
- */
143
- export async function importConfigurationExample(appwriteFolderPath) {
144
- console.log("📥 Import configuration with terminology support...");
145
- const yamlImportIntegration = new YamlImportIntegration(appwriteFolderPath);
146
- // Initialize YAML import system
147
- await yamlImportIntegration.initialize();
148
- // Create example import configurations for both formats
149
- console.log("\\n📝 Creating import configuration templates...");
150
- // Collection format import config
151
- await yamlImportIntegration.createFromTemplate("Users", "users.json", false, // collection terminology
152
- "users-collection-import.yaml");
153
- // Table format import config
154
- await yamlImportIntegration.createFromTemplate("Users", "users.json", true, // table terminology
155
- "users-table-import.yaml");
156
- // Get statistics
157
- const stats = await yamlImportIntegration.getStatistics();
158
- console.log("\\n📊 Import Configuration Statistics:");
159
- console.log(` Total configurations: ${stats.totalConfigurations}`);
160
- console.log(` Collections with configs: ${stats.collectionsWithConfigs}`);
161
- console.log(` Total attribute mappings: ${stats.totalAttributeMappings}`);
162
- console.log(` Total relationship mappings: ${stats.totalRelationshipMappings}`);
163
- }
164
- /**
165
- * Example 7: Manual terminology conversion
166
- */
167
- export function manualTerminologyConversion() {
168
- console.log("🔧 Manual terminology conversion example...");
169
- // Sample YAML data with collection terminology
170
- const collectionData = {
171
- name: "Product",
172
- id: "product",
173
- attributes: [
174
- {
175
- key: "name",
176
- type: "string",
177
- required: true,
178
- relatedCollection: "Categories"
179
- }
180
- ],
181
- indexes: [
182
- {
183
- key: "name_index",
184
- type: "key",
185
- attributes: ["name"]
186
- }
187
- ]
188
- };
189
- console.log("\\n📝 Original (Collection format):");
190
- console.log(JSON.stringify(collectionData, null, 2));
191
- // Convert to table terminology
192
- const tableData = convertTerminology(collectionData, true);
193
- console.log("\\n🔄 Converted to Table format:");
194
- console.log(JSON.stringify(tableData, null, 2));
195
- // Convert back to collection terminology
196
- const normalizedData = normalizeYamlData(tableData);
197
- console.log("\\n↩️ Normalized back to Collection format:");
198
- console.log(JSON.stringify(normalizedData, null, 2));
199
- // Terminology detection
200
- console.log("\\n🔍 Terminology Detection:");
201
- console.log(` Original uses table terminology: ${usesTableTerminology(collectionData)}`);
202
- console.log(` Converted uses table terminology: ${usesTableTerminology(tableData)}`);
203
- console.log(` Normalized uses table terminology: ${usesTableTerminology(normalizedData)}`);
204
- }
205
- /**
206
- * Main example runner
207
- */
208
- export async function runYamlTerminologyExamples(outputDir) {
209
- console.log("🎯 Running YAML Terminology Examples\\n");
210
- try {
211
- // Example collection for demonstrations
212
- const exampleCollectionInput = {
213
- name: "Product",
214
- $id: "product",
215
- enabled: true,
216
- documentSecurity: false,
217
- $permissions: [],
218
- attributes: [
219
- {
220
- key: "name",
221
- type: "string",
222
- required: true,
223
- size: 255
224
- },
225
- {
226
- key: "price",
227
- type: "double",
228
- required: true,
229
- min: 0
230
- },
231
- {
232
- key: "categoryId",
233
- type: "relationship",
234
- relationType: "manyToOne",
235
- relatedCollection: "Categories",
236
- twoWay: false,
237
- onDelete: "setNull",
238
- required: false
239
- }
240
- ],
241
- indexes: [
242
- {
243
- key: "name_index",
244
- type: "key",
245
- attributes: ["name"]
246
- }
247
- ],
248
- importDefs: []
249
- };
250
- const exampleCollection = CollectionCreateSchema.parse(exampleCollectionInput);
251
- // Run examples
252
- await generateTemplateExamples(outputDir);
253
- console.log("\\n" + "=".repeat(60) + "\\n");
254
- convertCollectionFormats(exampleCollection);
255
- console.log("\\n" + "=".repeat(60) + "\\n");
256
- await processYamlFiles(outputDir);
257
- console.log("\\n" + "=".repeat(60) + "\\n");
258
- await migrateTerminology(outputDir);
259
- console.log("\\n" + "=".repeat(60) + "\\n");
260
- await validateTerminology(outputDir);
261
- console.log("\\n" + "=".repeat(60) + "\\n");
262
- await importConfigurationExample(outputDir);
263
- console.log("\\n" + "=".repeat(60) + "\\n");
264
- manualTerminologyConversion();
265
- console.log("\\n🎉 All examples completed successfully!");
266
- }
267
- catch (error) {
268
- console.error("❌ Error running examples:", error);
269
- throw error;
270
- }
271
- }
272
- // Note: Functions are already exported above with their declarations
@@ -1,4 +0,0 @@
1
- import { Client, type Models } from "node-appwrite";
2
- import { type AppwriteFunction } from "appwrite-utils";
3
- export declare const deployFunction: (client: Client, functionId: string, codePath: string, activate?: boolean, entrypoint?: string, commands?: string, ignored?: string[]) => Promise<Models.Deployment>;
4
- export declare const deployLocalFunction: (client: Client, functionName: string, functionConfig: AppwriteFunction, functionPath?: string) => Promise<Models.Deployment>;
@@ -1,146 +0,0 @@
1
- import { Client, Functions, Runtime } from "node-appwrite";
2
- import { InputFile } from "node-appwrite/file";
3
- import { create as createTarball } from "tar";
4
- import { join, relative } from "node:path";
5
- import fs from "node:fs";
6
- import { platform } from "node:os";
7
- import {} from "appwrite-utils";
8
- import chalk from "chalk";
9
- import cliProgress from "cli-progress";
10
- import { execSync } from "child_process";
11
- import { createFunction, getFunction, updateFunction, updateFunctionSpecifications, } from "./methods.js";
12
- import ignore from "ignore";
13
- import { MessageFormatter } from "../shared/messageFormatter.js";
14
- import { resolveFunctionDirectory, validateFunctionDirectory } from './pathResolution.js';
15
- export const deployFunction = async (client, functionId, codePath, activate = true, entrypoint = "index.js", commands = "npm install", ignored = [
16
- "node_modules",
17
- ".git",
18
- ".vscode",
19
- ".DS_Store",
20
- "__pycache__",
21
- ".venv",
22
- ]) => {
23
- const functions = new Functions(client);
24
- MessageFormatter.processing("Preparing function deployment...", { prefix: "Deployment" });
25
- // Convert ignored patterns to lowercase for case-insensitive comparison
26
- const ignoredLower = ignored.map((pattern) => pattern.toLowerCase());
27
- const tarPath = join(process.cwd(), `function-${functionId}.tar.gz`);
28
- // Verify codePath exists and is a directory
29
- if (!fs.existsSync(codePath)) {
30
- throw new Error(`Function directory not found at ${codePath}`);
31
- }
32
- const stats = await fs.promises.stat(codePath);
33
- if (!stats.isDirectory()) {
34
- throw new Error(`${codePath} is not a directory`);
35
- }
36
- MessageFormatter.processing(`Creating tarball from ${codePath}`, { prefix: "Deployment" });
37
- const progressBar = new cliProgress.SingleBar({
38
- format: "Uploading |" +
39
- chalk.cyan("{bar}") +
40
- "| {percentage}% | {value}/{total} Chunks",
41
- barCompleteChar: "█",
42
- barIncompleteChar: "░",
43
- hideCursor: true,
44
- });
45
- await createTarball({
46
- gzip: true,
47
- file: tarPath,
48
- cwd: codePath,
49
- filter: (path, stat) => {
50
- const relativePath = relative(codePath, join(codePath, path)).toLowerCase();
51
- // Skip if path matches any ignored pattern
52
- if (ignoredLower.some((pattern) => relativePath.startsWith(pattern) ||
53
- relativePath.includes(`/${pattern}`) ||
54
- relativePath.includes(`\\${pattern}`))) {
55
- MessageFormatter.debug(`Ignoring ${path}`, undefined, { prefix: "Deployment" });
56
- return false;
57
- }
58
- return true;
59
- },
60
- }, ["."] // This now only includes contents of codePath since we set cwd to codePath
61
- );
62
- const fileBuffer = await fs.promises.readFile(tarPath);
63
- const fileObject = InputFile.fromBuffer(new Uint8Array(fileBuffer), `function-${functionId}.tar.gz`);
64
- try {
65
- MessageFormatter.processing("Creating deployment...", { prefix: "Deployment" });
66
- // Start with 1 as default total since we don't know the chunk size yet
67
- progressBar.start(1, 0);
68
- const functionResponse = await functions.createDeployment(functionId, fileObject, activate, entrypoint, commands, (progress) => {
69
- const chunks = progress.chunksUploaded;
70
- const total = progress.chunksTotal;
71
- if (chunks !== undefined && total !== undefined) {
72
- // First chunk, initialize the bar with correct total
73
- if (chunks === 0) {
74
- progressBar.start(total || 100, 0);
75
- }
76
- else {
77
- progressBar.update(chunks);
78
- // Check if upload is complete
79
- if (chunks === total) {
80
- progressBar.update(total);
81
- progressBar.stop();
82
- MessageFormatter.success("Upload complete!", { prefix: "Deployment" });
83
- }
84
- }
85
- }
86
- });
87
- // Ensure progress bar completes even if callback never fired
88
- if (progressBar.getProgress() === 0) {
89
- progressBar.update(1);
90
- progressBar.stop();
91
- }
92
- await fs.promises.unlink(tarPath);
93
- return functionResponse;
94
- }
95
- catch (error) {
96
- progressBar.stop();
97
- MessageFormatter.error("Deployment failed", error instanceof Error ? error : undefined, { prefix: "Deployment" });
98
- throw error;
99
- }
100
- };
101
- export const deployLocalFunction = async (client, functionName, functionConfig, functionPath) => {
102
- let functionExists = true;
103
- let functionThatExists;
104
- try {
105
- functionThatExists = await getFunction(client, functionConfig.$id);
106
- }
107
- catch (error) {
108
- functionExists = false;
109
- }
110
- const configDirPath = process.cwd(); // TODO: This should be passed from caller
111
- const resolvedPath = resolveFunctionDirectory(functionName, configDirPath, functionConfig.dirPath, functionPath);
112
- if (!validateFunctionDirectory(resolvedPath)) {
113
- throw new Error(`Function directory is invalid or missing required files: ${resolvedPath}`);
114
- }
115
- if (functionConfig.predeployCommands?.length) {
116
- MessageFormatter.processing("Executing predeploy commands...", { prefix: "Deployment" });
117
- const isWindows = platform() === "win32";
118
- for (const command of functionConfig.predeployCommands) {
119
- try {
120
- MessageFormatter.debug(`Executing: ${command}`, undefined, { prefix: "Deployment" });
121
- execSync(command, {
122
- cwd: resolvedPath,
123
- stdio: "inherit",
124
- shell: isWindows ? "cmd.exe" : "/bin/sh",
125
- windowsHide: true,
126
- });
127
- }
128
- catch (error) {
129
- MessageFormatter.error(`Failed to execute predeploy command: ${command}`, error instanceof Error ? error : undefined, { prefix: "Deployment" });
130
- throw new Error(``);
131
- }
132
- }
133
- }
134
- // Only create function if it doesn't exist
135
- if (!functionExists) {
136
- await createFunction(client, functionConfig);
137
- }
138
- else {
139
- MessageFormatter.processing("Updating function...", { prefix: "Deployment" });
140
- await updateFunction(client, functionConfig);
141
- }
142
- const deployPath = functionConfig.deployDir
143
- ? join(resolvedPath, functionConfig.deployDir)
144
- : resolvedPath;
145
- return deployFunction(client, functionConfig.$id, deployPath, true, functionConfig.entrypoint, functionConfig.commands, functionConfig.ignore);
146
- };
@@ -1,3 +0,0 @@
1
- import { type AppwriteFunction } from 'appwrite-utils';
2
- export declare function discoverFnConfigs(startDir: string): AppwriteFunction[];
3
- export declare function mergeDiscoveredFunctions(central?: AppwriteFunction[], discovered?: AppwriteFunction[]): AppwriteFunction[];
@@ -1,108 +0,0 @@
1
- import fs from 'node:fs';
2
- import path from 'node:path';
3
- import yaml from 'js-yaml';
4
- import { homedir } from 'node:os';
5
- import { AppwriteFunctionSchema } from 'appwrite-utils';
6
- import { shouldIgnoreDirectory } from '../utils/directoryUtils.js';
7
- import { MessageFormatter } from '../shared/messageFormatter.js';
8
- function findGitRoot(startDir) {
9
- let dir = path.resolve(startDir);
10
- while (dir !== path.parse(dir).root) {
11
- if (fs.existsSync(path.join(dir, '.git')))
12
- return dir;
13
- const parent = path.dirname(dir);
14
- if (parent === dir)
15
- break;
16
- dir = parent;
17
- }
18
- return path.resolve(startDir);
19
- }
20
- function expandTilde(p) {
21
- if (!p)
22
- return p;
23
- if (p === '~' || p.startsWith('~/'))
24
- return p.replace(/^~(?=$|\/|\\)/, homedir());
25
- return p;
26
- }
27
- export function discoverFnConfigs(startDir) {
28
- const root = findGitRoot(startDir);
29
- const results = [];
30
- const visit = (dir, depth = 0) => {
31
- if (depth > 5)
32
- return; // cap depth
33
- const base = path.basename(dir);
34
- if (shouldIgnoreDirectory(base))
35
- return;
36
- let entries = [];
37
- try {
38
- entries = fs.readdirSync(dir, { withFileTypes: true });
39
- }
40
- catch {
41
- return;
42
- }
43
- // Check for .fnconfig.yaml / .fnconfig.yml
44
- for (const fname of ['.fnconfig.yaml', '.fnconfig.yml']) {
45
- const cfgPath = path.join(dir, fname);
46
- if (fs.existsSync(cfgPath)) {
47
- try {
48
- const raw = fs.readFileSync(cfgPath, 'utf8');
49
- const data = yaml.load(raw);
50
- const parsed = AppwriteFunctionSchema.parse({
51
- $id: data.id || data.$id,
52
- name: data.name,
53
- runtime: data.runtime,
54
- execute: data.execute || [],
55
- events: data.events || [],
56
- schedule: data.schedule,
57
- timeout: data.timeout,
58
- enabled: data.enabled,
59
- logging: data.logging,
60
- entrypoint: data.entrypoint,
61
- commands: data.commands,
62
- scopes: data.scopes,
63
- installationId: data.installationId,
64
- providerRepositoryId: data.providerRepositoryId,
65
- providerBranch: data.providerBranch,
66
- providerSilentMode: data.providerSilentMode,
67
- providerRootDirectory: data.providerRootDirectory,
68
- templateRepository: data.templateRepository,
69
- templateOwner: data.templateOwner,
70
- templateRootDirectory: data.templateRootDirectory,
71
- templateVersion: data.templateVersion,
72
- specification: data.specification,
73
- dirPath: data.dirPath,
74
- predeployCommands: data.predeployCommands,
75
- deployDir: data.deployDir,
76
- ignore: data.ignore,
77
- });
78
- // Resolve dirPath relative to the config file directory
79
- let dirPath = parsed.dirPath || '.';
80
- dirPath = expandTilde(dirPath);
81
- if (!path.isAbsolute(dirPath))
82
- dirPath = path.resolve(path.dirname(cfgPath), dirPath);
83
- const merged = { ...parsed, dirPath };
84
- results.push(merged);
85
- }
86
- catch (e) {
87
- MessageFormatter.warning(`Failed to parse ${cfgPath}: ${e instanceof Error ? e.message : String(e)}`, { prefix: 'Functions' });
88
- }
89
- }
90
- }
91
- for (const entry of entries) {
92
- if (entry.isDirectory())
93
- visit(path.join(dir, entry.name), depth + 1);
94
- }
95
- };
96
- visit(root, 0);
97
- return results;
98
- }
99
- export function mergeDiscoveredFunctions(central = [], discovered = []) {
100
- const map = new Map();
101
- for (const f of central)
102
- if (f?.$id)
103
- map.set(f.$id, f);
104
- for (const f of discovered)
105
- if (f?.$id)
106
- map.set(f.$id, f); // discovered overrides
107
- return Array.from(map.values());
108
- }