appium 2.0.0-beta.5 → 2.0.0-beta.53

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 (199) hide show
  1. package/README.md +156 -63
  2. package/build/lib/appium.d.ts +226 -0
  3. package/build/lib/appium.d.ts.map +1 -0
  4. package/build/lib/appium.js +694 -439
  5. package/build/lib/appium.js.map +1 -0
  6. package/build/lib/cli/args.d.ts +17 -0
  7. package/build/lib/cli/args.d.ts.map +1 -0
  8. package/build/lib/cli/args.js +253 -319
  9. package/build/lib/cli/args.js.map +1 -0
  10. package/build/lib/cli/driver-command.d.ts +102 -0
  11. package/build/lib/cli/driver-command.d.ts.map +1 -0
  12. package/build/lib/cli/driver-command.js +126 -81
  13. package/build/lib/cli/driver-command.js.map +1 -0
  14. package/build/lib/cli/extension-command.d.ts +385 -0
  15. package/build/lib/cli/extension-command.d.ts.map +1 -0
  16. package/build/lib/cli/extension-command.js +731 -383
  17. package/build/lib/cli/extension-command.js.map +1 -0
  18. package/build/lib/cli/extension.d.ts +23 -0
  19. package/build/lib/cli/extension.d.ts.map +1 -0
  20. package/build/lib/cli/extension.js +71 -54
  21. package/build/lib/cli/extension.js.map +1 -0
  22. package/build/lib/cli/parser.d.ts +84 -0
  23. package/build/lib/cli/parser.d.ts.map +1 -0
  24. package/build/lib/cli/parser.js +240 -128
  25. package/build/lib/cli/parser.js.map +1 -0
  26. package/build/lib/cli/plugin-command.d.ts +99 -0
  27. package/build/lib/cli/plugin-command.d.ts.map +1 -0
  28. package/build/lib/cli/plugin-command.js +120 -81
  29. package/build/lib/cli/plugin-command.js.map +1 -0
  30. package/build/lib/cli/utils.d.ts +29 -0
  31. package/build/lib/cli/utils.d.ts.map +1 -0
  32. package/build/lib/cli/utils.js +72 -51
  33. package/build/lib/cli/utils.js.map +1 -0
  34. package/build/lib/config-file.d.ts +100 -0
  35. package/build/lib/config-file.d.ts.map +1 -0
  36. package/build/lib/config-file.js +207 -0
  37. package/build/lib/config-file.js.map +1 -0
  38. package/build/lib/config.d.ts +49 -0
  39. package/build/lib/config.d.ts.map +1 -0
  40. package/build/lib/config.js +265 -201
  41. package/build/lib/config.js.map +1 -0
  42. package/build/lib/constants.d.ts +49 -0
  43. package/build/lib/constants.d.ts.map +1 -0
  44. package/build/lib/constants.js +66 -0
  45. package/build/lib/constants.js.map +1 -0
  46. package/build/lib/extension/driver-config.d.ts +82 -0
  47. package/build/lib/extension/driver-config.d.ts.map +1 -0
  48. package/build/lib/extension/driver-config.js +212 -0
  49. package/build/lib/extension/driver-config.js.map +1 -0
  50. package/build/lib/extension/extension-config.d.ts +249 -0
  51. package/build/lib/extension/extension-config.d.ts.map +1 -0
  52. package/build/lib/extension/extension-config.js +581 -0
  53. package/build/lib/extension/extension-config.js.map +1 -0
  54. package/build/lib/extension/index.d.ts +48 -0
  55. package/build/lib/extension/index.d.ts.map +1 -0
  56. package/build/lib/extension/index.js +105 -0
  57. package/build/lib/extension/index.js.map +1 -0
  58. package/build/lib/extension/manifest-migrations.d.ts +27 -0
  59. package/build/lib/extension/manifest-migrations.d.ts.map +1 -0
  60. package/build/lib/extension/manifest-migrations.js +118 -0
  61. package/build/lib/extension/manifest-migrations.js.map +1 -0
  62. package/build/lib/extension/manifest.d.ts +145 -0
  63. package/build/lib/extension/manifest.d.ts.map +1 -0
  64. package/build/lib/extension/manifest.js +521 -0
  65. package/build/lib/extension/manifest.js.map +1 -0
  66. package/build/lib/extension/package-changed.d.ts +11 -0
  67. package/build/lib/extension/package-changed.d.ts.map +1 -0
  68. package/build/lib/extension/package-changed.js +62 -0
  69. package/build/lib/extension/package-changed.js.map +1 -0
  70. package/build/lib/extension/plugin-config.d.ts +56 -0
  71. package/build/lib/extension/plugin-config.d.ts.map +1 -0
  72. package/build/lib/extension/plugin-config.js +102 -0
  73. package/build/lib/extension/plugin-config.js.map +1 -0
  74. package/build/lib/grid-register.d.ts +10 -0
  75. package/build/lib/grid-register.d.ts.map +1 -0
  76. package/build/lib/grid-register.js +122 -144
  77. package/build/lib/grid-register.js.map +1 -0
  78. package/build/lib/logger.d.ts +3 -0
  79. package/build/lib/logger.d.ts.map +1 -0
  80. package/build/lib/logger.js +5 -17
  81. package/build/lib/logger.js.map +1 -0
  82. package/build/lib/logsink.d.ts +4 -0
  83. package/build/lib/logsink.d.ts.map +1 -0
  84. package/build/lib/logsink.js +190 -187
  85. package/build/lib/logsink.js.map +1 -0
  86. package/build/lib/main.d.ts +62 -0
  87. package/build/lib/main.d.ts.map +1 -0
  88. package/build/lib/main.js +348 -228
  89. package/build/lib/main.js.map +1 -0
  90. package/build/lib/schema/arg-spec.d.ts +143 -0
  91. package/build/lib/schema/arg-spec.d.ts.map +1 -0
  92. package/build/lib/schema/arg-spec.js +164 -0
  93. package/build/lib/schema/arg-spec.js.map +1 -0
  94. package/build/lib/schema/cli-args.d.ts +19 -0
  95. package/build/lib/schema/cli-args.d.ts.map +1 -0
  96. package/build/lib/schema/cli-args.js +217 -0
  97. package/build/lib/schema/cli-args.js.map +1 -0
  98. package/build/lib/schema/cli-transformers.d.ts +5 -0
  99. package/build/lib/schema/cli-transformers.d.ts.map +1 -0
  100. package/build/lib/schema/cli-transformers.js +124 -0
  101. package/build/lib/schema/cli-transformers.js.map +1 -0
  102. package/build/lib/schema/index.d.ts +3 -0
  103. package/build/lib/schema/index.d.ts.map +1 -0
  104. package/build/lib/schema/index.js +19 -0
  105. package/build/lib/schema/index.js.map +1 -0
  106. package/build/lib/schema/keywords.d.ts +24 -0
  107. package/build/lib/schema/keywords.d.ts.map +1 -0
  108. package/build/lib/schema/keywords.js +128 -0
  109. package/build/lib/schema/keywords.js.map +1 -0
  110. package/build/lib/schema/schema.d.ts +259 -0
  111. package/build/lib/schema/schema.d.ts.map +1 -0
  112. package/build/lib/schema/schema.js +615 -0
  113. package/build/lib/schema/schema.js.map +1 -0
  114. package/build/lib/utils.d.ts +121 -0
  115. package/build/lib/utils.d.ts.map +1 -0
  116. package/build/lib/utils.js +351 -273
  117. package/build/lib/utils.js.map +1 -0
  118. package/build/tsconfig.tsbuildinfo +1 -0
  119. package/build/types/cli.d.ts +134 -0
  120. package/build/types/cli.d.ts.map +1 -0
  121. package/build/types/cli.js +3 -0
  122. package/build/types/cli.js.map +1 -0
  123. package/build/types/index.d.ts +15 -0
  124. package/build/types/index.d.ts.map +1 -0
  125. package/build/types/index.js +19 -0
  126. package/build/types/index.js.map +1 -0
  127. package/build/types/manifest/base.d.ts +135 -0
  128. package/build/types/manifest/base.d.ts.map +1 -0
  129. package/build/types/manifest/base.js +3 -0
  130. package/build/types/manifest/base.js.map +1 -0
  131. package/build/types/manifest/index.d.ts +19 -0
  132. package/build/types/manifest/index.d.ts.map +1 -0
  133. package/build/types/manifest/index.js +40 -0
  134. package/build/types/manifest/index.js.map +1 -0
  135. package/build/types/manifest/v3.d.ts +139 -0
  136. package/build/types/manifest/v3.d.ts.map +1 -0
  137. package/build/types/manifest/v3.js +3 -0
  138. package/build/types/manifest/v3.js.map +1 -0
  139. package/driver.d.ts +1 -0
  140. package/driver.js +14 -0
  141. package/index.js +11 -0
  142. package/lib/appium.js +535 -186
  143. package/lib/cli/args.js +267 -422
  144. package/lib/cli/driver-command.js +126 -23
  145. package/lib/cli/extension-command.js +679 -271
  146. package/lib/cli/extension.js +48 -17
  147. package/lib/cli/parser.js +263 -83
  148. package/lib/cli/plugin-command.js +115 -20
  149. package/lib/cli/utils.js +24 -10
  150. package/lib/config-file.js +220 -0
  151. package/lib/config.js +244 -110
  152. package/lib/constants.js +71 -0
  153. package/lib/extension/driver-config.js +250 -0
  154. package/lib/extension/extension-config.js +682 -0
  155. package/lib/extension/index.js +116 -0
  156. package/lib/extension/manifest-migrations.js +120 -0
  157. package/lib/extension/manifest.js +573 -0
  158. package/lib/extension/package-changed.js +64 -0
  159. package/lib/extension/plugin-config.js +112 -0
  160. package/lib/grid-register.js +49 -35
  161. package/lib/logger.js +1 -2
  162. package/lib/logsink.js +64 -38
  163. package/lib/main.js +321 -101
  164. package/lib/schema/arg-spec.js +229 -0
  165. package/lib/schema/cli-args.js +238 -0
  166. package/lib/schema/cli-transformers.js +119 -0
  167. package/lib/schema/index.js +2 -0
  168. package/lib/schema/keywords.js +136 -0
  169. package/lib/schema/schema.js +722 -0
  170. package/lib/utils.js +291 -167
  171. package/package.json +83 -84
  172. package/plugin.d.ts +1 -0
  173. package/plugin.js +13 -0
  174. package/scripts/autoinstall-extensions.js +237 -0
  175. package/support.d.ts +1 -0
  176. package/support.js +13 -0
  177. package/tsconfig.json +25 -0
  178. package/types/cli.ts +193 -0
  179. package/types/index.ts +20 -0
  180. package/types/manifest/README.md +30 -0
  181. package/types/manifest/base.ts +158 -0
  182. package/types/manifest/index.ts +27 -0
  183. package/types/manifest/v3.ts +161 -0
  184. package/CHANGELOG.md +0 -3515
  185. package/bin/ios-webkit-debug-proxy-launcher.js +0 -71
  186. package/build/lib/cli/npm.js +0 -208
  187. package/build/lib/cli/parser-helpers.js +0 -82
  188. package/build/lib/driver-config.js +0 -77
  189. package/build/lib/drivers.js +0 -96
  190. package/build/lib/extension-config.js +0 -253
  191. package/build/lib/plugin-config.js +0 -59
  192. package/build/lib/plugins.js +0 -14
  193. package/lib/cli/npm.js +0 -184
  194. package/lib/cli/parser-helpers.js +0 -79
  195. package/lib/driver-config.js +0 -46
  196. package/lib/drivers.js +0 -81
  197. package/lib/extension-config.js +0 -209
  198. package/lib/plugin-config.js +0 -34
  199. package/lib/plugins.js +0 -10
@@ -0,0 +1,615 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.isAllowedSchemaFileExtension = exports.getDefaultsForExtension = exports.getDefaultsForSchema = exports.flattenSchema = exports.getSchema = exports.validate = exports.resetSchema = exports.finalizeSchema = exports.isFinalized = exports.hasArgSpec = exports.getArgSpec = exports.getAllArgSpecs = exports.registerSchema = exports.SchemaUnsupportedSchemaError = exports.SchemaUnknownSchemaError = exports.SchemaNameConflictError = exports.SchemaFinalizationError = exports.ALLOWED_SCHEMA_EXTENSIONS = exports.RoachHotelMap = void 0;
7
+ const ajv_1 = __importDefault(require("ajv"));
8
+ const ajv_formats_1 = __importDefault(require("ajv-formats"));
9
+ const lodash_1 = __importDefault(require("lodash"));
10
+ const path_1 = __importDefault(require("path"));
11
+ const constants_1 = require("../constants");
12
+ const schema_1 = require("@appium/schema");
13
+ const arg_spec_1 = require("./arg-spec");
14
+ const keywords_1 = require("./keywords");
15
+ /**
16
+ * Key/value pairs go in... but they don't come out.
17
+ *
18
+ * @template K,V
19
+ * @extends {Map<K,V>}
20
+ */
21
+ class RoachHotelMap extends Map {
22
+ /**
23
+ * @param {K} key
24
+ * @param {V} value
25
+ */
26
+ set(key, value) {
27
+ if (this.has(key)) {
28
+ throw new Error(`${key} is already set`);
29
+ }
30
+ return super.set(key, value);
31
+ }
32
+ /**
33
+ * @param {K} key
34
+ */
35
+ // eslint-disable-next-line no-unused-vars
36
+ delete(key) {
37
+ return false;
38
+ }
39
+ clear() {
40
+ throw new Error(`Cannot clear RoachHotelMap`);
41
+ }
42
+ }
43
+ exports.RoachHotelMap = RoachHotelMap;
44
+ /**
45
+ * Extensions that an extension schema file can have.
46
+ */
47
+ exports.ALLOWED_SCHEMA_EXTENSIONS = new Set(['.json', '.js', '.cjs']);
48
+ const SCHEMA_KEY = '$schema';
49
+ /**
50
+ * A wrapper around Ajv and schema-related functions.
51
+ *
52
+ * Should have been named Highlander, because _there can only be one_
53
+ */
54
+ class AppiumSchema {
55
+ /**
56
+ * Initializes Ajv, adds standard formats and our custom keywords.
57
+ * @see https://npm.im/ajv-formats
58
+ * @private
59
+ */
60
+ constructor() {
61
+ /**
62
+ * A mapping of unique argument IDs to their corresponding {@link ArgSpec}s.
63
+ *
64
+ * An "argument" is a CLI argument or a config property.
65
+ *
66
+ * Used to provide easy lookups of argument metadata when converting between different representations of those arguments.
67
+ * @private
68
+ * @type {RoachHotelMap<string,ArgSpec>}
69
+ */
70
+ this._argSpecs = new RoachHotelMap();
71
+ /**
72
+ * A map of extension types to extension names to schema objects.
73
+ *
74
+ * This data structure is used to ensure there are no naming conflicts. The schemas
75
+ * are stored here in memory until the instance is _finalized_.
76
+ * @private
77
+ * @type {Record<ExtensionType,Map<string,SchemaObject>>}
78
+ */
79
+ this._registeredSchemas = { [constants_1.DRIVER_TYPE]: new Map(), [constants_1.PLUGIN_TYPE]: new Map() };
80
+ /**
81
+ * Lookup of schema IDs to finalized schemas.
82
+ *
83
+ * This does not include references, but rather the root schemas themselves.
84
+ * @private
85
+ * @type {Record<string,StrictSchemaObject>?}
86
+ */
87
+ this._finalizedSchemas = null;
88
+ this._ajv = AppiumSchema._instantiateAjv();
89
+ }
90
+ /**
91
+ * Factory function for {@link AppiumSchema} instances.
92
+ *
93
+ * Returns a singleton instance if one exists, otherwise creates a new one.
94
+ * Binds public methods to the instance.
95
+ * @returns {AppiumSchema}
96
+ */
97
+ static create() {
98
+ if (!AppiumSchema._instance) {
99
+ const instance = new AppiumSchema();
100
+ AppiumSchema._instance = instance;
101
+ lodash_1.default.bindAll(instance, [
102
+ 'finalize',
103
+ 'flatten',
104
+ 'getAllArgSpecs',
105
+ 'getArgSpec',
106
+ 'getDefaults',
107
+ 'getDefaultsForExtension',
108
+ 'getSchema',
109
+ 'hasArgSpec',
110
+ 'isFinalized',
111
+ 'registerSchema',
112
+ 'hasRegisteredSchema',
113
+ 'reset',
114
+ 'validate',
115
+ ]);
116
+ }
117
+ return AppiumSchema._instance;
118
+ }
119
+ /**
120
+ * Returns `true` if a schema has been registered using given extension type and name.
121
+ *
122
+ * This does not depend on whether or not the instance has been _finalized_.
123
+ * @param {ExtensionType} extType - Extension type
124
+ * @param {string} extName - Name
125
+ * @returns {boolean} If registered
126
+ */
127
+ hasRegisteredSchema(extType, extName) {
128
+ return this._registeredSchemas[extType].has(extName);
129
+ }
130
+ /**
131
+ * Return `true` if {@link AppiumSchema.finalize finalize} has been called
132
+ * successfully and {@link AppiumSchema.reset reset} has not been called since.
133
+ * @returns {boolean} If finalized
134
+ */
135
+ isFinalized() {
136
+ return Boolean(this._finalizedSchemas);
137
+ }
138
+ getAllArgSpecs() {
139
+ return this._argSpecs;
140
+ }
141
+ /**
142
+ * Call this when no more schemas will be registered.
143
+ *
144
+ * This does three things:
145
+ * 1. It combines all schemas from extensions into the Appium config schema,
146
+ * then adds the result to the `Ajv` instance.
147
+ * 2. It adds schemas for _each_ argument/property for validation purposes.
148
+ * The CLI uses these schemas to validate specific arguments.
149
+ * 3. The schemas are validated against JSON schema draft-07 (which is the
150
+ * only one supported at this time)
151
+ *
152
+ * Any method in this instance that needs to interact with the `Ajv` instance
153
+ * will throw if this method has not been called.
154
+ *
155
+ * If the instance has already been finalized, this is a no-op.
156
+ * @public
157
+ * @throws {Error} If the schema is not valid
158
+ * @returns {Readonly<Record<string,StrictSchemaObject>>} Record of schema IDs to full schema objects
159
+ */
160
+ finalize() {
161
+ if (this.isFinalized()) {
162
+ return /** @type {NonNullable<typeof this._finalizedSchemas>} */ (this._finalizedSchemas);
163
+ }
164
+ const ajv = this._ajv;
165
+ // Ajv will _mutate_ the schema, so we need to clone it.
166
+ const baseSchema = lodash_1.default.cloneDeep(schema_1.AppiumConfigJsonSchema);
167
+ /**
168
+ *
169
+ * @param {SchemaObject} schema
170
+ * @param {ExtensionType} [extType]
171
+ * @param {string} [extName]
172
+ */
173
+ const addArgSpecs = (schema, extType, extName) => {
174
+ for (let [propName, propSchema] of Object.entries(schema)) {
175
+ const argSpec = arg_spec_1.ArgSpec.create(propName, {
176
+ dest: propSchema.appiumCliDest,
177
+ defaultValue: propSchema.default,
178
+ extType,
179
+ extName,
180
+ });
181
+ const { arg } = argSpec;
182
+ this._argSpecs.set(arg, argSpec);
183
+ }
184
+ };
185
+ addArgSpecs(lodash_1.default.omit(baseSchema.properties.server.properties, [constants_1.DRIVER_TYPE, constants_1.PLUGIN_TYPE]));
186
+ /**
187
+ * @type {Record<string,StrictSchemaObject>}
188
+ */
189
+ const finalizedSchemas = {};
190
+ const finalSchema = lodash_1.default.reduce(this._registeredSchemas,
191
+ /**
192
+ * @param {typeof baseSchema} baseSchema
193
+ * @param {Map<string,SchemaObject>} extensionSchemas
194
+ * @param {ExtensionType} extType
195
+ */
196
+ (baseSchema, extensionSchemas, extType) => {
197
+ extensionSchemas.forEach((schema, extName) => {
198
+ const $ref = arg_spec_1.ArgSpec.toSchemaBaseRef(extType, extName);
199
+ schema.$id = $ref;
200
+ schema.additionalProperties = false; // this makes `schema` become a `StrictSchemaObject`
201
+ baseSchema.properties.server.properties[extType].properties[extName] = {
202
+ $ref,
203
+ $comment: extName,
204
+ };
205
+ ajv.validateSchema(schema, true);
206
+ addArgSpecs(schema.properties, extType, extName);
207
+ ajv.addSchema(schema, $ref);
208
+ finalizedSchemas[$ref] = /** @type {StrictSchemaObject} */ (schema);
209
+ });
210
+ return baseSchema;
211
+ }, baseSchema);
212
+ ajv.addSchema(finalSchema, arg_spec_1.APPIUM_CONFIG_SCHEMA_ID);
213
+ finalizedSchemas[arg_spec_1.APPIUM_CONFIG_SCHEMA_ID] = finalSchema;
214
+ ajv.validateSchema(finalSchema, true);
215
+ this._finalizedSchemas = finalizedSchemas;
216
+ return Object.freeze(finalizedSchemas);
217
+ }
218
+ /**
219
+ * Configures and creates an Ajv instance.
220
+ * @private
221
+ * @returns {Ajv}
222
+ */
223
+ static _instantiateAjv() {
224
+ const ajv = (0, ajv_formats_1.default)(new ajv_1.default({
225
+ // without this not much validation actually happens
226
+ allErrors: true,
227
+ }));
228
+ // add custom keywords to ajv. see schema-keywords.js
229
+ lodash_1.default.forEach(keywords_1.keywords, (keyword) => {
230
+ ajv.addKeyword(keyword);
231
+ });
232
+ return ajv;
233
+ }
234
+ /**
235
+ * Resets this instance to its original state.
236
+ *
237
+ * - Removes all added schemas from the `Ajv` instance
238
+ * - Resets the map of {@link ArgSpec ArgSpecs}
239
+ * - Resets the map of registered schemas
240
+ * - Sets the {@link AppiumSchema._finalized _finalized} flag to `false`
241
+ *
242
+ * If you need to call {@link AppiumSchema.finalize} again, you'll want to call this first.
243
+ * @returns {void}
244
+ */
245
+ reset() {
246
+ for (const schemaId of Object.keys(this._finalizedSchemas ?? {})) {
247
+ this._ajv.removeSchema(schemaId);
248
+ }
249
+ this._argSpecs = new RoachHotelMap();
250
+ this._registeredSchemas = {
251
+ [constants_1.DRIVER_TYPE]: new Map(),
252
+ [constants_1.PLUGIN_TYPE]: new Map(),
253
+ };
254
+ this._finalizedSchemas = null;
255
+ // Ajv seems to have an over-eager cache, so we have to dump the object entirely.
256
+ this._ajv = AppiumSchema._instantiateAjv();
257
+ }
258
+ /**
259
+ * Registers a schema from an extension.
260
+ *
261
+ * This is "fail-fast" in that the schema will immediately be validated against JSON schema draft-07 _or_ whatever the value of the schema's `$schema` prop is.
262
+ *
263
+ * Does _not_ add the schema to the `ajv` instance (this is done by {@link AppiumSchema.finalize}).
264
+ * @param {ExtensionType} extType - Extension type
265
+ * @param {string} extName - Unique extension name for `type`
266
+ * @param {SchemaObject} schema - Schema object
267
+ * @throws {SchemaNameConflictError} If the schema is an invalid
268
+ * @returns {void}
269
+ */
270
+ registerSchema(extType, extName, schema) {
271
+ if (!(extType && extName) || lodash_1.default.isUndefined(schema)) {
272
+ throw new TypeError('Expected extension type, extension name, and a defined schema');
273
+ }
274
+ if (!AppiumSchema.isSupportedSchemaType(schema)) {
275
+ throw new SchemaUnsupportedSchemaError(schema, extType, extName);
276
+ }
277
+ const normalizedExtName = lodash_1.default.kebabCase(extName);
278
+ if (this.hasRegisteredSchema(extType, normalizedExtName)) {
279
+ if (lodash_1.default.isEqual(this._registeredSchemas[extType].get(normalizedExtName), schema)) {
280
+ return;
281
+ }
282
+ throw new SchemaNameConflictError(extType, extName);
283
+ }
284
+ this._ajv.validateSchema(schema, true);
285
+ this._registeredSchemas[extType].set(normalizedExtName, schema);
286
+ }
287
+ /**
288
+ * Returns a {@link ArgSpec} for the given argument name.
289
+ * @param {string} name - CLI argument name
290
+ * @param {ExtensionType} [extType] - Extension type
291
+ * @param {string} [extName] - Extension name
292
+ * @returns {ArgSpec|undefined} ArgSpec or `undefined` if not found
293
+ */
294
+ getArgSpec(name, extType, extName) {
295
+ return this._argSpecs.get(arg_spec_1.ArgSpec.toArg(name, extType, extName));
296
+ }
297
+ /**
298
+ * Returns `true` if the instance knows about an argument by the given `name`.
299
+ * @param {string} name - CLI argument name
300
+ * @param {ExtensionType} [extType] - Extension type
301
+ * @param {string} [extName] - Extension name
302
+ * @returns {boolean} `true` if such an {@link ArgSpec} exists
303
+ */
304
+ hasArgSpec(name, extType, extName) {
305
+ return this._argSpecs.has(arg_spec_1.ArgSpec.toArg(name, extType, extName));
306
+ }
307
+ /**
308
+ * Returns a `Record` of argument "dest" strings to default values.
309
+ *
310
+ * The "dest" string is the property name in object returned by
311
+ * `argparse.ArgumentParser['parse_args']`.
312
+ * @template {boolean|undefined} Flattened
313
+ * @param {Flattened} [flatten=true] - If `true`, flattens the returned object
314
+ * using "keypath"-style keys of the format `<extType>.<extName>.<argName>`.
315
+ * Otherwise, returns a nested object using `extType` and `extName` as
316
+ * properties. Base arguments (server arguments) are always at the top level.
317
+ * @returns {DefaultValues<Flattened>}
318
+ */
319
+ getDefaults(flatten = /** @type {Flattened} */ (true)) {
320
+ if (!this.isFinalized()) {
321
+ throw new SchemaFinalizationError();
322
+ }
323
+ /**
324
+ * @private
325
+ * @callback DefaultReducer
326
+ * @param {DefaultValues<Flattened>} defaults
327
+ * @param {ArgSpec} argSpec
328
+ * @returns {DefaultValues<Flattened>}
329
+ */
330
+ /** @type {DefaultReducer} */
331
+ const reducer = flatten
332
+ ? (defaults, { defaultValue, dest }) => {
333
+ if (!lodash_1.default.isUndefined(defaultValue)) {
334
+ defaults[dest] = defaultValue;
335
+ }
336
+ return defaults;
337
+ }
338
+ : (defaults, { defaultValue, dest }) => {
339
+ if (!lodash_1.default.isUndefined(defaultValue)) {
340
+ lodash_1.default.set(defaults, dest, defaultValue);
341
+ }
342
+ return defaults;
343
+ };
344
+ /** @type {DefaultValues<Flattened>} */
345
+ const retval = {};
346
+ return [...this._argSpecs.values()].reduce(reducer, retval);
347
+ }
348
+ /**
349
+ * Returns a flattened Record of defaults for a specific extension. Keys will
350
+ * be of format `<argName>`.
351
+ * @param {ExtensionType} extType - Extension type
352
+ * @param {string} extName - Extension name
353
+ * @returns {Record<string,ArgSpecDefaultValue>}
354
+ */
355
+ getDefaultsForExtension(extType, extName) {
356
+ if (!this.isFinalized()) {
357
+ throw new SchemaFinalizationError();
358
+ }
359
+ const specs = [...this._argSpecs.values()].filter((spec) => spec.extType === extType && spec.extName === extName);
360
+ return specs.reduce((defaults, { defaultValue, rawDest }) => {
361
+ if (!lodash_1.default.isUndefined(defaultValue)) {
362
+ defaults[rawDest] = defaultValue;
363
+ }
364
+ return defaults;
365
+ }, {});
366
+ }
367
+ /**
368
+ * Flatten schema into an array of `SchemaObject`s and associated
369
+ * {@link ArgSpec ArgSpecs}.
370
+ *
371
+ * Converts nested extension schemas to keys based on the extension type and
372
+ * name. Used when translating to `argparse` options or getting the list of
373
+ * default values (see {@link AppiumSchema.getDefaults}) for CLI or otherwise.
374
+ *
375
+ * The return value is an intermediate reprsentation used by `cli-args`
376
+ * module's `toParserArgs`, which converts the finalized schema to parameters
377
+ * used by `argparse`.
378
+ * @throws If {@link AppiumSchema.finalize} has not been called yet.
379
+ * @returns {FlattenedSchema}
380
+ */
381
+ flatten() {
382
+ const schema = this.getSchema();
383
+ /** @type { {properties: SchemaObject, prefix: string[]}[] } */
384
+ const stack = [{ properties: schema.properties, prefix: [] }];
385
+ /** @type {FlattenedSchema} */
386
+ const flattened = [];
387
+ // this bit is a recursive algorithm rewritten as a for loop.
388
+ // when we find something we want to traverse, we add it to `stack`
389
+ for (const { properties, prefix } of stack) {
390
+ const pairs = lodash_1.default.toPairs(properties);
391
+ for (const [key, value] of pairs) {
392
+ if (key === SCHEMA_KEY) {
393
+ continue;
394
+ }
395
+ const { properties, $ref } = value;
396
+ if (properties) {
397
+ stack.push({
398
+ properties,
399
+ prefix: key === arg_spec_1.SERVER_PROP_NAME ? [] : [...prefix, key],
400
+ });
401
+ }
402
+ else if ($ref) {
403
+ let refSchema;
404
+ try {
405
+ refSchema = this.getSchema($ref);
406
+ }
407
+ catch (err) {
408
+ // this can happen if an extension schema supplies a $ref to a non-existent schema
409
+ throw new SchemaUnknownSchemaError($ref);
410
+ }
411
+ const { normalizedExtName } = arg_spec_1.ArgSpec.extensionInfoFromRootSchemaId($ref);
412
+ if (!normalizedExtName) {
413
+ /* istanbul ignore next */
414
+ throw new ReferenceError(`Could not determine extension name from schema ID ${$ref}. This is a bug.`);
415
+ }
416
+ stack.push({
417
+ properties: refSchema.properties,
418
+ prefix: [...prefix, key, normalizedExtName],
419
+ });
420
+ }
421
+ else if (key !== constants_1.DRIVER_TYPE && key !== constants_1.PLUGIN_TYPE) {
422
+ const [extType, extName] = prefix;
423
+ const argSpec = this.getArgSpec(key, /** @type {ExtensionType} */ (extType), extName);
424
+ if (!argSpec) {
425
+ /* istanbul ignore next */
426
+ throw new ReferenceError(`Unknown argument with key ${key}, extType ${extType} and extName ${extName}. This is a bug.`);
427
+ }
428
+ flattened.push({ schema: lodash_1.default.cloneDeep(value), argSpec });
429
+ }
430
+ }
431
+ }
432
+ return flattened;
433
+ }
434
+ /**
435
+ * Retrieves the schema itself
436
+ * @public
437
+ * @param {string} [ref] - Schema ID
438
+ * @throws If the schema has not yet been finalized
439
+ * @returns {SchemaObject}
440
+ */
441
+ getSchema(ref = arg_spec_1.APPIUM_CONFIG_SCHEMA_ID) {
442
+ return /** @type {SchemaObject} */ (this._getValidator(ref).schema);
443
+ }
444
+ /**
445
+ * Retrieves schema validator function from Ajv
446
+ * @param {string} [id] - Schema ID
447
+ * @private
448
+ * @returns {import('ajv').ValidateFunction}
449
+ */
450
+ _getValidator(id = arg_spec_1.APPIUM_CONFIG_SCHEMA_ID) {
451
+ const validator = this._ajv.getSchema(id);
452
+ if (!validator) {
453
+ if (id === arg_spec_1.APPIUM_CONFIG_SCHEMA_ID) {
454
+ throw new SchemaFinalizationError();
455
+ }
456
+ else {
457
+ throw new SchemaUnknownSchemaError(id);
458
+ }
459
+ }
460
+ return validator;
461
+ }
462
+ /**
463
+ * Given an object, validates it against the Appium config schema.
464
+ * If errors occur, the returned array will be non-empty.
465
+ * @param {any} value - The value (hopefully an object) to validate against the schema
466
+ * @param {string} [ref] - Schema ID or ref.
467
+ * @public
468
+ * @returns {import('ajv').ErrorObject[]} Array of errors, if any.
469
+ */
470
+ validate(value, ref = arg_spec_1.APPIUM_CONFIG_SCHEMA_ID) {
471
+ const validator = this._getValidator(ref);
472
+ return !validator(value) && lodash_1.default.isArray(validator.errors) ? [...validator.errors] : [];
473
+ }
474
+ /**
475
+ * Returns `true` if `filename`'s file extension is allowed (in {@link ALLOWED_SCHEMA_EXTENSIONS}).
476
+ * @param {string} filename
477
+ * @returns {boolean}
478
+ */
479
+ static isAllowedSchemaFileExtension(filename) {
480
+ return exports.ALLOWED_SCHEMA_EXTENSIONS.has(path_1.default.extname(filename));
481
+ }
482
+ /**
483
+ * Returns `true` if `schema` is a plain object with a non-true `$async` property.
484
+ * @param {any} schema - Schema to check
485
+ * @returns {schema is SchemaObject}
486
+ */
487
+ static isSupportedSchemaType(schema) {
488
+ return lodash_1.default.isPlainObject(schema) && schema.$async !== true;
489
+ }
490
+ }
491
+ /**
492
+ * Thrown when the {@link AppiumSchema} instance has not yet been finalized, but
493
+ * the method called requires it.
494
+ */
495
+ class SchemaFinalizationError extends Error {
496
+ constructor() {
497
+ super('Schema not yet finalized; `finalize()` must be called first.');
498
+ /**
499
+ * @type {Readonly<string>}
500
+ */
501
+ this.code = 'APPIUMERR_SCHEMA_FINALIZATION';
502
+ }
503
+ }
504
+ exports.SchemaFinalizationError = SchemaFinalizationError;
505
+ /**
506
+ * Thrown when a "unique" schema ID conflicts with an existing schema ID.
507
+ *
508
+ * This is likely going to be caused by attempting to register the same schema twice.
509
+ */
510
+ class SchemaNameConflictError extends Error {
511
+ /**
512
+ * @param {ExtensionType} extType
513
+ * @param {string} extName
514
+ */
515
+ constructor(extType, extName) {
516
+ super(`Name for ${extType} schema "${extName}" conflicts with an existing schema`);
517
+ /**
518
+ * @type {Readonly<string>}
519
+ */
520
+ this.code = 'APPIUMERR_SCHEMA_NAME_CONFLICT';
521
+ this.data = { extType, extName };
522
+ }
523
+ }
524
+ exports.SchemaNameConflictError = SchemaNameConflictError;
525
+ /**
526
+ * Thrown when a schema ID was expected, but it doesn't exist on the {@link Ajv} instance.
527
+ */
528
+ class SchemaUnknownSchemaError extends ReferenceError {
529
+ /**
530
+ * @param {string} schemaId
531
+ */
532
+ constructor(schemaId) {
533
+ super(`Unknown schema: "${schemaId}"`);
534
+ /**
535
+ * @type {Readonly<string>}
536
+ */
537
+ this.code = 'APPIUMERR_SCHEMA_UNKNOWN_SCHEMA';
538
+ this.data = { schemaId };
539
+ }
540
+ }
541
+ exports.SchemaUnknownSchemaError = SchemaUnknownSchemaError;
542
+ /**
543
+ * Thrown when a schema is provided, but it's of an unsupported type.
544
+ *
545
+ * "Valid" schemas which are unsupported include boolean schemas and async schemas
546
+ * (having a `true` `$async` property).
547
+ */
548
+ class SchemaUnsupportedSchemaError extends TypeError {
549
+ /**
550
+ * @param {any} schema
551
+ * @param {ExtensionType} extType
552
+ * @param {string} extName
553
+ */
554
+ constructor(schema, extType, extName) {
555
+ // https://github.com/Microsoft/TypeScript/issues/8277
556
+ super((() => {
557
+ let msg = `Unsupported schema from ${extType} "${extName}":`;
558
+ if (lodash_1.default.isBoolean(schema)) {
559
+ return `${msg} schema cannot be a boolean`;
560
+ }
561
+ if (lodash_1.default.isPlainObject(schema)) {
562
+ if (schema.$async) {
563
+ return `${msg} schema cannot be an async schema`;
564
+ }
565
+ /* istanbul ignore next */
566
+ throw new TypeError(`schema IS supported; this error should not be thrown (this is a bug). value of schema: ${JSON.stringify(schema)}`);
567
+ }
568
+ return `${msg} schema must be a plain object without a true "$async" property`;
569
+ })());
570
+ /**
571
+ * @type {Readonly<string>}
572
+ */
573
+ this.code = 'APPIUMERR_SCHEMA_UNSUPPORTED_SCHEMA';
574
+ this.data = { schema, extType, extName };
575
+ }
576
+ }
577
+ exports.SchemaUnsupportedSchemaError = SchemaUnsupportedSchemaError;
578
+ const appiumSchema = AppiumSchema.create();
579
+ exports.registerSchema = appiumSchema.registerSchema, exports.getAllArgSpecs = appiumSchema.getAllArgSpecs, exports.getArgSpec = appiumSchema.getArgSpec, exports.hasArgSpec = appiumSchema.hasArgSpec, exports.isFinalized = appiumSchema.isFinalized, exports.finalizeSchema = appiumSchema.finalize, exports.resetSchema = appiumSchema.reset, exports.validate = appiumSchema.validate, exports.getSchema = appiumSchema.getSchema, exports.flattenSchema = appiumSchema.flatten, exports.getDefaultsForSchema = appiumSchema.getDefaults, exports.getDefaultsForExtension = appiumSchema.getDefaultsForExtension;
580
+ exports.isAllowedSchemaFileExtension = AppiumSchema.isAllowedSchemaFileExtension;
581
+ /**
582
+ * Appium only supports schemas that are plain objects; not arrays.
583
+ * @typedef {import('ajv').SchemaObject & {[key: number]: never}} SchemaObject
584
+ */
585
+ /**
586
+ * @typedef {import('@appium/types').ExtensionType} ExtensionType
587
+ */
588
+ /**
589
+ * An object having property `additionalProperties: false`
590
+ * @typedef StrictProp
591
+ * @property {false} additionalProperties
592
+ */
593
+ /**
594
+ * A {@link SchemaObject} with `additionalProperties: false`
595
+ * @typedef {SchemaObject & StrictProp} StrictSchemaObject
596
+ */
597
+ /**
598
+ * A list of schemas associated with properties and their corresponding {@link ArgSpec} objects.
599
+ *
600
+ * Intermediate data structure used when converting the entire schema down to CLI arguments.
601
+ * @typedef { {schema: SchemaObject, argSpec: ArgSpec}[] } FlattenedSchema
602
+ */
603
+ /**
604
+ * @typedef {ArgSpec['defaultValue']} ArgSpecDefaultValue
605
+ */
606
+ /**
607
+ * e.g. `{driver: {foo: 'bar'}}` where `foo` is the arg name and `bar` is the default value.
608
+ * @typedef {Record<string,Record<string,ArgSpecDefaultValue>>} NestedArgSpecDefaultValue
609
+ */
610
+ /**
611
+ * Helper type for the return value of {@link AppiumSchema.getDefaults}
612
+ * @template {boolean|undefined} Flattened
613
+ * @typedef {Record<string,Flattened extends true ? ArgSpecDefaultValue : ArgSpecDefaultValue | NestedArgSpecDefaultValue>} DefaultValues
614
+ */
615
+ //# sourceMappingURL=schema.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../lib/schema/schema.js"],"names":[],"mappings":"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"}