@xyo-network/module-abstract 2.75.15 → 2.75.17

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 (66) hide show
  1. package/dist/docs.json +358 -358
  2. package/package.json +25 -25
  3. package/dist/browser/AbstractModule.cjs +0 -775
  4. package/dist/browser/AbstractModule.cjs.map +0 -1
  5. package/dist/browser/AbstractModule.js +0 -756
  6. package/dist/browser/AbstractModule.js.map +0 -1
  7. package/dist/browser/AbstractModuleInstance.cjs +0 -817
  8. package/dist/browser/AbstractModuleInstance.cjs.map +0 -1
  9. package/dist/browser/AbstractModuleInstance.js +0 -798
  10. package/dist/browser/AbstractModuleInstance.js.map +0 -1
  11. package/dist/browser/BaseEmitter.cjs +0 -68
  12. package/dist/browser/BaseEmitter.cjs.map +0 -1
  13. package/dist/browser/BaseEmitter.js +0 -49
  14. package/dist/browser/BaseEmitter.js.map +0 -1
  15. package/dist/browser/Error.cjs +0 -68
  16. package/dist/browser/Error.cjs.map +0 -1
  17. package/dist/browser/Error.js +0 -49
  18. package/dist/browser/Error.js.map +0 -1
  19. package/dist/browser/QueryValidator/ModuleConfigQueryValidator.cjs +0 -83
  20. package/dist/browser/QueryValidator/ModuleConfigQueryValidator.cjs.map +0 -1
  21. package/dist/browser/QueryValidator/ModuleConfigQueryValidator.js +0 -64
  22. package/dist/browser/QueryValidator/ModuleConfigQueryValidator.js.map +0 -1
  23. package/dist/browser/QueryValidator/QueryValidator.cjs +0 -19
  24. package/dist/browser/QueryValidator/QueryValidator.cjs.map +0 -1
  25. package/dist/browser/QueryValidator/QueryValidator.js +0 -1
  26. package/dist/browser/QueryValidator/QueryValidator.js.map +0 -1
  27. package/dist/browser/QueryValidator/SupportedQueryValidator.cjs +0 -47
  28. package/dist/browser/QueryValidator/SupportedQueryValidator.cjs.map +0 -1
  29. package/dist/browser/QueryValidator/SupportedQueryValidator.js +0 -28
  30. package/dist/browser/QueryValidator/SupportedQueryValidator.js.map +0 -1
  31. package/dist/browser/QueryValidator/index.cjs +0 -108
  32. package/dist/browser/QueryValidator/index.cjs.map +0 -1
  33. package/dist/browser/QueryValidator/index.js +0 -87
  34. package/dist/browser/QueryValidator/index.js.map +0 -1
  35. package/dist/node/AbstractModule.js +0 -799
  36. package/dist/node/AbstractModule.js.map +0 -1
  37. package/dist/node/AbstractModule.mjs +0 -776
  38. package/dist/node/AbstractModule.mjs.map +0 -1
  39. package/dist/node/AbstractModuleInstance.js +0 -840
  40. package/dist/node/AbstractModuleInstance.js.map +0 -1
  41. package/dist/node/AbstractModuleInstance.mjs +0 -817
  42. package/dist/node/AbstractModuleInstance.mjs.map +0 -1
  43. package/dist/node/BaseEmitter.js +0 -71
  44. package/dist/node/BaseEmitter.js.map +0 -1
  45. package/dist/node/BaseEmitter.mjs +0 -48
  46. package/dist/node/BaseEmitter.mjs.map +0 -1
  47. package/dist/node/Error.js +0 -71
  48. package/dist/node/Error.js.map +0 -1
  49. package/dist/node/Error.mjs +0 -48
  50. package/dist/node/Error.mjs.map +0 -1
  51. package/dist/node/QueryValidator/ModuleConfigQueryValidator.js +0 -94
  52. package/dist/node/QueryValidator/ModuleConfigQueryValidator.js.map +0 -1
  53. package/dist/node/QueryValidator/ModuleConfigQueryValidator.mjs +0 -71
  54. package/dist/node/QueryValidator/ModuleConfigQueryValidator.mjs.map +0 -1
  55. package/dist/node/QueryValidator/QueryValidator.js +0 -19
  56. package/dist/node/QueryValidator/QueryValidator.js.map +0 -1
  57. package/dist/node/QueryValidator/QueryValidator.mjs +0 -1
  58. package/dist/node/QueryValidator/QueryValidator.mjs.map +0 -1
  59. package/dist/node/QueryValidator/SupportedQueryValidator.js +0 -51
  60. package/dist/node/QueryValidator/SupportedQueryValidator.js.map +0 -1
  61. package/dist/node/QueryValidator/SupportedQueryValidator.mjs +0 -27
  62. package/dist/node/QueryValidator/SupportedQueryValidator.mjs.map +0 -1
  63. package/dist/node/QueryValidator/index.js +0 -120
  64. package/dist/node/QueryValidator/index.js.map +0 -1
  65. package/dist/node/QueryValidator/index.mjs +0 -93
  66. package/dist/node/QueryValidator/index.mjs.map +0 -1
@@ -1,775 +0,0 @@
1
- "use strict";
2
- var __defProp = Object.defineProperty;
3
- var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
- var __getOwnPropNames = Object.getOwnPropertyNames;
5
- var __hasOwnProp = Object.prototype.hasOwnProperty;
6
- var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
7
- var __export = (target, all) => {
8
- for (var name in all)
9
- __defProp(target, name, { get: all[name], enumerable: true });
10
- };
11
- var __copyProps = (to, from, except, desc) => {
12
- if (from && typeof from === "object" || typeof from === "function") {
13
- for (let key of __getOwnPropNames(from))
14
- if (!__hasOwnProp.call(to, key) && key !== except)
15
- __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
16
- }
17
- return to;
18
- };
19
- var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
20
-
21
- // src/AbstractModule.ts
22
- var AbstractModule_exports = {};
23
- __export(AbstractModule_exports, {
24
- AbstractModule: () => AbstractModule
25
- });
26
- module.exports = __toCommonJS(AbstractModule_exports);
27
- var import_assert = require("@xylabs/assert");
28
- var import_exists = require("@xylabs/exists");
29
- var import_lodash = require("@xylabs/lodash");
30
- var import_account = require("@xyo-network/account");
31
- var import_address_payload_plugin = require("@xyo-network/address-payload-plugin");
32
- var import_archivist_model = require("@xyo-network/archivist-model");
33
- var import_boundwitness_builder3 = require("@xyo-network/boundwitness-builder");
34
- var import_config_payload_plugin = require("@xyo-network/config-payload-plugin");
35
- var import_core2 = require("@xyo-network/core");
36
- var import_error = require("@xyo-network/error");
37
- var import_manifest_model = require("@xyo-network/manifest-model");
38
- var import_module_model = require("@xyo-network/module-model");
39
- var import_module_resolver = require("@xyo-network/module-resolver");
40
- var import_payload_builder2 = require("@xyo-network/payload-builder");
41
- var import_promise = require("@xyo-network/promise");
42
- var import_query_payload_plugin = require("@xyo-network/query-payload-plugin");
43
- var import_shared = require("@xyo-network/shared");
44
-
45
- // src/BaseEmitter.ts
46
- var import_core = require("@xyo-network/core");
47
- var import_module_events = require("@xyo-network/module-events");
48
- var BaseEmitter = class extends import_core.Base {
49
- static {
50
- __name(this, "BaseEmitter");
51
- }
52
- //just here to query types
53
- eventData = {};
54
- events;
55
- constructor(params) {
56
- super(params);
57
- this.events = new import_module_events.Events();
58
- }
59
- clearListeners(eventNames) {
60
- return this.events.clearListeners(eventNames);
61
- }
62
- emit(eventName, eventArgs) {
63
- return this.events.emit(eventName, eventArgs);
64
- }
65
- emitSerial(eventName, eventArgs) {
66
- return this.events.emitSerial(eventName, eventArgs);
67
- }
68
- listenerCount(eventNames) {
69
- return this.events.listenerCount(eventNames);
70
- }
71
- off(eventNames, listener) {
72
- return this.events.off(eventNames, listener);
73
- }
74
- offAny(listener) {
75
- return this.events.offAny(listener);
76
- }
77
- on(eventNames, listener) {
78
- return this.events.on(eventNames, listener);
79
- }
80
- onAny(listener) {
81
- return this.events.onAny(listener);
82
- }
83
- once(eventName, listener) {
84
- return this.events.once(eventName, listener);
85
- }
86
- };
87
-
88
- // src/Error.ts
89
- var import_payload_builder = require("@xyo-network/payload-builder");
90
- var import_payload_model = require("@xyo-network/payload-model");
91
- var ModuleErrorBuilder = class extends import_payload_builder.PayloadBuilder {
92
- static {
93
- __name(this, "ModuleErrorBuilder");
94
- }
95
- _message;
96
- _name;
97
- _query;
98
- _sources;
99
- constructor() {
100
- super({
101
- schema: import_payload_model.ModuleErrorSchema
102
- });
103
- }
104
- build() {
105
- return {
106
- message: this._message,
107
- name: this._name,
108
- query: this._query,
109
- schema: import_payload_model.ModuleErrorSchema,
110
- sources: this._sources
111
- };
112
- }
113
- message(message) {
114
- this._message = message;
115
- return this;
116
- }
117
- name(name) {
118
- this._name = name;
119
- return this;
120
- }
121
- query(query) {
122
- this._query = query;
123
- return this;
124
- }
125
- sources(sources) {
126
- this._sources = sources;
127
- return this;
128
- }
129
- };
130
-
131
- // src/QueryValidator/ModuleConfigQueryValidator.ts
132
- var import_boundwitness_builder = require("@xyo-network/boundwitness-builder");
133
- var delimiter = "";
134
- var ModuleConfigQueryValidator = class {
135
- static {
136
- __name(this, "ModuleConfigQueryValidator");
137
- }
138
- allowed = {};
139
- disallowed = {};
140
- hasAllowedRules;
141
- hasDisallowedRules;
142
- hasRules;
143
- constructor(config) {
144
- if (config?.security?.allowed) {
145
- Object.entries(config.security?.allowed).forEach(([schema, addresses]) => {
146
- this.allowed[schema] = addresses.map(toAddressesString);
147
- });
148
- }
149
- if (config?.security?.disallowed) {
150
- Object.entries(config.security?.disallowed).forEach(([schema, addresses]) => {
151
- this.disallowed[schema] = addresses.map(toAddressesString);
152
- });
153
- }
154
- this.hasAllowedRules = Object.keys(this.allowed).length > 0;
155
- this.hasDisallowedRules = Object.keys(this.disallowed).length > 0;
156
- this.hasRules = this.hasAllowedRules || this.hasDisallowedRules;
157
- }
158
- queryable = async (query, payloads) => {
159
- if (!this.hasRules)
160
- return true;
161
- const addresses = query.addresses;
162
- if (!addresses.length)
163
- return false;
164
- const wrapper = import_boundwitness_builder.QueryBoundWitnessWrapper.parseQuery(query, payloads);
165
- const schema = (await wrapper.getQuery()).schema;
166
- return this.queryAllowed(schema, addresses) && !this.queryDisallowed(schema, addresses);
167
- };
168
- queryAllowed = (schema, addresses) => {
169
- if (!this.hasAllowedRules)
170
- return true;
171
- if (addresses.length > 1) {
172
- const signatories = toAddressesString(addresses);
173
- const validCosigners = this.allowed?.[schema]?.includes(signatories);
174
- if (validCosigners)
175
- return true;
176
- }
177
- return addresses.every((address) => this.allowed?.[schema]?.includes(address) || false);
178
- };
179
- queryDisallowed = (schema, addresses) => {
180
- if (!this.hasDisallowedRules)
181
- return false;
182
- return addresses.some((address) => this.disallowed?.[schema]?.includes(address));
183
- };
184
- };
185
- var toAddressesString = /* @__PURE__ */ __name((addresses) => {
186
- return Array.isArray(addresses) ? addresses.sort().map((address) => address.toLowerCase()).join(delimiter) : addresses.toLowerCase();
187
- }, "toAddressesString");
188
-
189
- // src/QueryValidator/SupportedQueryValidator.ts
190
- var import_boundwitness_builder2 = require("@xyo-network/boundwitness-builder");
191
- var isQuerySupportedByModule = /* @__PURE__ */ __name(async (mod, query, payloads) => {
192
- const wrapper = import_boundwitness_builder2.QueryBoundWitnessWrapper.parseQuery(query, payloads);
193
- const schema = (await wrapper.getQuery()).schema;
194
- return mod.queries.includes(schema);
195
- }, "isQuerySupportedByModule");
196
- var SupportedQueryValidator = class {
197
- static {
198
- __name(this, "SupportedQueryValidator");
199
- }
200
- mod;
201
- constructor(mod) {
202
- this.mod = mod;
203
- this.queryable = (query, payloads) => {
204
- return isQuerySupportedByModule(this.mod, query, payloads);
205
- };
206
- }
207
- queryable;
208
- };
209
-
210
- // src/AbstractModule.ts
211
- var AbstractModule = class _AbstractModule extends BaseEmitter {
212
- static {
213
- __name(this, "AbstractModule");
214
- }
215
- static configSchemas;
216
- static enableLazyLoad = false;
217
- static privateConstructorKey = Date.now().toString();
218
- downResolver = new import_module_resolver.CompositeModuleResolver();
219
- upResolver = new import_module_resolver.CompositeModuleResolver();
220
- _account = void 0;
221
- _baseModuleQueryAccountPaths = {
222
- [import_module_model.ModuleAddressQuerySchema]: "1",
223
- [import_module_model.ModuleDescribeQuerySchema]: "4",
224
- [import_module_model.ModuleDiscoverQuerySchema]: "2",
225
- [import_module_model.ModuleManifestQuerySchema]: "5",
226
- [import_module_model.ModuleSubscribeQuerySchema]: "3"
227
- };
228
- _queryAccounts = {
229
- [import_module_model.ModuleAddressQuerySchema]: void 0,
230
- [import_module_model.ModuleDescribeQuerySchema]: void 0,
231
- [import_module_model.ModuleDiscoverQuerySchema]: void 0,
232
- [import_module_model.ModuleManifestQuerySchema]: void 0,
233
- [import_module_model.ModuleSubscribeQuerySchema]: void 0
234
- };
235
- _startPromise = void 0;
236
- _started = void 0;
237
- moduleConfigQueryValidator;
238
- supportedQueryValidator;
239
- _busyCount = 0;
240
- constructor(privateConstructorKey, params, account) {
241
- (0, import_assert.assertEx)(_AbstractModule.privateConstructorKey === privateConstructorKey, "Use create function instead of constructor");
242
- const mutatedParams = {
243
- ...params
244
- };
245
- super(mutatedParams);
246
- this._account = account;
247
- this.supportedQueryValidator = new SupportedQueryValidator(this).queryable;
248
- this.moduleConfigQueryValidator = new ModuleConfigQueryValidator(mutatedParams?.config).queryable;
249
- }
250
- static get configSchema() {
251
- return this.configSchemas[0];
252
- }
253
- get account() {
254
- return (0, import_assert.assertEx)(this._account, "Missing account");
255
- }
256
- get address() {
257
- return this.account.address;
258
- }
259
- get allowAnonymous() {
260
- return !!this.config.security?.allowAnonymous;
261
- }
262
- get config() {
263
- return this.params.config;
264
- }
265
- get ephemeralQueryAccountEnabled() {
266
- return !!this.params.ephemeralQueryAccountEnabled;
267
- }
268
- get queries() {
269
- return [
270
- import_module_model.ModuleDiscoverQuerySchema,
271
- import_module_model.ModuleAddressQuerySchema,
272
- import_module_model.ModuleSubscribeQuerySchema,
273
- import_module_model.ModuleDescribeQuerySchema,
274
- import_module_model.ModuleManifestQuerySchema
275
- ];
276
- }
277
- get queryAccountPaths() {
278
- return {
279
- ...this._baseModuleQueryAccountPaths,
280
- ...this._queryAccountPaths
281
- };
282
- }
283
- get queryAccounts() {
284
- return this._queryAccounts;
285
- }
286
- get timestamp() {
287
- return this.config.timestamp ?? false;
288
- }
289
- static _getRootFunction(funcName) {
290
- let anyThis = this;
291
- while (anyThis.__proto__[funcName]) {
292
- anyThis = anyThis.__proto__;
293
- }
294
- return anyThis[funcName];
295
- }
296
- static _noOverride(functionName) {
297
- const thisFunc = this[functionName];
298
- const rootFunc = this._getRootFunction(functionName);
299
- (0, import_assert.assertEx)(thisFunc === rootFunc, `Override not allowed for [${functionName}] - override ${functionName}Handler instead`);
300
- }
301
- static async create(params) {
302
- this._noOverride("create");
303
- if (!this.configSchemas || this.configSchemas.length === 0) {
304
- throw Error(`Missing configSchema [${params?.config?.schema}][${this.name}]`);
305
- }
306
- const { account, config, wallet } = params ?? {};
307
- const { accountDerivationPath } = config ?? {};
308
- (0, import_assert.assertEx)(!(!!account && !!wallet), `Specifying both {account} and {wallet} are not allowed [${config?.schema}] [${account === "random" ? "random" : account?.address}, ${wallet?.address}]`);
309
- const schema = params?.config?.schema ?? this.configSchema;
310
- const allowedSchemas = this.configSchemas;
311
- (0, import_assert.assertEx)(allowedSchemas.filter((allowedSchema) => allowedSchema === schema).length > 0, `Bad Config Schema [Received ${schema}] [Expected ${JSON.stringify(allowedSchemas)}]`);
312
- const mutatedConfig = {
313
- ...params?.config,
314
- schema
315
- };
316
- params?.logger?.debug(`config: ${JSON.stringify(mutatedConfig, null, 2)}`);
317
- const mutatedParams = {
318
- ...params,
319
- config: mutatedConfig
320
- };
321
- const activeLogger = params?.logger ?? _AbstractModule.defaultLogger;
322
- const generatedAccount = await _AbstractModule.determineAccount({
323
- account,
324
- accountDerivationPath,
325
- wallet
326
- });
327
- const address = generatedAccount.address;
328
- mutatedParams.logger = activeLogger ? new import_shared.IdLogger(activeLogger, () => `0x${address}`) : void 0;
329
- const newModule = new this(_AbstractModule.privateConstructorKey, mutatedParams, generatedAccount);
330
- if (!_AbstractModule.enableLazyLoad) {
331
- await newModule.start?.();
332
- }
333
- return newModule;
334
- }
335
- static async determineAccount({ account, accountDerivationPath, wallet }) {
336
- if (wallet) {
337
- return (0, import_assert.assertEx)(accountDerivationPath ? await wallet.derivePath(accountDerivationPath) : wallet, "Failed to derive account from path");
338
- } else if (account === "random") {
339
- return await import_account.HDWallet.random();
340
- } else if (account) {
341
- return account;
342
- } else {
343
- console.warn("AbstractModule.determineAccount: No account provided - Creating Random account");
344
- return await import_account.HDWallet.random();
345
- }
346
- }
347
- static factory(params) {
348
- return import_module_model.ModuleFactory.withParams(this, params);
349
- }
350
- _getRootFunction(funcName) {
351
- let anyThis = this;
352
- while (anyThis.__proto__[funcName]) {
353
- anyThis = anyThis.__proto__;
354
- }
355
- return anyThis[funcName];
356
- }
357
- _noOverride(functionName) {
358
- const thisFunc = this[functionName];
359
- const rootFunc = this._getRootFunction(functionName);
360
- (0, import_assert.assertEx)(thisFunc === rootFunc, `Override not allowed for [${functionName}] - override ${functionName}Handler instead`);
361
- }
362
- async busy(closure) {
363
- if (this._busyCount <= 0) {
364
- this._busyCount = 0;
365
- const args = {
366
- busy: true,
367
- module: this
368
- };
369
- await this.emit("moduleBusy", args);
370
- }
371
- this._busyCount++;
372
- try {
373
- return await closure();
374
- } finally {
375
- this._busyCount--;
376
- if (this._busyCount <= 0) {
377
- this._busyCount = 0;
378
- const args = {
379
- busy: false,
380
- module: this
381
- };
382
- await this.emit("moduleBusy", args);
383
- }
384
- }
385
- }
386
- emit(eventName, eventArgs) {
387
- return super.emit(eventName, eventArgs);
388
- }
389
- previousHash() {
390
- return this.account.previousHash;
391
- }
392
- async query(query, payloads, queryConfig) {
393
- this._noOverride("query");
394
- return await this.busy(async () => {
395
- const resultPayloads = [];
396
- const errorPayloads = [];
397
- const queryAccount = this.ephemeralQueryAccountEnabled ? await import_account.HDWallet.random() : void 0;
398
- try {
399
- await this.started("throw");
400
- if (!this.allowAnonymous) {
401
- if (query.addresses.length === 0) {
402
- throw Error(`Anonymous Queries not allowed, but running anyway [${this.config.name}], [${this.address}]`);
403
- }
404
- }
405
- resultPayloads.push(...await this.queryHandler((0, import_assert.assertEx)(import_boundwitness_builder3.QueryBoundWitnessWrapper.unwrap(query)), payloads, queryConfig));
406
- } catch (ex) {
407
- await (0, import_error.handleErrorAsync)(ex, async (error) => {
408
- errorPayloads.push(new ModuleErrorBuilder().sources([
409
- await import_core2.PayloadHasher.hashAsync(query)
410
- ]).name(this.config.name ?? "<Unknown>").query(query.schema).message(error.message).build());
411
- });
412
- }
413
- if (this.timestamp) {
414
- const timestamp = {
415
- schema: "network.xyo.timestamp",
416
- timestamp: Date.now()
417
- };
418
- resultPayloads.push(timestamp);
419
- }
420
- const result = await this.bindQueryResult(query, resultPayloads, queryAccount ? [
421
- queryAccount
422
- ] : [], errorPayloads);
423
- const args = {
424
- module: this,
425
- payloads,
426
- query,
427
- result
428
- };
429
- await this.emit("moduleQueried", args);
430
- return result;
431
- });
432
- }
433
- queryable(query, payloads, queryConfig) {
434
- if (!this.started("warn"))
435
- return false;
436
- const configValidator = queryConfig ? new ModuleConfigQueryValidator(Object.assign({}, this.config, queryConfig)).queryable : this.moduleConfigQueryValidator;
437
- const validators = [
438
- this.supportedQueryValidator,
439
- configValidator
440
- ];
441
- return validators.every((validator) => validator(query, payloads));
442
- }
443
- async resolve(nameOrAddressOrFilter, options) {
444
- const direction = options?.direction ?? "all";
445
- const up = direction === "up" || direction === "all";
446
- const down = direction === "down" || direction === "all";
447
- switch (typeof nameOrAddressOrFilter) {
448
- case "string": {
449
- return (down ? await this.downResolver.resolve(nameOrAddressOrFilter, options) : void 0) ?? (up ? await this.upResolver.resolve(nameOrAddressOrFilter, options) : void 0);
450
- }
451
- default: {
452
- const filter = nameOrAddressOrFilter;
453
- return [
454
- ...down ? await this.downResolver.resolve(filter, options) : [],
455
- ...up ? await this.upResolver.resolve(filter, options) : []
456
- ].filter(import_module_model.duplicateModules);
457
- }
458
- }
459
- }
460
- start(_timeout) {
461
- this._startPromise = this._startPromise ?? this.startHandler();
462
- return this._startPromise;
463
- }
464
- async started(notStartedAction = "log", tryStart = true) {
465
- const started = await this._started;
466
- if (started === true) {
467
- return true;
468
- }
469
- if (!started) {
470
- this._started = (async () => {
471
- if (tryStart) {
472
- try {
473
- await this.start();
474
- return true;
475
- } catch (ex) {
476
- (0, import_error.handleError)(ex, (error) => {
477
- this.logger?.warn(`Autostart of Module Failed: ${error.message})`);
478
- this._started = void 0;
479
- });
480
- }
481
- }
482
- switch (notStartedAction) {
483
- case "throw":
484
- throw Error(`Module not Started [${this.address}]`);
485
- case "warn":
486
- this.logger?.warn("Module not started");
487
- break;
488
- case "error":
489
- this.logger?.error("Module not started");
490
- break;
491
- case "none":
492
- break;
493
- case "log":
494
- default: {
495
- this.logger?.log("Module not started");
496
- break;
497
- }
498
- }
499
- return false;
500
- })();
501
- }
502
- if (!this._started) {
503
- throw "Failed to create start promise";
504
- }
505
- return await this._started;
506
- }
507
- async stop(_timeout) {
508
- return await this.busy(async () => {
509
- const result = await this.stopHandler();
510
- this._started = void 0;
511
- this._startPromise = void 0;
512
- return result;
513
- });
514
- }
515
- bindHashes(hashes, schema, account) {
516
- const promise = new import_promise.PromiseEx((resolve) => {
517
- const result = this.bindHashesInternal(hashes, schema, account);
518
- resolve?.(result);
519
- return result;
520
- }, account);
521
- return promise;
522
- }
523
- async bindHashesInternal(hashes, schema, account) {
524
- const builder = new import_boundwitness_builder3.BoundWitnessBuilder().hashes(hashes, schema).witness(this.account);
525
- const result = (await (account ? builder.witness(account) : builder).build())[0];
526
- this.logger?.debug(`result: ${JSON.stringify(result, null, 2)}`);
527
- return result;
528
- }
529
- bindQuery(query, payloads, account) {
530
- const promise = new import_promise.PromiseEx(async (resolve) => {
531
- const result = await this.bindQueryInternal(query, payloads, account);
532
- resolve?.(result);
533
- return result;
534
- }, account);
535
- return promise;
536
- }
537
- async bindQueryInternal(query, payloads, account) {
538
- const builder = new import_boundwitness_builder3.QueryBoundWitnessBuilder().payloads(payloads).witness(this.account).query(query);
539
- const result = await (account ? builder.witness(account) : builder).build();
540
- return result;
541
- }
542
- async bindQueryResult(query, payloads, additionalWitnesses = [], errors) {
543
- const builder = new import_boundwitness_builder3.BoundWitnessBuilder().payloads(payloads).errors(errors);
544
- const queryWitnessAccount = this.queryAccounts[query.schema];
545
- const witnesses = [
546
- this.account,
547
- queryWitnessAccount,
548
- ...additionalWitnesses
549
- ].filter(import_exists.exists);
550
- builder.witnesses(witnesses);
551
- const result = [
552
- (await builder.build())[0],
553
- payloads,
554
- errors ?? []
555
- ];
556
- if (this.config.archiving) {
557
- await this.storeToArchivists(result.flat());
558
- }
559
- return result;
560
- }
561
- commitArchivist = () => this.getArchivist("commit");
562
- async describeHandler() {
563
- const description = {
564
- address: this.address,
565
- queries: this.queries,
566
- schema: import_module_model.ModuleDescriptionSchema
567
- };
568
- if (this.config?.name) {
569
- description.name = this.config.name;
570
- }
571
- const discover = await this.discoverHandler();
572
- description.children = (0, import_lodash.compact)(discover?.map((payload) => {
573
- const address = payload.schema === import_address_payload_plugin.AddressSchema ? payload.address : void 0;
574
- return address != this.address ? address : void 0;
575
- }) ?? []);
576
- return description;
577
- }
578
- discoverHandler() {
579
- const config = this.config;
580
- const address = new import_payload_builder2.PayloadBuilder({
581
- schema: import_address_payload_plugin.AddressSchema
582
- }).fields({
583
- address: this.address,
584
- name: this.config?.name
585
- }).build();
586
- const queries = this.queries.map((query) => {
587
- return new import_payload_builder2.PayloadBuilder({
588
- schema: import_query_payload_plugin.QuerySchema
589
- }).fields({
590
- query
591
- }).build();
592
- });
593
- const configSchema = {
594
- config: config.schema,
595
- schema: import_config_payload_plugin.ConfigSchema
596
- };
597
- return (0, import_lodash.compact)([
598
- config,
599
- configSchema,
600
- address,
601
- ...queries
602
- ]);
603
- }
604
- async getArchivist(kind) {
605
- if (!this.config.archivist)
606
- return void 0;
607
- const filter = typeof this.config.archivist === "string" || this.config.archivist instanceof String ? this.config.archivist : this.config?.archivist?.[kind];
608
- const resolved = await this.upResolver.resolve(filter);
609
- return (0, import_archivist_model.asArchivistInstance)(resolved);
610
- }
611
- async initializeQueryAccounts() {
612
- const paths = Object.values(this.queryAccountPaths).filter(import_exists.exists);
613
- const distinctPaths = new Set(paths);
614
- (0, import_assert.assertEx)(distinctPaths.size === paths.length, `${this.config?.name ? this.config.name + ": " : ""}Duplicate query account paths`);
615
- const wallet = this.account;
616
- if (wallet?.derivePath) {
617
- for (const key in this.queryAccountPaths) {
618
- if (Object.prototype.hasOwnProperty.call(this.queryAccountPaths, key)) {
619
- const query = key;
620
- const queryAccountPath = this.queryAccountPaths[query];
621
- if (queryAccountPath) {
622
- this._queryAccounts[query] = await wallet.derivePath?.(queryAccountPath);
623
- }
624
- }
625
- }
626
- }
627
- }
628
- manifestHandler(_depth, _ignoreAddresses) {
629
- const name = this.config.name ?? "Anonymous";
630
- return {
631
- config: {
632
- name,
633
- ...this.config
634
- },
635
- schema: import_manifest_model.ModuleManifestPayloadSchema,
636
- status: {
637
- address: this.address
638
- }
639
- };
640
- }
641
- moduleAddressHandler() {
642
- const queryAccounts = Object.entries(this.queryAccounts).filter((value) => {
643
- return (0, import_exists.exists)(value[1]);
644
- }).map(([name2, account]) => {
645
- const address2 = account.address;
646
- const previousHash2 = account.previousHash;
647
- return [
648
- {
649
- address: address2,
650
- name: name2,
651
- schema: import_address_payload_plugin.AddressSchema
652
- },
653
- {
654
- address: address2,
655
- previousHash: previousHash2,
656
- schema: import_module_model.AddressPreviousHashSchema
657
- }
658
- ];
659
- });
660
- const address = this.address;
661
- const name = this.config.name;
662
- const previousHash = this.address;
663
- const moduleAccount = name ? {
664
- address,
665
- name,
666
- schema: import_address_payload_plugin.AddressSchema
667
- } : {
668
- address,
669
- schema: import_address_payload_plugin.AddressSchema
670
- };
671
- const moduleAccountPreviousHash = previousHash ? {
672
- address,
673
- previousHash,
674
- schema: import_module_model.AddressPreviousHashSchema
675
- } : {
676
- address,
677
- schema: import_module_model.AddressPreviousHashSchema
678
- };
679
- return [
680
- moduleAccount,
681
- moduleAccountPreviousHash,
682
- ...queryAccounts
683
- ].flat();
684
- }
685
- async queryHandler(query, payloads, queryConfig) {
686
- await this.started("throw");
687
- const wrapper = import_boundwitness_builder3.QueryBoundWitnessWrapper.parseQuery(query, payloads);
688
- const queryPayload = await wrapper.getQuery();
689
- (0, import_assert.assertEx)(this.queryable(query, payloads, queryConfig));
690
- const resultPayloads = [];
691
- switch (queryPayload.schema) {
692
- case import_module_model.ModuleManifestQuerySchema: {
693
- resultPayloads.push(await this.manifestHandler(queryPayload.maxDepth));
694
- break;
695
- }
696
- case import_module_model.ModuleDiscoverQuerySchema: {
697
- resultPayloads.push(...await this.discoverHandler());
698
- break;
699
- }
700
- case import_module_model.ModuleDescribeQuerySchema: {
701
- resultPayloads.push(await this.describeHandler());
702
- break;
703
- }
704
- case import_module_model.ModuleAddressQuerySchema: {
705
- resultPayloads.push(...await this.moduleAddressHandler());
706
- break;
707
- }
708
- case import_module_model.ModuleSubscribeQuerySchema: {
709
- this.subscribeHandler();
710
- break;
711
- }
712
- default:
713
- throw Error(`Unsupported Query [${queryPayload.schema}]`);
714
- }
715
- return resultPayloads;
716
- }
717
- readArchivist = () => this.getArchivist("read");
718
- async resolveArchivingArchivists() {
719
- const archivists = this.config.archiving?.archivists;
720
- if (!archivists)
721
- return [];
722
- const resolved = await Promise.all(archivists.map((archivist) => this.resolve(archivist)));
723
- return (0, import_lodash.compact)(resolved.map((mod) => (0, import_archivist_model.asArchivistInstance)(mod)));
724
- }
725
- async startHandler() {
726
- this.validateConfig();
727
- await this.initializeQueryAccounts();
728
- this._started = true;
729
- return true;
730
- }
731
- stopHandler(_timeout) {
732
- this._started = void 0;
733
- return true;
734
- }
735
- async storeToArchivists(payloads) {
736
- const archivists = await this.resolveArchivingArchivists();
737
- return (await Promise.all(archivists.map((archivist) => {
738
- return archivist.insert?.(payloads);
739
- }))).map(([bw]) => bw);
740
- }
741
- subscribeHandler() {
742
- return;
743
- }
744
- validateConfig(config, parents = []) {
745
- return Object.entries(config ?? this.config ?? {}).reduce((valid, [key, value]) => {
746
- switch (typeof value) {
747
- case "function":
748
- this.logger?.warn(`Fields of type function not allowed in config [${parents?.join(".")}.${key}]`);
749
- return false;
750
- case "object": {
751
- if (Array.isArray(value)) {
752
- return value.reduce((valid2, value2) => {
753
- return this.validateConfig(value2, [
754
- ...parents,
755
- key
756
- ]) && valid2;
757
- }, true) && valid;
758
- }
759
- if (!(0, import_module_model.serializableField)(value)) {
760
- this.logger?.warn(`Fields that are not serializable to JSON are not allowed in config [${parents?.join(".")}.${key}]`);
761
- return false;
762
- }
763
- return value ? this.validateConfig(value, [
764
- ...parents,
765
- key
766
- ]) && valid : true;
767
- }
768
- default:
769
- return valid;
770
- }
771
- }, true);
772
- }
773
- writeArchivist = () => this.getArchivist("write");
774
- };
775
- //# sourceMappingURL=AbstractModule.cjs.map