@njdamstra/appwrite-utils-cli 1.8.9 → 1.10.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 (284) hide show
  1. package/CHANGELOG.md +16 -0
  2. package/CONFIG_TODO.md +1189 -0
  3. package/SELECTION_DIALOGS.md +146 -0
  4. package/SERVICE_IMPLEMENTATION_REPORT.md +462 -0
  5. package/dist/adapters/index.d.ts +7 -8
  6. package/dist/adapters/index.js +7 -9
  7. package/dist/backups/operations/bucketBackup.js +2 -2
  8. package/dist/backups/operations/collectionBackup.d.ts +1 -1
  9. package/dist/backups/operations/collectionBackup.js +3 -3
  10. package/dist/backups/operations/comprehensiveBackup.d.ts +1 -1
  11. package/dist/backups/operations/comprehensiveBackup.js +2 -2
  12. package/dist/backups/tracking/centralizedTracking.d.ts +1 -1
  13. package/dist/backups/tracking/centralizedTracking.js +2 -2
  14. package/dist/cli/commands/configCommands.js +51 -7
  15. package/dist/cli/commands/databaseCommands.d.ts +1 -0
  16. package/dist/cli/commands/databaseCommands.js +119 -9
  17. package/dist/cli/commands/functionCommands.js +3 -3
  18. package/dist/cli/commands/importFileCommands.d.ts +7 -0
  19. package/dist/cli/commands/importFileCommands.js +674 -0
  20. package/dist/cli/commands/schemaCommands.js +3 -3
  21. package/dist/cli/commands/storageCommands.js +2 -3
  22. package/dist/cli/commands/transferCommands.js +3 -5
  23. package/dist/collections/attributes.d.ts +1 -1
  24. package/dist/collections/attributes.js +2 -35
  25. package/dist/collections/indexes.js +1 -3
  26. package/dist/collections/methods.d.ts +1 -1
  27. package/dist/collections/methods.js +111 -192
  28. package/dist/collections/tableOperations.d.ts +1 -0
  29. package/dist/collections/tableOperations.js +55 -23
  30. package/dist/collections/transferOperations.d.ts +1 -1
  31. package/dist/collections/transferOperations.js +3 -4
  32. package/dist/collections/wipeOperations.d.ts +4 -3
  33. package/dist/collections/wipeOperations.js +112 -39
  34. package/dist/databases/methods.js +2 -2
  35. package/dist/databases/setup.js +2 -2
  36. package/dist/examples/yamlTerminologyExample.js +2 -2
  37. package/dist/functions/deployments.d.ts +1 -1
  38. package/dist/functions/deployments.js +5 -5
  39. package/dist/functions/fnConfigDiscovery.js +2 -2
  40. package/dist/functions/methods.js +16 -4
  41. package/dist/init.js +1 -1
  42. package/dist/interactiveCLI.d.ts +6 -1
  43. package/dist/interactiveCLI.js +63 -9
  44. package/dist/main.js +130 -177
  45. package/dist/migrations/afterImportActions.js +2 -3
  46. package/dist/migrations/appwriteToX.d.ts +1 -1
  47. package/dist/migrations/appwriteToX.js +9 -7
  48. package/dist/migrations/comprehensiveTransfer.js +3 -5
  49. package/dist/migrations/dataLoader.js +2 -5
  50. package/dist/migrations/importController.js +3 -4
  51. package/dist/migrations/importDataActions.js +3 -3
  52. package/dist/migrations/relationships.js +1 -2
  53. package/dist/migrations/services/DataTransformationService.js +2 -2
  54. package/dist/migrations/services/FileHandlerService.js +1 -1
  55. package/dist/migrations/services/ImportOrchestrator.js +4 -4
  56. package/dist/migrations/services/RateLimitManager.js +1 -1
  57. package/dist/migrations/services/RelationshipResolver.js +1 -1
  58. package/dist/migrations/services/UserMappingService.js +1 -1
  59. package/dist/migrations/services/ValidationService.js +1 -1
  60. package/dist/migrations/transfer.d.ts +8 -4
  61. package/dist/migrations/transfer.js +106 -55
  62. package/dist/migrations/yaml/YamlImportConfigLoader.js +1 -1
  63. package/dist/migrations/yaml/YamlImportIntegration.js +2 -2
  64. package/dist/migrations/yaml/generateImportSchemas.js +1 -1
  65. package/dist/setupCommands.d.ts +1 -1
  66. package/dist/setupCommands.js +5 -6
  67. package/dist/setupController.js +1 -1
  68. package/dist/shared/backupTracking.d.ts +1 -1
  69. package/dist/shared/backupTracking.js +2 -2
  70. package/dist/shared/confirmationDialogs.js +1 -1
  71. package/dist/shared/migrationHelpers.d.ts +1 -1
  72. package/dist/shared/migrationHelpers.js +3 -3
  73. package/dist/shared/operationQueue.d.ts +1 -1
  74. package/dist/shared/operationQueue.js +2 -3
  75. package/dist/shared/operationsTable.d.ts +1 -1
  76. package/dist/shared/operationsTable.js +2 -2
  77. package/dist/shared/progressManager.js +1 -1
  78. package/dist/shared/selectionDialogs.js +9 -8
  79. package/dist/storage/methods.js +4 -4
  80. package/dist/storage/schemas.d.ts +2 -2
  81. package/dist/tables/indexManager.d.ts +65 -0
  82. package/dist/tables/indexManager.js +294 -0
  83. package/dist/types.d.ts +2 -2
  84. package/dist/types.js +1 -1
  85. package/dist/users/methods.js +2 -3
  86. package/dist/utils/configMigration.js +1 -1
  87. package/dist/utils/index.d.ts +1 -1
  88. package/dist/utils/index.js +1 -1
  89. package/dist/utils/loadConfigs.d.ts +2 -2
  90. package/dist/utils/loadConfigs.js +6 -7
  91. package/dist/utils/setupFiles.js +5 -7
  92. package/dist/utilsController.d.ts +15 -8
  93. package/dist/utilsController.js +57 -28
  94. package/package.json +7 -3
  95. package/src/adapters/index.ts +8 -34
  96. package/src/backups/operations/bucketBackup.ts +2 -2
  97. package/src/backups/operations/collectionBackup.ts +4 -4
  98. package/src/backups/operations/comprehensiveBackup.ts +3 -3
  99. package/src/backups/tracking/centralizedTracking.ts +3 -3
  100. package/src/cli/commands/configCommands.ts +72 -8
  101. package/src/cli/commands/databaseCommands.ts +161 -9
  102. package/src/cli/commands/functionCommands.ts +4 -3
  103. package/src/cli/commands/importFileCommands.ts +815 -0
  104. package/src/cli/commands/schemaCommands.ts +3 -3
  105. package/src/cli/commands/storageCommands.ts +2 -3
  106. package/src/cli/commands/transferCommands.ts +3 -6
  107. package/src/collections/attributes.ts +3 -39
  108. package/src/collections/indexes.ts +2 -4
  109. package/src/collections/methods.ts +115 -150
  110. package/src/collections/tableOperations.ts +57 -21
  111. package/src/collections/transferOperations.ts +4 -5
  112. package/src/collections/wipeOperations.ts +154 -51
  113. package/src/databases/methods.ts +2 -2
  114. package/src/databases/setup.ts +2 -2
  115. package/src/examples/yamlTerminologyExample.ts +2 -2
  116. package/src/functions/deployments.ts +6 -5
  117. package/src/functions/fnConfigDiscovery.ts +2 -2
  118. package/src/functions/methods.ts +17 -4
  119. package/src/init.ts +1 -1
  120. package/src/interactiveCLI.ts +75 -10
  121. package/src/main.ts +143 -287
  122. package/src/migrations/afterImportActions.ts +2 -3
  123. package/src/migrations/appwriteToX.ts +12 -8
  124. package/src/migrations/comprehensiveTransfer.ts +6 -6
  125. package/src/migrations/dataLoader.ts +2 -5
  126. package/src/migrations/importController.ts +3 -4
  127. package/src/migrations/importDataActions.ts +3 -3
  128. package/src/migrations/relationships.ts +1 -2
  129. package/src/migrations/services/DataTransformationService.ts +2 -2
  130. package/src/migrations/services/FileHandlerService.ts +1 -1
  131. package/src/migrations/services/ImportOrchestrator.ts +4 -4
  132. package/src/migrations/services/RateLimitManager.ts +1 -1
  133. package/src/migrations/services/RelationshipResolver.ts +1 -1
  134. package/src/migrations/services/UserMappingService.ts +1 -1
  135. package/src/migrations/services/ValidationService.ts +1 -1
  136. package/src/migrations/transfer.ts +126 -83
  137. package/src/migrations/yaml/YamlImportConfigLoader.ts +1 -1
  138. package/src/migrations/yaml/YamlImportIntegration.ts +2 -2
  139. package/src/migrations/yaml/generateImportSchemas.ts +1 -1
  140. package/src/setupCommands.ts +5 -6
  141. package/src/setupController.ts +1 -1
  142. package/src/shared/backupTracking.ts +3 -3
  143. package/src/shared/confirmationDialogs.ts +1 -1
  144. package/src/shared/migrationHelpers.ts +4 -4
  145. package/src/shared/operationQueue.ts +3 -4
  146. package/src/shared/operationsTable.ts +3 -3
  147. package/src/shared/progressManager.ts +1 -1
  148. package/src/shared/selectionDialogs.ts +9 -8
  149. package/src/storage/methods.ts +4 -4
  150. package/src/tables/indexManager.ts +409 -0
  151. package/src/types.ts +2 -2
  152. package/src/users/methods.ts +2 -3
  153. package/src/utils/configMigration.ts +1 -1
  154. package/src/utils/index.ts +1 -1
  155. package/src/utils/loadConfigs.ts +15 -7
  156. package/src/utils/setupFiles.ts +5 -7
  157. package/src/utilsController.ts +86 -32
  158. package/dist/adapters/AdapterFactory.d.ts +0 -94
  159. package/dist/adapters/AdapterFactory.js +0 -405
  160. package/dist/adapters/DatabaseAdapter.d.ts +0 -233
  161. package/dist/adapters/DatabaseAdapter.js +0 -50
  162. package/dist/adapters/LegacyAdapter.d.ts +0 -50
  163. package/dist/adapters/LegacyAdapter.js +0 -612
  164. package/dist/adapters/TablesDBAdapter.d.ts +0 -45
  165. package/dist/adapters/TablesDBAdapter.js +0 -571
  166. package/dist/config/ConfigManager.d.ts +0 -445
  167. package/dist/config/ConfigManager.js +0 -625
  168. package/dist/config/configMigration.d.ts +0 -87
  169. package/dist/config/configMigration.js +0 -390
  170. package/dist/config/configValidation.d.ts +0 -66
  171. package/dist/config/configValidation.js +0 -358
  172. package/dist/config/index.d.ts +0 -8
  173. package/dist/config/index.js +0 -7
  174. package/dist/config/services/ConfigDiscoveryService.d.ts +0 -126
  175. package/dist/config/services/ConfigDiscoveryService.js +0 -374
  176. package/dist/config/services/ConfigLoaderService.d.ts +0 -129
  177. package/dist/config/services/ConfigLoaderService.js +0 -540
  178. package/dist/config/services/ConfigMergeService.d.ts +0 -208
  179. package/dist/config/services/ConfigMergeService.js +0 -308
  180. package/dist/config/services/ConfigValidationService.d.ts +0 -214
  181. package/dist/config/services/ConfigValidationService.js +0 -310
  182. package/dist/config/services/SessionAuthService.d.ts +0 -225
  183. package/dist/config/services/SessionAuthService.js +0 -456
  184. package/dist/config/services/__tests__/ConfigMergeService.test.d.ts +0 -1
  185. package/dist/config/services/__tests__/ConfigMergeService.test.js +0 -271
  186. package/dist/config/services/index.d.ts +0 -13
  187. package/dist/config/services/index.js +0 -10
  188. package/dist/config/yamlConfig.d.ts +0 -722
  189. package/dist/config/yamlConfig.js +0 -702
  190. package/dist/functions/pathResolution.d.ts +0 -37
  191. package/dist/functions/pathResolution.js +0 -185
  192. package/dist/shared/attributeMapper.d.ts +0 -20
  193. package/dist/shared/attributeMapper.js +0 -203
  194. package/dist/shared/errorUtils.d.ts +0 -54
  195. package/dist/shared/errorUtils.js +0 -95
  196. package/dist/shared/functionManager.d.ts +0 -48
  197. package/dist/shared/functionManager.js +0 -336
  198. package/dist/shared/indexManager.d.ts +0 -24
  199. package/dist/shared/indexManager.js +0 -151
  200. package/dist/shared/jsonSchemaGenerator.d.ts +0 -50
  201. package/dist/shared/jsonSchemaGenerator.js +0 -290
  202. package/dist/shared/logging.d.ts +0 -61
  203. package/dist/shared/logging.js +0 -116
  204. package/dist/shared/messageFormatter.d.ts +0 -39
  205. package/dist/shared/messageFormatter.js +0 -162
  206. package/dist/shared/pydanticModelGenerator.d.ts +0 -17
  207. package/dist/shared/pydanticModelGenerator.js +0 -615
  208. package/dist/shared/schemaGenerator.d.ts +0 -40
  209. package/dist/shared/schemaGenerator.js +0 -556
  210. package/dist/utils/ClientFactory.d.ts +0 -87
  211. package/dist/utils/ClientFactory.js +0 -212
  212. package/dist/utils/configDiscovery.d.ts +0 -78
  213. package/dist/utils/configDiscovery.js +0 -472
  214. package/dist/utils/constantsGenerator.d.ts +0 -31
  215. package/dist/utils/constantsGenerator.js +0 -321
  216. package/dist/utils/dataConverters.d.ts +0 -46
  217. package/dist/utils/dataConverters.js +0 -139
  218. package/dist/utils/directoryUtils.d.ts +0 -22
  219. package/dist/utils/directoryUtils.js +0 -59
  220. package/dist/utils/getClientFromConfig.d.ts +0 -39
  221. package/dist/utils/getClientFromConfig.js +0 -199
  222. package/dist/utils/helperFunctions.d.ts +0 -63
  223. package/dist/utils/helperFunctions.js +0 -156
  224. package/dist/utils/pathResolvers.d.ts +0 -53
  225. package/dist/utils/pathResolvers.js +0 -72
  226. package/dist/utils/projectConfig.d.ts +0 -119
  227. package/dist/utils/projectConfig.js +0 -171
  228. package/dist/utils/retryFailedPromises.d.ts +0 -2
  229. package/dist/utils/retryFailedPromises.js +0 -23
  230. package/dist/utils/sessionAuth.d.ts +0 -48
  231. package/dist/utils/sessionAuth.js +0 -164
  232. package/dist/utils/typeGuards.d.ts +0 -35
  233. package/dist/utils/typeGuards.js +0 -57
  234. package/dist/utils/validationRules.d.ts +0 -43
  235. package/dist/utils/validationRules.js +0 -42
  236. package/dist/utils/versionDetection.d.ts +0 -58
  237. package/dist/utils/versionDetection.js +0 -251
  238. package/dist/utils/yamlConverter.d.ts +0 -100
  239. package/dist/utils/yamlConverter.js +0 -428
  240. package/dist/utils/yamlLoader.d.ts +0 -70
  241. package/dist/utils/yamlLoader.js +0 -267
  242. package/src/adapters/AdapterFactory.ts +0 -510
  243. package/src/adapters/DatabaseAdapter.ts +0 -306
  244. package/src/adapters/LegacyAdapter.ts +0 -841
  245. package/src/adapters/TablesDBAdapter.ts +0 -773
  246. package/src/config/ConfigManager.ts +0 -808
  247. package/src/config/README.md +0 -274
  248. package/src/config/configMigration.ts +0 -575
  249. package/src/config/configValidation.ts +0 -445
  250. package/src/config/index.ts +0 -10
  251. package/src/config/services/ConfigDiscoveryService.ts +0 -463
  252. package/src/config/services/ConfigLoaderService.ts +0 -740
  253. package/src/config/services/ConfigMergeService.ts +0 -388
  254. package/src/config/services/ConfigValidationService.ts +0 -394
  255. package/src/config/services/SessionAuthService.ts +0 -565
  256. package/src/config/services/__tests__/ConfigMergeService.test.ts +0 -351
  257. package/src/config/services/index.ts +0 -29
  258. package/src/config/yamlConfig.ts +0 -761
  259. package/src/functions/pathResolution.ts +0 -227
  260. package/src/shared/attributeMapper.ts +0 -229
  261. package/src/shared/errorUtils.ts +0 -110
  262. package/src/shared/functionManager.ts +0 -525
  263. package/src/shared/indexManager.ts +0 -254
  264. package/src/shared/jsonSchemaGenerator.ts +0 -383
  265. package/src/shared/logging.ts +0 -149
  266. package/src/shared/messageFormatter.ts +0 -208
  267. package/src/shared/pydanticModelGenerator.ts +0 -618
  268. package/src/shared/schemaGenerator.ts +0 -644
  269. package/src/utils/ClientFactory.ts +0 -240
  270. package/src/utils/configDiscovery.ts +0 -557
  271. package/src/utils/constantsGenerator.ts +0 -369
  272. package/src/utils/dataConverters.ts +0 -159
  273. package/src/utils/directoryUtils.ts +0 -61
  274. package/src/utils/getClientFromConfig.ts +0 -257
  275. package/src/utils/helperFunctions.ts +0 -228
  276. package/src/utils/pathResolvers.ts +0 -81
  277. package/src/utils/projectConfig.ts +0 -299
  278. package/src/utils/retryFailedPromises.ts +0 -29
  279. package/src/utils/sessionAuth.ts +0 -230
  280. package/src/utils/typeGuards.ts +0 -65
  281. package/src/utils/validationRules.ts +0 -88
  282. package/src/utils/versionDetection.ts +0 -292
  283. package/src/utils/yamlConverter.ts +0 -542
  284. package/src/utils/yamlLoader.ts +0 -371
@@ -1,702 +0,0 @@
1
- import { z } from "zod";
2
- import yaml from "js-yaml";
3
- import fs from "fs";
4
- import path from "path";
5
- import { AppwriteConfigSchema, RuntimeSchema, FunctionScopes, FunctionSpecifications, permissionsSchema, PermissionToAppwritePermission } from "@njdamstra/appwrite-utils";
6
- import { shouldIgnoreDirectory } from "../utils/directoryUtils.js";
7
- import { MessageFormatter } from "../shared/messageFormatter.js";
8
- const YamlConfigSchema = z.object({
9
- appwrite: z.object({
10
- endpoint: z.string().default("https://cloud.appwrite.io/v1"),
11
- project: z.string(),
12
- key: z.string(),
13
- // Session authentication support
14
- sessionCookie: z.string().optional(),
15
- authMethod: z.enum(["session", "apikey", "auto"]).optional().default("auto"),
16
- sessionMetadata: z.object({
17
- email: z.string().optional(),
18
- expiresAt: z.string().optional(),
19
- }).optional(),
20
- }),
21
- logging: z
22
- .object({
23
- enabled: z.boolean().default(false),
24
- level: z.enum(["error", "warn", "info", "debug"]).default("info"),
25
- directory: z.string().optional(),
26
- console: z.boolean().default(false),
27
- })
28
- .optional()
29
- .default({ enabled: false, level: "info", console: false }),
30
- backups: z
31
- .object({
32
- enabled: z.boolean().default(true),
33
- interval: z.number().default(3600),
34
- retention: z.number().default(30),
35
- cleanup: z.boolean().default(true),
36
- })
37
- .optional()
38
- .default({ enabled: true, interval: 3600, retention: 30, cleanup: true }),
39
- data: z
40
- .object({
41
- enableMockData: z.boolean().default(false),
42
- documentBucketId: z.string().default("documents"),
43
- usersCollectionName: z.string().default("Members"),
44
- importDirectory: z.string().default("importData"),
45
- })
46
- .optional()
47
- .default({
48
- enableMockData: false,
49
- documentBucketId: "documents",
50
- usersCollectionName: "Members",
51
- importDirectory: "importData",
52
- }),
53
- schemas: z
54
- .object({
55
- outputDirectory: z.string().default("schemas"),
56
- yamlSchemaDirectory: z.string().default(".yaml_schemas"),
57
- collectionsDirectory: z.string().default("collections"),
58
- tablesDirectory: z.string().default("tables"),
59
- })
60
- .optional()
61
- .default({
62
- outputDirectory: "schemas",
63
- yamlSchemaDirectory: ".yaml_schemas",
64
- collectionsDirectory: "collections",
65
- tablesDirectory: "tables",
66
- }),
67
- migrations: z
68
- .object({
69
- enabled: z.boolean().default(false),
70
- })
71
- .optional()
72
- .default({
73
- enabled: true,
74
- }),
75
- databases: z
76
- .array(z.object({
77
- id: z.string(),
78
- name: z.string(),
79
- bucket: z
80
- .object({
81
- id: z.string(),
82
- name: z.string(),
83
- permissions: permissionsSchema,
84
- fileSecurity: z.boolean().optional(),
85
- enabled: z.boolean().optional(),
86
- maximumFileSize: z.number().optional(),
87
- allowedFileExtensions: z.array(z.string()).optional(),
88
- compression: z.enum(["none", "gzip", "zstd"]).optional(),
89
- encryption: z.boolean().optional(),
90
- antivirus: z.boolean().optional(),
91
- })
92
- .optional(),
93
- }))
94
- .optional()
95
- .default([
96
- { id: "dev", name: "Development" },
97
- { id: "main", name: "Main" },
98
- { id: "staging", name: "Staging" },
99
- ]),
100
- buckets: z
101
- .array(z.object({
102
- id: z.string(),
103
- name: z.string(),
104
- permissions: permissionsSchema,
105
- fileSecurity: z.boolean().optional(),
106
- enabled: z.boolean().optional(),
107
- maximumFileSize: z.number().optional(),
108
- allowedFileExtensions: z.array(z.string()).optional(),
109
- compression: z.enum(["none", "gzip", "zstd"]).optional(),
110
- encryption: z.boolean().optional(),
111
- antivirus: z.boolean().optional(),
112
- }))
113
- .optional()
114
- .default([]),
115
- functions: z
116
- .array(z.object({
117
- id: z.string(),
118
- name: z.string(),
119
- runtime: RuntimeSchema,
120
- execute: z.array(z.string()).optional(),
121
- events: z.array(z.string()).optional(),
122
- schedule: z.string().optional(),
123
- timeout: z.number().optional(),
124
- enabled: z.boolean().optional(),
125
- logging: z.boolean().optional(),
126
- entrypoint: z.string().optional(),
127
- commands: z.string().optional(),
128
- scopes: z.array(FunctionScopes).optional(),
129
- installationId: z.string().optional(),
130
- providerRepositoryId: z.string().optional(),
131
- providerBranch: z.string().optional(),
132
- providerSilentMode: z.boolean().optional(),
133
- providerRootDirectory: z.string().optional(),
134
- templateRepository: z.string().optional(),
135
- templateOwner: z.string().optional(),
136
- templateRootDirectory: z.string().optional(),
137
- templateBranch: z.string().optional(),
138
- specification: FunctionSpecifications.optional(),
139
- // Critical missing fields for function deployment
140
- dirPath: z.string().optional(),
141
- predeployCommands: z.array(z.string()).optional(),
142
- deployDir: z.string().optional(),
143
- ignore: z.array(z.string()).optional(),
144
- templateVersion: z.string().optional(),
145
- }))
146
- .optional()
147
- .default([]),
148
- });
149
- export const convertYamlToAppwriteConfig = (yamlConfig) => {
150
- const appwriteConfig = {
151
- appwriteEndpoint: yamlConfig.appwrite.endpoint,
152
- appwriteProject: yamlConfig.appwrite.project,
153
- appwriteKey: yamlConfig.appwrite.key,
154
- // Session authentication support from YAML
155
- sessionCookie: yamlConfig.appwrite.sessionCookie,
156
- authMethod: yamlConfig.appwrite.authMethod || "auto",
157
- sessionMetadata: yamlConfig.appwrite.sessionMetadata,
158
- apiMode: "auto", // Default to auto-detect for dual API support
159
- appwriteClient: null,
160
- logging: {
161
- enabled: yamlConfig.logging.enabled,
162
- level: yamlConfig.logging.level,
163
- logDirectory: yamlConfig.logging.directory,
164
- console: yamlConfig.logging.console,
165
- },
166
- enableBackups: yamlConfig.backups.enabled,
167
- backupInterval: yamlConfig.backups.interval,
168
- backupRetention: yamlConfig.backups.retention,
169
- enableBackupCleanup: yamlConfig.backups.cleanup,
170
- enableMockData: yamlConfig.data.enableMockData,
171
- documentBucketId: yamlConfig.data.documentBucketId,
172
- usersCollectionName: yamlConfig.data.usersCollectionName,
173
- schemaConfig: {
174
- outputDirectory: yamlConfig.schemas.outputDirectory,
175
- yamlSchemaDirectory: yamlConfig.schemas.yamlSchemaDirectory,
176
- importDirectory: yamlConfig.data.importDirectory,
177
- collectionsDirectory: yamlConfig.schemas.collectionsDirectory || "collections",
178
- tablesDirectory: yamlConfig.schemas.tablesDirectory || "tables",
179
- },
180
- databases: yamlConfig.databases.map((db) => ({
181
- $id: db.id,
182
- name: db.name,
183
- bucket: db.bucket
184
- ? {
185
- $id: db.bucket.id,
186
- name: db.bucket.name,
187
- $permissions: PermissionToAppwritePermission(db.bucket.permissions),
188
- fileSecurity: db.bucket.fileSecurity || false,
189
- enabled: db.bucket.enabled || true,
190
- maximumFileSize: db.bucket.maximumFileSize || 30000000,
191
- allowedFileExtensions: db.bucket.allowedFileExtensions || [],
192
- compression: db.bucket.compression || "none",
193
- encryption: db.bucket.encryption || false,
194
- antivirus: db.bucket.antivirus || false,
195
- }
196
- : undefined,
197
- })),
198
- buckets: yamlConfig.buckets.map((bucket) => ({
199
- $id: bucket.id,
200
- name: bucket.name,
201
- $permissions: PermissionToAppwritePermission(bucket.permissions),
202
- fileSecurity: bucket.fileSecurity || false,
203
- enabled: bucket.enabled || true,
204
- maximumFileSize: bucket.maximumFileSize || 30000000,
205
- allowedFileExtensions: bucket.allowedFileExtensions || [],
206
- compression: bucket.compression || "none",
207
- encryption: bucket.encryption || false,
208
- antivirus: bucket.antivirus || false,
209
- })),
210
- functions: yamlConfig.functions?.map((func) => ({
211
- $id: func.id,
212
- name: func.name,
213
- runtime: func.runtime,
214
- execute: func.execute || [],
215
- events: func.events || [],
216
- schedule: func.schedule || "",
217
- timeout: func.timeout || 15,
218
- enabled: func.enabled || true,
219
- logging: func.logging || true,
220
- entrypoint: func.entrypoint || "",
221
- commands: func.commands || "",
222
- scopes: func.scopes || [],
223
- installationId: func.installationId || "",
224
- providerRepositoryId: func.providerRepositoryId || "",
225
- providerBranch: func.providerBranch || "",
226
- providerSilentMode: func.providerSilentMode || false,
227
- providerRootDirectory: func.providerRootDirectory || "",
228
- templateRepository: func.templateRepository || "",
229
- templateOwner: func.templateOwner || "",
230
- templateRootDirectory: func.templateRootDirectory || "",
231
- templateBranch: func.templateBranch || "",
232
- specification: func.specification || "s-0.5vcpu-512mb",
233
- // Include critical missing fields for function deployment
234
- dirPath: func.dirPath,
235
- predeployCommands: func.predeployCommands,
236
- deployDir: func.deployDir,
237
- ignore: func.ignore,
238
- templateVersion: func.templateVersion,
239
- })),
240
- collections: [], // Note: Collections are managed separately in YAML configs via individual collection files
241
- };
242
- return appwriteConfig;
243
- };
244
- /**
245
- * Load YAML config with optional session preservation
246
- * Maintains authentication priority: explicit session > YAML file > system prefs
247
- */
248
- export const loadYamlConfigWithSession = async (configPath, sessionOptions) => {
249
- try {
250
- const fileContent = fs.readFileSync(configPath, "utf8");
251
- const yamlData = yaml.load(fileContent);
252
- const yamlConfig = YamlConfigSchema.parse(yamlData);
253
- const appwriteConfig = convertYamlToAppwriteConfig(yamlConfig);
254
- // Apply session preservation if provided (explicit overrides take priority)
255
- if (sessionOptions) {
256
- if (sessionOptions.sessionCookie) {
257
- appwriteConfig.sessionCookie = sessionOptions.sessionCookie;
258
- }
259
- if (sessionOptions.authMethod) {
260
- appwriteConfig.authMethod = sessionOptions.authMethod;
261
- }
262
- if (sessionOptions.sessionMetadata) {
263
- appwriteConfig.sessionMetadata = sessionOptions.sessionMetadata;
264
- }
265
- }
266
- return appwriteConfig;
267
- }
268
- catch (error) {
269
- if (error instanceof z.ZodError) {
270
- MessageFormatter.error("YAML config validation failed", undefined, { prefix: "Config" });
271
- error.issues.forEach((err) => {
272
- MessageFormatter.error(`${err.path.join('.')} → ${err.message}`, undefined, { prefix: "Config" });
273
- });
274
- }
275
- else {
276
- MessageFormatter.error("Error loading YAML config", error instanceof Error ? error : undefined, { prefix: "Config" });
277
- if (error instanceof Error && error.stack) {
278
- MessageFormatter.debug("Stack trace", error.stack, { prefix: "Config" });
279
- }
280
- }
281
- return null;
282
- }
283
- };
284
- export const loadYamlConfig = async (configPath) => {
285
- try {
286
- const fileContent = fs.readFileSync(configPath, "utf8");
287
- const yamlData = yaml.load(fileContent);
288
- const yamlConfig = YamlConfigSchema.parse(yamlData);
289
- return convertYamlToAppwriteConfig(yamlConfig);
290
- }
291
- catch (error) {
292
- if (error instanceof z.ZodError) {
293
- MessageFormatter.error("YAML config validation failed", undefined, { prefix: "Config" });
294
- error.issues.forEach((err) => {
295
- MessageFormatter.error(`${err.path.join('.')} → ${err.message}`, undefined, { prefix: "Config" });
296
- });
297
- }
298
- else {
299
- MessageFormatter.error("Error loading YAML config", error instanceof Error ? error : undefined, { prefix: "Config" });
300
- if (error instanceof Error && error.stack) {
301
- MessageFormatter.debug("Stack trace", error.stack, { prefix: "Config" });
302
- }
303
- }
304
- return null;
305
- }
306
- };
307
- export const findYamlConfig = (startDir) => {
308
- // First check current directory for YAML configs
309
- const possiblePaths = [
310
- path.join(startDir, ".appwrite", "config.yaml"),
311
- path.join(startDir, ".appwrite", "config.yml"),
312
- path.join(startDir, ".appwrite", "appwriteConfig.yaml"),
313
- path.join(startDir, ".appwrite", "appwriteConfig.yml"),
314
- path.join(startDir, "appwrite.yaml"),
315
- path.join(startDir, "appwrite.yml"),
316
- ];
317
- for (const configPath of possiblePaths) {
318
- if (fs.existsSync(configPath)) {
319
- return configPath;
320
- }
321
- }
322
- // Recursively search subdirectories for .appwrite folders
323
- const yamlConfigInSubdirs = findYamlConfigRecursive(startDir);
324
- if (yamlConfigInSubdirs) {
325
- return yamlConfigInSubdirs;
326
- }
327
- // Only check one level up to avoid infinite traversal
328
- const parentDir = path.dirname(startDir);
329
- if (parentDir !== startDir && path.basename(parentDir) !== 'node_modules') {
330
- const parentPossiblePaths = [
331
- path.join(parentDir, ".appwrite", "config.yaml"),
332
- path.join(parentDir, ".appwrite", "config.yml"),
333
- path.join(parentDir, ".appwrite", "appwriteConfig.yaml"),
334
- path.join(parentDir, ".appwrite", "appwriteConfig.yml"),
335
- path.join(parentDir, "appwrite.yaml"),
336
- path.join(parentDir, "appwrite.yml"),
337
- ];
338
- for (const configPath of parentPossiblePaths) {
339
- if (fs.existsSync(configPath)) {
340
- return configPath;
341
- }
342
- }
343
- }
344
- return null;
345
- };
346
- const findYamlConfigRecursive = (dir, depth = 0) => {
347
- // Limit search depth to prevent infinite recursion
348
- if (depth > 5) {
349
- return null;
350
- }
351
- if (shouldIgnoreDirectory(path.basename(dir))) {
352
- return null;
353
- }
354
- try {
355
- const entries = fs.readdirSync(dir, { withFileTypes: true });
356
- for (const entry of entries) {
357
- if (entry.isDirectory() && !shouldIgnoreDirectory(entry.name)) {
358
- const fullPath = path.join(dir, entry.name);
359
- // Check if this is an .appwrite directory
360
- if (entry.name === ".appwrite") {
361
- const configPaths = [
362
- path.join(fullPath, "config.yaml"),
363
- path.join(fullPath, "config.yml"),
364
- path.join(fullPath, "appwriteConfig.yaml"),
365
- path.join(fullPath, "appwriteConfig.yml"),
366
- ];
367
- for (const configPath of configPaths) {
368
- if (fs.existsSync(configPath)) {
369
- return configPath;
370
- }
371
- }
372
- }
373
- // Recurse into other directories with increased depth
374
- const result = findYamlConfigRecursive(fullPath, depth + 1);
375
- if (result)
376
- return result;
377
- }
378
- }
379
- }
380
- catch (error) {
381
- // Ignore directory access errors
382
- }
383
- return null;
384
- };
385
- export const generateYamlConfigTemplate = (outputPath) => {
386
- const template = {
387
- appwrite: {
388
- endpoint: "https://cloud.appwrite.io/v1",
389
- project: "YOUR_PROJECT_ID",
390
- key: "YOUR_API_KEY",
391
- authMethod: "auto",
392
- // Optional session authentication (leave empty to use API key)
393
- // sessionCookie: "session_cookie_from_appwrite_cli",
394
- },
395
- logging: {
396
- enabled: false,
397
- level: "info",
398
- console: false,
399
- },
400
- backups: {
401
- enabled: true,
402
- interval: 3600,
403
- retention: 30,
404
- cleanup: true,
405
- },
406
- data: {
407
- enableMockData: false,
408
- documentBucketId: "documents",
409
- usersCollectionName: "Members",
410
- importDirectory: "importData",
411
- },
412
- schemas: {
413
- outputDirectory: "schemas",
414
- yamlSchemaDirectory: ".yaml_schemas",
415
- collectionsDirectory: "collections",
416
- tablesDirectory: "tables",
417
- },
418
- migrations: {
419
- enabled: true,
420
- },
421
- databases: [
422
- { id: "dev", name: "Development" },
423
- { id: "main", name: "Main" },
424
- { id: "staging", name: "Staging" },
425
- ],
426
- buckets: [],
427
- functions: [],
428
- };
429
- let yamlContent = yaml.dump(template, {
430
- indent: 2,
431
- lineWidth: 120,
432
- sortKeys: false,
433
- });
434
- // Add inline comments to the schemas section
435
- yamlContent = yamlContent.replace(/schemas:\s*\n(\s*)outputDirectory: schemas\n(\s*)yamlSchemaDirectory: \.yaml_schemas\n(\s*)collectionsDirectory: collections\n(\s*)tablesDirectory: tables/, `schemas:
436
- $1outputDirectory: schemas
437
- $2yamlSchemaDirectory: .yaml_schemas
438
- $3# Directory for legacy Databases API collection definitions
439
- $3collectionsDirectory: collections
440
- $4# Directory for new TablesDB API table definitions
441
- $4tablesDirectory: tables`);
442
- // Add schema reference header and documentation
443
- const schemaReference = "# yaml-language-server: $schema=./.yaml_schemas/appwrite-config.schema.json\n";
444
- const documentation = `# Appwrite Project Configuration
445
- #
446
- # Authentication Configuration:
447
- # - key: Standard API key authentication
448
- # - sessionCookie: Session cookie from Appwrite CLI authentication
449
- # - authMethod: "auto" (detects available method), "session" (prefer session), "apikey" (prefer API key)
450
- # - Priority: Explicit CLI args > YAML config > ~/.appwrite/prefs.json > Error
451
- #
452
- # Directory Configuration:
453
- # - collectionsDirectory: Use for legacy Databases API (default: "collections")
454
- # - tablesDirectory: Use for new TablesDB API (default: "tables")
455
- # - API mode is auto-detected based on server version, or set explicitly via apiMode
456
- #
457
- # For dual API support, both directories can coexist with different definitions
458
-
459
- `;
460
- const finalContent = schemaReference + documentation + yamlContent;
461
- fs.writeFileSync(outputPath, finalContent, "utf8");
462
- };
463
- /**
464
- * Converts AppwriteConfig back to YAML format and writes to file
465
- * @param configPath Path to the YAML config file
466
- * @param config The AppwriteConfig to convert and save
467
- */
468
- export const writeYamlConfig = async (configPath, config) => {
469
- try {
470
- // Convert AppwriteConfig back to YAML format
471
- const yamlConfig = {
472
- appwrite: {
473
- endpoint: config.appwriteEndpoint,
474
- project: config.appwriteProject,
475
- key: config.appwriteKey,
476
- // Include session authentication fields
477
- sessionCookie: config.sessionCookie,
478
- authMethod: config.authMethod || "auto",
479
- sessionMetadata: config.sessionMetadata,
480
- },
481
- logging: {
482
- enabled: config.logging?.enabled || false,
483
- level: config.logging?.level || "info",
484
- directory: config.logging?.logDirectory,
485
- console: config.logging?.console || false,
486
- },
487
- backups: {
488
- enabled: config.enableBackups !== false,
489
- interval: config.backupInterval || 3600,
490
- retention: config.backupRetention || 30,
491
- cleanup: config.enableBackupCleanup !== false,
492
- },
493
- data: {
494
- enableMockData: config.enableMockData || false,
495
- documentBucketId: config.documentBucketId || "documents",
496
- usersCollectionName: config.usersCollectionName || "Members",
497
- importDirectory: config.schemaConfig?.importDirectory || "importData",
498
- },
499
- schemas: {
500
- outputDirectory: config.schemaConfig?.outputDirectory || "schemas",
501
- yamlSchemaDirectory: config.schemaConfig?.yamlSchemaDirectory || ".yaml_schemas",
502
- collectionsDirectory: config.schemaConfig?.collectionsDirectory || "collections",
503
- tablesDirectory: config.schemaConfig?.tablesDirectory || "tables",
504
- },
505
- migrations: {
506
- enabled: true,
507
- },
508
- databases: config.databases?.map(db => ({
509
- id: db.$id,
510
- name: db.name,
511
- bucket: db.bucket ? {
512
- id: db.bucket.$id,
513
- name: db.bucket.name,
514
- permissions: db.bucket.permissions || [],
515
- fileSecurity: db.bucket.fileSecurity,
516
- enabled: db.bucket.enabled,
517
- maximumFileSize: db.bucket.maximumFileSize,
518
- allowedFileExtensions: db.bucket.allowedFileExtensions,
519
- compression: db.bucket.compression,
520
- encryption: db.bucket.encryption,
521
- antivirus: db.bucket.antivirus,
522
- } : undefined,
523
- })) || [],
524
- buckets: config.buckets?.map(bucket => ({
525
- id: bucket.$id,
526
- name: bucket.name,
527
- permissions: bucket.permissions || [],
528
- fileSecurity: bucket.fileSecurity,
529
- enabled: bucket.enabled,
530
- maximumFileSize: bucket.maximumFileSize,
531
- allowedFileExtensions: bucket.allowedFileExtensions,
532
- compression: bucket.compression,
533
- encryption: bucket.encryption,
534
- antivirus: bucket.antivirus,
535
- })) || [],
536
- functions: config.functions?.map(func => ({
537
- id: func.$id,
538
- name: func.name,
539
- runtime: func.runtime,
540
- execute: func.execute,
541
- events: func.events,
542
- schedule: func.schedule,
543
- timeout: func.timeout,
544
- enabled: func.enabled,
545
- logging: func.logging,
546
- entrypoint: func.entrypoint,
547
- commands: func.commands,
548
- scopes: func.scopes,
549
- installationId: func.installationId,
550
- providerRepositoryId: func.providerRepositoryId,
551
- providerBranch: func.providerBranch,
552
- providerSilentMode: func.providerSilentMode,
553
- providerRootDirectory: func.providerRootDirectory,
554
- templateRepository: func.templateRepository,
555
- templateOwner: func.templateOwner,
556
- templateRootDirectory: func.templateRootDirectory,
557
- specification: func.specification,
558
- // Include critical fields for function deployment
559
- dirPath: func.dirPath,
560
- predeployCommands: func.predeployCommands,
561
- deployDir: func.deployDir,
562
- ignore: func.ignore,
563
- templateVersion: func.templateVersion,
564
- })) || [],
565
- };
566
- // Write YAML config
567
- const yamlContent = yaml.dump(yamlConfig, {
568
- indent: 2,
569
- lineWidth: 120,
570
- sortKeys: false,
571
- });
572
- // Preserve schema reference if it exists
573
- let finalContent = yamlContent;
574
- if (fs.existsSync(configPath)) {
575
- const existingContent = fs.readFileSync(configPath, "utf8");
576
- const lines = existingContent.split('\n');
577
- const schemaLine = lines.find(line => line.startsWith('# yaml-language-server:'));
578
- const commentLine = lines.find(line => line.startsWith('# Appwrite Project Configuration'));
579
- if (schemaLine) {
580
- finalContent = schemaLine + '\n';
581
- if (commentLine) {
582
- finalContent += commentLine + '\n';
583
- }
584
- finalContent += yamlContent;
585
- }
586
- }
587
- else {
588
- // Add schema reference for new files
589
- const schemaReference = "# yaml-language-server: $schema=./.yaml_schemas/appwrite-config.schema.json\n";
590
- finalContent = schemaReference + "# Appwrite Project Configuration\n" + yamlContent;
591
- }
592
- fs.writeFileSync(configPath, finalContent, "utf8");
593
- MessageFormatter.success(`Updated YAML configuration at ${configPath}`, { prefix: "Config" });
594
- }
595
- catch (error) {
596
- MessageFormatter.error("Error writing YAML config", error instanceof Error ? error : undefined, { prefix: "Config" });
597
- throw error;
598
- }
599
- };
600
- /**
601
- * Adds a new function to the YAML config file
602
- * @param configPath Path to the YAML config file
603
- * @param newFunction The function configuration to add
604
- */
605
- export const addFunctionToYamlConfig = async (configPath, newFunction) => {
606
- try {
607
- // Read current config
608
- const fileContent = fs.readFileSync(configPath, "utf8");
609
- const yamlData = yaml.load(fileContent);
610
- // Initialize functions array if it doesn't exist
611
- if (!yamlData.functions) {
612
- yamlData.functions = [];
613
- }
614
- // Convert AppwriteFunction to YAML format
615
- const yamlFunction = {
616
- id: newFunction.$id,
617
- name: newFunction.name,
618
- runtime: newFunction.runtime,
619
- execute: newFunction.execute || ["any"],
620
- events: newFunction.events || [],
621
- schedule: newFunction.schedule || "",
622
- timeout: newFunction.timeout || 15,
623
- enabled: newFunction.enabled !== false,
624
- logging: newFunction.logging !== false,
625
- entrypoint: newFunction.entrypoint || "",
626
- commands: newFunction.commands || "",
627
- scopes: newFunction.scopes || [],
628
- specification: newFunction.specification || "s-0.5vcpu-512mb",
629
- // Include critical fields for function deployment if they exist
630
- ...(newFunction.dirPath && { dirPath: newFunction.dirPath }),
631
- ...(newFunction.predeployCommands && { predeployCommands: newFunction.predeployCommands }),
632
- ...(newFunction.deployDir && { deployDir: newFunction.deployDir }),
633
- ...(newFunction.ignore && { ignore: newFunction.ignore }),
634
- ...(newFunction.templateVersion && { templateVersion: newFunction.templateVersion }),
635
- };
636
- // Add new function
637
- yamlData.functions.push(yamlFunction);
638
- // Write back to file
639
- const updatedYamlContent = yaml.dump(yamlData, {
640
- indent: 2,
641
- lineWidth: 120,
642
- sortKeys: false,
643
- });
644
- // Preserve schema reference if it exists
645
- const lines = fileContent.split('\n');
646
- const schemaLine = lines.find(line => line.startsWith('# yaml-language-server:'));
647
- let finalContent = updatedYamlContent;
648
- if (schemaLine) {
649
- finalContent = schemaLine + '\n' + updatedYamlContent;
650
- }
651
- fs.writeFileSync(configPath, finalContent, "utf8");
652
- MessageFormatter.success(`Added function "${newFunction.name}" to YAML config`, { prefix: "Config" });
653
- }
654
- catch (error) {
655
- MessageFormatter.error("Error adding function to YAML config", error instanceof Error ? error : undefined, { prefix: "Config" });
656
- throw error;
657
- }
658
- };
659
- /**
660
- * Extract session options from AppwriteConfig for YAML operations
661
- * Useful for preserving session state during config reloads
662
- */
663
- export const extractSessionOptionsFromConfig = (config) => {
664
- return {
665
- sessionCookie: config.sessionCookie,
666
- authMethod: config.authMethod,
667
- sessionMetadata: config.sessionMetadata,
668
- };
669
- };
670
- /**
671
- * Create session-preserved YAML config operations
672
- * Maintains authentication state during config file updates
673
- */
674
- export const createSessionPreservingYamlConfig = (configPath, sessionOptions) => {
675
- return {
676
- load: () => loadYamlConfigWithSession(configPath, sessionOptions),
677
- write: (config) => {
678
- // Merge session options into config before writing
679
- const enhancedConfig = {
680
- ...config,
681
- sessionCookie: sessionOptions.sessionCookie || config.sessionCookie,
682
- authMethod: sessionOptions.authMethod || config.authMethod,
683
- sessionMetadata: sessionOptions.sessionMetadata || config.sessionMetadata,
684
- };
685
- return writeYamlConfig(configPath, enhancedConfig);
686
- },
687
- addFunction: (func) => addFunctionToYamlConfig(configPath, func),
688
- };
689
- };
690
- /**
691
- * Determine if YAML config has session authentication configured
692
- */
693
- export const hasYamlSessionAuth = (configPath) => {
694
- try {
695
- const fileContent = fs.readFileSync(configPath, "utf8");
696
- const yamlData = yaml.load(fileContent);
697
- return !!(yamlData?.appwrite?.sessionCookie && yamlData.appwrite.sessionCookie.trim());
698
- }
699
- catch (error) {
700
- return false;
701
- }
702
- };