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,24 +0,0 @@
1
- import { z } from "zod";
2
- export declare const AuthUserSchema: z.ZodObject<{
3
- $id: z.ZodString;
4
- $createdAt: z.ZodOptional<z.ZodString>;
5
- $updatedAt: z.ZodOptional<z.ZodString>;
6
- name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
7
- email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
8
- phone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
9
- prefs: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>>;
10
- labels: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
11
- }, z.core.$strip>;
12
- export type AuthUser = z.infer<typeof AuthUserSchema>;
13
- export declare const AuthUserCreateSchema: z.ZodObject<{
14
- email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
15
- name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
16
- $createdAt: z.ZodOptional<z.ZodString>;
17
- $updatedAt: z.ZodOptional<z.ZodString>;
18
- phone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
19
- prefs: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>>;
20
- labels: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
21
- userId: z.ZodOptional<z.ZodString>;
22
- password: z.ZodOptional<z.ZodString>;
23
- }, z.core.$strip>;
24
- export type AuthUserCreate = z.infer<typeof AuthUserCreateSchema>;
@@ -1,17 +0,0 @@
1
- import { z } from "zod";
2
- export const AuthUserSchema = z.object({
3
- $id: z.string(),
4
- $createdAt: z.string().optional(),
5
- $updatedAt: z.string().optional(),
6
- name: z.string().nullish(),
7
- email: z.string().email("Invalid Email Address").nullish(),
8
- phone: z.string().nullish(),
9
- prefs: z.record(z.string(), z.string()).optional().default({}),
10
- labels: z.array(z.string()).optional().default([]),
11
- });
12
- export const AuthUserCreateSchema = AuthUserSchema.omit({
13
- $id: true,
14
- }).extend({
15
- userId: z.string().optional(),
16
- password: z.string().optional(),
17
- });
package/dist/setup.d.ts DELETED
@@ -1,2 +0,0 @@
1
- #!/usr/bin/env node
2
- export {};
package/dist/setup.js DELETED
@@ -1,5 +0,0 @@
1
- #!/usr/bin/env node
2
- import { setupDirsFiles } from "./utils/setupFiles.js";
3
- const args = process.argv.slice(2);
4
- const genExample = args.includes("--example");
5
- setupDirsFiles(genExample);
@@ -1,58 +0,0 @@
1
- import { type ApiMode } from "./utils/versionDetection.js";
2
- /**
3
- * Terminology configuration for API mode-specific naming
4
- */
5
- interface TerminologyConfig {
6
- container: "table" | "collection";
7
- containerName: "Table" | "Collection";
8
- fields: "columns" | "attributes";
9
- fieldName: "Column" | "Attribute";
10
- security: "rowSecurity" | "documentSecurity";
11
- schemaRef: "table.schema.json" | "collection.schema.json";
12
- items: "rows" | "documents";
13
- }
14
- /**
15
- * Detection result with source information
16
- */
17
- interface ApiModeDetectionResult {
18
- apiMode: ApiMode;
19
- useTables: boolean;
20
- detectionSource: "appwrite.json" | "server-version" | "default";
21
- serverVersion?: string;
22
- }
23
- /**
24
- * Get terminology configuration based on API mode
25
- */
26
- export declare function getTerminologyConfig(useTables: boolean): TerminologyConfig;
27
- /**
28
- * Detect API mode using multiple detection sources
29
- * Priority: appwrite.json > server version > default (collections)
30
- */
31
- export declare function detectApiMode(basePath: string): Promise<ApiModeDetectionResult>;
32
- /**
33
- * Create directory structure for Appwrite project
34
- */
35
- export declare function createProjectDirectories(basePath: string, useTables: boolean): {
36
- appwriteFolder: string;
37
- containerFolder: string;
38
- schemaFolder: string;
39
- yamlSchemaFolder: string;
40
- dataFolder: string;
41
- };
42
- /**
43
- * Create example YAML schema file with correct terminology
44
- */
45
- export declare function createExampleSchema(containerFolder: string, terminology: TerminologyConfig): string;
46
- /**
47
- * Create JSON schema for YAML validation
48
- */
49
- export declare function createYamlValidationSchema(yamlSchemaFolder: string, useTables: boolean): string;
50
- /**
51
- * Initialize a new Appwrite project with correct directory structure and terminology
52
- */
53
- export declare function initProject(basePath?: string, forceApiMode?: 'legacy' | 'tablesdb'): Promise<void>;
54
- /**
55
- * Create a new collection or table schema file
56
- */
57
- export declare function createSchema(name: string, basePath?: string, forceApiMode?: 'legacy' | 'tablesdb'): Promise<void>;
58
- export {};
@@ -1,490 +0,0 @@
1
- import { mkdirSync, writeFileSync, existsSync } from "node:fs";
2
- import path from "node:path";
3
- import { ulid } from "ulidx";
4
- import { MessageFormatter } from "./shared/messageFormatter.js";
5
- import { detectAppwriteVersionCached, fetchServerVersion, isVersionAtLeast } from "./utils/versionDetection.js";
6
- import { loadAppwriteProjectConfig, findAppwriteProjectConfig, isTablesDBProject } from "./utils/projectConfig.js";
7
- import { findYamlConfig, generateYamlConfigTemplate } from "./config/yamlConfig.js";
8
- import { loadYamlConfig } from "./config/yamlConfig.js";
9
- import { hasSessionAuth } from "./utils/sessionAuth.js";
10
- /**
11
- * Get terminology configuration based on API mode
12
- */
13
- export function getTerminologyConfig(useTables) {
14
- return useTables
15
- ? {
16
- container: "table",
17
- containerName: "Table",
18
- fields: "columns",
19
- fieldName: "Column",
20
- security: "rowSecurity",
21
- schemaRef: "table.schema.json",
22
- items: "rows"
23
- }
24
- : {
25
- container: "collection",
26
- containerName: "Collection",
27
- fields: "attributes",
28
- fieldName: "Attribute",
29
- security: "documentSecurity",
30
- schemaRef: "collection.schema.json",
31
- items: "documents"
32
- };
33
- }
34
- /**
35
- * Detect API mode using multiple detection sources
36
- * Priority: appwrite.json > server version > default (collections)
37
- */
38
- export async function detectApiMode(basePath) {
39
- let useTables = false;
40
- let detectionSource = "default";
41
- let serverVersion;
42
- try {
43
- // Priority 1: Check for existing appwrite.json project config
44
- const projectConfigPath = findAppwriteProjectConfig(basePath);
45
- if (projectConfigPath) {
46
- const projectConfig = loadAppwriteProjectConfig(projectConfigPath);
47
- if (projectConfig) {
48
- useTables = isTablesDBProject(projectConfig);
49
- detectionSource = "appwrite.json";
50
- MessageFormatter.info(`Detected ${useTables ? 'TablesDB' : 'Collections'} project from ${projectConfigPath}`, { prefix: "Setup" });
51
- return {
52
- apiMode: useTables ? 'tablesdb' : 'legacy',
53
- useTables,
54
- detectionSource
55
- };
56
- }
57
- }
58
- // Priority 2: Try reading existing YAML config for version detection
59
- const yamlPath = findYamlConfig(basePath);
60
- if (yamlPath) {
61
- const cfg = await loadYamlConfig(yamlPath);
62
- if (cfg) {
63
- const endpoint = cfg.appwriteEndpoint;
64
- const projectId = cfg.appwriteProject;
65
- if (hasSessionAuth(endpoint, projectId)) {
66
- MessageFormatter.info("Using session authentication for version detection", { prefix: "Setup" });
67
- }
68
- const ver = await fetchServerVersion(endpoint);
69
- serverVersion = ver || undefined;
70
- if (isVersionAtLeast(ver || undefined, '1.8.0')) {
71
- useTables = true;
72
- detectionSource = "server-version";
73
- MessageFormatter.info(`Detected TablesDB support (Appwrite ${ver})`, { prefix: "Setup" });
74
- }
75
- else {
76
- MessageFormatter.info(`Using Collections API (Appwrite ${ver || 'unknown'})`, { prefix: "Setup" });
77
- }
78
- return {
79
- apiMode: useTables ? 'tablesdb' : 'legacy',
80
- useTables,
81
- detectionSource,
82
- serverVersion
83
- };
84
- }
85
- }
86
- }
87
- catch (error) {
88
- MessageFormatter.warning(`Version detection failed, defaulting to Collections API: ${error instanceof Error ? error.message : String(error)}`, { prefix: "Setup" });
89
- }
90
- // Default to Collections API
91
- return {
92
- apiMode: 'legacy',
93
- useTables: false,
94
- detectionSource: 'default'
95
- };
96
- }
97
- /**
98
- * Create directory structure for Appwrite project
99
- */
100
- export function createProjectDirectories(basePath, useTables) {
101
- const appwriteFolder = path.join(basePath, ".appwrite");
102
- const containerName = useTables ? "tables" : "collections";
103
- const containerFolder = path.join(appwriteFolder, containerName);
104
- const schemaFolder = path.join(appwriteFolder, "schemas");
105
- const yamlSchemaFolder = path.join(appwriteFolder, ".yaml_schemas");
106
- const dataFolder = path.join(appwriteFolder, "importData");
107
- // Create all directories
108
- for (const dir of [appwriteFolder, containerFolder, schemaFolder, yamlSchemaFolder, dataFolder]) {
109
- if (!existsSync(dir)) {
110
- mkdirSync(dir, { recursive: true });
111
- }
112
- }
113
- return {
114
- appwriteFolder,
115
- containerFolder,
116
- schemaFolder,
117
- yamlSchemaFolder,
118
- dataFolder
119
- };
120
- }
121
- /**
122
- * Create example YAML schema file with correct terminology
123
- */
124
- export function createExampleSchema(containerFolder, terminology) {
125
- const yamlExample = `# yaml-language-server: $schema=../.yaml_schemas/${terminology.schemaRef}
126
- # Example ${terminology.containerName} Definition
127
- name: Example${terminology.containerName}
128
- id: example_${terminology.container}_${Date.now()}
129
- ${terminology.security}: false
130
- enabled: true
131
- permissions:
132
- - permission: read
133
- target: any
134
- - permission: create
135
- target: users
136
- - permission: update
137
- target: users
138
- - permission: delete
139
- target: users
140
- ${terminology.fields}:
141
- - key: title
142
- type: string
143
- size: 255
144
- required: true
145
- description: "The title of the item"
146
- - key: description
147
- type: string
148
- size: 1000
149
- required: false
150
- description: "A longer description"
151
- - key: isActive
152
- type: boolean
153
- required: false
154
- default: true${terminology.container === 'table' ? `
155
- - key: uniqueCode
156
- type: string
157
- size: 50
158
- required: false
159
- unique: true
160
- description: "Unique identifier code (TablesDB feature)"` : ''}
161
- indexes:
162
- - key: title_search
163
- type: fulltext
164
- attributes:
165
- - title
166
- importDefs: []
167
- `;
168
- const examplePath = path.join(containerFolder, `Example${terminology.containerName}.yaml`);
169
- writeFileSync(examplePath, yamlExample);
170
- MessageFormatter.info(`Created example ${terminology.container} definition with ${terminology.fields} terminology`, { prefix: "Setup" });
171
- return examplePath;
172
- }
173
- /**
174
- * Create JSON schema for YAML validation
175
- */
176
- export function createYamlValidationSchema(yamlSchemaFolder, useTables) {
177
- const schemaFileName = useTables ? "table.schema.json" : "collection.schema.json";
178
- const containerType = useTables ? "Table" : "Collection";
179
- const fieldsName = useTables ? "columns" : "attributes";
180
- const fieldsDescription = useTables ? "Table columns (fields)" : "Collection attributes (fields)";
181
- const securityField = useTables ? "rowSecurity" : "documentSecurity";
182
- const securityDescription = useTables ? "Enable row-level permissions" : "Enable document-level permissions";
183
- const itemType = useTables ? "row" : "document";
184
- const schema = {
185
- "$schema": "https://json-schema.org/draft/2020-12/schema",
186
- "$id": `https://appwrite-utils.dev/schemas/${schemaFileName}`,
187
- "title": `Appwrite ${containerType} Definition`,
188
- "description": `Schema for defining Appwrite ${useTables ? 'tables' : 'collections'} in YAML${useTables ? ' (TablesDB API)' : ''}`,
189
- "type": "object",
190
- "properties": {
191
- "name": {
192
- "type": "string",
193
- "description": `The name of the ${useTables ? 'table' : 'collection'}`
194
- },
195
- "id": {
196
- "type": "string",
197
- "description": `The ID of the ${useTables ? 'table' : 'collection'} (optional, auto-generated if not provided)`,
198
- "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]{0,35}$"
199
- },
200
- [securityField]: {
201
- "type": "boolean",
202
- "default": false,
203
- "description": securityDescription
204
- },
205
- "enabled": {
206
- "type": "boolean",
207
- "default": true,
208
- "description": `Whether the ${useTables ? 'table' : 'collection'} is enabled`
209
- },
210
- "permissions": {
211
- "type": "array",
212
- "description": `${containerType}-level permissions`,
213
- "items": {
214
- "type": "object",
215
- "properties": {
216
- "permission": {
217
- "type": "string",
218
- "enum": ["read", "create", "update", "delete"],
219
- "description": "The permission type"
220
- },
221
- "target": {
222
- "type": "string",
223
- "description": "Permission target (e.g., 'any', 'users', 'users/verified', 'label:admin')"
224
- }
225
- },
226
- "required": ["permission", "target"],
227
- "additionalProperties": false
228
- }
229
- },
230
- [fieldsName]: {
231
- "type": "array",
232
- "description": fieldsDescription,
233
- "items": {
234
- "type": "object",
235
- "properties": {
236
- "key": {
237
- "type": "string",
238
- "description": `${useTables ? 'Column' : 'Attribute'} name`,
239
- "pattern": "^[a-zA-Z][a-zA-Z0-9]*$"
240
- },
241
- "type": {
242
- "type": "string",
243
- "enum": ["string", "integer", "double", "boolean", "datetime", "email", "ip", "url", "enum", "relationship"],
244
- "description": `${useTables ? 'Column' : 'Attribute'} data type`
245
- },
246
- "size": {
247
- "type": "number",
248
- "description": `Maximum size for string ${useTables ? 'columns' : 'attributes'}`,
249
- "minimum": 1,
250
- "maximum": 1073741824
251
- },
252
- "required": {
253
- "type": "boolean",
254
- "default": false,
255
- "description": `Whether the ${useTables ? 'column' : 'attribute'} is required`
256
- },
257
- "array": {
258
- "type": "boolean",
259
- "default": false,
260
- "description": `Whether the ${useTables ? 'column' : 'attribute'} is an array`
261
- },
262
- // Encryption flag for string types
263
- "encrypt": {
264
- "type": "boolean",
265
- "default": false,
266
- "description": `Enable encryption for string ${useTables ? 'columns' : 'attributes'}`
267
- },
268
- ...(useTables ? {
269
- "unique": {
270
- "type": "boolean",
271
- "default": false,
272
- "description": "Whether the column values must be unique (TablesDB feature)"
273
- }
274
- } : {}),
275
- "default": {
276
- "description": `Default value for the ${useTables ? 'column' : 'attribute'}`
277
- },
278
- "description": {
279
- "type": "string",
280
- "description": `${useTables ? 'Column' : 'Attribute'} description`
281
- },
282
- "min": {
283
- "type": "number",
284
- "description": `Minimum value for numeric ${useTables ? 'columns' : 'attributes'}`
285
- },
286
- "max": {
287
- "type": "number",
288
- "description": `Maximum value for numeric ${useTables ? 'columns' : 'attributes'}`
289
- },
290
- "elements": {
291
- "type": "array",
292
- "items": {
293
- "type": "string"
294
- },
295
- "description": `Allowed values for enum ${useTables ? 'columns' : 'attributes'}`
296
- },
297
- "relatedCollection": {
298
- "type": "string",
299
- "description": `Related ${useTables ? 'table' : 'collection'} name for relationship ${useTables ? 'columns' : 'attributes'}`
300
- },
301
- "relationType": {
302
- "type": "string",
303
- "enum": ["oneToOne", "oneToMany", "manyToOne", "manyToMany"],
304
- "description": "Type of relationship"
305
- },
306
- "twoWay": {
307
- "type": "boolean",
308
- "description": "Whether the relationship is bidirectional"
309
- },
310
- "twoWayKey": {
311
- "type": "string",
312
- "description": "Key name for the reverse relationship"
313
- },
314
- "onDelete": {
315
- "type": "string",
316
- "enum": ["cascade", "restrict", "setNull"],
317
- "description": `Action to take when related ${itemType} is deleted`
318
- },
319
- "side": {
320
- "type": "string",
321
- "enum": ["parent", "child"],
322
- "description": "Side of the relationship"
323
- }
324
- },
325
- "required": ["key", "type"],
326
- "additionalProperties": false,
327
- "allOf": [
328
- {
329
- "if": {
330
- "properties": { "type": { "const": "enum" } }
331
- },
332
- "then": {
333
- "required": ["elements"]
334
- }
335
- },
336
- {
337
- "if": {
338
- "properties": { "type": { "const": "relationship" } }
339
- },
340
- "then": {
341
- "required": ["relatedCollection", "relationType"]
342
- }
343
- }
344
- ]
345
- }
346
- },
347
- "indexes": {
348
- "type": "array",
349
- "description": `Database indexes for the ${useTables ? 'table' : 'collection'}`,
350
- "items": {
351
- "type": "object",
352
- "properties": {
353
- "key": {
354
- "type": "string",
355
- "description": "Index name"
356
- },
357
- "type": {
358
- "type": "string",
359
- "enum": ["key", "fulltext", "unique"],
360
- "description": "Index type"
361
- },
362
- "attributes": {
363
- "type": "array",
364
- "items": {
365
- "type": "string"
366
- },
367
- "description": `${useTables ? 'Columns' : 'Attributes'} to index`,
368
- "minItems": 1
369
- },
370
- "orders": {
371
- "type": "array",
372
- "items": {
373
- "type": "string",
374
- "enum": ["ASC", "DESC"]
375
- },
376
- "description": `Sort order for each ${useTables ? 'column' : 'attribute'}`
377
- }
378
- },
379
- "required": ["key", "type", "attributes"],
380
- "additionalProperties": false
381
- }
382
- },
383
- "importDefs": {
384
- "type": "array",
385
- "description": "Import definitions for data migration",
386
- "default": []
387
- }
388
- },
389
- "required": ["name"],
390
- "additionalProperties": false
391
- };
392
- const schemaPath = path.join(yamlSchemaFolder, schemaFileName);
393
- writeFileSync(schemaPath, JSON.stringify(schema, null, 2));
394
- return schemaPath;
395
- }
396
- /**
397
- * Initialize a new Appwrite project with correct directory structure and terminology
398
- */
399
- export async function initProject(basePath, forceApiMode) {
400
- const projectPath = basePath || process.cwd();
401
- // Detect API mode
402
- const detection = forceApiMode
403
- ? {
404
- apiMode: forceApiMode,
405
- useTables: forceApiMode === 'tablesdb',
406
- detectionSource: 'forced',
407
- }
408
- : await detectApiMode(projectPath);
409
- const { useTables, detectionSource } = detection;
410
- const terminology = getTerminologyConfig(useTables);
411
- // Create directory structure
412
- const dirs = createProjectDirectories(projectPath, useTables);
413
- // Generate YAML config
414
- const configPath = path.join(dirs.appwriteFolder, "config.yaml");
415
- generateYamlConfigTemplate(configPath);
416
- // Create example schema file
417
- createExampleSchema(dirs.containerFolder, terminology);
418
- // Create JSON validation schema
419
- createYamlValidationSchema(dirs.yamlSchemaFolder, useTables);
420
- // Success messages
421
- const containerType = useTables ? "TablesDB" : "Collections";
422
- MessageFormatter.success(`Created YAML config and setup files/directories in .appwrite/ folder.`, { prefix: "Setup" });
423
- MessageFormatter.info(`Project configured for ${containerType} API (${detectionSource} detection)`, { prefix: "Setup" });
424
- MessageFormatter.info("You can now configure your project in .appwrite/config.yaml", { prefix: "Setup" });
425
- MessageFormatter.info(`${terminology.containerName}s can be defined in .appwrite/${terminology.container}s/ as .yaml files`, { prefix: "Setup" });
426
- MessageFormatter.info("Schemas will be generated in .appwrite/schemas/", { prefix: "Setup" });
427
- MessageFormatter.info("Import data can be placed in .appwrite/importData/", { prefix: "Setup" });
428
- if (useTables) {
429
- MessageFormatter.info("TablesDB features: unique constraints, enhanced performance, row-level security", { prefix: "Setup" });
430
- }
431
- }
432
- /**
433
- * Create a new collection or table schema file
434
- */
435
- export async function createSchema(name, basePath, forceApiMode) {
436
- const projectPath = basePath || process.cwd();
437
- // Detect API mode
438
- const detection = forceApiMode
439
- ? {
440
- apiMode: forceApiMode,
441
- useTables: forceApiMode === 'tablesdb',
442
- detectionSource: 'forced',
443
- }
444
- : await detectApiMode(projectPath);
445
- const { useTables } = detection;
446
- const terminology = getTerminologyConfig(useTables);
447
- // Find or create container directory
448
- const appwriteFolder = path.join(projectPath, ".appwrite");
449
- const containerFolder = path.join(appwriteFolder, useTables ? "tables" : "collections");
450
- if (!existsSync(containerFolder)) {
451
- mkdirSync(containerFolder, { recursive: true });
452
- }
453
- // Create YAML schema file
454
- const yamlSchema = `# yaml-language-server: $schema=../.yaml_schemas/${terminology.schemaRef}
455
- # ${terminology.containerName} Definition: ${name}
456
- name: ${name}
457
- id: ${ulid()}
458
- ${terminology.security}: false
459
- enabled: true
460
- permissions:
461
- - permission: read
462
- target: any
463
- - permission: create
464
- target: users
465
- - permission: update
466
- target: users
467
- - permission: delete
468
- target: users
469
- ${terminology.fields}:
470
- # Add your ${terminology.fields} here
471
- # Example:
472
- # - key: title
473
- # type: string
474
- # size: 255
475
- # required: true
476
- # description: "The title of the item"
477
- indexes:
478
- # Add your indexes here
479
- # Example:
480
- # - key: title_search
481
- # type: fulltext
482
- # attributes:
483
- # - title
484
- importDefs: []
485
- `;
486
- const schemaPath = path.join(containerFolder, `${name}.yaml`);
487
- writeFileSync(schemaPath, yamlSchema);
488
- MessageFormatter.success(`Created ${terminology.container} schema: ${schemaPath}`, { prefix: "Setup" });
489
- MessageFormatter.info(`Add your ${terminology.fields} to define the ${terminology.container} structure`, { prefix: "Setup" });
490
- }
@@ -1,9 +0,0 @@
1
- import type { AppwriteConfig } from "appwrite-utils";
2
- export declare class SetupController {
3
- private currentDir;
4
- private config;
5
- constructor(currentDir: string);
6
- runSetup(withExampleData?: boolean): Promise<void>;
7
- loadConfig(): Promise<AppwriteConfig | null>;
8
- hasExistingConfig(): boolean;
9
- }
@@ -1,34 +0,0 @@
1
- import { setupDirsFiles } from "./utils/setupFiles.js";
2
- import { loadConfig } from "./utils/loadConfigs.js";
3
- import path from "path";
4
- import fs from "fs";
5
- import { MessageFormatter } from "./shared/messageFormatter.js";
6
- export class SetupController {
7
- currentDir;
8
- config = null;
9
- constructor(currentDir) {
10
- this.currentDir = currentDir;
11
- }
12
- async runSetup(withExampleData = false) {
13
- await setupDirsFiles(withExampleData, this.currentDir);
14
- MessageFormatter.success("Setup completed successfully", { prefix: "Setup" });
15
- }
16
- async loadConfig() {
17
- if (this.hasExistingConfig()) {
18
- try {
19
- const appwriteDir = path.join(this.currentDir, "appwrite");
20
- this.config = await loadConfig(appwriteDir);
21
- return this.config;
22
- }
23
- catch (error) {
24
- MessageFormatter.error("Error loading config", error, { prefix: "Setup" });
25
- return null;
26
- }
27
- }
28
- return null;
29
- }
30
- hasExistingConfig() {
31
- const configPath = path.join(this.currentDir, "appwrite", "appwriteConfig.ts");
32
- return fs.existsSync(configPath);
33
- }
34
- }
@@ -1,20 +0,0 @@
1
- import type { CreateAttributeParams, UpdateAttributeParams } from "../adapters/DatabaseAdapter.js";
2
- import type { Attribute } from "appwrite-utils";
3
- /**
4
- * Map a schema Attribute into DatabaseAdapter CreateAttributeParams
5
- * Only includes fields valid for the specific type to satisfy TS unions.
6
- * Also normalizes min/max ordering for numeric types to avoid server errors.
7
- */
8
- export declare function mapToCreateAttributeParams(attr: Attribute, base: {
9
- databaseId: string;
10
- tableId: string;
11
- }): CreateAttributeParams;
12
- /**
13
- * Map a schema Attribute into DatabaseAdapter UpdateAttributeParams
14
- * Omits fields that are not explicitly provided, and guards enum updates
15
- * so we never send an empty elements array (preserve existing on server).
16
- */
17
- export declare function mapToUpdateAttributeParams(attr: Attribute, base: {
18
- databaseId: string;
19
- tableId: string;
20
- }): UpdateAttributeParams;