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