node-appwrite 17.1.0 → 18.0.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 (112) hide show
  1. package/README.md +67 -2
  2. package/dist/client.js +3 -3
  3. package/dist/client.js.map +1 -1
  4. package/dist/client.mjs +3 -3
  5. package/dist/client.mjs.map +1 -1
  6. package/dist/enums/{v-c-s-deployment-type.js → vcs-deployment-type.js} +1 -1
  7. package/dist/enums/vcs-deployment-type.js.map +1 -0
  8. package/dist/enums/{v-c-s-deployment-type.mjs → vcs-deployment-type.mjs} +2 -2
  9. package/dist/enums/vcs-deployment-type.mjs.map +1 -0
  10. package/dist/index.d.mts +2 -1
  11. package/dist/index.d.ts +2 -1
  12. package/dist/index.js +7 -2
  13. package/dist/index.js.map +1 -1
  14. package/dist/index.mjs +2 -1
  15. package/dist/index.mjs.map +1 -1
  16. package/dist/models.d.mts +829 -145
  17. package/dist/models.d.ts +829 -145
  18. package/dist/query.d.mts +70 -0
  19. package/dist/query.d.ts +70 -0
  20. package/dist/query.js +70 -0
  21. package/dist/query.js.map +1 -1
  22. package/dist/query.mjs +70 -0
  23. package/dist/query.mjs.map +1 -1
  24. package/dist/services/account.d.mts +656 -101
  25. package/dist/services/account.d.ts +656 -101
  26. package/dist/services/account.js +592 -292
  27. package/dist/services/account.js.map +1 -1
  28. package/dist/services/account.mjs +592 -292
  29. package/dist/services/account.mjs.map +1 -1
  30. package/dist/services/avatars.d.mts +176 -45
  31. package/dist/services/avatars.d.ts +176 -45
  32. package/dist/services/avatars.js +104 -93
  33. package/dist/services/avatars.js.map +1 -1
  34. package/dist/services/avatars.mjs +104 -93
  35. package/dist/services/avatars.mjs.map +1 -1
  36. package/dist/services/databases.d.mts +1274 -271
  37. package/dist/services/databases.d.ts +1274 -271
  38. package/dist/services/databases.js +939 -584
  39. package/dist/services/databases.js.map +1 -1
  40. package/dist/services/databases.mjs +939 -584
  41. package/dist/services/databases.mjs.map +1 -1
  42. package/dist/services/functions.d.mts +537 -114
  43. package/dist/services/functions.d.ts +537 -114
  44. package/dist/services/functions.js +393 -276
  45. package/dist/services/functions.js.map +1 -1
  46. package/dist/services/functions.mjs +393 -276
  47. package/dist/services/functions.mjs.map +1 -1
  48. package/dist/services/graphql.d.mts +24 -2
  49. package/dist/services/graphql.d.ts +24 -2
  50. package/dist/services/graphql.js +20 -16
  51. package/dist/services/graphql.js.map +1 -1
  52. package/dist/services/graphql.mjs +20 -16
  53. package/dist/services/graphql.mjs.map +1 -1
  54. package/dist/services/health.d.mts +176 -17
  55. package/dist/services/health.d.ts +176 -17
  56. package/dist/services/health.js +144 -115
  57. package/dist/services/health.js.map +1 -1
  58. package/dist/services/health.mjs +144 -115
  59. package/dist/services/health.mjs.map +1 -1
  60. package/dist/services/locale.d.mts +2 -2
  61. package/dist/services/locale.d.ts +2 -2
  62. package/dist/services/locale.js +7 -7
  63. package/dist/services/locale.js.map +1 -1
  64. package/dist/services/locale.mjs +7 -7
  65. package/dist/services/locale.mjs.map +1 -1
  66. package/dist/services/messaging.d.mts +1552 -270
  67. package/dist/services/messaging.d.ts +1552 -270
  68. package/dist/services/messaging.js +1417 -592
  69. package/dist/services/messaging.js.map +1 -1
  70. package/dist/services/messaging.mjs +1417 -592
  71. package/dist/services/messaging.mjs.map +1 -1
  72. package/dist/services/sites.d.mts +499 -103
  73. package/dist/services/sites.d.ts +499 -103
  74. package/dist/services/sites.js +371 -258
  75. package/dist/services/sites.js.map +1 -1
  76. package/dist/services/sites.mjs +371 -258
  77. package/dist/services/sites.mjs.map +1 -1
  78. package/dist/services/storage.d.mts +311 -68
  79. package/dist/services/storage.d.ts +311 -68
  80. package/dist/services/storage.js +225 -158
  81. package/dist/services/storage.js.map +1 -1
  82. package/dist/services/storage.mjs +225 -158
  83. package/dist/services/storage.mjs.map +1 -1
  84. package/dist/services/tables-db.d.mts +1549 -0
  85. package/dist/services/tables-db.d.ts +1549 -0
  86. package/dist/services/tables-db.js +2374 -0
  87. package/dist/services/tables-db.js.map +1 -0
  88. package/dist/services/tables-db.mjs +2373 -0
  89. package/dist/services/tables-db.mjs.map +1 -0
  90. package/dist/services/teams.d.mts +249 -55
  91. package/dist/services/teams.d.ts +249 -55
  92. package/dist/services/teams.js +170 -135
  93. package/dist/services/teams.js.map +1 -1
  94. package/dist/services/teams.mjs +170 -135
  95. package/dist/services/teams.mjs.map +1 -1
  96. package/dist/services/tokens.d.mts +76 -11
  97. package/dist/services/tokens.d.ts +76 -11
  98. package/dist/services/tokens.js +60 -45
  99. package/dist/services/tokens.js.map +1 -1
  100. package/dist/services/tokens.mjs +60 -45
  101. package/dist/services/tokens.mjs.map +1 -1
  102. package/dist/services/users.d.mts +867 -140
  103. package/dist/services/users.d.ts +867 -140
  104. package/dist/services/users.js +719 -408
  105. package/dist/services/users.js.map +1 -1
  106. package/dist/services/users.mjs +719 -408
  107. package/dist/services/users.mjs.map +1 -1
  108. package/package.json +1 -1
  109. package/dist/enums/v-c-s-deployment-type.js.map +0 -1
  110. package/dist/enums/v-c-s-deployment-type.mjs.map +0 -1
  111. /package/dist/enums/{v-c-s-deployment-type.d.mts → vcs-deployment-type.d.mts} +0 -0
  112. /package/dist/enums/{v-c-s-deployment-type.d.ts → vcs-deployment-type.d.ts} +0 -0
@@ -3,7 +3,7 @@ import { Models } from '../models.mjs';
3
3
  import { Framework } from '../enums/framework.mjs';
4
4
  import { BuildRuntime } from '../enums/build-runtime.mjs';
5
5
  import { Adapter } from '../enums/adapter.mjs';
6
- import { VCSDeploymentType } from '../enums/v-c-s-deployment-type.mjs';
6
+ import { VCSDeploymentType } from '../enums/vcs-deployment-type.mjs';
7
7
  import { DeploymentDownloadType } from '../enums/deployment-download-type.mjs';
8
8
  import '../query.mjs';
9
9
 
@@ -11,37 +11,95 @@ declare class Sites {
11
11
  client: Client;
12
12
  constructor(client: Client);
13
13
  /**
14
- * Get a list of all the project's sites. You can use the query params to filter your results.
14
+ * Get a list of all the project's sites. You can use the query params to filter your results.
15
15
  *
16
- * @param {string[]} queries
17
- * @param {string} search
16
+ * @param {string[]} params.queries - Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following attributes: name, enabled, framework, deploymentId, buildCommand, installCommand, outputDirectory, installationId
17
+ * @param {string} params.search - Search term to filter your list results. Max length: 256 chars.
18
18
  * @throws {AppwriteException}
19
19
  * @returns {Promise<Models.SiteList>}
20
20
  */
21
+ list(params?: {
22
+ queries?: string[];
23
+ search?: string;
24
+ }): Promise<Models.SiteList>;
25
+ /**
26
+ * Get a list of all the project's sites. You can use the query params to filter your results.
27
+ *
28
+ * @param {string[]} queries - Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following attributes: name, enabled, framework, deploymentId, buildCommand, installCommand, outputDirectory, installationId
29
+ * @param {string} search - Search term to filter your list results. Max length: 256 chars.
30
+ * @throws {AppwriteException}
31
+ * @returns {Promise<Models.SiteList>}
32
+ * @deprecated Use the object parameter style method for a better developer experience.
33
+ */
21
34
  list(queries?: string[], search?: string): Promise<Models.SiteList>;
22
35
  /**
23
36
  * Create a new site.
24
37
  *
25
- * @param {string} siteId
26
- * @param {string} name
27
- * @param {Framework} framework
28
- * @param {BuildRuntime} buildRuntime
29
- * @param {boolean} enabled
30
- * @param {boolean} logging
31
- * @param {number} timeout
32
- * @param {string} installCommand
33
- * @param {string} buildCommand
34
- * @param {string} outputDirectory
35
- * @param {Adapter} adapter
36
- * @param {string} installationId
37
- * @param {string} fallbackFile
38
- * @param {string} providerRepositoryId
39
- * @param {string} providerBranch
40
- * @param {boolean} providerSilentMode
41
- * @param {string} providerRootDirectory
42
- * @param {string} specification
38
+ * @param {string} params.siteId - Site ID. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.
39
+ * @param {string} params.name - Site name. Max length: 128 chars.
40
+ * @param {Framework} params.framework - Sites framework.
41
+ * @param {BuildRuntime} params.buildRuntime - Runtime to use during build step.
42
+ * @param {boolean} params.enabled - Is site enabled? When set to 'disabled', users cannot access the site but Server SDKs with and API key can still access the site. No data is lost when this is toggled.
43
+ * @param {boolean} params.logging - When disabled, request logs will exclude logs and errors, and site responses will be slightly faster.
44
+ * @param {number} params.timeout - Maximum request time in seconds.
45
+ * @param {string} params.installCommand - Install Command.
46
+ * @param {string} params.buildCommand - Build Command.
47
+ * @param {string} params.outputDirectory - Output Directory for site.
48
+ * @param {Adapter} params.adapter - Framework adapter defining rendering strategy. Allowed values are: static, ssr
49
+ * @param {string} params.installationId - Appwrite Installation ID for VCS (Version Control System) deployment.
50
+ * @param {string} params.fallbackFile - Fallback file for single page application sites.
51
+ * @param {string} params.providerRepositoryId - Repository ID of the repo linked to the site.
52
+ * @param {string} params.providerBranch - Production branch for the repo linked to the site.
53
+ * @param {boolean} params.providerSilentMode - Is the VCS (Version Control System) connection in silent mode for the repo linked to the site? In silent mode, comments will not be made on commits and pull requests.
54
+ * @param {string} params.providerRootDirectory - Path to site code in the linked repo.
55
+ * @param {string} params.specification - Framework specification for the site and builds.
56
+ * @throws {AppwriteException}
57
+ * @returns {Promise<Models.Site>}
58
+ */
59
+ create(params: {
60
+ siteId: string;
61
+ name: string;
62
+ framework: Framework;
63
+ buildRuntime: BuildRuntime;
64
+ enabled?: boolean;
65
+ logging?: boolean;
66
+ timeout?: number;
67
+ installCommand?: string;
68
+ buildCommand?: string;
69
+ outputDirectory?: string;
70
+ adapter?: Adapter;
71
+ installationId?: string;
72
+ fallbackFile?: string;
73
+ providerRepositoryId?: string;
74
+ providerBranch?: string;
75
+ providerSilentMode?: boolean;
76
+ providerRootDirectory?: string;
77
+ specification?: string;
78
+ }): Promise<Models.Site>;
79
+ /**
80
+ * Create a new site.
81
+ *
82
+ * @param {string} siteId - Site ID. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.
83
+ * @param {string} name - Site name. Max length: 128 chars.
84
+ * @param {Framework} framework - Sites framework.
85
+ * @param {BuildRuntime} buildRuntime - Runtime to use during build step.
86
+ * @param {boolean} enabled - Is site enabled? When set to 'disabled', users cannot access the site but Server SDKs with and API key can still access the site. No data is lost when this is toggled.
87
+ * @param {boolean} logging - When disabled, request logs will exclude logs and errors, and site responses will be slightly faster.
88
+ * @param {number} timeout - Maximum request time in seconds.
89
+ * @param {string} installCommand - Install Command.
90
+ * @param {string} buildCommand - Build Command.
91
+ * @param {string} outputDirectory - Output Directory for site.
92
+ * @param {Adapter} adapter - Framework adapter defining rendering strategy. Allowed values are: static, ssr
93
+ * @param {string} installationId - Appwrite Installation ID for VCS (Version Control System) deployment.
94
+ * @param {string} fallbackFile - Fallback file for single page application sites.
95
+ * @param {string} providerRepositoryId - Repository ID of the repo linked to the site.
96
+ * @param {string} providerBranch - Production branch for the repo linked to the site.
97
+ * @param {boolean} providerSilentMode - Is the VCS (Version Control System) connection in silent mode for the repo linked to the site? In silent mode, comments will not be made on commits and pull requests.
98
+ * @param {string} providerRootDirectory - Path to site code in the linked repo.
99
+ * @param {string} specification - Framework specification for the site and builds.
43
100
  * @throws {AppwriteException}
44
101
  * @returns {Promise<Models.Site>}
102
+ * @deprecated Use the object parameter style method for a better developer experience.
45
103
  */
46
104
  create(siteId: string, name: string, framework: Framework, buildRuntime: BuildRuntime, enabled?: boolean, logging?: boolean, timeout?: number, installCommand?: string, buildCommand?: string, outputDirectory?: string, adapter?: Adapter, installationId?: string, fallbackFile?: string, providerRepositoryId?: string, providerBranch?: string, providerSilentMode?: boolean, providerRootDirectory?: string, specification?: string): Promise<Models.Site>;
47
105
  /**
@@ -61,224 +119,562 @@ declare class Sites {
61
119
  /**
62
120
  * Get a site by its unique ID.
63
121
  *
64
- * @param {string} siteId
122
+ * @param {string} params.siteId - Site ID.
65
123
  * @throws {AppwriteException}
66
124
  * @returns {Promise<Models.Site>}
67
125
  */
126
+ get(params: {
127
+ siteId: string;
128
+ }): Promise<Models.Site>;
129
+ /**
130
+ * Get a site by its unique ID.
131
+ *
132
+ * @param {string} siteId - Site ID.
133
+ * @throws {AppwriteException}
134
+ * @returns {Promise<Models.Site>}
135
+ * @deprecated Use the object parameter style method for a better developer experience.
136
+ */
68
137
  get(siteId: string): Promise<Models.Site>;
69
138
  /**
70
139
  * Update site by its unique ID.
71
140
  *
72
- * @param {string} siteId
73
- * @param {string} name
74
- * @param {Framework} framework
75
- * @param {boolean} enabled
76
- * @param {boolean} logging
77
- * @param {number} timeout
78
- * @param {string} installCommand
79
- * @param {string} buildCommand
80
- * @param {string} outputDirectory
81
- * @param {BuildRuntime} buildRuntime
82
- * @param {Adapter} adapter
83
- * @param {string} fallbackFile
84
- * @param {string} installationId
85
- * @param {string} providerRepositoryId
86
- * @param {string} providerBranch
87
- * @param {boolean} providerSilentMode
88
- * @param {string} providerRootDirectory
89
- * @param {string} specification
141
+ * @param {string} params.siteId - Site ID.
142
+ * @param {string} params.name - Site name. Max length: 128 chars.
143
+ * @param {Framework} params.framework - Sites framework.
144
+ * @param {boolean} params.enabled - Is site enabled? When set to 'disabled', users cannot access the site but Server SDKs with and API key can still access the site. No data is lost when this is toggled.
145
+ * @param {boolean} params.logging - When disabled, request logs will exclude logs and errors, and site responses will be slightly faster.
146
+ * @param {number} params.timeout - Maximum request time in seconds.
147
+ * @param {string} params.installCommand - Install Command.
148
+ * @param {string} params.buildCommand - Build Command.
149
+ * @param {string} params.outputDirectory - Output Directory for site.
150
+ * @param {BuildRuntime} params.buildRuntime - Runtime to use during build step.
151
+ * @param {Adapter} params.adapter - Framework adapter defining rendering strategy. Allowed values are: static, ssr
152
+ * @param {string} params.fallbackFile - Fallback file for single page application sites.
153
+ * @param {string} params.installationId - Appwrite Installation ID for VCS (Version Control System) deployment.
154
+ * @param {string} params.providerRepositoryId - Repository ID of the repo linked to the site.
155
+ * @param {string} params.providerBranch - Production branch for the repo linked to the site.
156
+ * @param {boolean} params.providerSilentMode - Is the VCS (Version Control System) connection in silent mode for the repo linked to the site? In silent mode, comments will not be made on commits and pull requests.
157
+ * @param {string} params.providerRootDirectory - Path to site code in the linked repo.
158
+ * @param {string} params.specification - Framework specification for the site and builds.
90
159
  * @throws {AppwriteException}
91
160
  * @returns {Promise<Models.Site>}
92
161
  */
162
+ update(params: {
163
+ siteId: string;
164
+ name: string;
165
+ framework: Framework;
166
+ enabled?: boolean;
167
+ logging?: boolean;
168
+ timeout?: number;
169
+ installCommand?: string;
170
+ buildCommand?: string;
171
+ outputDirectory?: string;
172
+ buildRuntime?: BuildRuntime;
173
+ adapter?: Adapter;
174
+ fallbackFile?: string;
175
+ installationId?: string;
176
+ providerRepositoryId?: string;
177
+ providerBranch?: string;
178
+ providerSilentMode?: boolean;
179
+ providerRootDirectory?: string;
180
+ specification?: string;
181
+ }): Promise<Models.Site>;
182
+ /**
183
+ * Update site by its unique ID.
184
+ *
185
+ * @param {string} siteId - Site ID.
186
+ * @param {string} name - Site name. Max length: 128 chars.
187
+ * @param {Framework} framework - Sites framework.
188
+ * @param {boolean} enabled - Is site enabled? When set to 'disabled', users cannot access the site but Server SDKs with and API key can still access the site. No data is lost when this is toggled.
189
+ * @param {boolean} logging - When disabled, request logs will exclude logs and errors, and site responses will be slightly faster.
190
+ * @param {number} timeout - Maximum request time in seconds.
191
+ * @param {string} installCommand - Install Command.
192
+ * @param {string} buildCommand - Build Command.
193
+ * @param {string} outputDirectory - Output Directory for site.
194
+ * @param {BuildRuntime} buildRuntime - Runtime to use during build step.
195
+ * @param {Adapter} adapter - Framework adapter defining rendering strategy. Allowed values are: static, ssr
196
+ * @param {string} fallbackFile - Fallback file for single page application sites.
197
+ * @param {string} installationId - Appwrite Installation ID for VCS (Version Control System) deployment.
198
+ * @param {string} providerRepositoryId - Repository ID of the repo linked to the site.
199
+ * @param {string} providerBranch - Production branch for the repo linked to the site.
200
+ * @param {boolean} providerSilentMode - Is the VCS (Version Control System) connection in silent mode for the repo linked to the site? In silent mode, comments will not be made on commits and pull requests.
201
+ * @param {string} providerRootDirectory - Path to site code in the linked repo.
202
+ * @param {string} specification - Framework specification for the site and builds.
203
+ * @throws {AppwriteException}
204
+ * @returns {Promise<Models.Site>}
205
+ * @deprecated Use the object parameter style method for a better developer experience.
206
+ */
93
207
  update(siteId: string, name: string, framework: Framework, enabled?: boolean, logging?: boolean, timeout?: number, installCommand?: string, buildCommand?: string, outputDirectory?: string, buildRuntime?: BuildRuntime, adapter?: Adapter, fallbackFile?: string, installationId?: string, providerRepositoryId?: string, providerBranch?: string, providerSilentMode?: boolean, providerRootDirectory?: string, specification?: string): Promise<Models.Site>;
94
208
  /**
95
209
  * Delete a site by its unique ID.
96
210
  *
97
- * @param {string} siteId
211
+ * @param {string} params.siteId - Site ID.
98
212
  * @throws {AppwriteException}
99
213
  * @returns {Promise<{}>}
100
214
  */
215
+ delete(params: {
216
+ siteId: string;
217
+ }): Promise<{}>;
218
+ /**
219
+ * Delete a site by its unique ID.
220
+ *
221
+ * @param {string} siteId - Site ID.
222
+ * @throws {AppwriteException}
223
+ * @returns {Promise<{}>}
224
+ * @deprecated Use the object parameter style method for a better developer experience.
225
+ */
101
226
  delete(siteId: string): Promise<{}>;
102
227
  /**
103
228
  * Update the site active deployment. Use this endpoint to switch the code deployment that should be used when visitor opens your site.
104
229
  *
105
- * @param {string} siteId
106
- * @param {string} deploymentId
230
+ * @param {string} params.siteId - Site ID.
231
+ * @param {string} params.deploymentId - Deployment ID.
232
+ * @throws {AppwriteException}
233
+ * @returns {Promise<Models.Site>}
234
+ */
235
+ updateSiteDeployment(params: {
236
+ siteId: string;
237
+ deploymentId: string;
238
+ }): Promise<Models.Site>;
239
+ /**
240
+ * Update the site active deployment. Use this endpoint to switch the code deployment that should be used when visitor opens your site.
241
+ *
242
+ * @param {string} siteId - Site ID.
243
+ * @param {string} deploymentId - Deployment ID.
107
244
  * @throws {AppwriteException}
108
245
  * @returns {Promise<Models.Site>}
246
+ * @deprecated Use the object parameter style method for a better developer experience.
109
247
  */
110
248
  updateSiteDeployment(siteId: string, deploymentId: string): Promise<Models.Site>;
111
249
  /**
112
- * Get a list of all the site&#039;s code deployments. You can use the query params to filter your results.
250
+ * Get a list of all the site's code deployments. You can use the query params to filter your results.
113
251
  *
114
- * @param {string} siteId
115
- * @param {string[]} queries
116
- * @param {string} search
252
+ * @param {string} params.siteId - Site ID.
253
+ * @param {string[]} params.queries - Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following attributes: buildSize, sourceSize, totalSize, buildDuration, status, activate, type
254
+ * @param {string} params.search - Search term to filter your list results. Max length: 256 chars.
117
255
  * @throws {AppwriteException}
118
256
  * @returns {Promise<Models.DeploymentList>}
119
257
  */
258
+ listDeployments(params: {
259
+ siteId: string;
260
+ queries?: string[];
261
+ search?: string;
262
+ }): Promise<Models.DeploymentList>;
263
+ /**
264
+ * Get a list of all the site's code deployments. You can use the query params to filter your results.
265
+ *
266
+ * @param {string} siteId - Site ID.
267
+ * @param {string[]} queries - Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following attributes: buildSize, sourceSize, totalSize, buildDuration, status, activate, type
268
+ * @param {string} search - Search term to filter your list results. Max length: 256 chars.
269
+ * @throws {AppwriteException}
270
+ * @returns {Promise<Models.DeploymentList>}
271
+ * @deprecated Use the object parameter style method for a better developer experience.
272
+ */
120
273
  listDeployments(siteId: string, queries?: string[], search?: string): Promise<Models.DeploymentList>;
121
274
  /**
122
- * Create a new site code deployment. Use this endpoint to upload a new version of your site code. To activate your newly uploaded code, you&#039;ll need to update the function&#039;s deployment to use your new deployment ID.
275
+ * Create a new site code deployment. Use this endpoint to upload a new version of your site code. To activate your newly uploaded code, you'll need to update the function's deployment to use your new deployment ID.
123
276
  *
124
- * @param {string} siteId
125
- * @param {File} code
126
- * @param {boolean} activate
127
- * @param {string} installCommand
128
- * @param {string} buildCommand
129
- * @param {string} outputDirectory
277
+ * @param {string} params.siteId - Site ID.
278
+ * @param {File} params.code - Gzip file with your code package. When used with the Appwrite CLI, pass the path to your code directory, and the CLI will automatically package your code. Use a path that is within the current directory.
279
+ * @param {boolean} params.activate - Automatically activate the deployment when it is finished building.
280
+ * @param {string} params.installCommand - Install Commands.
281
+ * @param {string} params.buildCommand - Build Commands.
282
+ * @param {string} params.outputDirectory - Output Directory.
130
283
  * @throws {AppwriteException}
131
284
  * @returns {Promise<Models.Deployment>}
132
285
  */
286
+ createDeployment(params: {
287
+ siteId: string;
288
+ code: File;
289
+ activate: boolean;
290
+ installCommand?: string;
291
+ buildCommand?: string;
292
+ outputDirectory?: string;
293
+ onProgress?: (progress: UploadProgress) => void;
294
+ }): Promise<Models.Deployment>;
295
+ /**
296
+ * Create a new site code deployment. Use this endpoint to upload a new version of your site code. To activate your newly uploaded code, you'll need to update the function's deployment to use your new deployment ID.
297
+ *
298
+ * @param {string} siteId - Site ID.
299
+ * @param {File} code - Gzip file with your code package. When used with the Appwrite CLI, pass the path to your code directory, and the CLI will automatically package your code. Use a path that is within the current directory.
300
+ * @param {boolean} activate - Automatically activate the deployment when it is finished building.
301
+ * @param {string} installCommand - Install Commands.
302
+ * @param {string} buildCommand - Build Commands.
303
+ * @param {string} outputDirectory - Output Directory.
304
+ * @throws {AppwriteException}
305
+ * @returns {Promise<Models.Deployment>}
306
+ * @deprecated Use the object parameter style method for a better developer experience.
307
+ */
133
308
  createDeployment(siteId: string, code: File, activate: boolean, installCommand?: string, buildCommand?: string, outputDirectory?: string, onProgress?: (progress: UploadProgress) => void): Promise<Models.Deployment>;
134
309
  /**
135
- * Create a new build for an existing site deployment. This endpoint allows you to rebuild a deployment with the updated site configuration, including its commands and output directory if they have been modified. The build process will be queued and executed asynchronously. The original deployment&#039;s code will be preserved and used for the new build.
310
+ * Create a new build for an existing site deployment. This endpoint allows you to rebuild a deployment with the updated site configuration, including its commands and output directory if they have been modified. The build process will be queued and executed asynchronously. The original deployment's code will be preserved and used for the new build.
311
+ *
312
+ * @param {string} params.siteId - Site ID.
313
+ * @param {string} params.deploymentId - Deployment ID.
314
+ * @throws {AppwriteException}
315
+ * @returns {Promise<Models.Deployment>}
316
+ */
317
+ createDuplicateDeployment(params: {
318
+ siteId: string;
319
+ deploymentId: string;
320
+ }): Promise<Models.Deployment>;
321
+ /**
322
+ * Create a new build for an existing site deployment. This endpoint allows you to rebuild a deployment with the updated site configuration, including its commands and output directory if they have been modified. The build process will be queued and executed asynchronously. The original deployment's code will be preserved and used for the new build.
136
323
  *
137
- * @param {string} siteId
138
- * @param {string} deploymentId
324
+ * @param {string} siteId - Site ID.
325
+ * @param {string} deploymentId - Deployment ID.
139
326
  * @throws {AppwriteException}
140
327
  * @returns {Promise<Models.Deployment>}
328
+ * @deprecated Use the object parameter style method for a better developer experience.
141
329
  */
142
330
  createDuplicateDeployment(siteId: string, deploymentId: string): Promise<Models.Deployment>;
143
331
  /**
144
332
  * Create a deployment based on a template.
145
-
146
- Use this endpoint with combination of [listTemplates](https://appwrite.io/docs/server/sites#listTemplates) to find the template details.
147
333
  *
148
- * @param {string} siteId
149
- * @param {string} repository
150
- * @param {string} owner
151
- * @param {string} rootDirectory
152
- * @param {string} version
153
- * @param {boolean} activate
334
+ * Use this endpoint with combination of [listTemplates](https://appwrite.io/docs/server/sites#listTemplates) to find the template details.
335
+ *
336
+ * @param {string} params.siteId - Site ID.
337
+ * @param {string} params.repository - Repository name of the template.
338
+ * @param {string} params.owner - The name of the owner of the template.
339
+ * @param {string} params.rootDirectory - Path to site code in the template repo.
340
+ * @param {string} params.version - Version (tag) for the repo linked to the site template.
341
+ * @param {boolean} params.activate - Automatically activate the deployment when it is finished building.
154
342
  * @throws {AppwriteException}
155
343
  * @returns {Promise<Models.Deployment>}
156
344
  */
345
+ createTemplateDeployment(params: {
346
+ siteId: string;
347
+ repository: string;
348
+ owner: string;
349
+ rootDirectory: string;
350
+ version: string;
351
+ activate?: boolean;
352
+ }): Promise<Models.Deployment>;
353
+ /**
354
+ * Create a deployment based on a template.
355
+ *
356
+ * Use this endpoint with combination of [listTemplates](https://appwrite.io/docs/server/sites#listTemplates) to find the template details.
357
+ *
358
+ * @param {string} siteId - Site ID.
359
+ * @param {string} repository - Repository name of the template.
360
+ * @param {string} owner - The name of the owner of the template.
361
+ * @param {string} rootDirectory - Path to site code in the template repo.
362
+ * @param {string} version - Version (tag) for the repo linked to the site template.
363
+ * @param {boolean} activate - Automatically activate the deployment when it is finished building.
364
+ * @throws {AppwriteException}
365
+ * @returns {Promise<Models.Deployment>}
366
+ * @deprecated Use the object parameter style method for a better developer experience.
367
+ */
157
368
  createTemplateDeployment(siteId: string, repository: string, owner: string, rootDirectory: string, version: string, activate?: boolean): Promise<Models.Deployment>;
158
369
  /**
159
370
  * Create a deployment when a site is connected to VCS.
160
-
161
- This endpoint lets you create deployment from a branch, commit, or a tag.
162
371
  *
163
- * @param {string} siteId
164
- * @param {VCSDeploymentType} type
165
- * @param {string} reference
166
- * @param {boolean} activate
372
+ * This endpoint lets you create deployment from a branch, commit, or a tag.
373
+ *
374
+ * @param {string} params.siteId - Site ID.
375
+ * @param {VCSDeploymentType} params.type - Type of reference passed. Allowed values are: branch, commit
376
+ * @param {string} params.reference - VCS reference to create deployment from. Depending on type this can be: branch name, commit hash
377
+ * @param {boolean} params.activate - Automatically activate the deployment when it is finished building.
167
378
  * @throws {AppwriteException}
168
379
  * @returns {Promise<Models.Deployment>}
169
380
  */
381
+ createVcsDeployment(params: {
382
+ siteId: string;
383
+ type: VCSDeploymentType;
384
+ reference: string;
385
+ activate?: boolean;
386
+ }): Promise<Models.Deployment>;
387
+ /**
388
+ * Create a deployment when a site is connected to VCS.
389
+ *
390
+ * This endpoint lets you create deployment from a branch, commit, or a tag.
391
+ *
392
+ * @param {string} siteId - Site ID.
393
+ * @param {VCSDeploymentType} type - Type of reference passed. Allowed values are: branch, commit
394
+ * @param {string} reference - VCS reference to create deployment from. Depending on type this can be: branch name, commit hash
395
+ * @param {boolean} activate - Automatically activate the deployment when it is finished building.
396
+ * @throws {AppwriteException}
397
+ * @returns {Promise<Models.Deployment>}
398
+ * @deprecated Use the object parameter style method for a better developer experience.
399
+ */
170
400
  createVcsDeployment(siteId: string, type: VCSDeploymentType, reference: string, activate?: boolean): Promise<Models.Deployment>;
171
401
  /**
172
402
  * Get a site deployment by its unique ID.
173
403
  *
174
- * @param {string} siteId
175
- * @param {string} deploymentId
404
+ * @param {string} params.siteId - Site ID.
405
+ * @param {string} params.deploymentId - Deployment ID.
406
+ * @throws {AppwriteException}
407
+ * @returns {Promise<Models.Deployment>}
408
+ */
409
+ getDeployment(params: {
410
+ siteId: string;
411
+ deploymentId: string;
412
+ }): Promise<Models.Deployment>;
413
+ /**
414
+ * Get a site deployment by its unique ID.
415
+ *
416
+ * @param {string} siteId - Site ID.
417
+ * @param {string} deploymentId - Deployment ID.
176
418
  * @throws {AppwriteException}
177
419
  * @returns {Promise<Models.Deployment>}
420
+ * @deprecated Use the object parameter style method for a better developer experience.
178
421
  */
179
422
  getDeployment(siteId: string, deploymentId: string): Promise<Models.Deployment>;
180
423
  /**
181
424
  * Delete a site deployment by its unique ID.
182
425
  *
183
- * @param {string} siteId
184
- * @param {string} deploymentId
426
+ * @param {string} params.siteId - Site ID.
427
+ * @param {string} params.deploymentId - Deployment ID.
428
+ * @throws {AppwriteException}
429
+ * @returns {Promise<{}>}
430
+ */
431
+ deleteDeployment(params: {
432
+ siteId: string;
433
+ deploymentId: string;
434
+ }): Promise<{}>;
435
+ /**
436
+ * Delete a site deployment by its unique ID.
437
+ *
438
+ * @param {string} siteId - Site ID.
439
+ * @param {string} deploymentId - Deployment ID.
185
440
  * @throws {AppwriteException}
186
441
  * @returns {Promise<{}>}
442
+ * @deprecated Use the object parameter style method for a better developer experience.
187
443
  */
188
444
  deleteDeployment(siteId: string, deploymentId: string): Promise<{}>;
189
445
  /**
190
- * Get a site deployment content by its unique ID. The endpoint response return with a &#039;Content-Disposition: attachment&#039; header that tells the browser to start downloading the file to user downloads directory.
446
+ * Get a site deployment content by its unique ID. The endpoint response return with a 'Content-Disposition: attachment' header that tells the browser to start downloading the file to user downloads directory.
191
447
  *
192
- * @param {string} siteId
193
- * @param {string} deploymentId
194
- * @param {DeploymentDownloadType} type
448
+ * @param {string} params.siteId - Site ID.
449
+ * @param {string} params.deploymentId - Deployment ID.
450
+ * @param {DeploymentDownloadType} params.type - Deployment file to download. Can be: "source", "output".
195
451
  * @throws {AppwriteException}
196
452
  * @returns {Promise<ArrayBuffer>}
197
453
  */
454
+ getDeploymentDownload(params: {
455
+ siteId: string;
456
+ deploymentId: string;
457
+ type?: DeploymentDownloadType;
458
+ }): Promise<ArrayBuffer>;
459
+ /**
460
+ * Get a site deployment content by its unique ID. The endpoint response return with a 'Content-Disposition: attachment' header that tells the browser to start downloading the file to user downloads directory.
461
+ *
462
+ * @param {string} siteId - Site ID.
463
+ * @param {string} deploymentId - Deployment ID.
464
+ * @param {DeploymentDownloadType} type - Deployment file to download. Can be: "source", "output".
465
+ * @throws {AppwriteException}
466
+ * @returns {Promise<ArrayBuffer>}
467
+ * @deprecated Use the object parameter style method for a better developer experience.
468
+ */
198
469
  getDeploymentDownload(siteId: string, deploymentId: string, type?: DeploymentDownloadType): Promise<ArrayBuffer>;
199
470
  /**
200
- * Cancel an ongoing site deployment build. If the build is already in progress, it will be stopped and marked as canceled. If the build hasn&#039;t started yet, it will be marked as canceled without executing. You cannot cancel builds that have already completed (status &#039;ready&#039;) or failed. The response includes the final build status and details.
471
+ * Cancel an ongoing site deployment build. If the build is already in progress, it will be stopped and marked as canceled. If the build hasn't started yet, it will be marked as canceled without executing. You cannot cancel builds that have already completed (status 'ready') or failed. The response includes the final build status and details.
201
472
  *
202
- * @param {string} siteId
203
- * @param {string} deploymentId
473
+ * @param {string} params.siteId - Site ID.
474
+ * @param {string} params.deploymentId - Deployment ID.
204
475
  * @throws {AppwriteException}
205
476
  * @returns {Promise<Models.Deployment>}
206
477
  */
478
+ updateDeploymentStatus(params: {
479
+ siteId: string;
480
+ deploymentId: string;
481
+ }): Promise<Models.Deployment>;
482
+ /**
483
+ * Cancel an ongoing site deployment build. If the build is already in progress, it will be stopped and marked as canceled. If the build hasn't started yet, it will be marked as canceled without executing. You cannot cancel builds that have already completed (status 'ready') or failed. The response includes the final build status and details.
484
+ *
485
+ * @param {string} siteId - Site ID.
486
+ * @param {string} deploymentId - Deployment ID.
487
+ * @throws {AppwriteException}
488
+ * @returns {Promise<Models.Deployment>}
489
+ * @deprecated Use the object parameter style method for a better developer experience.
490
+ */
207
491
  updateDeploymentStatus(siteId: string, deploymentId: string): Promise<Models.Deployment>;
208
492
  /**
209
493
  * Get a list of all site logs. You can use the query params to filter your results.
210
494
  *
211
- * @param {string} siteId
212
- * @param {string[]} queries
495
+ * @param {string} params.siteId - Site ID.
496
+ * @param {string[]} params.queries - Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following attributes: trigger, status, responseStatusCode, duration, requestMethod, requestPath, deploymentId
497
+ * @throws {AppwriteException}
498
+ * @returns {Promise<Models.ExecutionList>}
499
+ */
500
+ listLogs(params: {
501
+ siteId: string;
502
+ queries?: string[];
503
+ }): Promise<Models.ExecutionList>;
504
+ /**
505
+ * Get a list of all site logs. You can use the query params to filter your results.
506
+ *
507
+ * @param {string} siteId - Site ID.
508
+ * @param {string[]} queries - Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following attributes: trigger, status, responseStatusCode, duration, requestMethod, requestPath, deploymentId
213
509
  * @throws {AppwriteException}
214
510
  * @returns {Promise<Models.ExecutionList>}
511
+ * @deprecated Use the object parameter style method for a better developer experience.
215
512
  */
216
513
  listLogs(siteId: string, queries?: string[]): Promise<Models.ExecutionList>;
217
514
  /**
218
515
  * Get a site request log by its unique ID.
219
516
  *
220
- * @param {string} siteId
221
- * @param {string} logId
517
+ * @param {string} params.siteId - Site ID.
518
+ * @param {string} params.logId - Log ID.
222
519
  * @throws {AppwriteException}
223
520
  * @returns {Promise<Models.Execution>}
224
521
  */
522
+ getLog(params: {
523
+ siteId: string;
524
+ logId: string;
525
+ }): Promise<Models.Execution>;
526
+ /**
527
+ * Get a site request log by its unique ID.
528
+ *
529
+ * @param {string} siteId - Site ID.
530
+ * @param {string} logId - Log ID.
531
+ * @throws {AppwriteException}
532
+ * @returns {Promise<Models.Execution>}
533
+ * @deprecated Use the object parameter style method for a better developer experience.
534
+ */
225
535
  getLog(siteId: string, logId: string): Promise<Models.Execution>;
226
536
  /**
227
537
  * Delete a site log by its unique ID.
228
538
  *
229
- * @param {string} siteId
230
- * @param {string} logId
539
+ * @param {string} params.siteId - Site ID.
540
+ * @param {string} params.logId - Log ID.
231
541
  * @throws {AppwriteException}
232
542
  * @returns {Promise<{}>}
233
543
  */
544
+ deleteLog(params: {
545
+ siteId: string;
546
+ logId: string;
547
+ }): Promise<{}>;
548
+ /**
549
+ * Delete a site log by its unique ID.
550
+ *
551
+ * @param {string} siteId - Site ID.
552
+ * @param {string} logId - Log ID.
553
+ * @throws {AppwriteException}
554
+ * @returns {Promise<{}>}
555
+ * @deprecated Use the object parameter style method for a better developer experience.
556
+ */
234
557
  deleteLog(siteId: string, logId: string): Promise<{}>;
235
558
  /**
236
559
  * Get a list of all variables of a specific site.
237
560
  *
238
- * @param {string} siteId
561
+ * @param {string} params.siteId - Site unique ID.
239
562
  * @throws {AppwriteException}
240
563
  * @returns {Promise<Models.VariableList>}
241
564
  */
565
+ listVariables(params: {
566
+ siteId: string;
567
+ }): Promise<Models.VariableList>;
568
+ /**
569
+ * Get a list of all variables of a specific site.
570
+ *
571
+ * @param {string} siteId - Site unique ID.
572
+ * @throws {AppwriteException}
573
+ * @returns {Promise<Models.VariableList>}
574
+ * @deprecated Use the object parameter style method for a better developer experience.
575
+ */
242
576
  listVariables(siteId: string): Promise<Models.VariableList>;
243
577
  /**
244
578
  * Create a new site variable. These variables can be accessed during build and runtime (server-side rendering) as environment variables.
245
579
  *
246
- * @param {string} siteId
247
- * @param {string} key
248
- * @param {string} value
249
- * @param {boolean} secret
580
+ * @param {string} params.siteId - Site unique ID.
581
+ * @param {string} params.key - Variable key. Max length: 255 chars.
582
+ * @param {string} params.value - Variable value. Max length: 8192 chars.
583
+ * @param {boolean} params.secret - Secret variables can be updated or deleted, but only sites can read them during build and runtime.
584
+ * @throws {AppwriteException}
585
+ * @returns {Promise<Models.Variable>}
586
+ */
587
+ createVariable(params: {
588
+ siteId: string;
589
+ key: string;
590
+ value: string;
591
+ secret?: boolean;
592
+ }): Promise<Models.Variable>;
593
+ /**
594
+ * Create a new site variable. These variables can be accessed during build and runtime (server-side rendering) as environment variables.
595
+ *
596
+ * @param {string} siteId - Site unique ID.
597
+ * @param {string} key - Variable key. Max length: 255 chars.
598
+ * @param {string} value - Variable value. Max length: 8192 chars.
599
+ * @param {boolean} secret - Secret variables can be updated or deleted, but only sites can read them during build and runtime.
250
600
  * @throws {AppwriteException}
251
601
  * @returns {Promise<Models.Variable>}
602
+ * @deprecated Use the object parameter style method for a better developer experience.
252
603
  */
253
604
  createVariable(siteId: string, key: string, value: string, secret?: boolean): Promise<Models.Variable>;
254
605
  /**
255
606
  * Get a variable by its unique ID.
256
607
  *
257
- * @param {string} siteId
258
- * @param {string} variableId
608
+ * @param {string} params.siteId - Site unique ID.
609
+ * @param {string} params.variableId - Variable unique ID.
610
+ * @throws {AppwriteException}
611
+ * @returns {Promise<Models.Variable>}
612
+ */
613
+ getVariable(params: {
614
+ siteId: string;
615
+ variableId: string;
616
+ }): Promise<Models.Variable>;
617
+ /**
618
+ * Get a variable by its unique ID.
619
+ *
620
+ * @param {string} siteId - Site unique ID.
621
+ * @param {string} variableId - Variable unique ID.
259
622
  * @throws {AppwriteException}
260
623
  * @returns {Promise<Models.Variable>}
624
+ * @deprecated Use the object parameter style method for a better developer experience.
261
625
  */
262
626
  getVariable(siteId: string, variableId: string): Promise<Models.Variable>;
263
627
  /**
264
628
  * Update variable by its unique ID.
265
629
  *
266
- * @param {string} siteId
267
- * @param {string} variableId
268
- * @param {string} key
269
- * @param {string} value
270
- * @param {boolean} secret
630
+ * @param {string} params.siteId - Site unique ID.
631
+ * @param {string} params.variableId - Variable unique ID.
632
+ * @param {string} params.key - Variable key. Max length: 255 chars.
633
+ * @param {string} params.value - Variable value. Max length: 8192 chars.
634
+ * @param {boolean} params.secret - Secret variables can be updated or deleted, but only sites can read them during build and runtime.
271
635
  * @throws {AppwriteException}
272
636
  * @returns {Promise<Models.Variable>}
273
637
  */
638
+ updateVariable(params: {
639
+ siteId: string;
640
+ variableId: string;
641
+ key: string;
642
+ value?: string;
643
+ secret?: boolean;
644
+ }): Promise<Models.Variable>;
645
+ /**
646
+ * Update variable by its unique ID.
647
+ *
648
+ * @param {string} siteId - Site unique ID.
649
+ * @param {string} variableId - Variable unique ID.
650
+ * @param {string} key - Variable key. Max length: 255 chars.
651
+ * @param {string} value - Variable value. Max length: 8192 chars.
652
+ * @param {boolean} secret - Secret variables can be updated or deleted, but only sites can read them during build and runtime.
653
+ * @throws {AppwriteException}
654
+ * @returns {Promise<Models.Variable>}
655
+ * @deprecated Use the object parameter style method for a better developer experience.
656
+ */
274
657
  updateVariable(siteId: string, variableId: string, key: string, value?: string, secret?: boolean): Promise<Models.Variable>;
275
658
  /**
276
659
  * Delete a variable by its unique ID.
277
660
  *
278
- * @param {string} siteId
279
- * @param {string} variableId
661
+ * @param {string} params.siteId - Site unique ID.
662
+ * @param {string} params.variableId - Variable unique ID.
663
+ * @throws {AppwriteException}
664
+ * @returns {Promise<{}>}
665
+ */
666
+ deleteVariable(params: {
667
+ siteId: string;
668
+ variableId: string;
669
+ }): Promise<{}>;
670
+ /**
671
+ * Delete a variable by its unique ID.
672
+ *
673
+ * @param {string} siteId - Site unique ID.
674
+ * @param {string} variableId - Variable unique ID.
280
675
  * @throws {AppwriteException}
281
676
  * @returns {Promise<{}>}
677
+ * @deprecated Use the object parameter style method for a better developer experience.
282
678
  */
283
679
  deleteVariable(siteId: string, variableId: string): Promise<{}>;
284
680
  }