@xyo-network/module-model 2.94.20 → 2.94.21

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 (80) hide show
  1. package/dist/browser/ResolveHelper.d.cts +2 -1
  2. package/dist/browser/ResolveHelper.d.cts.map +1 -1
  3. package/dist/browser/ResolveHelper.d.mts +2 -1
  4. package/dist/browser/ResolveHelper.d.mts.map +1 -1
  5. package/dist/browser/ResolveHelper.d.ts +2 -1
  6. package/dist/browser/ResolveHelper.d.ts.map +1 -1
  7. package/dist/browser/index.cjs +36 -12
  8. package/dist/browser/index.cjs.map +1 -1
  9. package/dist/browser/index.js +36 -12
  10. package/dist/browser/index.js.map +1 -1
  11. package/dist/browser/instance/ModuleResolver.d.cts +1 -0
  12. package/dist/browser/instance/ModuleResolver.d.cts.map +1 -1
  13. package/dist/browser/instance/ModuleResolver.d.mts +1 -0
  14. package/dist/browser/instance/ModuleResolver.d.mts.map +1 -1
  15. package/dist/browser/instance/ModuleResolver.d.ts +1 -0
  16. package/dist/browser/instance/ModuleResolver.d.ts.map +1 -1
  17. package/dist/browser/instance/ObjectFilter.d.cts +0 -1
  18. package/dist/browser/instance/ObjectFilter.d.cts.map +1 -1
  19. package/dist/browser/instance/ObjectFilter.d.mts +0 -1
  20. package/dist/browser/instance/ObjectFilter.d.mts.map +1 -1
  21. package/dist/browser/instance/ObjectFilter.d.ts +0 -1
  22. package/dist/browser/instance/ObjectFilter.d.ts.map +1 -1
  23. package/dist/browser/instance/ObjectResolver.d.cts +3 -0
  24. package/dist/browser/instance/ObjectResolver.d.cts.map +1 -1
  25. package/dist/browser/instance/ObjectResolver.d.mts +3 -0
  26. package/dist/browser/instance/ObjectResolver.d.mts.map +1 -1
  27. package/dist/browser/instance/ObjectResolver.d.ts +3 -0
  28. package/dist/browser/instance/ObjectResolver.d.ts.map +1 -1
  29. package/dist/browser/instance/attachable/AttachableInstance.d.cts +1 -0
  30. package/dist/browser/instance/attachable/AttachableInstance.d.cts.map +1 -1
  31. package/dist/browser/instance/attachable/AttachableInstance.d.mts +1 -0
  32. package/dist/browser/instance/attachable/AttachableInstance.d.mts.map +1 -1
  33. package/dist/browser/instance/attachable/AttachableInstance.d.ts +1 -0
  34. package/dist/browser/instance/attachable/AttachableInstance.d.ts.map +1 -1
  35. package/dist/browser/withModule.d.cts.map +1 -1
  36. package/dist/browser/withModule.d.mts.map +1 -1
  37. package/dist/browser/withModule.d.ts.map +1 -1
  38. package/dist/node/ResolveHelper.d.cts +2 -1
  39. package/dist/node/ResolveHelper.d.cts.map +1 -1
  40. package/dist/node/ResolveHelper.d.mts +2 -1
  41. package/dist/node/ResolveHelper.d.mts.map +1 -1
  42. package/dist/node/ResolveHelper.d.ts +2 -1
  43. package/dist/node/ResolveHelper.d.ts.map +1 -1
  44. package/dist/node/index.cjs +36 -12
  45. package/dist/node/index.cjs.map +1 -1
  46. package/dist/node/index.js +36 -12
  47. package/dist/node/index.js.map +1 -1
  48. package/dist/node/instance/ModuleResolver.d.cts +1 -0
  49. package/dist/node/instance/ModuleResolver.d.cts.map +1 -1
  50. package/dist/node/instance/ModuleResolver.d.mts +1 -0
  51. package/dist/node/instance/ModuleResolver.d.mts.map +1 -1
  52. package/dist/node/instance/ModuleResolver.d.ts +1 -0
  53. package/dist/node/instance/ModuleResolver.d.ts.map +1 -1
  54. package/dist/node/instance/ObjectFilter.d.cts +0 -1
  55. package/dist/node/instance/ObjectFilter.d.cts.map +1 -1
  56. package/dist/node/instance/ObjectFilter.d.mts +0 -1
  57. package/dist/node/instance/ObjectFilter.d.mts.map +1 -1
  58. package/dist/node/instance/ObjectFilter.d.ts +0 -1
  59. package/dist/node/instance/ObjectFilter.d.ts.map +1 -1
  60. package/dist/node/instance/ObjectResolver.d.cts +3 -0
  61. package/dist/node/instance/ObjectResolver.d.cts.map +1 -1
  62. package/dist/node/instance/ObjectResolver.d.mts +3 -0
  63. package/dist/node/instance/ObjectResolver.d.mts.map +1 -1
  64. package/dist/node/instance/ObjectResolver.d.ts +3 -0
  65. package/dist/node/instance/ObjectResolver.d.ts.map +1 -1
  66. package/dist/node/instance/attachable/AttachableInstance.d.cts +1 -0
  67. package/dist/node/instance/attachable/AttachableInstance.d.cts.map +1 -1
  68. package/dist/node/instance/attachable/AttachableInstance.d.mts +1 -0
  69. package/dist/node/instance/attachable/AttachableInstance.d.mts.map +1 -1
  70. package/dist/node/instance/attachable/AttachableInstance.d.ts +1 -0
  71. package/dist/node/instance/attachable/AttachableInstance.d.ts.map +1 -1
  72. package/dist/node/withModule.d.cts.map +1 -1
  73. package/dist/node/withModule.d.mts.map +1 -1
  74. package/dist/node/withModule.d.ts.map +1 -1
  75. package/package.json +8 -8
  76. package/src/ResolveHelper.ts +33 -15
  77. package/src/instance/ModuleResolver.ts +1 -0
  78. package/src/instance/ObjectFilter.ts +0 -1
  79. package/src/instance/ObjectResolver.ts +4 -0
  80. package/src/instance/attachable/AttachableInstance.ts +3 -0
@@ -8,6 +8,7 @@ export interface ResolveHelperConfig {
8
8
  downResolver?: ModuleResolver;
9
9
  logger?: Logger;
10
10
  module: ModuleInstance;
11
+ privateResolver?: ModuleResolver;
11
12
  upResolver?: ModuleResolver;
12
13
  }
13
14
  export declare class ResolveHelper {
@@ -15,7 +16,7 @@ export declare class ResolveHelper {
15
16
  static resolve<T extends ModuleInstance = ModuleInstance>(config: ResolveHelperConfig, all: '*', options?: ModuleFilterOptions<T>): Promise<T[]>;
16
17
  static resolve<T extends ModuleInstance = ModuleInstance>(config: ResolveHelperConfig, filter: ModuleFilter, options?: ModuleFilterOptions<T>): Promise<T[]>;
17
18
  static resolve<T extends ModuleInstance = ModuleInstance>(config: ResolveHelperConfig, id: ModuleIdentifier, options?: ModuleFilterOptions<T>): Promise<T | undefined>;
18
- static resolveModuleIdentifier<T extends ModuleInstance = ModuleInstance>(resolver: ModuleResolver, path: ModuleIdentifier): Promise<T | undefined>;
19
+ static resolveModuleIdentifier<T extends ModuleInstance = ModuleInstance>(resolver: ModuleResolver, path: ModuleIdentifier, required?: boolean): Promise<T | undefined>;
19
20
  static traceModuleIdentifier(resolver: ModuleResolver, path: ModuleIdentifier): Promise<Address[]>;
20
21
  static validateRequiredResolve(required: boolean | 'warn' | 'log', result: ModuleInstance[] | ModuleInstance | undefined, idOrFilter: ModuleIdentifier | ModuleFilter, logger?: Logger | undefined): void;
21
22
  }
@@ -1 +1 @@
1
- {"version":3,"file":"ResolveHelper.d.ts","sourceRoot":"","sources":["../../src/ResolveHelper.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AACrC,OAAO,EAAY,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAGjD,OAAO,EAAoB,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAwCrD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,YAAY,CAAC,EAAE,cAAc,CAAA;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,cAAc,CAAA;IACtB,UAAU,CAAC,EAAE,cAAc,CAAA;CAC5B;AAED,qBAAa,aAAa;IACxB,MAAM,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;WAChB,OAAO,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,EAC5D,MAAM,EAAE,mBAAmB,EAC3B,GAAG,EAAE,GAAG,EACR,OAAO,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,CAAC,EAAE,CAAC;WACF,OAAO,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,EAC5D,MAAM,EAAE,mBAAmB,EAC3B,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,CAAC,EAAE,CAAC;WACF,OAAO,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,EAC5D,MAAM,EAAE,mBAAmB,EAC3B,EAAE,EAAE,gBAAgB,EACpB,OAAO,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;WAwEZ,uBAAuB,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,EAC5E,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;WAaZ,qBAAqB,CAAC,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAaxG,MAAM,CAAC,uBAAuB,CAC5B,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,EAClC,MAAM,EAAE,cAAc,EAAE,GAAG,cAAc,GAAG,SAAS,EACrD,UAAU,EAAE,gBAAgB,GAAG,YAAY,EAC3C,MAAM,qBAAqB;CAmB9B"}
1
+ {"version":3,"file":"ResolveHelper.d.ts","sourceRoot":"","sources":["../../src/ResolveHelper.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAa,MAAM,aAAa,CAAA;AAChD,OAAO,EAAY,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAGjD,OAAO,EAAoB,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AA0CrD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,YAAY,CAAC,EAAE,cAAc,CAAA;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,cAAc,CAAA;IACtB,eAAe,CAAC,EAAE,cAAc,CAAA;IAChC,UAAU,CAAC,EAAE,cAAc,CAAA;CAC5B;AAED,qBAAa,aAAa;IACxB,MAAM,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;WAChB,OAAO,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,EAC5D,MAAM,EAAE,mBAAmB,EAC3B,GAAG,EAAE,GAAG,EACR,OAAO,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,CAAC,EAAE,CAAC;WACF,OAAO,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,EAC5D,MAAM,EAAE,mBAAmB,EAC3B,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,CAAC,EAAE,CAAC;WACF,OAAO,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,EAC5D,MAAM,EAAE,mBAAmB,EAC3B,EAAE,EAAE,gBAAgB,EACpB,OAAO,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;WAmFZ,uBAAuB,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,EAC5E,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,gBAAgB,EACtB,QAAQ,CAAC,EAAE,OAAO,GACjB,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;WAeZ,qBAAqB,CAAC,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAaxG,MAAM,CAAC,uBAAuB,CAC5B,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,EAClC,MAAM,EAAE,cAAc,EAAE,GAAG,cAAc,GAAG,SAAS,EACrD,UAAU,EAAE,gBAAgB,GAAG,YAAY,EAC3C,MAAM,qBAAqB;CAmB9B"}
@@ -8,6 +8,7 @@ export interface ResolveHelperConfig {
8
8
  downResolver?: ModuleResolver;
9
9
  logger?: Logger;
10
10
  module: ModuleInstance;
11
+ privateResolver?: ModuleResolver;
11
12
  upResolver?: ModuleResolver;
12
13
  }
13
14
  export declare class ResolveHelper {
@@ -15,7 +16,7 @@ export declare class ResolveHelper {
15
16
  static resolve<T extends ModuleInstance = ModuleInstance>(config: ResolveHelperConfig, all: '*', options?: ModuleFilterOptions<T>): Promise<T[]>;
16
17
  static resolve<T extends ModuleInstance = ModuleInstance>(config: ResolveHelperConfig, filter: ModuleFilter, options?: ModuleFilterOptions<T>): Promise<T[]>;
17
18
  static resolve<T extends ModuleInstance = ModuleInstance>(config: ResolveHelperConfig, id: ModuleIdentifier, options?: ModuleFilterOptions<T>): Promise<T | undefined>;
18
- static resolveModuleIdentifier<T extends ModuleInstance = ModuleInstance>(resolver: ModuleResolver, path: ModuleIdentifier): Promise<T | undefined>;
19
+ static resolveModuleIdentifier<T extends ModuleInstance = ModuleInstance>(resolver: ModuleResolver, path: ModuleIdentifier, required?: boolean): Promise<T | undefined>;
19
20
  static traceModuleIdentifier(resolver: ModuleResolver, path: ModuleIdentifier): Promise<Address[]>;
20
21
  static validateRequiredResolve(required: boolean | 'warn' | 'log', result: ModuleInstance[] | ModuleInstance | undefined, idOrFilter: ModuleIdentifier | ModuleFilter, logger?: Logger | undefined): void;
21
22
  }
@@ -1 +1 @@
1
- {"version":3,"file":"ResolveHelper.d.ts","sourceRoot":"","sources":["../../src/ResolveHelper.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AACrC,OAAO,EAAY,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAGjD,OAAO,EAAoB,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAwCrD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,YAAY,CAAC,EAAE,cAAc,CAAA;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,cAAc,CAAA;IACtB,UAAU,CAAC,EAAE,cAAc,CAAA;CAC5B;AAED,qBAAa,aAAa;IACxB,MAAM,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;WAChB,OAAO,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,EAC5D,MAAM,EAAE,mBAAmB,EAC3B,GAAG,EAAE,GAAG,EACR,OAAO,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,CAAC,EAAE,CAAC;WACF,OAAO,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,EAC5D,MAAM,EAAE,mBAAmB,EAC3B,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,CAAC,EAAE,CAAC;WACF,OAAO,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,EAC5D,MAAM,EAAE,mBAAmB,EAC3B,EAAE,EAAE,gBAAgB,EACpB,OAAO,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;WAwEZ,uBAAuB,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,EAC5E,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;WAaZ,qBAAqB,CAAC,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAaxG,MAAM,CAAC,uBAAuB,CAC5B,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,EAClC,MAAM,EAAE,cAAc,EAAE,GAAG,cAAc,GAAG,SAAS,EACrD,UAAU,EAAE,gBAAgB,GAAG,YAAY,EAC3C,MAAM,qBAAqB;CAmB9B"}
1
+ {"version":3,"file":"ResolveHelper.d.ts","sourceRoot":"","sources":["../../src/ResolveHelper.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAa,MAAM,aAAa,CAAA;AAChD,OAAO,EAAY,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAGjD,OAAO,EAAoB,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AA0CrD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,YAAY,CAAC,EAAE,cAAc,CAAA;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,cAAc,CAAA;IACtB,eAAe,CAAC,EAAE,cAAc,CAAA;IAChC,UAAU,CAAC,EAAE,cAAc,CAAA;CAC5B;AAED,qBAAa,aAAa;IACxB,MAAM,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;WAChB,OAAO,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,EAC5D,MAAM,EAAE,mBAAmB,EAC3B,GAAG,EAAE,GAAG,EACR,OAAO,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,CAAC,EAAE,CAAC;WACF,OAAO,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,EAC5D,MAAM,EAAE,mBAAmB,EAC3B,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,CAAC,EAAE,CAAC;WACF,OAAO,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,EAC5D,MAAM,EAAE,mBAAmB,EAC3B,EAAE,EAAE,gBAAgB,EACpB,OAAO,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;WAmFZ,uBAAuB,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,EAC5E,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,gBAAgB,EACtB,QAAQ,CAAC,EAAE,OAAO,GACjB,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;WAeZ,qBAAqB,CAAC,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAaxG,MAAM,CAAC,uBAAuB,CAC5B,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,EAClC,MAAM,EAAE,cAAc,EAAE,GAAG,cAAc,GAAG,SAAS,EACrD,UAAU,EAAE,gBAAgB,GAAG,YAAY,EAC3C,MAAM,qBAAqB;CAmB9B"}
@@ -8,6 +8,7 @@ export interface ResolveHelperConfig {
8
8
  downResolver?: ModuleResolver;
9
9
  logger?: Logger;
10
10
  module: ModuleInstance;
11
+ privateResolver?: ModuleResolver;
11
12
  upResolver?: ModuleResolver;
12
13
  }
13
14
  export declare class ResolveHelper {
@@ -15,7 +16,7 @@ export declare class ResolveHelper {
15
16
  static resolve<T extends ModuleInstance = ModuleInstance>(config: ResolveHelperConfig, all: '*', options?: ModuleFilterOptions<T>): Promise<T[]>;
16
17
  static resolve<T extends ModuleInstance = ModuleInstance>(config: ResolveHelperConfig, filter: ModuleFilter, options?: ModuleFilterOptions<T>): Promise<T[]>;
17
18
  static resolve<T extends ModuleInstance = ModuleInstance>(config: ResolveHelperConfig, id: ModuleIdentifier, options?: ModuleFilterOptions<T>): Promise<T | undefined>;
18
- static resolveModuleIdentifier<T extends ModuleInstance = ModuleInstance>(resolver: ModuleResolver, path: ModuleIdentifier): Promise<T | undefined>;
19
+ static resolveModuleIdentifier<T extends ModuleInstance = ModuleInstance>(resolver: ModuleResolver, path: ModuleIdentifier, required?: boolean): Promise<T | undefined>;
19
20
  static traceModuleIdentifier(resolver: ModuleResolver, path: ModuleIdentifier): Promise<Address[]>;
20
21
  static validateRequiredResolve(required: boolean | 'warn' | 'log', result: ModuleInstance[] | ModuleInstance | undefined, idOrFilter: ModuleIdentifier | ModuleFilter, logger?: Logger | undefined): void;
21
22
  }
@@ -1 +1 @@
1
- {"version":3,"file":"ResolveHelper.d.ts","sourceRoot":"","sources":["../../src/ResolveHelper.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AACrC,OAAO,EAAY,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAGjD,OAAO,EAAoB,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAwCrD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,YAAY,CAAC,EAAE,cAAc,CAAA;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,cAAc,CAAA;IACtB,UAAU,CAAC,EAAE,cAAc,CAAA;CAC5B;AAED,qBAAa,aAAa;IACxB,MAAM,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;WAChB,OAAO,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,EAC5D,MAAM,EAAE,mBAAmB,EAC3B,GAAG,EAAE,GAAG,EACR,OAAO,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,CAAC,EAAE,CAAC;WACF,OAAO,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,EAC5D,MAAM,EAAE,mBAAmB,EAC3B,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,CAAC,EAAE,CAAC;WACF,OAAO,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,EAC5D,MAAM,EAAE,mBAAmB,EAC3B,EAAE,EAAE,gBAAgB,EACpB,OAAO,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;WAwEZ,uBAAuB,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,EAC5E,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;WAaZ,qBAAqB,CAAC,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAaxG,MAAM,CAAC,uBAAuB,CAC5B,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,EAClC,MAAM,EAAE,cAAc,EAAE,GAAG,cAAc,GAAG,SAAS,EACrD,UAAU,EAAE,gBAAgB,GAAG,YAAY,EAC3C,MAAM,qBAAqB;CAmB9B"}
1
+ {"version":3,"file":"ResolveHelper.d.ts","sourceRoot":"","sources":["../../src/ResolveHelper.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAa,MAAM,aAAa,CAAA;AAChD,OAAO,EAAY,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAGjD,OAAO,EAAoB,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AA0CrD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,YAAY,CAAC,EAAE,cAAc,CAAA;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,cAAc,CAAA;IACtB,eAAe,CAAC,EAAE,cAAc,CAAA;IAChC,UAAU,CAAC,EAAE,cAAc,CAAA;CAC5B;AAED,qBAAa,aAAa;IACxB,MAAM,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;WAChB,OAAO,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,EAC5D,MAAM,EAAE,mBAAmB,EAC3B,GAAG,EAAE,GAAG,EACR,OAAO,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,CAAC,EAAE,CAAC;WACF,OAAO,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,EAC5D,MAAM,EAAE,mBAAmB,EAC3B,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,CAAC,EAAE,CAAC;WACF,OAAO,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,EAC5D,MAAM,EAAE,mBAAmB,EAC3B,EAAE,EAAE,gBAAgB,EACpB,OAAO,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;WAmFZ,uBAAuB,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,EAC5E,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,gBAAgB,EACtB,QAAQ,CAAC,EAAE,OAAO,GACjB,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;WAeZ,qBAAqB,CAAC,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAaxG,MAAM,CAAC,uBAAuB,CAC5B,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,EAClC,MAAM,EAAE,cAAc,EAAE,GAAG,cAAc,GAAG,SAAS,EACrD,UAAU,EAAE,gBAAgB,GAAG,YAAY,EAC3C,MAAM,qBAAqB;CAmB9B"}
@@ -518,6 +518,8 @@ var isModuleStateWithMeta = /* @__PURE__ */ __name((payload) => {
518
518
 
519
519
  // src/ResolveHelper.ts
520
520
  var import_assert3 = require("@xylabs/assert");
521
+ var import_exists = require("@xylabs/exists");
522
+ var import_hex2 = require("@xylabs/hex");
521
523
  var import_logger = require("@xylabs/logger");
522
524
  var import_object10 = require("@xylabs/object");
523
525
  var ResolveHelper = class {
@@ -525,15 +527,14 @@ var ResolveHelper = class {
525
527
  __name(this, "ResolveHelper");
526
528
  }
527
529
  static defaultLogger;
528
- static async resolve(config, idOrFilter = "*", { visibility, maxDepth = 3, required = "log", ...options } = {}) {
529
- const { module: module2, logger = this.defaultLogger, dead = false, upResolver, downResolver } = config;
530
- const log = logger ? new import_logger.IdLogger(logger, () => `ResolveHelper [${module2.id}][${idOrFilter}][${visibility}]`) : void 0;
530
+ static async resolve(config, idOrFilter = "*", { maxDepth = 3, required = "log", ...options } = {}) {
531
+ const { module: module2, logger = this.defaultLogger, dead = false, upResolver, downResolver, privateResolver } = config;
532
+ const log = logger ? new import_logger.IdLogger(logger, () => `ResolveHelper [${module2.id}][${idOrFilter}]`) : void 0;
531
533
  const downLocalOptions = {
532
534
  ...options,
533
535
  direction: "down",
534
536
  maxDepth,
535
- required: false,
536
- visibility
537
+ required: false
537
538
  };
538
539
  const upLocalOptions = {
539
540
  ...downLocalOptions,
@@ -542,8 +543,7 @@ var ResolveHelper = class {
542
543
  const childOptions = {
543
544
  ...options,
544
545
  maxDepth: maxDepth - 1,
545
- required: false,
546
- visibility
546
+ required: false
547
547
  };
548
548
  const direction = options?.direction ?? "all";
549
549
  const up = direction === "up" || direction === "all";
@@ -577,7 +577,26 @@ var ResolveHelper = class {
577
577
  if (dead) {
578
578
  return void 0;
579
579
  }
580
- result = (down && downResolver ? await this.resolveModuleIdentifier(downResolver, idOrFilter) : void 0) ?? (up && upResolver ? await this.resolveModuleIdentifier(upResolver, idOrFilter) : void 0);
580
+ const resolvers = [
581
+ [
582
+ downResolver,
583
+ downLocalOptions
584
+ ],
585
+ [
586
+ up ? upResolver : void 0,
587
+ upLocalOptions
588
+ ],
589
+ [
590
+ up ? privateResolver : void 0,
591
+ upLocalOptions
592
+ ]
593
+ ].filter(([resolver]) => (0, import_exists.exists)(resolver));
594
+ for (const resolver of resolvers) {
595
+ const [resolverInstance] = resolver;
596
+ if (!result) {
597
+ result = await this.resolveModuleIdentifier(resolverInstance, idOrFilter);
598
+ }
599
+ }
581
600
  break;
582
601
  }
583
602
  default: {
@@ -597,12 +616,17 @@ var ResolveHelper = class {
597
616
  return result;
598
617
  }
599
618
  //resolves a complex module path to addresses
600
- static async resolveModuleIdentifier(resolver, path) {
619
+ static async resolveModuleIdentifier(resolver, path, required) {
601
620
  const parts = path.split(":");
602
621
  const first = parts.shift();
603
- const firstModule = asModuleInstance((0, import_assert3.assertEx)(await resolver.resolve(first, {
604
- maxDepth: 1
605
- }), () => `Failed to resolve [${first}]`), () => `Resolved invalid module instance [${first}]`);
622
+ const firstIsAddress = (0, import_hex2.isAddress)(first);
623
+ const resolvedModule = await resolver.resolve(first, {
624
+ maxDepth: firstIsAddress ? 10 : 1
625
+ }) ?? (first ? await resolver.resolvePrivate(first, {
626
+ maxDepth: firstIsAddress ? 10 : 1
627
+ }) : void 0);
628
+ const finalModule = required ? (0, import_assert3.assertEx)(resolvedModule, () => `Failed to resolve [${first}] [${firstIsAddress}]`) : resolvedModule;
629
+ const firstModule = asModuleInstance(finalModule, () => `Resolved invalid module instance [${first}]`);
606
630
  if (firstModule) {
607
631
  return parts.length > 0 ? await this.resolveModuleIdentifier(firstModule, parts.join(":")) : firstModule;
608
632
  }
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/index.ts","../../src/Config/Config.ts","../../src/CreatableModule/CreatableModule.ts","../../src/CreatableModule/CreatableModuleRegistry.ts","../../src/CreatableModule/LabeledCreatableModuleFactory.ts","../../src/CreatableModule/ModuleFactory.ts","../../src/CreatableModule/ModuleFactoryLocator.ts","../../src/Labels/Labels.ts","../../src/instance/asModuleInstance.ts","../../src/instance/isModuleInstance.ts","../../src/module/asModule.ts","../../src/Queries/Manifest.ts","../../src/Queries/ModuleAddress/Query.ts","../../src/Queries/State.ts","../../src/Queries/Subscribe.ts","../../src/module/asModuleObject.ts","../../src/module/isModuleObject.ts","../../src/module/IsModuleFactory.ts","../../src/module/isModule.ts","../../src/instance/attachable/asAttachableInstance.ts","../../src/instance/attachable/isAttachableInstance.ts","../../src/instance/attachable/AttachableInstance.ts","../../src/instance/Instance.ts","../../src/instance/ObjectFilter.ts","../../src/instance/ModuleFilter.ts","../../src/instance/ObjectResolver.ts","../../src/instance/ModuleResolver.ts","../../src/lib/duplicateModules.ts","../../src/lib/serializable.ts","../../src/ModuleIdentifier.ts","../../src/Payload/AddressPreviousHash.ts","../../src/Payload/Description.ts","../../src/Payload/ModuleState.ts","../../src/ResolveHelper.ts","../../src/withModule.ts"],"sourcesContent":["export * from './cache'\nexport * from './Config'\nexport * from './CreatableModule'\nexport * from './EventsModels'\nexport * from './instance'\nexport * from './Labels'\nexport * from './lib'\nexport * from './module'\nexport * from './ModuleDescription'\nexport * from './ModuleIdentifier'\nexport * from './ModuleIdentifierTransformer'\nexport * from './ModuleParams'\nexport * from './ModuleQueryHandlerResult'\nexport * from './ModuleQueryResult'\nexport * from './Payload'\nexport * from './Queries'\nexport * from './ResolveHelper'\nexport * from './withModule'\n","import { EmptyObject, WithAdditional } from '@xylabs/object'\nimport { Payload, Schema } from '@xyo-network/payload-model'\n\nimport { ArchivingModuleConfig } from './Archiving'\nimport { ModuleConfigFields } from './Fields'\n\nexport type ModuleConfigSchema = 'network.xyo.module.config'\nexport const ModuleConfigSchema: ModuleConfigSchema = 'network.xyo.module.config'\n\nexport type ModuleConfig<TConfig extends EmptyObject | Payload | void = void, TSchema extends Schema | void = void> = Payload<\n WithAdditional<ArchivingModuleConfig & ModuleConfigFields, TConfig>,\n TSchema extends Schema ? TSchema\n : TConfig extends Payload ? TConfig['schema']\n : ModuleConfigSchema\n>\n\nexport type AnyConfigSchema<TConfig extends Omit<ModuleConfig, 'schema'> & { schema: string } = Omit<ModuleConfig, 'schema'> & { schema: string }> =\n ModuleConfig<TConfig, string>\n\nexport type OptionalConfigSchema<TConfig extends AnyConfigSchema<ModuleConfig> = AnyConfigSchema<ModuleConfig>> = Omit<TConfig, 'schema'> & {\n schema?: TConfig['schema']\n}\n\nexport type AnyModuleConfig = AnyConfigSchema<ModuleConfig>\n","import { Logger } from '@xylabs/logger'\nimport { AccountInstance } from '@xyo-network/account-model'\n\nimport { AttachableModuleInstance } from '../instance'\n\nexport type CreatableModuleFactory<T extends AttachableModuleInstance = AttachableModuleInstance> = Omit<\n Omit<CreatableModule<T>, 'new'>,\n 'create'\n> & {\n create<T extends AttachableModuleInstance>(this: CreatableModuleFactory<T>, params?: T['params']): Promise<T>\n}\n\nexport interface CreatableModule<T extends AttachableModuleInstance = AttachableModuleInstance> {\n configSchema: string\n configSchemas: string[]\n defaultLogger?: Logger\n new (privateConstructorKey: string, params: T['params'], account: AccountInstance): T\n _noOverride(functionName: string): void\n create<T extends AttachableModuleInstance>(this: CreatableModule<T>, params?: T['params']): Promise<T>\n factory<T extends AttachableModuleInstance>(this: CreatableModule<T>, params?: T['params']): CreatableModuleFactory<T>\n}\n\n/**\n * Class annotation to be used to decorate Modules which support\n * an asynchronous creation pattern\n * @returns The decorated Module requiring it implement the members\n * of the CreatableModule as statics properties/methods\n */\nexport function creatableModule<TModule extends AttachableModuleInstance = AttachableModuleInstance>() {\n return <U extends CreatableModule<TModule>>(constructor: U) => {\n constructor\n }\n}\n","import { CreatableModuleFactory } from './CreatableModule'\nimport { CreatableModuleDictionary } from './CreatableModuleDictionary'\nimport { LabeledCreatableModuleFactory } from './LabeledCreatableModuleFactory'\n\nexport interface CreatableModuleRegistry {\n [key: string]: (CreatableModuleFactory | LabeledCreatableModuleFactory)[] | undefined\n}\n\nexport const toCreatableModuleRegistry = (dict: CreatableModuleDictionary | CreatableModuleRegistry): CreatableModuleRegistry => {\n // eslint-disable-next-line unicorn/no-array-reduce\n return Object.entries(dict).reduce((registry, [schema, factory]) => {\n registry[schema] = Array.isArray(factory) ? factory : [factory]\n return registry\n }, {} as CreatableModuleRegistry)\n}\n\nexport const assignCreatableModuleRegistry = (\n target: CreatableModuleRegistry = {},\n ...sources: CreatableModuleRegistry[]\n): CreatableModuleRegistry => {\n sources.map((source) =>\n Object.entries(source).map(([schema, factories]) => {\n if (factories) {\n const existingFactories = target[schema]\n target[schema] = existingFactories ? (target[schema] = [...existingFactories, ...factories]) : factories\n }\n }),\n )\n return target\n}\n","import { AttachableModuleInstance } from '../instance'\nimport { WithOptionalLabels } from '../Labels'\nimport { CreatableModuleFactory } from './CreatableModule'\n\nexport type LabeledCreatableModuleFactory<T extends AttachableModuleInstance = AttachableModuleInstance> = CreatableModuleFactory<T> &\n WithOptionalLabels\n\nexport const hasLabels = (factory: CreatableModuleFactory | LabeledCreatableModuleFactory): factory is LabeledCreatableModuleFactory => {\n return (factory as LabeledCreatableModuleFactory).labels !== undefined\n}\n","import { assertEx } from '@xylabs/assert'\nimport { merge } from '@xylabs/lodash'\nimport { Logger } from '@xylabs/logger'\n\nimport { AttachableModuleInstance } from '../instance'\nimport { Labels, WithOptionalLabels } from '../Labels'\nimport { CreatableModule, CreatableModuleFactory } from './CreatableModule'\n\nexport class ModuleFactory<TModule extends AttachableModuleInstance> implements CreatableModuleFactory<TModule> {\n configSchemas: CreatableModuleFactory<TModule>['configSchemas']\n\n creatableModule: CreatableModule<TModule>\n\n defaultLogger?: Logger | undefined\n\n defaultParams?: Omit<TModule['params'], 'config'> & { config?: Partial<TModule['params']['config']> }\n\n labels?: Labels\n\n constructor(\n creatableModule: CreatableModule<TModule>,\n params?: Omit<TModule['params'], 'config'> & { config?: Partial<TModule['params']['config']> },\n labels: Labels = {},\n ) {\n this.creatableModule = creatableModule\n this.defaultParams = params\n this.configSchemas = creatableModule.configSchemas\n this.labels = Object.assign({}, (creatableModule as WithOptionalLabels).labels ?? {}, labels ?? {})\n }\n\n get configSchema(): string {\n return this.configSchemas[0]\n }\n\n static withParams<T extends AttachableModuleInstance>(\n creatableModule: CreatableModule<T>,\n params?: Omit<T['params'], 'config'> & { config?: T['params']['config'] },\n labels: Labels = {},\n ) {\n return new ModuleFactory(creatableModule, params, labels)\n }\n\n _getRootFunction(funcName: string) {\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n let anyThis = this as any\n while (anyThis.__proto__[funcName]) {\n anyThis = anyThis.__proto__\n }\n return anyThis[funcName]\n }\n\n _noOverride(functionName: string) {\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n const thisFunc = (this as any)[functionName]\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n const rootFunc = this._getRootFunction(functionName)\n assertEx(thisFunc === rootFunc, () => `Override not allowed for [${functionName}] - override ${functionName}Handler instead`)\n }\n\n create<T extends AttachableModuleInstance>(this: CreatableModuleFactory<T>, params?: TModule['params'] | undefined): Promise<T> {\n const factory = this as ModuleFactory<T>\n const schema = factory.creatableModule.configSchema\n const mergedParams: TModule['params'] = merge({}, factory.defaultParams, params, {\n config: merge({}, factory.defaultParams?.config, params?.config, { schema }),\n })\n return factory.creatableModule.create<T>(mergedParams)\n }\n\n factory<T extends AttachableModuleInstance>(this: CreatableModule<T>, _params?: T['params'] | undefined): CreatableModuleFactory<T> {\n throw new Error('Method not implemented.')\n }\n}\n","import { assertEx } from '@xylabs/assert'\n\nimport { AttachableModuleInstance } from '../instance'\nimport { hasAllLabels, Labels } from '../Labels'\nimport { CreatableModuleFactory } from './CreatableModule'\nimport { CreatableModuleRegistry } from './CreatableModuleRegistry'\nimport { hasLabels, LabeledCreatableModuleFactory } from './LabeledCreatableModuleFactory'\n\n/**\n * A class which encapsulates the Service Locator Pattern for Module Factories\n */\nexport class ModuleFactoryLocator {\n constructor(protected readonly _registry: CreatableModuleRegistry = {}) {}\n\n /**\n * The current registry for the module factory\n */\n get registry(): Readonly<CreatableModuleRegistry> {\n return this._registry\n }\n\n /**\n * Locates a module factory that matches the supplied schema and labels\n * @param schema The config schema for the module\n * @param labels The labels for the module factory\n * @returns A module factory that matches the supplied schema and labels or throws if one is not found\n */\n locate(schema: string, labels?: Labels): CreatableModuleFactory | LabeledCreatableModuleFactory {\n return assertEx(this.tryLocate(schema, labels), () => {\n const configString = `config schema [${schema}]`\n const labelsString = labels ? ` & labels [${JSON.stringify(labels)}]` : ''\n return `No module factory for the supplied ${configString}${labelsString} registered`\n })\n }\n\n /**\n * Registers a single module factory (with optional tags) with the locator\n * @param additional Additional module factories to register\n */\n register<TModule extends AttachableModuleInstance>(mod: CreatableModuleFactory<TModule>, labels?: Labels): this {\n mod.configSchemas.map((schema) => {\n const existingFactories = this._registry[schema]\n const factory: LabeledCreatableModuleFactory<TModule> = {\n // Destructure instance properties\n ...mod,\n // Copy static methods\n create: mod.create.bind(mod) as LabeledCreatableModuleFactory<TModule>['create'],\n // Merge module & supplied labels\n labels: Object.assign({}, (mod as LabeledCreatableModuleFactory).labels ?? {}, labels ?? {}),\n }\n this._registry[schema] = existingFactories ? [...existingFactories, factory] : [factory]\n })\n return this\n }\n\n /**\n * Registers multiple module factories with the locator\n * @param additional Additional module factories to register\n */\n registerMany(additional: CreatableModuleRegistry): this {\n Object.entries(additional).map(([schema, factories]) => {\n if (factories) {\n const existingFactories = this._registry[schema]\n this._registry[schema] = existingFactories ? [...existingFactories, ...factories] : factories\n }\n })\n return this\n }\n\n /**\n * Tries to locate a module factory that matches the supplied schema and labels\n * @param schema The config schema for the module\n * @param labels The labels for the module factory\n * @returns A module factory that matches the supplied schema and labels or undefined\n */\n tryLocate(schema: string, labels?: Labels): CreatableModuleFactory | LabeledCreatableModuleFactory | undefined {\n // If labels were provided\n return labels ?\n // Find the first factory that has labels and has all the labels provided\n this._registry[schema]?.filter(hasLabels).find((factory) => hasAllLabels(factory?.labels, labels))\n : // Otherwise, return the first factory\n this._registry[schema]?.[0]\n }\n}\n","/**\n * Object used to represent labels identifying a resource.\n */\nexport interface Labels {\n [key: string]: string | undefined\n}\n\n/**\n * Interface for objects that have labels.\n */\nexport interface WithLabels<T extends Labels = Labels> {\n labels: T\n}\n\n/**\n * Interface for objects that have labels.\n */\nexport interface WithOptionalLabels<T extends Labels = Labels> {\n labels?: T\n}\n\n/**\n * Returns true if the source object has all the labels from the required set\n * @param source Source object to check against\n * @param required Set of labels to check for in source\n * @returns True of the source object has all the labels from the required set\n */\nexport const hasAllLabels = (source?: Labels, required?: Labels): boolean => {\n if (!required) return true\n return Object.entries(required).every(([key, value]) => {\n // eslint-disable-next-line no-prototype-builtins\n return source?.hasOwnProperty(key as keyof typeof source) && source?.[key as keyof typeof source] === value\n })\n}\n","import { AsObjectFactory } from '@xylabs/object'\n\nimport { isModuleInstance } from './isModuleInstance'\n\nexport const asModuleInstance = AsObjectFactory.create(isModuleInstance)\n","import { IsObjectFactory, ObjectTypeShape, TypeCheck } from '@xylabs/object'\n\nimport { isModule } from '../module'\nimport { ModuleInstance } from './Instance'\n\nexport const requiredModuleInstanceFunctions: ObjectTypeShape = {\n manifest: 'function',\n state: 'function',\n}\n\n//we do not use IsInstanceFactory here to prevent a cycle\nconst factory = new IsObjectFactory<ModuleInstance>()\n\nexport const isModuleInstance: TypeCheck<ModuleInstance> = factory.create(requiredModuleInstanceFunctions, [isModule])\n","import { AsObjectFactory } from '@xylabs/object'\n\nimport { isModule } from './isModule'\n\nexport const asModule = AsObjectFactory.create(isModule)\n","import { Query } from '@xyo-network/payload-model'\n\nexport type ModuleManifestQuerySchema = 'network.xyo.query.module.manifest'\nexport const ModuleManifestQuerySchema: ModuleManifestQuerySchema = 'network.xyo.query.module.manifest'\n\nexport type ModuleManifestQuery = Query<{\n maxDepth?: number\n schema: ModuleManifestQuerySchema\n}>\n","import { Query } from '@xyo-network/payload-model'\n\nexport type ModuleAddressQuerySchema = 'network.xyo.query.module.address'\nexport const ModuleAddressQuerySchema: ModuleAddressQuerySchema = 'network.xyo.query.module.address'\n\nexport type ModuleAddressQuery = Query<{\n schema: ModuleAddressQuerySchema\n}>\n","import { Query } from '@xyo-network/payload-model'\n\nexport const ModuleStateQuerySchema = 'network.xyo.query.module.state'\nexport type ModuleStateQuerySchema = typeof ModuleStateQuerySchema\n\nexport type ModuleStateQuery = Query<void, ModuleStateQuerySchema>\n","import { Address } from '@xylabs/hex'\nimport { Query } from '@xyo-network/payload-model'\n\nexport type ModuleSubscribeQuerySchema = 'network.xyo.query.module.subscribe'\nexport const ModuleSubscribeQuerySchema: ModuleSubscribeQuerySchema = 'network.xyo.query.module.subscribe'\n\nexport interface ModuleSubscribeFilter {\n /** @field if specified, at least one of the schemas must be present in the boundwtness to generate a notification */\n schema?: string[]\n}\n\n//requests notification when a boundwitness is added to the modules chain that meets the filter criteria\nexport type ModuleSubscribeQuery = Query<{\n /** @field The address that will receive notifications */\n address: Address\n /** @field A subscribe with a null for filter is an unsubscribe */\n filter?: ModuleSubscribeFilter | null\n /** @field The maximum events queued per send [may increase frequency] */\n maxQueue?: number\n schema: ModuleSubscribeQuerySchema\n}>\n","import { AsObjectFactory } from '@xylabs/object'\n\nimport { isModuleObject } from './isModuleObject'\n\nexport const asModuleObject = AsObjectFactory.create(isModuleObject)\n","import { IsObjectFactory, ObjectTypeShape } from '@xylabs/object'\n\nimport { Module } from './Module'\n\nexport const requiredModuleShape: ObjectTypeShape = {\n address: 'string',\n queries: 'array',\n query: 'function',\n}\n\nconst factory = new IsObjectFactory<Module>()\n\nexport const isModuleObject = factory.create(requiredModuleShape)\n","import { AnyObject, EmptyObject, TypeCheck } from '@xylabs/object'\nimport { AnyNonPromise } from '@xylabs/promise'\n\nimport { asModuleObject } from './asModuleObject'\nimport { isModuleObject } from './isModuleObject'\nimport { Module } from './Module'\n\nexport type ModuleTypeCheck<T extends Module = Module> = TypeCheck<T>\n\nexport class IsModuleFactory<T extends Module = Module> {\n create(expectedQueries?: string[], additionalChecks?: TypeCheck<AnyObject | EmptyObject>[]): ModuleTypeCheck<T> {\n return (obj: AnyNonPromise, config): obj is T => {\n const module = asModuleObject(obj)\n const result =\n isModuleObject(module, config) &&\n (expectedQueries?.reduce((prev, query) => prev && module.queries.includes(query), true) ?? true) &&\n //perform additional checks\n (additionalChecks?.reduce((prev, check) => prev && check(obj, config), true) ?? true)\n return result\n }\n }\n}\n","import { TypeCheck } from '@xylabs/object'\nimport { Schema } from '@xyo-network/payload-model'\n\nimport { ModuleStateQuerySchema } from '../Queries'\nimport { IsModuleFactory } from './IsModuleFactory'\nimport { isModuleObject } from './isModuleObject'\nimport { Module } from './Module'\n\nexport const requiredModuleQueries: Schema[] = [ModuleStateQuerySchema]\n\n//we do not use IsInstanceFactory here to prevent a cycle\nconst factory = new IsModuleFactory<Module>()\n\nexport const isModule: TypeCheck<Module> = factory.create(requiredModuleQueries, [isModuleObject])\n","import { AsObjectFactory } from '@xylabs/object'\n\nimport { isAttachableModuleInstance } from './isAttachableInstance'\n\nexport const asAttachableModuleInstance = AsObjectFactory.create(isAttachableModuleInstance)\n","import { IsObjectFactory, ObjectTypeShape, TypeCheck } from '@xylabs/object'\n\nimport { isModuleInstance } from '../isModuleInstance'\nimport { AttachableModuleInstance } from './AttachableInstance'\n\nexport const requiredAttachableModuleInstanceFunctions: ObjectTypeShape = {\n downResolver: 'object',\n upResolver: 'object',\n}\n\n//we do not use IsInstanceFactory here to prevent a cycle\nconst factory = new IsObjectFactory<AttachableModuleInstance>()\n\nexport const isAttachableModuleInstance: TypeCheck<AttachableModuleInstance> = factory.create(requiredAttachableModuleInstanceFunctions, [\n isModuleInstance,\n])\n","import { IsObjectFactory, TypeCheck } from '@xylabs/object'\n\nimport { ModuleEventData } from '../../EventsModels'\nimport { ModuleParams } from '../../ModuleParams'\nimport { ModuleInstance } from '../Instance'\nimport { ModuleResolverInstance } from '../ModuleResolver'\n\nexport interface AttachableModuleInstance<TParams extends ModuleParams = ModuleParams, TEventData extends ModuleEventData = ModuleEventData>\n extends ModuleInstance<TParams, TEventData> {\n /* The resolver is a 'down' resolver. It can resolve the module or any children (if it is a node for example), that are in the module*/\n readonly downResolver: ModuleResolverInstance\n\n /* The resolver is a 'up' resolver. It can resolve the parent or any children of the parent*/\n /* This is set by a NodeModule when attaching to the module */\n readonly upResolver: ModuleResolverInstance\n}\n\nexport type AttachableModuleInstanceTypeCheck<T extends AttachableModuleInstance = AttachableModuleInstance> = TypeCheck<T>\n\nexport class IsAttachableModuleInstanceFactory<T extends AttachableModuleInstance = AttachableModuleInstance> extends IsObjectFactory<T> {}\n","import { IsObjectFactory, toJsonString, TypeCheck } from '@xylabs/object'\n\nimport { ModuleEventData } from '../EventsModels'\nimport { Module, ModuleQueryFunctions } from '../module'\nimport { ModuleIdentifier } from '../ModuleIdentifier'\nimport { ModuleParams } from '../ModuleParams'\nimport { ObjectResolver } from './ObjectResolver'\n\nexport type ModulePipeLine = Lowercase<'one-to-one' | 'one-to-many' | 'many-to-one' | 'many-to-many'>\n\nexport type ModuleStatus = 'started' | 'stopped' | 'dead' | 'wrapped' | 'proxy'\n\nexport class DeadModuleError extends Error {\n constructor(\n public id: ModuleIdentifier,\n public error: Error | undefined,\n msg = 'Dead Module Error',\n ) {\n super(`${msg} [${id}]: ${error?.message ?? toJsonString(error)}`)\n\n // Set the prototype explicitly.\n Object.setPrototypeOf(this, DeadModuleError.prototype)\n }\n}\n\nexport interface ModuleInstance<TParams extends ModuleParams = ModuleParams, TEventData extends ModuleEventData = ModuleEventData>\n extends Module<TParams, TEventData>,\n ObjectResolver<ModuleInstance>,\n ModuleQueryFunctions {\n readonly pipeline?: ModulePipeLine\n\n //if the module has become non-functional, such as a broken bridge connection, this will be 'dead'\n readonly status: ModuleStatus\n}\n\nexport type InstanceTypeCheck<T extends ModuleInstance = ModuleInstance> = TypeCheck<T>\n\nexport class IsInstanceFactory<T extends ModuleInstance = ModuleInstance> extends IsObjectFactory<T> {}\n","import { Address } from '@xylabs/hex'\nimport { AnyObject, EmptyObject, TypeCheck } from '@xylabs/object'\n\nimport { ModuleName } from '../ModuleIdentifier'\n\nexport type Direction = 'up' | 'down' | 'all'\nexport type Visibility = 'public' | 'private' | 'all'\n\nexport interface ResolveStrategy {\n maxDepth?: number\n required?: boolean | 'warn' | 'log'\n retry?: number\n timeout?: number\n}\n\nexport interface ObjectFilterOptions<T extends EmptyObject = AnyObject> extends ResolveStrategy {\n direction?: Direction\n identity?: TypeCheck<T>\n visibility?: Visibility\n}\n\nexport interface AddressObjectFilter<T extends EmptyObject = AnyObject> extends ObjectFilterOptions<T> {\n address: Address[]\n}\n\nexport const isAddressObjectFilter = <T extends EmptyObject = AnyObject>(value: unknown): value is AddressObjectFilter<T> =>\n (value as AddressObjectFilter<T>).address !== undefined\n\nexport interface NameObjectFilter<T extends EmptyObject = AnyObject> extends ObjectFilterOptions<T> {\n name: ModuleName[]\n}\n\nexport const isNameObjectFilter = <T extends EmptyObject = AnyObject>(value: unknown): value is NameObjectFilter<T> =>\n (value as NameObjectFilter<T>).name !== undefined\n\nexport interface QueryObjectFilter<T extends EmptyObject = AnyObject> extends ObjectFilterOptions<T> {\n query: string[][]\n}\n\nexport const isQueryObjectFilter = <T extends EmptyObject = AnyObject>(value: unknown): value is QueryObjectFilter<T> =>\n (value as QueryObjectFilter<T>).query !== undefined\n\nexport type AnyObjectFilter<T extends EmptyObject = AnyObject> = Partial<AddressObjectFilter<T>> &\n Partial<NameObjectFilter<T>> &\n Partial<QueryObjectFilter<T>>\n\nexport type ObjectFilter<T extends EmptyObject> = ObjectFilterOptions<T> | AddressObjectFilter<T> | NameObjectFilter<T> | QueryObjectFilter<T>\n","import { ModuleInstance } from './Instance'\nimport {\n AddressObjectFilter,\n AnyObjectFilter,\n isAddressObjectFilter,\n isNameObjectFilter,\n isQueryObjectFilter,\n NameObjectFilter,\n ObjectFilter,\n ObjectFilterOptions,\n QueryObjectFilter,\n} from './ObjectFilter'\n\nexport interface ModuleFilterOptions<T extends ModuleInstance = ModuleInstance> extends ObjectFilterOptions<T> {}\n\nexport const isAddressModuleFilter = isAddressObjectFilter<ModuleInstance>\n\nexport const isNameModuleFilter = isNameObjectFilter<ModuleInstance>\n\nexport const isQueryModuleFilter = isQueryObjectFilter<ModuleInstance>\n\nexport type AnyModuleFilter<T extends ModuleInstance = ModuleInstance> = AnyObjectFilter<T>\n\nexport type AddressModuleFilter<T extends ModuleInstance = ModuleInstance> = AddressObjectFilter<T>\n\nexport type NameModuleFilter<T extends ModuleInstance = ModuleInstance> = NameObjectFilter<T>\n\nexport type QueryModuleFilter<T extends ModuleInstance = ModuleInstance> = QueryObjectFilter<T>\n\nexport type ModuleFilter<T extends ModuleInstance = ModuleInstance> = ObjectFilter<T>\n","import { AnyObject, EmptyObject } from '@xylabs/object'\nimport { Promisable } from '@xylabs/promise'\n\nimport { ModuleIdentifier } from '../ModuleIdentifier'\nimport { ObjectFilter, ObjectFilterOptions } from './ObjectFilter'\n\nexport const isObjectResolver = <T extends EmptyObject = AnyObject>(value?: unknown): value is ObjectResolver<T> => {\n // eslint-disable-next-line deprecation/deprecation\n return typeof (value as Partial<ObjectResolver<T>>).resolve === 'function'\n}\n\nexport enum ObjectResolverPriority {\n VeryLow = 0,\n Low = 1,\n Normal = 2,\n High = 3,\n VeryHigh = 4,\n}\n\nexport interface ObjectResolver<TResult extends EmptyObject> {\n priority: ObjectResolverPriority\n /** @deprecated do not pass undefined. If trying to get all, pass '*' */\n resolve<T extends TResult = TResult>(): Promisable<T | undefined>\n resolve<T extends TResult = TResult>(all: '*', options?: ObjectFilterOptions<T>): Promisable<T[]>\n resolve<T extends TResult = TResult>(id: ModuleIdentifier, options?: ObjectFilterOptions<T>): Promisable<T | undefined>\n resolve<T extends TResult = TResult>(filter: ObjectFilter<T>, options?: ObjectFilterOptions<T>): Promisable<T[]>\n /** @deprecated do not pass undefined. If trying to get all, pass '*' */\n resolve<T extends TResult = TResult>(filter?: ObjectFilter<T>, options?: ObjectFilterOptions<T>): Promisable<T[]>\n resolve<T extends TResult = TResult>(\n idOrFilter?: ObjectFilter<T> | ModuleIdentifier,\n options?: ObjectFilterOptions<T>,\n ): Promisable<T | T[] | undefined>\n}\n\nexport interface ObjectResolverInstance<TResult extends EmptyObject> extends ObjectResolver<TResult> {\n addResolver: (resolver: ObjectResolverInstance<TResult>) => this\n removeResolver: (resolver: ObjectResolverInstance<TResult>) => this\n}\n","import { Address } from '@xylabs/hex'\nimport { Promisable } from '@xylabs/promise'\n\nimport { ModuleIdentifier } from '../ModuleIdentifier'\nimport { ModuleInstance } from './Instance'\nimport { ObjectFilterOptions } from './ObjectFilter'\nimport { isObjectResolver, ObjectResolver } from './ObjectResolver'\n\nexport const isModuleResolver = isObjectResolver<ModuleInstance>\n\nexport interface ModuleResolver<TResult extends ModuleInstance = ModuleInstance> extends ObjectResolver<TResult> {}\n\nexport interface ModuleNameResolver {\n resolveIdentifier(id: ModuleIdentifier, options?: ObjectFilterOptions): Promisable<Address | undefined>\n}\n\nexport interface ModuleResolverInstance<TResult extends ModuleInstance = ModuleInstance> extends ModuleResolver<TResult>, ModuleNameResolver {\n addResolver: (resolver: ModuleResolverInstance<TResult>) => this\n removeResolver: (resolver: ModuleResolverInstance<TResult>) => this\n}\n","import { Module } from '../module'\n\n/**\n * Used to filter duplicates from an array of modules\n * @example: modulesArray.filter(duplicateModules)\n * @param value Current Module\n * @param index Current Module's index\n * @param array Module Array\n * @returns True if the Module's address is the first occurrence of\n * that address in the array, false otherwise\n */\nexport const duplicateModules = (value: Module, index: number, array: Module[]): value is Module => {\n return array.findIndex((v) => v.address === value.address) === index\n}\n","// Inspired by https://stackoverflow.com/a/49079549/2803259\n\nimport { every, isArray, isBoolean, isNull, isNumber, isPlainObject, isString, isUndefined, overSome } from '@xylabs/lodash'\n\nconst JSONPrimitiveChecks = [isUndefined, isNull, isBoolean, isNumber, isString]\nconst JSONComplexChecks = [isPlainObject, isArray]\n\nexport const serializable = (field: unknown, depth?: number): boolean | null => {\n let depthExceeded = false\n const decrementDepth = () => (depth ? depth-- : undefined)\n\n const recursiveSerializable = (field: unknown) => {\n if (depth !== undefined && depth < 1) {\n depthExceeded = true\n return false\n }\n\n // decrement during every recursion\n decrementDepth()\n\n const nestedSerializable = (field: unknown): boolean => overSome(JSONComplexChecks)(field) && every(field as object, recursiveSerializable)\n\n return overSome([...JSONPrimitiveChecks, nestedSerializable])(field)\n }\n\n const valid = recursiveSerializable(field)\n\n return depthExceeded ? null : valid\n}\n\nexport const serializableField = (field: unknown) => {\n return overSome([...JSONPrimitiveChecks, ...JSONComplexChecks])(field)\n}\n","import { Address, isAddress } from '@xylabs/hex'\n\nexport const DisallowedModuleIdentifierCharacters = {\n ' ': true,\n '!': true,\n '\"': true,\n '#': true,\n $: true,\n '%': true,\n '&': true,\n \"'\": true,\n '(': true,\n ')': true,\n '*': true,\n ',': true,\n '.': true,\n '/': true,\n ':': true,\n ';': true,\n '<': true,\n '=': true,\n '>': true,\n '?': true,\n '@': true,\n '[': true,\n ']': true,\n '^': true,\n _: true,\n '{': true,\n '|': true,\n '}': true,\n '~': true,\n}\nexport type ReservedModuleIdentifierCharacter = keyof typeof DisallowedModuleIdentifierCharacters\nexport const ReservedModuleIdentifierCharacters = new Set<ReservedModuleIdentifierCharacter>(\n Object.keys(DisallowedModuleIdentifierCharacters) as ReservedModuleIdentifierCharacter[],\n)\n\n//using Exclude to make this type not allowed to take a naked string\nexport type ModuleName = Exclude<string, 'reserved-module-name-56487634'>\n\nexport type ModuleIdentifier =\n | ColonPair<ModuleIdentifierPart>\n | ColonPair<ColonPair<ModuleIdentifierPart>>\n | ColonPair<ColonPair<ColonPair<ModuleIdentifierPart>>>\n | ColonPair<ColonPair<ColonPair<ColonPair<ModuleIdentifierPart>>>>\n | ColonPair<ColonPair<ColonPair<ColonPair<ColonPair<ModuleIdentifierPart>>>>>\n | ColonPair<ColonPair<ColonPair<ColonPair<ColonPair<ColonPair<ModuleIdentifierPart>>>>>>\n | ColonPair<ColonPair<ColonPair<ColonPair<ColonPair<ColonPair<ColonPair<ModuleIdentifierPart>>>>>>>\n\nexport type ColonPair<T extends string> = `${T}:${T}` | T\n\nexport type ModuleIdentifierPart = Exclude<Address | ModuleName, '*'>\n\nexport const isModuleName = (value: unknown): value is ModuleName => {\n return typeof value === 'string' && !isAddress(value) && !includesReservedModuleIdentifierCharacter(value)\n}\n\nexport const includesReservedModuleIdentifierCharacter = (value: unknown): boolean => {\n return typeof value === 'string' && [...value].some((char) => ReservedModuleIdentifierCharacters.has(char as ReservedModuleIdentifierCharacter))\n}\n\nexport const isModuleIdentifierPart = (value: unknown): value is ModuleIdentifierPart => {\n return isModuleName(value) || isAddress(value)\n}\n","import { Address } from '@xylabs/hex'\nimport { AddressSchema } from '@xyo-network/address-payload-plugin'\nimport { Payload } from '@xyo-network/payload-model'\n\nexport const AddressPreviousHashSchema = `${AddressSchema}.hash.previous`\nexport type AddressPreviousHashSchema = typeof AddressPreviousHashSchema\n\nexport type AddressPreviousHashPayload = Payload<{\n address: Address\n previousHash?: string\n schema: AddressPreviousHashSchema\n}>\n","import { Payload } from '@xyo-network/payload-model'\n\nimport { ModuleDescription } from '../ModuleDescription'\n\nexport const ModuleDescriptionSchema = 'network.xyo.module.description'\nexport type ModuleDescriptionSchema = typeof ModuleDescriptionSchema\n\nexport type ModuleDescriptionPayload = Payload<ModuleDescription, ModuleDescriptionSchema>\n","import { isPayloadOfSchemaType, Payload, WithMeta } from '@xyo-network/payload-model'\n\nexport interface StateDictionary {\n [key: string]: string | number | undefined\n}\nexport interface State<T extends StateDictionary = StateDictionary> {\n state: T\n}\n\nexport const ModuleStateSchema = 'network.xyo.module.state' as const\nexport type ModuleStateSchema = typeof ModuleStateSchema\n\nexport type ModuleState<T extends StateDictionary = StateDictionary> = Payload<State<T>, ModuleStateSchema>\n\nexport const isModuleState = <T extends StateDictionary = StateDictionary>(payload?: Payload | null): payload is ModuleState<T> => {\n return isPayloadOfSchemaType<ModuleState<T>>(ModuleStateSchema)(payload)\n}\n\nexport const isModuleStateWithMeta = <T extends StateDictionary = StateDictionary>(payload?: Payload | null): payload is WithMeta<ModuleState<T>> => {\n return isPayloadOfSchemaType<WithMeta<ModuleState<T>>>(ModuleStateSchema)(payload)\n}\n","/* eslint-disable max-statements */\n/* eslint-disable complexity */\nimport { assertEx } from '@xylabs/assert'\nimport { Address } from '@xylabs/hex'\nimport { IdLogger, Logger } from '@xylabs/logger'\nimport { toJsonString } from '@xylabs/object'\n\nimport { asModuleInstance, ModuleFilter, ModuleFilterOptions, ModuleInstance, ModuleResolver } from './instance'\nimport { duplicateModules } from './lib'\nimport { ModuleIdentifier } from './ModuleIdentifier'\n\n/*\n\nResolution rules\n\n1. Resolution is always done from the perspective of the module whose resolve function was called.\n\n2. Requesting '*' will return all the modules that the resolver can see.\n\n3. Requesting a simple ModuleName (string w/o ':' separator) will return an immediate child that has that name.\n\n4. Requesting a complex ModuleName (string w/ ':' separator) will resolve the first part and then recursively resolve\n the remaining name by calling the first part's resolved module's resolve with the remainder of the name.\n\n5. Requesting an Address (string) will return the module with that address, regardless of how distant it is from the module. [limited by maxDepth]\n\n6. Requesting a ModuleFilter will first request all the modules '*' and then filter them based on the filter settings. [Do we need this mode?]\n\n7. When a string is passed as the ModuleIdentifier, do the following:\n Check if id is complex (contains a ':')\n a) If it is complex, go to #4 above\n b) Call isAddress in the id to see if it is a valid address.\n i) If it is a valid address, go to #5 above\n ii) If it is not a valid address, go to # 3 above\n\n Note 1: If someone were to name a module with a valid address, that name will not be resolvable.\n Note 2: If someone were to name a module with a string containing a ':', that name will not be resolvable.\n\n8. Modules have two resolvers, up and down.\n a) Up Traversal\n i) Every module's upResolver also can call it's parent's upResolver\n ii) An upResolver also can see the parent's children's downResolvers\n iii) This means that when traversing upResolvers, you can traverse all the way up.\n iv) At any point of the up traversal, it can start traversing down to any immediate child, public or private.\n b) Down Traversal\n i) A down traversal is limited to the public children of the module. [The same as scope as calling the 'resolve' function]\n\n*/\n\nexport interface ResolveHelperConfig {\n address: Address\n dead?: boolean\n downResolver?: ModuleResolver\n logger?: Logger\n module: ModuleInstance\n upResolver?: ModuleResolver\n}\n\nexport class ResolveHelper {\n static defaultLogger?: Logger\n static async resolve<T extends ModuleInstance = ModuleInstance>(\n config: ResolveHelperConfig,\n all: '*',\n options?: ModuleFilterOptions<T>,\n ): Promise<T[]>\n static async resolve<T extends ModuleInstance = ModuleInstance>(\n config: ResolveHelperConfig,\n filter: ModuleFilter,\n options?: ModuleFilterOptions<T>,\n ): Promise<T[]>\n static async resolve<T extends ModuleInstance = ModuleInstance>(\n config: ResolveHelperConfig,\n id: ModuleIdentifier,\n options?: ModuleFilterOptions<T>,\n ): Promise<T | undefined>\n static async resolve<T extends ModuleInstance = ModuleInstance>(\n config: ResolveHelperConfig,\n idOrFilter: ModuleFilter<T> | ModuleIdentifier = '*',\n { visibility, maxDepth = 3, required = 'log', ...options }: ModuleFilterOptions<T> = {},\n ): Promise<T | T[] | undefined> {\n const { module, logger = this.defaultLogger, dead = false, upResolver, downResolver } = config\n const log = logger ? new IdLogger(logger, () => `ResolveHelper [${module.id}][${idOrFilter}][${visibility}]`) : undefined\n\n const downLocalOptions: ModuleFilterOptions<T> = { ...options, direction: 'down', maxDepth, required: false, visibility }\n const upLocalOptions: ModuleFilterOptions<T> = { ...downLocalOptions, direction: 'up' }\n\n const childOptions: ModuleFilterOptions<T> = { ...options, maxDepth: maxDepth - 1, required: false, visibility }\n\n const direction = options?.direction ?? 'all'\n const up = direction === 'up' || direction === 'all'\n const down = direction === 'down' || direction === 'all'\n let result: T | T[] | undefined\n log?.debug('start', idOrFilter, maxDepth)\n if (idOrFilter === '*') {\n if (dead) {\n log?.warn('failed [dead]', idOrFilter)\n return []\n }\n const modules = [\n ...(down ? await (downResolver as ModuleResolver).resolve<T>('*', downLocalOptions) : []),\n ...(up ? await (upResolver as ModuleResolver).resolve<T>('*', upLocalOptions) : []),\n ]\n .filter(duplicateModules)\n .filter((module) => module.address !== config.address)\n\n if (modules.length > 0) {\n log?.log('modules [count]', modules.length)\n log?.debug('modules', toJsonString(modules, 4))\n }\n\n if (maxDepth === 0) {\n return modules\n }\n const childModules = (await Promise.all(modules.map(async (module) => await module.resolve<T>('*', childOptions))))\n .flat()\n .filter(duplicateModules)\n return [...modules, ...childModules].filter(duplicateModules)\n } else {\n switch (typeof idOrFilter) {\n case 'string': {\n if (dead) {\n return undefined\n }\n result =\n (down && downResolver ? await this.resolveModuleIdentifier<T>(downResolver, idOrFilter) : undefined) ??\n (up && upResolver ? await this.resolveModuleIdentifier<T>(upResolver, idOrFilter) : undefined)\n break\n }\n default: {\n if (dead) {\n return []\n }\n const filter: ModuleFilter<T> | undefined = idOrFilter\n result = [\n ...(down ? await (downResolver as ModuleResolver).resolve<T>(filter, downLocalOptions) : []),\n ...(up ? await (upResolver as ModuleResolver).resolve<T>(filter, upLocalOptions) : []),\n ].filter(duplicateModules)\n break\n }\n }\n }\n this.validateRequiredResolve(required, result, idOrFilter, logger)\n return result\n }\n\n //resolves a complex module path to addresses\n static async resolveModuleIdentifier<T extends ModuleInstance = ModuleInstance>(\n resolver: ModuleResolver,\n path: ModuleIdentifier,\n ): Promise<T | undefined> {\n const parts = path.split(':')\n const first = parts.shift()\n const firstModule = asModuleInstance(\n assertEx(await resolver.resolve(first, { maxDepth: 1 }), () => `Failed to resolve [${first}]`),\n () => `Resolved invalid module instance [${first}]`,\n ) as T\n if (firstModule) {\n return parts.length > 0 ? await this.resolveModuleIdentifier<T>(firstModule, parts.join(':')) : firstModule\n }\n }\n\n //translates a complex module path to addresses\n static async traceModuleIdentifier(resolver: ModuleResolver, path: ModuleIdentifier): Promise<Address[]> {\n const parts = path.split(':')\n const first = parts.shift()\n const firstModule = asModuleInstance(\n assertEx(await resolver.resolve(first, { maxDepth: 1 }), () => `Failed to resolve [${first}]`),\n () => `Resolved invalid module instance [${first}]`,\n )\n if (firstModule) {\n return parts.length > 0 ? [firstModule.address, ...(await this.traceModuleIdentifier(firstModule, parts.join(':')))] : [firstModule.address]\n }\n return []\n }\n\n static validateRequiredResolve(\n required: boolean | 'warn' | 'log',\n result: ModuleInstance[] | ModuleInstance | undefined,\n idOrFilter: ModuleIdentifier | ModuleFilter,\n logger = this.defaultLogger,\n ) {\n const log = logger ? new IdLogger(logger, () => `validateRequiredResolve [${idOrFilter}][${result}]`) : undefined\n if (required && (result === undefined || (Array.isArray(result) && result.length > 0))) {\n switch (required) {\n case 'warn': {\n log?.warn('resolve failed', idOrFilter)\n break\n }\n case 'log': {\n log?.log('resolve failed', idOrFilter)\n break\n }\n default: {\n throw new Error(`resolve failed [${idOrFilter}]`)\n }\n }\n }\n }\n}\n","import { TypeCheck } from '@xylabs/object'\n\nimport { isModuleInstance } from './instance'\nimport { isModule } from './module'\n\nexport const WithFactory = {\n create: <T extends object>(typeCheck: TypeCheck<T>) => {\n return <R>(\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n module: any,\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n closure: (module: T) => R,\n ): R | undefined => {\n return typeCheck(module) ? closure(module) : undefined\n }\n },\n}\n\nexport const withModule = WithFactory.create(isModule)\nexport const withModuleInstance = WithFactory.create(isModuleInstance)\n"],"mappings":"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","names":["ModuleConfigSchema","creatableModule","constructor","toCreatableModuleRegistry","dict","Object","entries","reduce","registry","schema","factory","Array","isArray","assignCreatableModuleRegistry","target","sources","map","source","factories","existingFactories","hasLabels","factory","labels","undefined","ModuleFactory","configSchemas","creatableModule","defaultLogger","defaultParams","labels","constructor","params","Object","assign","configSchema","withParams","_getRootFunction","funcName","anyThis","__proto__","_noOverride","functionName","thisFunc","rootFunc","assertEx","create","factory","schema","mergedParams","merge","config","_params","Error","import_assert","hasAllLabels","source","required","Object","entries","every","key","value","hasOwnProperty","ModuleFactoryLocator","constructor","_registry","registry","locate","schema","labels","assertEx","tryLocate","configString","labelsString","JSON","stringify","register","mod","configSchemas","map","existingFactories","factory","create","bind","Object","assign","registerMany","additional","entries","factories","filter","hasLabels","find","hasAllLabels","import_object","import_object","import_object","ModuleManifestQuerySchema","ModuleAddressQuerySchema","ModuleStateQuerySchema","ModuleSubscribeQuerySchema","import_object","requiredModuleShape","address","queries","query","factory","IsObjectFactory","isModuleObject","create","asModuleObject","AsObjectFactory","create","isModuleObject","IsModuleFactory","create","expectedQueries","additionalChecks","obj","config","module","asModuleObject","result","isModuleObject","reduce","prev","query","queries","includes","check","requiredModuleQueries","ModuleStateQuerySchema","factory","IsModuleFactory","isModule","create","isModuleObject","asModule","AsObjectFactory","create","isModule","requiredModuleInstanceFunctions","manifest","state","factory","IsObjectFactory","isModuleInstance","create","isModule","asModuleInstance","AsObjectFactory","create","isModuleInstance","import_object","import_object","requiredAttachableModuleInstanceFunctions","downResolver","upResolver","factory","IsObjectFactory","isAttachableModuleInstance","create","isModuleInstance","asAttachableModuleInstance","AsObjectFactory","create","isAttachableModuleInstance","import_object","IsAttachableModuleInstanceFactory","IsObjectFactory","import_object","DeadModuleError","Error","constructor","id","error","msg","message","toJsonString","Object","setPrototypeOf","prototype","IsInstanceFactory","IsObjectFactory","isAddressObjectFilter","value","address","undefined","isNameObjectFilter","name","isQueryObjectFilter","query","isAddressModuleFilter","isAddressObjectFilter","isNameModuleFilter","isNameObjectFilter","isQueryModuleFilter","isQueryObjectFilter","isObjectResolver","value","resolve","ObjectResolverPriority","isModuleResolver","isObjectResolver","duplicateModules","value","index","array","findIndex","v","address","import_lodash","JSONPrimitiveChecks","isUndefined","isNull","isBoolean","isNumber","isString","JSONComplexChecks","isPlainObject","isArray","serializable","field","depth","depthExceeded","decrementDepth","undefined","recursiveSerializable","nestedSerializable","overSome","every","valid","serializableField","DisallowedModuleIdentifierCharacters","$","_","ReservedModuleIdentifierCharacters","Set","Object","keys","isModuleName","value","isAddress","includesReservedModuleIdentifierCharacter","some","char","has","isModuleIdentifierPart","AddressPreviousHashSchema","AddressSchema","ModuleDescriptionSchema","ModuleStateSchema","isModuleState","payload","isPayloadOfSchemaType","isModuleStateWithMeta","import_assert","import_object","ResolveHelper","defaultLogger","resolve","config","idOrFilter","visibility","maxDepth","required","options","module","logger","dead","upResolver","downResolver","log","IdLogger","id","undefined","downLocalOptions","direction","upLocalOptions","childOptions","up","down","result","debug","warn","modules","filter","duplicateModules","address","length","toJsonString","childModules","Promise","all","map","flat","resolveModuleIdentifier","validateRequiredResolve","resolver","path","parts","split","first","shift","firstModule","asModuleInstance","assertEx","join","traceModuleIdentifier","Array","isArray","Error","WithFactory","create","typeCheck","module","closure","undefined","withModule","isModule","withModuleInstance","isModuleInstance"]}
1
+ {"version":3,"sources":["../../src/index.ts","../../src/Config/Config.ts","../../src/CreatableModule/CreatableModule.ts","../../src/CreatableModule/CreatableModuleRegistry.ts","../../src/CreatableModule/LabeledCreatableModuleFactory.ts","../../src/CreatableModule/ModuleFactory.ts","../../src/CreatableModule/ModuleFactoryLocator.ts","../../src/Labels/Labels.ts","../../src/instance/asModuleInstance.ts","../../src/instance/isModuleInstance.ts","../../src/module/asModule.ts","../../src/Queries/Manifest.ts","../../src/Queries/ModuleAddress/Query.ts","../../src/Queries/State.ts","../../src/Queries/Subscribe.ts","../../src/module/asModuleObject.ts","../../src/module/isModuleObject.ts","../../src/module/IsModuleFactory.ts","../../src/module/isModule.ts","../../src/instance/attachable/asAttachableInstance.ts","../../src/instance/attachable/isAttachableInstance.ts","../../src/instance/attachable/AttachableInstance.ts","../../src/instance/Instance.ts","../../src/instance/ObjectFilter.ts","../../src/instance/ModuleFilter.ts","../../src/instance/ObjectResolver.ts","../../src/instance/ModuleResolver.ts","../../src/lib/duplicateModules.ts","../../src/lib/serializable.ts","../../src/ModuleIdentifier.ts","../../src/Payload/AddressPreviousHash.ts","../../src/Payload/Description.ts","../../src/Payload/ModuleState.ts","../../src/ResolveHelper.ts","../../src/withModule.ts"],"sourcesContent":["export * from './cache'\nexport * from './Config'\nexport * from './CreatableModule'\nexport * from './EventsModels'\nexport * from './instance'\nexport * from './Labels'\nexport * from './lib'\nexport * from './module'\nexport * from './ModuleDescription'\nexport * from './ModuleIdentifier'\nexport * from './ModuleIdentifierTransformer'\nexport * from './ModuleParams'\nexport * from './ModuleQueryHandlerResult'\nexport * from './ModuleQueryResult'\nexport * from './Payload'\nexport * from './Queries'\nexport * from './ResolveHelper'\nexport * from './withModule'\n","import { EmptyObject, WithAdditional } from '@xylabs/object'\nimport { Payload, Schema } from '@xyo-network/payload-model'\n\nimport { ArchivingModuleConfig } from './Archiving'\nimport { ModuleConfigFields } from './Fields'\n\nexport type ModuleConfigSchema = 'network.xyo.module.config'\nexport const ModuleConfigSchema: ModuleConfigSchema = 'network.xyo.module.config'\n\nexport type ModuleConfig<TConfig extends EmptyObject | Payload | void = void, TSchema extends Schema | void = void> = Payload<\n WithAdditional<ArchivingModuleConfig & ModuleConfigFields, TConfig>,\n TSchema extends Schema ? TSchema\n : TConfig extends Payload ? TConfig['schema']\n : ModuleConfigSchema\n>\n\nexport type AnyConfigSchema<TConfig extends Omit<ModuleConfig, 'schema'> & { schema: string } = Omit<ModuleConfig, 'schema'> & { schema: string }> =\n ModuleConfig<TConfig, string>\n\nexport type OptionalConfigSchema<TConfig extends AnyConfigSchema<ModuleConfig> = AnyConfigSchema<ModuleConfig>> = Omit<TConfig, 'schema'> & {\n schema?: TConfig['schema']\n}\n\nexport type AnyModuleConfig = AnyConfigSchema<ModuleConfig>\n","import { Logger } from '@xylabs/logger'\nimport { AccountInstance } from '@xyo-network/account-model'\n\nimport { AttachableModuleInstance } from '../instance'\n\nexport type CreatableModuleFactory<T extends AttachableModuleInstance = AttachableModuleInstance> = Omit<\n Omit<CreatableModule<T>, 'new'>,\n 'create'\n> & {\n create<T extends AttachableModuleInstance>(this: CreatableModuleFactory<T>, params?: T['params']): Promise<T>\n}\n\nexport interface CreatableModule<T extends AttachableModuleInstance = AttachableModuleInstance> {\n configSchema: string\n configSchemas: string[]\n defaultLogger?: Logger\n new (privateConstructorKey: string, params: T['params'], account: AccountInstance): T\n _noOverride(functionName: string): void\n create<T extends AttachableModuleInstance>(this: CreatableModule<T>, params?: T['params']): Promise<T>\n factory<T extends AttachableModuleInstance>(this: CreatableModule<T>, params?: T['params']): CreatableModuleFactory<T>\n}\n\n/**\n * Class annotation to be used to decorate Modules which support\n * an asynchronous creation pattern\n * @returns The decorated Module requiring it implement the members\n * of the CreatableModule as statics properties/methods\n */\nexport function creatableModule<TModule extends AttachableModuleInstance = AttachableModuleInstance>() {\n return <U extends CreatableModule<TModule>>(constructor: U) => {\n constructor\n }\n}\n","import { CreatableModuleFactory } from './CreatableModule'\nimport { CreatableModuleDictionary } from './CreatableModuleDictionary'\nimport { LabeledCreatableModuleFactory } from './LabeledCreatableModuleFactory'\n\nexport interface CreatableModuleRegistry {\n [key: string]: (CreatableModuleFactory | LabeledCreatableModuleFactory)[] | undefined\n}\n\nexport const toCreatableModuleRegistry = (dict: CreatableModuleDictionary | CreatableModuleRegistry): CreatableModuleRegistry => {\n // eslint-disable-next-line unicorn/no-array-reduce\n return Object.entries(dict).reduce((registry, [schema, factory]) => {\n registry[schema] = Array.isArray(factory) ? factory : [factory]\n return registry\n }, {} as CreatableModuleRegistry)\n}\n\nexport const assignCreatableModuleRegistry = (\n target: CreatableModuleRegistry = {},\n ...sources: CreatableModuleRegistry[]\n): CreatableModuleRegistry => {\n sources.map((source) =>\n Object.entries(source).map(([schema, factories]) => {\n if (factories) {\n const existingFactories = target[schema]\n target[schema] = existingFactories ? (target[schema] = [...existingFactories, ...factories]) : factories\n }\n }),\n )\n return target\n}\n","import { AttachableModuleInstance } from '../instance'\nimport { WithOptionalLabels } from '../Labels'\nimport { CreatableModuleFactory } from './CreatableModule'\n\nexport type LabeledCreatableModuleFactory<T extends AttachableModuleInstance = AttachableModuleInstance> = CreatableModuleFactory<T> &\n WithOptionalLabels\n\nexport const hasLabels = (factory: CreatableModuleFactory | LabeledCreatableModuleFactory): factory is LabeledCreatableModuleFactory => {\n return (factory as LabeledCreatableModuleFactory).labels !== undefined\n}\n","import { assertEx } from '@xylabs/assert'\nimport { merge } from '@xylabs/lodash'\nimport { Logger } from '@xylabs/logger'\n\nimport { AttachableModuleInstance } from '../instance'\nimport { Labels, WithOptionalLabels } from '../Labels'\nimport { CreatableModule, CreatableModuleFactory } from './CreatableModule'\n\nexport class ModuleFactory<TModule extends AttachableModuleInstance> implements CreatableModuleFactory<TModule> {\n configSchemas: CreatableModuleFactory<TModule>['configSchemas']\n\n creatableModule: CreatableModule<TModule>\n\n defaultLogger?: Logger | undefined\n\n defaultParams?: Omit<TModule['params'], 'config'> & { config?: Partial<TModule['params']['config']> }\n\n labels?: Labels\n\n constructor(\n creatableModule: CreatableModule<TModule>,\n params?: Omit<TModule['params'], 'config'> & { config?: Partial<TModule['params']['config']> },\n labels: Labels = {},\n ) {\n this.creatableModule = creatableModule\n this.defaultParams = params\n this.configSchemas = creatableModule.configSchemas\n this.labels = Object.assign({}, (creatableModule as WithOptionalLabels).labels ?? {}, labels ?? {})\n }\n\n get configSchema(): string {\n return this.configSchemas[0]\n }\n\n static withParams<T extends AttachableModuleInstance>(\n creatableModule: CreatableModule<T>,\n params?: Omit<T['params'], 'config'> & { config?: T['params']['config'] },\n labels: Labels = {},\n ) {\n return new ModuleFactory(creatableModule, params, labels)\n }\n\n _getRootFunction(funcName: string) {\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n let anyThis = this as any\n while (anyThis.__proto__[funcName]) {\n anyThis = anyThis.__proto__\n }\n return anyThis[funcName]\n }\n\n _noOverride(functionName: string) {\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n const thisFunc = (this as any)[functionName]\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n const rootFunc = this._getRootFunction(functionName)\n assertEx(thisFunc === rootFunc, () => `Override not allowed for [${functionName}] - override ${functionName}Handler instead`)\n }\n\n create<T extends AttachableModuleInstance>(this: CreatableModuleFactory<T>, params?: TModule['params'] | undefined): Promise<T> {\n const factory = this as ModuleFactory<T>\n const schema = factory.creatableModule.configSchema\n const mergedParams: TModule['params'] = merge({}, factory.defaultParams, params, {\n config: merge({}, factory.defaultParams?.config, params?.config, { schema }),\n })\n return factory.creatableModule.create<T>(mergedParams)\n }\n\n factory<T extends AttachableModuleInstance>(this: CreatableModule<T>, _params?: T['params'] | undefined): CreatableModuleFactory<T> {\n throw new Error('Method not implemented.')\n }\n}\n","import { assertEx } from '@xylabs/assert'\n\nimport { AttachableModuleInstance } from '../instance'\nimport { hasAllLabels, Labels } from '../Labels'\nimport { CreatableModuleFactory } from './CreatableModule'\nimport { CreatableModuleRegistry } from './CreatableModuleRegistry'\nimport { hasLabels, LabeledCreatableModuleFactory } from './LabeledCreatableModuleFactory'\n\n/**\n * A class which encapsulates the Service Locator Pattern for Module Factories\n */\nexport class ModuleFactoryLocator {\n constructor(protected readonly _registry: CreatableModuleRegistry = {}) {}\n\n /**\n * The current registry for the module factory\n */\n get registry(): Readonly<CreatableModuleRegistry> {\n return this._registry\n }\n\n /**\n * Locates a module factory that matches the supplied schema and labels\n * @param schema The config schema for the module\n * @param labels The labels for the module factory\n * @returns A module factory that matches the supplied schema and labels or throws if one is not found\n */\n locate(schema: string, labels?: Labels): CreatableModuleFactory | LabeledCreatableModuleFactory {\n return assertEx(this.tryLocate(schema, labels), () => {\n const configString = `config schema [${schema}]`\n const labelsString = labels ? ` & labels [${JSON.stringify(labels)}]` : ''\n return `No module factory for the supplied ${configString}${labelsString} registered`\n })\n }\n\n /**\n * Registers a single module factory (with optional tags) with the locator\n * @param additional Additional module factories to register\n */\n register<TModule extends AttachableModuleInstance>(mod: CreatableModuleFactory<TModule>, labels?: Labels): this {\n mod.configSchemas.map((schema) => {\n const existingFactories = this._registry[schema]\n const factory: LabeledCreatableModuleFactory<TModule> = {\n // Destructure instance properties\n ...mod,\n // Copy static methods\n create: mod.create.bind(mod) as LabeledCreatableModuleFactory<TModule>['create'],\n // Merge module & supplied labels\n labels: Object.assign({}, (mod as LabeledCreatableModuleFactory).labels ?? {}, labels ?? {}),\n }\n this._registry[schema] = existingFactories ? [...existingFactories, factory] : [factory]\n })\n return this\n }\n\n /**\n * Registers multiple module factories with the locator\n * @param additional Additional module factories to register\n */\n registerMany(additional: CreatableModuleRegistry): this {\n Object.entries(additional).map(([schema, factories]) => {\n if (factories) {\n const existingFactories = this._registry[schema]\n this._registry[schema] = existingFactories ? [...existingFactories, ...factories] : factories\n }\n })\n return this\n }\n\n /**\n * Tries to locate a module factory that matches the supplied schema and labels\n * @param schema The config schema for the module\n * @param labels The labels for the module factory\n * @returns A module factory that matches the supplied schema and labels or undefined\n */\n tryLocate(schema: string, labels?: Labels): CreatableModuleFactory | LabeledCreatableModuleFactory | undefined {\n // If labels were provided\n return labels ?\n // Find the first factory that has labels and has all the labels provided\n this._registry[schema]?.filter(hasLabels).find((factory) => hasAllLabels(factory?.labels, labels))\n : // Otherwise, return the first factory\n this._registry[schema]?.[0]\n }\n}\n","/**\n * Object used to represent labels identifying a resource.\n */\nexport interface Labels {\n [key: string]: string | undefined\n}\n\n/**\n * Interface for objects that have labels.\n */\nexport interface WithLabels<T extends Labels = Labels> {\n labels: T\n}\n\n/**\n * Interface for objects that have labels.\n */\nexport interface WithOptionalLabels<T extends Labels = Labels> {\n labels?: T\n}\n\n/**\n * Returns true if the source object has all the labels from the required set\n * @param source Source object to check against\n * @param required Set of labels to check for in source\n * @returns True of the source object has all the labels from the required set\n */\nexport const hasAllLabels = (source?: Labels, required?: Labels): boolean => {\n if (!required) return true\n return Object.entries(required).every(([key, value]) => {\n // eslint-disable-next-line no-prototype-builtins\n return source?.hasOwnProperty(key as keyof typeof source) && source?.[key as keyof typeof source] === value\n })\n}\n","import { AsObjectFactory } from '@xylabs/object'\n\nimport { isModuleInstance } from './isModuleInstance'\n\nexport const asModuleInstance = AsObjectFactory.create(isModuleInstance)\n","import { IsObjectFactory, ObjectTypeShape, TypeCheck } from '@xylabs/object'\n\nimport { isModule } from '../module'\nimport { ModuleInstance } from './Instance'\n\nexport const requiredModuleInstanceFunctions: ObjectTypeShape = {\n manifest: 'function',\n state: 'function',\n}\n\n//we do not use IsInstanceFactory here to prevent a cycle\nconst factory = new IsObjectFactory<ModuleInstance>()\n\nexport const isModuleInstance: TypeCheck<ModuleInstance> = factory.create(requiredModuleInstanceFunctions, [isModule])\n","import { AsObjectFactory } from '@xylabs/object'\n\nimport { isModule } from './isModule'\n\nexport const asModule = AsObjectFactory.create(isModule)\n","import { Query } from '@xyo-network/payload-model'\n\nexport type ModuleManifestQuerySchema = 'network.xyo.query.module.manifest'\nexport const ModuleManifestQuerySchema: ModuleManifestQuerySchema = 'network.xyo.query.module.manifest'\n\nexport type ModuleManifestQuery = Query<{\n maxDepth?: number\n schema: ModuleManifestQuerySchema\n}>\n","import { Query } from '@xyo-network/payload-model'\n\nexport type ModuleAddressQuerySchema = 'network.xyo.query.module.address'\nexport const ModuleAddressQuerySchema: ModuleAddressQuerySchema = 'network.xyo.query.module.address'\n\nexport type ModuleAddressQuery = Query<{\n schema: ModuleAddressQuerySchema\n}>\n","import { Query } from '@xyo-network/payload-model'\n\nexport const ModuleStateQuerySchema = 'network.xyo.query.module.state'\nexport type ModuleStateQuerySchema = typeof ModuleStateQuerySchema\n\nexport type ModuleStateQuery = Query<void, ModuleStateQuerySchema>\n","import { Address } from '@xylabs/hex'\nimport { Query } from '@xyo-network/payload-model'\n\nexport type ModuleSubscribeQuerySchema = 'network.xyo.query.module.subscribe'\nexport const ModuleSubscribeQuerySchema: ModuleSubscribeQuerySchema = 'network.xyo.query.module.subscribe'\n\nexport interface ModuleSubscribeFilter {\n /** @field if specified, at least one of the schemas must be present in the boundwtness to generate a notification */\n schema?: string[]\n}\n\n//requests notification when a boundwitness is added to the modules chain that meets the filter criteria\nexport type ModuleSubscribeQuery = Query<{\n /** @field The address that will receive notifications */\n address: Address\n /** @field A subscribe with a null for filter is an unsubscribe */\n filter?: ModuleSubscribeFilter | null\n /** @field The maximum events queued per send [may increase frequency] */\n maxQueue?: number\n schema: ModuleSubscribeQuerySchema\n}>\n","import { AsObjectFactory } from '@xylabs/object'\n\nimport { isModuleObject } from './isModuleObject'\n\nexport const asModuleObject = AsObjectFactory.create(isModuleObject)\n","import { IsObjectFactory, ObjectTypeShape } from '@xylabs/object'\n\nimport { Module } from './Module'\n\nexport const requiredModuleShape: ObjectTypeShape = {\n address: 'string',\n queries: 'array',\n query: 'function',\n}\n\nconst factory = new IsObjectFactory<Module>()\n\nexport const isModuleObject = factory.create(requiredModuleShape)\n","import { AnyObject, EmptyObject, TypeCheck } from '@xylabs/object'\nimport { AnyNonPromise } from '@xylabs/promise'\n\nimport { asModuleObject } from './asModuleObject'\nimport { isModuleObject } from './isModuleObject'\nimport { Module } from './Module'\n\nexport type ModuleTypeCheck<T extends Module = Module> = TypeCheck<T>\n\nexport class IsModuleFactory<T extends Module = Module> {\n create(expectedQueries?: string[], additionalChecks?: TypeCheck<AnyObject | EmptyObject>[]): ModuleTypeCheck<T> {\n return (obj: AnyNonPromise, config): obj is T => {\n const module = asModuleObject(obj)\n const result =\n isModuleObject(module, config) &&\n (expectedQueries?.reduce((prev, query) => prev && module.queries.includes(query), true) ?? true) &&\n //perform additional checks\n (additionalChecks?.reduce((prev, check) => prev && check(obj, config), true) ?? true)\n return result\n }\n }\n}\n","import { TypeCheck } from '@xylabs/object'\nimport { Schema } from '@xyo-network/payload-model'\n\nimport { ModuleStateQuerySchema } from '../Queries'\nimport { IsModuleFactory } from './IsModuleFactory'\nimport { isModuleObject } from './isModuleObject'\nimport { Module } from './Module'\n\nexport const requiredModuleQueries: Schema[] = [ModuleStateQuerySchema]\n\n//we do not use IsInstanceFactory here to prevent a cycle\nconst factory = new IsModuleFactory<Module>()\n\nexport const isModule: TypeCheck<Module> = factory.create(requiredModuleQueries, [isModuleObject])\n","import { AsObjectFactory } from '@xylabs/object'\n\nimport { isAttachableModuleInstance } from './isAttachableInstance'\n\nexport const asAttachableModuleInstance = AsObjectFactory.create(isAttachableModuleInstance)\n","import { IsObjectFactory, ObjectTypeShape, TypeCheck } from '@xylabs/object'\n\nimport { isModuleInstance } from '../isModuleInstance'\nimport { AttachableModuleInstance } from './AttachableInstance'\n\nexport const requiredAttachableModuleInstanceFunctions: ObjectTypeShape = {\n downResolver: 'object',\n upResolver: 'object',\n}\n\n//we do not use IsInstanceFactory here to prevent a cycle\nconst factory = new IsObjectFactory<AttachableModuleInstance>()\n\nexport const isAttachableModuleInstance: TypeCheck<AttachableModuleInstance> = factory.create(requiredAttachableModuleInstanceFunctions, [\n isModuleInstance,\n])\n","import { IsObjectFactory, TypeCheck } from '@xylabs/object'\n\nimport { ModuleEventData } from '../../EventsModels'\nimport { ModuleParams } from '../../ModuleParams'\nimport { ModuleInstance } from '../Instance'\nimport { ModuleResolverInstance } from '../ModuleResolver'\n\nexport interface AttachableModuleInstance<TParams extends ModuleParams = ModuleParams, TEventData extends ModuleEventData = ModuleEventData>\n extends ModuleInstance<TParams, TEventData> {\n /* The resolver is a 'down' resolver. It can resolve the module or any children (if it is a node for example), that are in the module*/\n readonly downResolver: ModuleResolverInstance\n\n // The resolver that gets called by children (usually only Nodes have this)\n readonly privateResolver: ModuleResolverInstance\n\n /* The resolver is a 'up' resolver. It can resolve the parent or any children of the parent*/\n /* This is set by a NodeModule when attaching to the module */\n readonly upResolver: ModuleResolverInstance\n}\n\nexport type AttachableModuleInstanceTypeCheck<T extends AttachableModuleInstance = AttachableModuleInstance> = TypeCheck<T>\n\nexport class IsAttachableModuleInstanceFactory<T extends AttachableModuleInstance = AttachableModuleInstance> extends IsObjectFactory<T> {}\n","import { IsObjectFactory, toJsonString, TypeCheck } from '@xylabs/object'\n\nimport { ModuleEventData } from '../EventsModels'\nimport { Module, ModuleQueryFunctions } from '../module'\nimport { ModuleIdentifier } from '../ModuleIdentifier'\nimport { ModuleParams } from '../ModuleParams'\nimport { ObjectResolver } from './ObjectResolver'\n\nexport type ModulePipeLine = Lowercase<'one-to-one' | 'one-to-many' | 'many-to-one' | 'many-to-many'>\n\nexport type ModuleStatus = 'started' | 'stopped' | 'dead' | 'wrapped' | 'proxy'\n\nexport class DeadModuleError extends Error {\n constructor(\n public id: ModuleIdentifier,\n public error: Error | undefined,\n msg = 'Dead Module Error',\n ) {\n super(`${msg} [${id}]: ${error?.message ?? toJsonString(error)}`)\n\n // Set the prototype explicitly.\n Object.setPrototypeOf(this, DeadModuleError.prototype)\n }\n}\n\nexport interface ModuleInstance<TParams extends ModuleParams = ModuleParams, TEventData extends ModuleEventData = ModuleEventData>\n extends Module<TParams, TEventData>,\n ObjectResolver<ModuleInstance>,\n ModuleQueryFunctions {\n readonly pipeline?: ModulePipeLine\n\n //if the module has become non-functional, such as a broken bridge connection, this will be 'dead'\n readonly status: ModuleStatus\n}\n\nexport type InstanceTypeCheck<T extends ModuleInstance = ModuleInstance> = TypeCheck<T>\n\nexport class IsInstanceFactory<T extends ModuleInstance = ModuleInstance> extends IsObjectFactory<T> {}\n","import { Address } from '@xylabs/hex'\nimport { AnyObject, EmptyObject, TypeCheck } from '@xylabs/object'\n\nimport { ModuleName } from '../ModuleIdentifier'\n\nexport type Direction = 'up' | 'down' | 'all'\nexport type Visibility = 'public' | 'private' | 'all'\n\nexport interface ResolveStrategy {\n maxDepth?: number\n required?: boolean | 'warn' | 'log'\n retry?: number\n timeout?: number\n}\n\nexport interface ObjectFilterOptions<T extends EmptyObject = AnyObject> extends ResolveStrategy {\n direction?: Direction\n identity?: TypeCheck<T>\n}\n\nexport interface AddressObjectFilter<T extends EmptyObject = AnyObject> extends ObjectFilterOptions<T> {\n address: Address[]\n}\n\nexport const isAddressObjectFilter = <T extends EmptyObject = AnyObject>(value: unknown): value is AddressObjectFilter<T> =>\n (value as AddressObjectFilter<T>).address !== undefined\n\nexport interface NameObjectFilter<T extends EmptyObject = AnyObject> extends ObjectFilterOptions<T> {\n name: ModuleName[]\n}\n\nexport const isNameObjectFilter = <T extends EmptyObject = AnyObject>(value: unknown): value is NameObjectFilter<T> =>\n (value as NameObjectFilter<T>).name !== undefined\n\nexport interface QueryObjectFilter<T extends EmptyObject = AnyObject> extends ObjectFilterOptions<T> {\n query: string[][]\n}\n\nexport const isQueryObjectFilter = <T extends EmptyObject = AnyObject>(value: unknown): value is QueryObjectFilter<T> =>\n (value as QueryObjectFilter<T>).query !== undefined\n\nexport type AnyObjectFilter<T extends EmptyObject = AnyObject> = Partial<AddressObjectFilter<T>> &\n Partial<NameObjectFilter<T>> &\n Partial<QueryObjectFilter<T>>\n\nexport type ObjectFilter<T extends EmptyObject> = ObjectFilterOptions<T> | AddressObjectFilter<T> | NameObjectFilter<T> | QueryObjectFilter<T>\n","import { ModuleInstance } from './Instance'\nimport {\n AddressObjectFilter,\n AnyObjectFilter,\n isAddressObjectFilter,\n isNameObjectFilter,\n isQueryObjectFilter,\n NameObjectFilter,\n ObjectFilter,\n ObjectFilterOptions,\n QueryObjectFilter,\n} from './ObjectFilter'\n\nexport interface ModuleFilterOptions<T extends ModuleInstance = ModuleInstance> extends ObjectFilterOptions<T> {}\n\nexport const isAddressModuleFilter = isAddressObjectFilter<ModuleInstance>\n\nexport const isNameModuleFilter = isNameObjectFilter<ModuleInstance>\n\nexport const isQueryModuleFilter = isQueryObjectFilter<ModuleInstance>\n\nexport type AnyModuleFilter<T extends ModuleInstance = ModuleInstance> = AnyObjectFilter<T>\n\nexport type AddressModuleFilter<T extends ModuleInstance = ModuleInstance> = AddressObjectFilter<T>\n\nexport type NameModuleFilter<T extends ModuleInstance = ModuleInstance> = NameObjectFilter<T>\n\nexport type QueryModuleFilter<T extends ModuleInstance = ModuleInstance> = QueryObjectFilter<T>\n\nexport type ModuleFilter<T extends ModuleInstance = ModuleInstance> = ObjectFilter<T>\n","import { AnyObject, EmptyObject } from '@xylabs/object'\nimport { Promisable } from '@xylabs/promise'\n\nimport { ModuleIdentifier } from '../ModuleIdentifier'\nimport { ObjectFilter, ObjectFilterOptions } from './ObjectFilter'\n\nexport const isObjectResolver = <T extends EmptyObject = AnyObject>(value?: unknown): value is ObjectResolver<T> => {\n // eslint-disable-next-line deprecation/deprecation\n return typeof (value as Partial<ObjectResolver<T>>).resolve === 'function'\n}\n\nexport enum ObjectResolverPriority {\n VeryLow = 0,\n Low = 1,\n Normal = 2,\n High = 3,\n VeryHigh = 4,\n}\n\nexport interface ObjectResolver<TResult extends EmptyObject> {\n priority: ObjectResolverPriority\n /** @deprecated do not pass undefined. If trying to get all, pass '*' */\n resolve<T extends TResult = TResult>(): Promisable<T | undefined>\n resolve<T extends TResult = TResult>(all: '*', options?: ObjectFilterOptions<T>): Promisable<T[]>\n resolve<T extends TResult = TResult>(id: ModuleIdentifier, options?: ObjectFilterOptions<T>): Promisable<T | undefined>\n resolve<T extends TResult = TResult>(filter: ObjectFilter<T>, options?: ObjectFilterOptions<T>): Promisable<T[]>\n /** @deprecated do not pass undefined. If trying to get all, pass '*' */\n resolve<T extends TResult = TResult>(filter?: ObjectFilter<T>, options?: ObjectFilterOptions<T>): Promisable<T[]>\n resolve<T extends TResult = TResult>(\n idOrFilter?: ObjectFilter<T> | ModuleIdentifier,\n options?: ObjectFilterOptions<T>,\n ): Promisable<T | T[] | undefined>\n\n resolvePrivate<T extends TResult = TResult>(all: '*', options?: ObjectFilterOptions<T>): Promise<T[]>\n resolvePrivate<T extends TResult = TResult>(id: ModuleIdentifier, options?: ObjectFilterOptions<T>): Promise<T | undefined>\n resolvePrivate<T extends TResult = TResult>(id: ModuleIdentifier, options?: ObjectFilterOptions<T>): Promise<T | T[] | undefined>\n}\n\nexport interface ObjectResolverInstance<TResult extends EmptyObject> extends ObjectResolver<TResult> {\n addResolver: (resolver: ObjectResolverInstance<TResult>) => this\n removeResolver: (resolver: ObjectResolverInstance<TResult>) => this\n}\n","import { Address } from '@xylabs/hex'\nimport { Promisable } from '@xylabs/promise'\n\nimport { ModuleIdentifier } from '../ModuleIdentifier'\nimport { ModuleInstance } from './Instance'\nimport { ObjectFilterOptions } from './ObjectFilter'\nimport { isObjectResolver, ObjectResolver } from './ObjectResolver'\n\nexport const isModuleResolver = isObjectResolver<ModuleInstance>\n\nexport interface ModuleResolver<TResult extends ModuleInstance = ModuleInstance> extends ObjectResolver<TResult> {}\n\nexport interface ModuleNameResolver {\n readonly root: ModuleInstance\n resolveIdentifier(id: ModuleIdentifier, options?: ObjectFilterOptions): Promisable<Address | undefined>\n}\n\nexport interface ModuleResolverInstance<TResult extends ModuleInstance = ModuleInstance> extends ModuleResolver<TResult>, ModuleNameResolver {\n addResolver: (resolver: ModuleResolverInstance<TResult>) => this\n removeResolver: (resolver: ModuleResolverInstance<TResult>) => this\n}\n","import { Module } from '../module'\n\n/**\n * Used to filter duplicates from an array of modules\n * @example: modulesArray.filter(duplicateModules)\n * @param value Current Module\n * @param index Current Module's index\n * @param array Module Array\n * @returns True if the Module's address is the first occurrence of\n * that address in the array, false otherwise\n */\nexport const duplicateModules = (value: Module, index: number, array: Module[]): value is Module => {\n return array.findIndex((v) => v.address === value.address) === index\n}\n","// Inspired by https://stackoverflow.com/a/49079549/2803259\n\nimport { every, isArray, isBoolean, isNull, isNumber, isPlainObject, isString, isUndefined, overSome } from '@xylabs/lodash'\n\nconst JSONPrimitiveChecks = [isUndefined, isNull, isBoolean, isNumber, isString]\nconst JSONComplexChecks = [isPlainObject, isArray]\n\nexport const serializable = (field: unknown, depth?: number): boolean | null => {\n let depthExceeded = false\n const decrementDepth = () => (depth ? depth-- : undefined)\n\n const recursiveSerializable = (field: unknown) => {\n if (depth !== undefined && depth < 1) {\n depthExceeded = true\n return false\n }\n\n // decrement during every recursion\n decrementDepth()\n\n const nestedSerializable = (field: unknown): boolean => overSome(JSONComplexChecks)(field) && every(field as object, recursiveSerializable)\n\n return overSome([...JSONPrimitiveChecks, nestedSerializable])(field)\n }\n\n const valid = recursiveSerializable(field)\n\n return depthExceeded ? null : valid\n}\n\nexport const serializableField = (field: unknown) => {\n return overSome([...JSONPrimitiveChecks, ...JSONComplexChecks])(field)\n}\n","import { Address, isAddress } from '@xylabs/hex'\n\nexport const DisallowedModuleIdentifierCharacters = {\n ' ': true,\n '!': true,\n '\"': true,\n '#': true,\n $: true,\n '%': true,\n '&': true,\n \"'\": true,\n '(': true,\n ')': true,\n '*': true,\n ',': true,\n '.': true,\n '/': true,\n ':': true,\n ';': true,\n '<': true,\n '=': true,\n '>': true,\n '?': true,\n '@': true,\n '[': true,\n ']': true,\n '^': true,\n _: true,\n '{': true,\n '|': true,\n '}': true,\n '~': true,\n}\nexport type ReservedModuleIdentifierCharacter = keyof typeof DisallowedModuleIdentifierCharacters\nexport const ReservedModuleIdentifierCharacters = new Set<ReservedModuleIdentifierCharacter>(\n Object.keys(DisallowedModuleIdentifierCharacters) as ReservedModuleIdentifierCharacter[],\n)\n\n//using Exclude to make this type not allowed to take a naked string\nexport type ModuleName = Exclude<string, 'reserved-module-name-56487634'>\n\nexport type ModuleIdentifier =\n | ColonPair<ModuleIdentifierPart>\n | ColonPair<ColonPair<ModuleIdentifierPart>>\n | ColonPair<ColonPair<ColonPair<ModuleIdentifierPart>>>\n | ColonPair<ColonPair<ColonPair<ColonPair<ModuleIdentifierPart>>>>\n | ColonPair<ColonPair<ColonPair<ColonPair<ColonPair<ModuleIdentifierPart>>>>>\n | ColonPair<ColonPair<ColonPair<ColonPair<ColonPair<ColonPair<ModuleIdentifierPart>>>>>>\n | ColonPair<ColonPair<ColonPair<ColonPair<ColonPair<ColonPair<ColonPair<ModuleIdentifierPart>>>>>>>\n\nexport type ColonPair<T extends string> = `${T}:${T}` | T\n\nexport type ModuleIdentifierPart = Exclude<Address | ModuleName, '*'>\n\nexport const isModuleName = (value: unknown): value is ModuleName => {\n return typeof value === 'string' && !isAddress(value) && !includesReservedModuleIdentifierCharacter(value)\n}\n\nexport const includesReservedModuleIdentifierCharacter = (value: unknown): boolean => {\n return typeof value === 'string' && [...value].some((char) => ReservedModuleIdentifierCharacters.has(char as ReservedModuleIdentifierCharacter))\n}\n\nexport const isModuleIdentifierPart = (value: unknown): value is ModuleIdentifierPart => {\n return isModuleName(value) || isAddress(value)\n}\n","import { Address } from '@xylabs/hex'\nimport { AddressSchema } from '@xyo-network/address-payload-plugin'\nimport { Payload } from '@xyo-network/payload-model'\n\nexport const AddressPreviousHashSchema = `${AddressSchema}.hash.previous`\nexport type AddressPreviousHashSchema = typeof AddressPreviousHashSchema\n\nexport type AddressPreviousHashPayload = Payload<{\n address: Address\n previousHash?: string\n schema: AddressPreviousHashSchema\n}>\n","import { Payload } from '@xyo-network/payload-model'\n\nimport { ModuleDescription } from '../ModuleDescription'\n\nexport const ModuleDescriptionSchema = 'network.xyo.module.description'\nexport type ModuleDescriptionSchema = typeof ModuleDescriptionSchema\n\nexport type ModuleDescriptionPayload = Payload<ModuleDescription, ModuleDescriptionSchema>\n","import { isPayloadOfSchemaType, Payload, WithMeta } from '@xyo-network/payload-model'\n\nexport interface StateDictionary {\n [key: string]: string | number | undefined\n}\nexport interface State<T extends StateDictionary = StateDictionary> {\n state: T\n}\n\nexport const ModuleStateSchema = 'network.xyo.module.state' as const\nexport type ModuleStateSchema = typeof ModuleStateSchema\n\nexport type ModuleState<T extends StateDictionary = StateDictionary> = Payload<State<T>, ModuleStateSchema>\n\nexport const isModuleState = <T extends StateDictionary = StateDictionary>(payload?: Payload | null): payload is ModuleState<T> => {\n return isPayloadOfSchemaType<ModuleState<T>>(ModuleStateSchema)(payload)\n}\n\nexport const isModuleStateWithMeta = <T extends StateDictionary = StateDictionary>(payload?: Payload | null): payload is WithMeta<ModuleState<T>> => {\n return isPayloadOfSchemaType<WithMeta<ModuleState<T>>>(ModuleStateSchema)(payload)\n}\n","/* eslint-disable max-statements */\n/* eslint-disable complexity */\nimport { assertEx } from '@xylabs/assert'\nimport { exists } from '@xylabs/exists'\nimport { Address, isAddress } from '@xylabs/hex'\nimport { IdLogger, Logger } from '@xylabs/logger'\nimport { toJsonString } from '@xylabs/object'\n\nimport { asModuleInstance, ModuleFilter, ModuleFilterOptions, ModuleInstance, ModuleResolver } from './instance'\nimport { duplicateModules } from './lib'\nimport { ModuleIdentifier } from './ModuleIdentifier'\n\n/*\n\nResolution rules\n\n1. Resolution is always done from the perspective of the module whose resolve function was called.\n\n2. Requesting '*' will return all the modules that the resolver can see. [limited by maxDepth]\n\n3. Requesting a simple ModuleName (string w/o ':' separator) will return an immediate child that has that name.\n\n4. Requesting a complex ModuleName (string w/ ':' separator) will resolve the first part and then recursively resolve\n the remaining name by calling the first part's resolved module's resolve with the remainder of the name.\n\n5. Requesting an Address (string) will return the module with that address, regardless of how distant it is from the module. [limited by maxDepth]\n\n6. Requesting a ModuleFilter will first request all the modules '*' and then filter them based on the filter settings. [Do we need this mode?]\n\n7. When a string is passed as the ModuleIdentifier, do the following:\n Check if id is complex (contains a ':')\n a) If it is complex, go to #4 above\n b) Call isAddress in the id to see if it is a valid address.\n i) If it is a valid address, go to #5 above\n ii) If it is not a valid address, go to # 3 above\n\n Note 1: If someone were to name a module with a valid address, that name will not be resolvable.\n Note 2: If someone were to name a module with a string containing a ':', that name will not be resolvable.\n\n8. Modules have two resolvers, up and down.\n a) Up Traversal\n i) Every module's upResolver also can call it's parent's upResolver\n ii) An upResolver also can see the parent's children's downResolvers\n iii) This means that when traversing upResolvers, you can traverse all the way up. [limited by maxDepth]\n iv) At any point of the up traversal, it can start traversing down to any immediate child, public or private.\n b) Down Traversal\n i) A down traversal is limited to the public children of the module. [The same as scope as calling the 'resolve' function]\n\n9. An up or a down traversal counts against the maxDepth\n\n*/\n\nexport interface ResolveHelperConfig {\n address: Address\n dead?: boolean\n downResolver?: ModuleResolver\n logger?: Logger\n module: ModuleInstance\n privateResolver?: ModuleResolver\n upResolver?: ModuleResolver\n}\n\nexport class ResolveHelper {\n static defaultLogger?: Logger\n static async resolve<T extends ModuleInstance = ModuleInstance>(\n config: ResolveHelperConfig,\n all: '*',\n options?: ModuleFilterOptions<T>,\n ): Promise<T[]>\n static async resolve<T extends ModuleInstance = ModuleInstance>(\n config: ResolveHelperConfig,\n filter: ModuleFilter,\n options?: ModuleFilterOptions<T>,\n ): Promise<T[]>\n static async resolve<T extends ModuleInstance = ModuleInstance>(\n config: ResolveHelperConfig,\n id: ModuleIdentifier,\n options?: ModuleFilterOptions<T>,\n ): Promise<T | undefined>\n static async resolve<T extends ModuleInstance = ModuleInstance>(\n config: ResolveHelperConfig,\n idOrFilter: ModuleFilter<T> | ModuleIdentifier = '*',\n { maxDepth = 3, required = 'log', ...options }: ModuleFilterOptions<T> = {},\n ): Promise<T | T[] | undefined> {\n const { module, logger = this.defaultLogger, dead = false, upResolver, downResolver, privateResolver } = config\n const log = logger ? new IdLogger(logger, () => `ResolveHelper [${module.id}][${idOrFilter}]`) : undefined\n\n const downLocalOptions: ModuleFilterOptions<T> = { ...options, direction: 'down', maxDepth, required: false }\n const upLocalOptions: ModuleFilterOptions<T> = { ...downLocalOptions, direction: 'up' }\n\n const childOptions: ModuleFilterOptions<T> = { ...options, maxDepth: maxDepth - 1, required: false }\n\n const direction = options?.direction ?? 'all'\n const up = direction === 'up' || direction === 'all'\n const down = direction === 'down' || direction === 'all'\n let result: T | T[] | undefined\n log?.debug('start', idOrFilter, maxDepth)\n if (idOrFilter === '*') {\n if (dead) {\n log?.warn('failed [dead]', idOrFilter)\n return []\n }\n const modules = [\n ...(down ? await (downResolver as ModuleResolver).resolve<T>('*', downLocalOptions) : []),\n ...(up ? await (upResolver as ModuleResolver).resolve<T>('*', upLocalOptions) : []),\n ]\n .filter(duplicateModules)\n .filter((module) => module.address !== config.address)\n\n if (modules.length > 0) {\n log?.log('modules [count]', modules.length)\n log?.debug('modules', toJsonString(modules, 4))\n }\n\n if (maxDepth === 0) {\n return modules\n }\n const childModules = (await Promise.all(modules.map(async (module) => await module.resolve<T>('*', childOptions))))\n .flat()\n .filter(duplicateModules)\n return [...modules, ...childModules].filter(duplicateModules)\n } else {\n switch (typeof idOrFilter) {\n case 'string': {\n if (dead) {\n return undefined\n }\n\n const resolvers = [\n [downResolver, downLocalOptions],\n [up ? upResolver : undefined, upLocalOptions],\n [up ? privateResolver : undefined, upLocalOptions],\n ].filter(([resolver]) => exists(resolver)) as [ModuleResolver, ModuleFilterOptions<T>][]\n\n for (const resolver of resolvers) {\n const [resolverInstance] = resolver\n if (!result) {\n result = await this.resolveModuleIdentifier<T>(resolverInstance, idOrFilter)\n }\n }\n\n break\n }\n default: {\n if (dead) {\n return []\n }\n const filter: ModuleFilter<T> | undefined = idOrFilter\n result = [\n ...(down ? await (downResolver as ModuleResolver).resolve<T>(filter, downLocalOptions) : []),\n ...(up ? await (upResolver as ModuleResolver).resolve<T>(filter, upLocalOptions) : []),\n ].filter(duplicateModules)\n break\n }\n }\n }\n this.validateRequiredResolve(required, result, idOrFilter, logger)\n return result\n }\n\n //resolves a complex module path to addresses\n static async resolveModuleIdentifier<T extends ModuleInstance = ModuleInstance>(\n resolver: ModuleResolver,\n path: ModuleIdentifier,\n required?: boolean,\n ): Promise<T | undefined> {\n const parts = path.split(':')\n const first = parts.shift()\n const firstIsAddress = isAddress(first)\n const resolvedModule =\n (await resolver.resolve(first, { maxDepth: firstIsAddress ? 10 : 1 })) ??\n (first ? await resolver.resolvePrivate(first, { maxDepth: firstIsAddress ? 10 : 1 }) : undefined)\n const finalModule = required ? assertEx(resolvedModule, () => `Failed to resolve [${first}] [${firstIsAddress}]`) : resolvedModule\n const firstModule = asModuleInstance(finalModule, () => `Resolved invalid module instance [${first}]`) as T\n if (firstModule) {\n return parts.length > 0 ? await this.resolveModuleIdentifier<T>(firstModule, parts.join(':')) : firstModule\n }\n }\n\n //translates a complex module path to addresses\n static async traceModuleIdentifier(resolver: ModuleResolver, path: ModuleIdentifier): Promise<Address[]> {\n const parts = path.split(':')\n const first = parts.shift()\n const firstModule = asModuleInstance(\n assertEx(await resolver.resolve(first, { maxDepth: 1 }), () => `Failed to resolve [${first}]`),\n () => `Resolved invalid module instance [${first}]`,\n )\n if (firstModule) {\n return parts.length > 0 ? [firstModule.address, ...(await this.traceModuleIdentifier(firstModule, parts.join(':')))] : [firstModule.address]\n }\n return []\n }\n\n static validateRequiredResolve(\n required: boolean | 'warn' | 'log',\n result: ModuleInstance[] | ModuleInstance | undefined,\n idOrFilter: ModuleIdentifier | ModuleFilter,\n logger = this.defaultLogger,\n ) {\n const log = logger ? new IdLogger(logger, () => `validateRequiredResolve [${idOrFilter}][${result}]`) : undefined\n if (required && (result === undefined || (Array.isArray(result) && result.length > 0))) {\n switch (required) {\n case 'warn': {\n log?.warn('resolve failed', idOrFilter)\n break\n }\n case 'log': {\n log?.log('resolve failed', idOrFilter)\n break\n }\n default: {\n throw new Error(`resolve failed [${idOrFilter}]`)\n }\n }\n }\n }\n}\n","import { TypeCheck } from '@xylabs/object'\n\nimport { isModuleInstance } from './instance'\nimport { isModule } from './module'\n\nexport const WithFactory = {\n create: <T extends object>(typeCheck: TypeCheck<T>) => {\n return <R>(\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n module: any,\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n closure: (module: T) => R,\n ): R | undefined => {\n return typeCheck(module) ? closure(module) : undefined\n }\n },\n}\n\nexport const withModule = WithFactory.create(isModule)\nexport const withModuleInstance = WithFactory.create(isModuleInstance)\n"],"mappings":"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","names":["ModuleConfigSchema","creatableModule","constructor","toCreatableModuleRegistry","dict","Object","entries","reduce","registry","schema","factory","Array","isArray","assignCreatableModuleRegistry","target","sources","map","source","factories","existingFactories","hasLabels","factory","labels","undefined","ModuleFactory","configSchemas","creatableModule","defaultLogger","defaultParams","labels","constructor","params","Object","assign","configSchema","withParams","_getRootFunction","funcName","anyThis","__proto__","_noOverride","functionName","thisFunc","rootFunc","assertEx","create","factory","schema","mergedParams","merge","config","_params","Error","import_assert","hasAllLabels","source","required","Object","entries","every","key","value","hasOwnProperty","ModuleFactoryLocator","constructor","_registry","registry","locate","schema","labels","assertEx","tryLocate","configString","labelsString","JSON","stringify","register","mod","configSchemas","map","existingFactories","factory","create","bind","Object","assign","registerMany","additional","entries","factories","filter","hasLabels","find","hasAllLabels","import_object","import_object","import_object","ModuleManifestQuerySchema","ModuleAddressQuerySchema","ModuleStateQuerySchema","ModuleSubscribeQuerySchema","import_object","requiredModuleShape","address","queries","query","factory","IsObjectFactory","isModuleObject","create","asModuleObject","AsObjectFactory","create","isModuleObject","IsModuleFactory","create","expectedQueries","additionalChecks","obj","config","module","asModuleObject","result","isModuleObject","reduce","prev","query","queries","includes","check","requiredModuleQueries","ModuleStateQuerySchema","factory","IsModuleFactory","isModule","create","isModuleObject","asModule","AsObjectFactory","create","isModule","requiredModuleInstanceFunctions","manifest","state","factory","IsObjectFactory","isModuleInstance","create","isModule","asModuleInstance","AsObjectFactory","create","isModuleInstance","import_object","import_object","requiredAttachableModuleInstanceFunctions","downResolver","upResolver","factory","IsObjectFactory","isAttachableModuleInstance","create","isModuleInstance","asAttachableModuleInstance","AsObjectFactory","create","isAttachableModuleInstance","import_object","IsAttachableModuleInstanceFactory","IsObjectFactory","import_object","DeadModuleError","Error","constructor","id","error","msg","message","toJsonString","Object","setPrototypeOf","prototype","IsInstanceFactory","IsObjectFactory","isAddressObjectFilter","value","address","undefined","isNameObjectFilter","name","isQueryObjectFilter","query","isAddressModuleFilter","isAddressObjectFilter","isNameModuleFilter","isNameObjectFilter","isQueryModuleFilter","isQueryObjectFilter","isObjectResolver","value","resolve","ObjectResolverPriority","isModuleResolver","isObjectResolver","duplicateModules","value","index","array","findIndex","v","address","import_lodash","JSONPrimitiveChecks","isUndefined","isNull","isBoolean","isNumber","isString","JSONComplexChecks","isPlainObject","isArray","serializable","field","depth","depthExceeded","decrementDepth","undefined","recursiveSerializable","nestedSerializable","overSome","every","valid","serializableField","DisallowedModuleIdentifierCharacters","$","_","ReservedModuleIdentifierCharacters","Set","Object","keys","isModuleName","value","isAddress","includesReservedModuleIdentifierCharacter","some","char","has","isModuleIdentifierPart","AddressPreviousHashSchema","AddressSchema","ModuleDescriptionSchema","ModuleStateSchema","isModuleState","payload","isPayloadOfSchemaType","isModuleStateWithMeta","import_assert","import_hex","import_object","ResolveHelper","defaultLogger","resolve","config","idOrFilter","maxDepth","required","options","module","logger","dead","upResolver","downResolver","privateResolver","log","IdLogger","id","undefined","downLocalOptions","direction","upLocalOptions","childOptions","up","down","result","debug","warn","modules","filter","duplicateModules","address","length","toJsonString","childModules","Promise","all","map","flat","resolvers","resolver","exists","resolverInstance","resolveModuleIdentifier","validateRequiredResolve","path","parts","split","first","shift","firstIsAddress","isAddress","resolvedModule","resolvePrivate","finalModule","assertEx","firstModule","asModuleInstance","join","traceModuleIdentifier","Array","isArray","Error","WithFactory","create","typeCheck","module","closure","undefined","withModule","isModule","withModuleInstance","isModuleInstance"]}
@@ -441,6 +441,8 @@ var isModuleStateWithMeta = /* @__PURE__ */ __name((payload) => {
441
441
 
442
442
  // src/ResolveHelper.ts
443
443
  import { assertEx as assertEx3 } from "@xylabs/assert";
444
+ import { exists } from "@xylabs/exists";
445
+ import { isAddress as isAddress2 } from "@xylabs/hex";
444
446
  import { IdLogger } from "@xylabs/logger";
445
447
  import { toJsonString as toJsonString2 } from "@xylabs/object";
446
448
  var ResolveHelper = class {
@@ -448,15 +450,14 @@ var ResolveHelper = class {
448
450
  __name(this, "ResolveHelper");
449
451
  }
450
452
  static defaultLogger;
451
- static async resolve(config, idOrFilter = "*", { visibility, maxDepth = 3, required = "log", ...options } = {}) {
452
- const { module, logger = this.defaultLogger, dead = false, upResolver, downResolver } = config;
453
- const log = logger ? new IdLogger(logger, () => `ResolveHelper [${module.id}][${idOrFilter}][${visibility}]`) : void 0;
453
+ static async resolve(config, idOrFilter = "*", { maxDepth = 3, required = "log", ...options } = {}) {
454
+ const { module, logger = this.defaultLogger, dead = false, upResolver, downResolver, privateResolver } = config;
455
+ const log = logger ? new IdLogger(logger, () => `ResolveHelper [${module.id}][${idOrFilter}]`) : void 0;
454
456
  const downLocalOptions = {
455
457
  ...options,
456
458
  direction: "down",
457
459
  maxDepth,
458
- required: false,
459
- visibility
460
+ required: false
460
461
  };
461
462
  const upLocalOptions = {
462
463
  ...downLocalOptions,
@@ -465,8 +466,7 @@ var ResolveHelper = class {
465
466
  const childOptions = {
466
467
  ...options,
467
468
  maxDepth: maxDepth - 1,
468
- required: false,
469
- visibility
469
+ required: false
470
470
  };
471
471
  const direction = options?.direction ?? "all";
472
472
  const up = direction === "up" || direction === "all";
@@ -500,7 +500,26 @@ var ResolveHelper = class {
500
500
  if (dead) {
501
501
  return void 0;
502
502
  }
503
- result = (down && downResolver ? await this.resolveModuleIdentifier(downResolver, idOrFilter) : void 0) ?? (up && upResolver ? await this.resolveModuleIdentifier(upResolver, idOrFilter) : void 0);
503
+ const resolvers = [
504
+ [
505
+ downResolver,
506
+ downLocalOptions
507
+ ],
508
+ [
509
+ up ? upResolver : void 0,
510
+ upLocalOptions
511
+ ],
512
+ [
513
+ up ? privateResolver : void 0,
514
+ upLocalOptions
515
+ ]
516
+ ].filter(([resolver]) => exists(resolver));
517
+ for (const resolver of resolvers) {
518
+ const [resolverInstance] = resolver;
519
+ if (!result) {
520
+ result = await this.resolveModuleIdentifier(resolverInstance, idOrFilter);
521
+ }
522
+ }
504
523
  break;
505
524
  }
506
525
  default: {
@@ -520,12 +539,17 @@ var ResolveHelper = class {
520
539
  return result;
521
540
  }
522
541
  //resolves a complex module path to addresses
523
- static async resolveModuleIdentifier(resolver, path) {
542
+ static async resolveModuleIdentifier(resolver, path, required) {
524
543
  const parts = path.split(":");
525
544
  const first = parts.shift();
526
- const firstModule = asModuleInstance(assertEx3(await resolver.resolve(first, {
527
- maxDepth: 1
528
- }), () => `Failed to resolve [${first}]`), () => `Resolved invalid module instance [${first}]`);
545
+ const firstIsAddress = isAddress2(first);
546
+ const resolvedModule = await resolver.resolve(first, {
547
+ maxDepth: firstIsAddress ? 10 : 1
548
+ }) ?? (first ? await resolver.resolvePrivate(first, {
549
+ maxDepth: firstIsAddress ? 10 : 1
550
+ }) : void 0);
551
+ const finalModule = required ? assertEx3(resolvedModule, () => `Failed to resolve [${first}] [${firstIsAddress}]`) : resolvedModule;
552
+ const firstModule = asModuleInstance(finalModule, () => `Resolved invalid module instance [${first}]`);
529
553
  if (firstModule) {
530
554
  return parts.length > 0 ? await this.resolveModuleIdentifier(firstModule, parts.join(":")) : firstModule;
531
555
  }