@xyo-network/module-model 2.107.3 → 2.107.4

package/dist/browser/index.cjs

@@ -1,2 +1,865 @@
-"use strict";var O=Object.defineProperty;var Pe=Object.getOwnPropertyDescriptor;var Ve=Object.getOwnPropertyNames;var We=Object.prototype.hasOwnProperty;var s=(e,t)=>O(e,"name",{value:t,configurable:!0});var ze=(e,t)=>{for(var r in t)O(e,r,{get:t[r],enumerable:!0})},Je=(e,t,r,o)=>{if(t&&typeof t=="object"||typeof t=="function")for(let n of Ve(t))!We.call(e,n)&&n!==r&&O(e,n,{get:()=>t[n],enumerable:!(o=Pe(t,n))||o.enumerable});return e};var Be=e=>Je(O({},"__esModule",{value:!0}),e);var Nt={};ze(Nt,{AddressChildSchema:()=>St,AddressPreviousHashSchema:()=>It,AddressSchema:()=>gt,DeadModuleError:()=>B,DisallowedModuleIdentifierCharacters:()=>Te,IsAttachableModuleInstanceFactory:()=>J,IsInstanceFactory:()=>G,IsModuleFactory:()=>y,MODULE_PATH_SEPARATOR:()=>R,ModuleAddressQuerySchema:()=>st,ModuleConfigSchema:()=>Ge,ModuleDescriptionSchema:()=>At,ModuleDetailsError:()=>P,ModuleFactory:()=>U,ModuleLimitationLabelName:()=>wt,ModuleLimitationViewLabel:()=>Mt,ModuleManifestQuerySchema:()=>ot,ModuleStateQuerySchema:()=>V,ModuleStateSchema:()=>oe,ModuleSubscribeQuerySchema:()=>nt,ObjectResolverPriority:()=>Z,ReservedModuleIdentifierCharacters:()=>je,ResolveHelper:()=>de,WithFactory:()=>ue,asAttachableModuleInstance:()=>ut,asModule:()=>it,asModuleInstance:()=>v,asModuleObject:()=>W,assignCreatableModuleRegistry:()=>et,creatableModule:()=>Ke,creatableModuleFactory:()=>Xe,duplicateModules:()=>M,hasAllLabels:()=>ht,hasLabels:()=>tt,includesReservedModuleIdentifierCharacter:()=>Oe,isAddressModuleFilter:()=>ft,isAddressObjectFilter:()=>K,isAttachableModuleInstance:()=>z,isModule:()=>h,isModuleIdentifierPart:()=>vt,isModuleInstance:()=>w,isModuleName:()=>Fe,isModuleObject:()=>x,isModuleResolver:()=>xt,isModuleState:()=>Ct,isModuleStateWithMeta:()=>Lt,isNameModuleFilter:()=>mt,isNameObjectFilter:()=>X,isObjectResolver:()=>ee,isQueryModuleFilter:()=>pt,isQueryObjectFilter:()=>Y,labeledCreatableModuleFactory:()=>rt,registerCreatableModuleFactories:()=>Ze,registerCreatableModuleFactory:()=>me,requiredAttachableModuleInstanceFunctions:()=>Se,requiredModuleInstanceFunctions:()=>ye,requiredModuleQueries:()=>we,requiredModuleShape:()=>xe,resolveAddressToInstance:()=>N,resolveAddressToInstanceAll:()=>ke,resolveAddressToInstanceDown:()=>g,resolveAddressToInstanceSiblings:()=>Tt,resolveAddressToInstanceUp:()=>se,resolveLocalNameToAddress:()=>ae,resolveLocalNameToAddressAll:()=>Ot,resolveLocalNameToAddressDown:()=>Ft,resolveLocalNameToAddressUp:()=>jt,resolveLocalNameToInstance:()=>ne,resolveLocalNameToInstanceAll:()=>$,resolveLocalNameToInstanceDown:()=>I,resolveLocalNameToInstanceUp:()=>S,resolvePathToAddress:()=>ce,resolvePathToInstance:()=>q,serializable:()=>bt,serializableField:()=>yt,transformModuleIdentifier:()=>A,withModule:()=>kt,withModuleInstance:()=>Rt});module.exports=Be(Nt);var Ge="network.xyo.module.config";function Ke(){return e=>{}}s(Ke,"creatableModule");function Xe(){return e=>{}}s(Xe,"creatableModuleFactory");var Ye=s((e,t)=>({...e,configSchemas:e.configSchemas,create:e.create.bind(e),defaultConfigSchema:e.defaultConfigSchema,labels:{...e.labels,...t}}),"buildModuleFactory"),me=s((e,t,r,o=!1)=>{let n=s(c=>{switch(typeof o){case"boolean":return o;case"string":return c===o;case"object":if(Array.isArray(o))return o.includes(c)}throw new Error(`Invalid primary value: ${o}`)},"isPrimaryForSchema"),a=Ye(t,r);e[t.defaultConfigSchema]=[a,...e[a.defaultConfigSchema]??[]];for(let c of a.configSchemas)e[c]=n(c)?[a,...e[c]??[]]:[...e[c]??[],a]},"registerCreatableModuleFactory"),Ze=s((e,t={},r=!1)=>{for(let o of e)me(t,o,void 0,r);return t},"registerCreatableModuleFactories"),et=s((e={},...t)=>(t.map(r=>Object.entries(r).map(([o,n])=>{if(n){let a=e[o];e[o]=a?e[o]=[...a,...n]:n}})),e),"assignCreatableModuleRegistry");var tt=s(e=>e.labels!==void 0,"hasLabels");function rt(){return e=>{}}s(rt,"labeledCreatableModuleFactory");var H=require("@xylabs/assert"),Q=require("@xylabs/lodash");var U=class e{static{s(this,"ModuleFactory")}configSchemas;creatableModule;defaultConfigSchema;defaultLogger;defaultParams;labels;constructor(t,r,o={}){this.creatableModule=t,this.defaultParams=r,this.configSchemas=t.configSchemas,this.defaultConfigSchema=t.defaultConfigSchema,(0,H.assertEx)(this.configSchemas.includes(this.defaultConfigSchema),()=>"defaultConfigSchema must be in configSchemas"),this.labels=Object.assign({},t.labels??{},o??{})}static withParams(t,r,o={}){return new e(t,r,o)}_getRootFunction(t){let r=this;for(;r.__proto__[t];)r=r.__proto__;return r[t]}_noOverride(t){let r=this[t],o=this._getRootFunction(t);(0,H.assertEx)(r===o,()=>`Override not allowed for [${t}] - override ${t}Handler instead`)}create(t){let r=this,o=r.creatableModule.defaultConfigSchema,n=(0,Q.merge)({},r.defaultParams,t,{config:(0,Q.merge)({},r.defaultParams?.config,t?.config,{schema:o})});return r.creatableModule.create(n)}factory(t){throw new Error("Method not implemented.")}};var P=class extends Error{static{s(this,"ModuleDetailsError")}details;constructor(t,r){super(t),this.details=r,this.name="ModuleError"}};var ve=require("@xylabs/object");var be=require("@xylabs/object");var Me=require("@xylabs/object");var ot="network.xyo.query.module.manifest";var st="network.xyo.query.module.address";var V="network.xyo.query.module.state";var nt="network.xyo.query.module.subscribe";var he=require("@xylabs/object");var pe=require("@xylabs/object"),xe={address:"string",queries:"array",query:"function"},at=new pe.IsObjectFactory,x=at.create(xe);var W=he.AsObjectFactory.create(x);var y=class{static{s(this,"IsModuleFactory")}create(t,r){return(o,n)=>{let a=W(o);return x(a,n)&&(t?.reduce((i,d)=>i&&a.queries.includes(d),!0)??!0)&&(r?.reduce((i,d)=>i&&d(o,n),!0)??!0)}}};var we=[V],ct=new y,h=ct.create(we,[x]);var it=Me.AsObjectFactory.create(h);var ye={manifest:"function",state:"function"},lt=new be.IsObjectFactory,w=lt.create(ye,[h]);var v=ve.AsObjectFactory.create(w);var Ie=require("@xylabs/object");var ge=require("@xylabs/object");var Se={downResolver:"object",upResolver:"object"},dt=new ge.IsObjectFactory,z=dt.create(Se,[w]);var ut=Ie.AsObjectFactory.create(z);var Ae=require("@xylabs/object");var J=class extends Ae.IsObjectFactory{static{s(this,"IsAttachableModuleInstanceFactory")}};var k=require("@xylabs/object");var B=class e extends Error{static{s(this,"DeadModuleError")}id;error;constructor(t,r,o="Dead Module Error"){super(`${o} [${t}]: ${r?.message??(0,k.toJsonString)(r)}`),this.id=t,this.error=r,Object.setPrototypeOf(this,e.prototype)}},G=class extends k.IsObjectFactory{static{s(this,"IsInstanceFactory")}};var K=s(e=>e.address!==void 0,"isAddressObjectFilter"),X=s(e=>e.name!==void 0,"isNameObjectFilter"),Y=s(e=>e.query!==void 0,"isQueryObjectFilter");var ft=K,mt=X,pt=Y;var ee=s(e=>typeof e.resolve=="function","isObjectResolver"),Z;(function(e){e[e.Disabled=-1]="Disabled",e[e.VeryLow=0]="VeryLow",e[e.Low=1]="Low",e[e.Normal=2]="Normal",e[e.High=3]="High",e[e.VeryHigh=4]="VeryHigh"})(Z||(Z={}));var xt=ee;var ht=s((e,t)=>t?Object.entries(t).every(([r,o])=>e?.hasOwnProperty(r)&&e?.[r]===o):!0,"hasAllLabels");var wt="network.xyo.module.limitation",Mt={ModuleLimitationLabelName:"view"};var M=s((e,t,r)=>r.findIndex(o=>o.address===e.address)===t,"duplicateModules");var l=require("@xylabs/lodash");var Ce=[l.isUndefined,l.isNull,l.isBoolean,l.isNumber,l.isString],Le=[l.isPlainObject,l.isArray],bt=s((e,t)=>{let r=!1,o=s(()=>t?t--:void 0,"decrementDepth"),n=s(c=>{if(t!==void 0&&t<1)return r=!0,!1;o();let i=s(d=>(0,l.overSome)(Le)(d)&&(0,l.every)(d,n),"nestedSerializable");return(0,l.overSome)([...Ce,i])(c)},"recursiveSerializable"),a=n(e);return r?null:a},"serializable"),yt=s(e=>(0,l.overSome)([...Ce,...Le])(e),"serializableField");var te=require("@xylabs/hex");var R=":",Te={" ":!0,"!":!0,'"':!0,"#":!0,$:!0,"%":!0,"&":!0,"'":!0,"(":!0,")":!0,"*":!0,",":!0,".":!0,"/":!0,":":!0,";":!0,"<":!0,"=":!0,">":!0,"?":!0,"@":!0,"[":!0,"]":!0,"^":!0,_:!0,"{":!0,"|":!0,"}":!0,"~":!0},je=new Set(Object.keys(Te)),Fe=s(e=>typeof e=="string"&&!(0,te.isAddress)(e)&&!Oe(e),"isModuleName"),Oe=s(e=>typeof e=="string"&&[...e].some(t=>je.has(t)),"includesReservedModuleIdentifierCharacter"),vt=s(e=>Fe(e)||(0,te.isAddress)(e),"isModuleIdentifierPart");var gt="network.xyo.address",St="network.xyo.address.child";var It="network.xyo.address.hash.previous";var At="network.xyo.module.description";var re=require("@xyo-network/payload-model");var oe="network.xyo.module.state",Ct=s(e=>(0,re.isPayloadOfSchemaType)(oe)(e),"isModuleState"),Lt=s(e=>(0,re.isPayloadOfSchemaType)(oe)(e),"isModuleStateWithMeta");var g=s(async(e,t,r=!1,o=[])=>{if(e.address===t)return e;let n=e.addressCache?.("up",r),a=(r?await e.privateChildren?.():[])??[],c=await e.publicChildren?.()??[],i=[...a,...c];for(let d of i){let f=await g(d,t,r,o);if(f)return n?.set(t,new WeakRef(f)),f}n?.set(t,null)},"resolveAddressToInstanceDown"),Tt=s(async(e,t,r=!1,o=[])=>{let n=await e.siblings?.()??[];for(let a of n){let c=await g(a,t,r,o);if(c)return c}},"resolveAddressToInstanceSiblings"),se=s(async(e,t,r=!1,o=[])=>{let n=e.addressCache?.("up",r),a=await e.parents?.()??[];for(let c of a){let i=await N(c,t,r,o);if(i)return n?.set(t,new WeakRef(i)),i}n?.set(t,null)},"resolveAddressToInstanceUp"),ke=s(async(e,t,r=!1,o=[])=>{let n=e.addressCache?.("all",r),a=await g(e,t,r??!1,o)??await se(e,t,r??!0,o);return n?.set(t,a?new WeakRef(a):null),a},"resolveAddressToInstanceAll"),N=s(async(e,t,r=!1,o=[],n="all")=>{switch(n){case"all":return await ke(e,t,r,o);case"up":return await se(e,t,r??!0,o);case"down":return await g(e,t,r??!1,o)}},"resolveAddressToInstance");var qe=require("@xylabs/assert"),Ee=require("@xylabs/exists"),_e=require("@xylabs/hex"),le=require("@xylabs/logger"),De=require("@xylabs/object");var m=class{static{s(this,"ResolveHelperStatic")}static defaultLogger;static transformers=[]};var Re=require("@xylabs/assert"),Ne=require("@xylabs/hex");var S=s(async(e,t)=>(await e.parents?.()??[]).find(o=>o.config.name===t),"resolveLocalNameToInstanceUp"),I=s(async(e,t,r=!1)=>{let o=(r?await e.privateChildren?.():[])??[],n=await e.publicChildren?.()??[];return[...o,...n].find(c=>c.config.name===t)},"resolveLocalNameToInstanceDown"),$=s(async(e,t,r=!1)=>await I(e,t,r)??await S(e,t),"resolveLocalNameToInstanceAll"),ne=s(async(e,t,r=!1,o="all")=>{switch(o){case"all":return await $(e,t,r);case"up":return await S(e,t);case"down":return await I(e,t,r)}},"resolveLocalNameToInstance");var jt=s(async(e,t)=>(await S(e,t))?.address,"resolveLocalNameToAddressUp"),Ft=s(async(e,t,r=!1)=>(await I(e,t,r))?.address,"resolveLocalNameToAddressDown"),Ot=s(async(e,t,r=!1)=>(await $(e,t,r))?.address,"resolveLocalNameToAddressAll"),ae=s(async(e,t,r=!1,o="all")=>(await ne(e,t,r,o))?.address,"resolveLocalNameToAddress");var A=s(async(e,t)=>{let r=e;for(let o of t)r=await o.transform(e);return r},"transformModuleIdentifier");var q=s(async(e,t,r=!1,o=m.transformers)=>{let n=t.split(R),a=await A((0,Re.assertEx)(n.shift(),()=>`First part is invalid [${t}]`),o);if(!a)return;let c=(0,Ne.asAddress)(a)??await ae(e,a,r);if(c){let i=await N(e,c,r);return i&&n.length>0?q(i,n.join(R)):i}},"resolvePathToInstance");var ce=s(async(e,t,r=!1,o=m.transformers)=>(await q(e,t,r,o))?.address,"resolvePathToAddress");var $e=require("@xylabs/assert");var ie=s(async(e,t)=>{let r=t.split(":"),o=r.shift(),n=v((0,$e.assertEx)(await e.resolve(o,{maxDepth:1}),()=>`Failed to resolve [${o}]`),()=>`Resolved invalid module instance [${o}]`);return n?r.length>0?[n.address,...await ie(n,r.join(":"))]:[n.address]:[]},"traceModuleIdentifier");var de=class e extends m{static{s(this,"ResolveHelper")}static async resolve(t,r="*",{maxDepth:o=3,required:n="log",...a}={}){let{transformers:c,module:i,logger:d=this.defaultLogger,dead:f=!1,upResolver:E,downResolver:_,privateResolver:He}=t,C=d?new le.IdLogger(d,()=>`ResolveHelper [${i.id}][${r}]`):void 0,L={...a,direction:"down",maxDepth:o,required:!1},T={...L,direction:"up"},Qe={...a,maxDepth:o-1,required:!1},j=a?.direction??"all",F=j==="up"||j==="all",fe=j==="down"||j==="all",b;if(C?.debug("start",r,o),r==="*"){if(f)return C?.warn("failed [dead]",r),[];let u=[...fe?await _.resolve("*",L):[],...F?await E.resolve("*",T):[]].filter(M).filter(p=>p.address!==t.address);if(u.length>0&&(C?.log("modules [count]",u.length),C?.debug("modules",(0,De.toJsonString)(u,4))),o===0)return u;let D=(await Promise.all(u.map(async p=>await p.resolve("*",Qe)))).flat().filter(M);return[...u,...D].filter(M)}else switch(typeof r){case"string":{if(f)return;let u=await ce(i,r,!1,c)??r;if(u){let D=[[_,L],[F?E:void 0,T],[F?He:void 0,T]].filter(([p])=>(0,Ee.exists)(p));for(let p of D){let[Ue]=p;b||(b=await this.resolveModuleIdentifier(Ue,u))}}break}default:{if(f)return[];let u=r;b=[...fe?await _.resolve(u,L):[],...F?await E.resolve(u,T):[]].filter(M);break}}return this.validateRequiredResolve(n,b,r,d),b}static async resolveModuleIdentifier(t,r,o){let n=r.split(":"),a=n.shift(),c=(0,_e.isAddress)(a),i=await t.resolve(a,{maxDepth:c?10:1})??(a?await t.resolvePrivate(a,{maxDepth:c?10:1}):void 0),d=o?(0,qe.assertEx)(i,()=>`Failed to resolve [${a}] [${c}]`):i,f=v(d,()=>`Resolved invalid module instance [${a}]`);if(f)return n.length>0?await this.resolveModuleIdentifier(f,n.join(":")):f}static traceModuleIdentifier(t,r){return ie(t,r)}static transformModuleIdentifier(t,r=e.transformers){return A(t,r)}static validateRequiredResolve(t,r,o,n=this.defaultLogger){let a=n?new le.IdLogger(n,()=>`validateRequiredResolve [${o}][${r}]`):void 0;if(t&&(r===void 0||Array.isArray(r)&&r.length>0))switch(t){case"warn":{a?.warn("resolve failed",o);break}case"log":{a?.log("resolve failed",o);break}default:throw new Error(`resolve failed [${o}]`)}}};var ue={create:s(e=>(t,r)=>e(t)?r(t):void 0,"create")},kt=ue.create(h),Rt=ue.create(w);
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  AddressChildSchema: () => AddressChildSchema,
+  AddressPreviousHashSchema: () => AddressPreviousHashSchema,
+  AddressSchema: () => AddressSchema,
+  DeadModuleError: () => DeadModuleError,
+  DisallowedModuleIdentifierCharacters: () => DisallowedModuleIdentifierCharacters,
+  IsAttachableModuleInstanceFactory: () => IsAttachableModuleInstanceFactory,
+  IsInstanceFactory: () => IsInstanceFactory,
+  IsModuleFactory: () => IsModuleFactory,
+  MODULE_PATH_SEPARATOR: () => MODULE_PATH_SEPARATOR,
+  ModuleAddressQuerySchema: () => ModuleAddressQuerySchema,
+  ModuleConfigSchema: () => ModuleConfigSchema,
+  ModuleDescriptionSchema: () => ModuleDescriptionSchema,
+  ModuleDetailsError: () => ModuleDetailsError,
+  ModuleFactory: () => ModuleFactory,
+  ModuleLimitationLabelName: () => ModuleLimitationLabelName,
+  ModuleLimitationViewLabel: () => ModuleLimitationViewLabel,
+  ModuleManifestQuerySchema: () => ModuleManifestQuerySchema,
+  ModuleStateQuerySchema: () => ModuleStateQuerySchema,
+  ModuleStateSchema: () => ModuleStateSchema,
+  ModuleSubscribeQuerySchema: () => ModuleSubscribeQuerySchema,
+  ObjectResolverPriority: () => ObjectResolverPriority,
+  ReservedModuleIdentifierCharacters: () => ReservedModuleIdentifierCharacters,
+  ResolveHelper: () => ResolveHelper,
+  WithFactory: () => WithFactory,
+  asAttachableModuleInstance: () => asAttachableModuleInstance,
+  asModule: () => asModule,
+  asModuleInstance: () => asModuleInstance,
+  asModuleObject: () => asModuleObject,
+  assignCreatableModuleRegistry: () => assignCreatableModuleRegistry,
+  creatableModule: () => creatableModule,
+  creatableModuleFactory: () => creatableModuleFactory,
+  duplicateModules: () => duplicateModules,
+  hasAllLabels: () => hasAllLabels,
+  hasLabels: () => hasLabels,
+  includesReservedModuleIdentifierCharacter: () => includesReservedModuleIdentifierCharacter,
+  isAddressModuleFilter: () => isAddressModuleFilter,
+  isAddressObjectFilter: () => isAddressObjectFilter,
+  isAttachableModuleInstance: () => isAttachableModuleInstance,
+  isModule: () => isModule,
+  isModuleIdentifierPart: () => isModuleIdentifierPart,
+  isModuleInstance: () => isModuleInstance,
+  isModuleName: () => isModuleName,
+  isModuleObject: () => isModuleObject,
+  isModuleResolver: () => isModuleResolver,
+  isModuleState: () => isModuleState,
+  isModuleStateWithMeta: () => isModuleStateWithMeta,
+  isNameModuleFilter: () => isNameModuleFilter,
+  isNameObjectFilter: () => isNameObjectFilter,
+  isObjectResolver: () => isObjectResolver,
+  isQueryModuleFilter: () => isQueryModuleFilter,
+  isQueryObjectFilter: () => isQueryObjectFilter,
+  labeledCreatableModuleFactory: () => labeledCreatableModuleFactory,
+  registerCreatableModuleFactories: () => registerCreatableModuleFactories,
+  registerCreatableModuleFactory: () => registerCreatableModuleFactory,
+  requiredAttachableModuleInstanceFunctions: () => requiredAttachableModuleInstanceFunctions,
+  requiredModuleInstanceFunctions: () => requiredModuleInstanceFunctions,
+  requiredModuleQueries: () => requiredModuleQueries,
+  requiredModuleShape: () => requiredModuleShape,
+  resolveAddressToInstance: () => resolveAddressToInstance,
+  resolveAddressToInstanceAll: () => resolveAddressToInstanceAll,
+  resolveAddressToInstanceDown: () => resolveAddressToInstanceDown,
+  resolveAddressToInstanceSiblings: () => resolveAddressToInstanceSiblings,
+  resolveAddressToInstanceUp: () => resolveAddressToInstanceUp,
+  resolveLocalNameToAddress: () => resolveLocalNameToAddress,
+  resolveLocalNameToAddressAll: () => resolveLocalNameToAddressAll,
+  resolveLocalNameToAddressDown: () => resolveLocalNameToAddressDown,
+  resolveLocalNameToAddressUp: () => resolveLocalNameToAddressUp,
+  resolveLocalNameToInstance: () => resolveLocalNameToInstance,
+  resolveLocalNameToInstanceAll: () => resolveLocalNameToInstanceAll,
+  resolveLocalNameToInstanceDown: () => resolveLocalNameToInstanceDown,
+  resolveLocalNameToInstanceUp: () => resolveLocalNameToInstanceUp,
+  resolvePathToAddress: () => resolvePathToAddress,
+  resolvePathToInstance: () => resolvePathToInstance,
+  serializable: () => serializable,
+  serializableField: () => serializableField,
+  transformModuleIdentifier: () => transformModuleIdentifier,
+  withModule: () => withModule,
+  withModuleInstance: () => withModuleInstance
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/Config/Config.ts
+var ModuleConfigSchema = "network.xyo.module.config";
+
+// src/CreatableModule/CreatableModule.ts
+function creatableModule() {
+  return (constructor) => {
+    constructor;
+  };
+}
+__name(creatableModule, "creatableModule");
+function creatableModuleFactory() {
+  return (constructor) => {
+    constructor;
+  };
+}
+__name(creatableModuleFactory, "creatableModuleFactory");
+
+// src/CreatableModule/CreatableModuleRegistry.ts
+var buildModuleFactory = /* @__PURE__ */ __name((mod, labels) => {
+  const factory5 = {
+    // Destructure instance properties
+    ...mod,
+    configSchemas: mod.configSchemas,
+    // Copy static methods
+    create: mod.create.bind(mod),
+    defaultConfigSchema: mod.defaultConfigSchema,
+    // Merge module & supplied labels
+    labels: {
+      ...mod.labels,
+      ...labels
+    }
+  };
+  return factory5;
+}, "buildModuleFactory");
+var registerCreatableModuleFactory = /* @__PURE__ */ __name((registry, factory5, labels, primary = false) => {
+  const isPrimaryForSchema = /* @__PURE__ */ __name((schema) => {
+    switch (typeof primary) {
+      case "boolean": {
+        return primary;
+      }
+      case "string": {
+        return schema === primary;
+      }
+      case "object": {
+        if (Array.isArray(primary)) {
+          return primary.includes(schema);
+        }
+      }
+    }
+    throw new Error(`Invalid primary value: ${primary}`);
+  }, "isPrimaryForSchema");
+  const factoryClone = buildModuleFactory(factory5, labels);
+  registry[factory5.defaultConfigSchema] = [
+    factoryClone,
+    ...registry[factoryClone.defaultConfigSchema] ?? []
+  ];
+  for (const schema of factoryClone.configSchemas) {
+    registry[schema] = isPrimaryForSchema(schema) ? [
+      factoryClone,
+      ...registry[schema] ?? []
+    ] : [
+      ...registry[schema] ?? [],
+      factoryClone
+    ];
+  }
+}, "registerCreatableModuleFactory");
+var registerCreatableModuleFactories = /* @__PURE__ */ __name((factories, registry = {}, primary = false) => {
+  for (const factory5 of factories) {
+    registerCreatableModuleFactory(registry, factory5, void 0, primary);
+  }
+  return registry;
+}, "registerCreatableModuleFactories");
+var assignCreatableModuleRegistry = /* @__PURE__ */ __name((target = {}, ...sources) => {
+  sources.map((source) => Object.entries(source).map(([schema, factories]) => {
+    if (factories) {
+      const existingFactories = target[schema];
+      target[schema] = existingFactories ? target[schema] = [
+        ...existingFactories,
+        ...factories
+      ] : factories;
+    }
+  }));
+  return target;
+}, "assignCreatableModuleRegistry");
+
+// src/CreatableModule/LabeledCreatableModuleFactory.ts
+var hasLabels = /* @__PURE__ */ __name((factory5) => {
+  return factory5.labels !== void 0;
+}, "hasLabels");
+function labeledCreatableModuleFactory() {
+  return (constructor) => {
+    constructor;
+  };
+}
+__name(labeledCreatableModuleFactory, "labeledCreatableModuleFactory");
+
+// src/CreatableModule/ModuleFactory.ts
+var import_assert = require("@xylabs/assert");
+var import_lodash = require("@xylabs/lodash");
+var ModuleFactory = class _ModuleFactory {
+  static {
+    __name(this, "ModuleFactory");
+  }
+  configSchemas;
+  creatableModule;
+  defaultConfigSchema;
+  defaultLogger;
+  defaultParams;
+  labels;
+  constructor(creatableModule2, params, labels = {}) {
+    this.creatableModule = creatableModule2;
+    this.defaultParams = params;
+    this.configSchemas = creatableModule2.configSchemas;
+    this.defaultConfigSchema = creatableModule2.defaultConfigSchema;
+    (0, import_assert.assertEx)(this.configSchemas.includes(this.defaultConfigSchema), () => "defaultConfigSchema must be in configSchemas");
+    this.labels = Object.assign({}, creatableModule2.labels ?? {}, labels ?? {});
+  }
+  static withParams(creatableModule2, params, labels = {}) {
+    return new _ModuleFactory(creatableModule2, params, labels);
+  }
+  _getRootFunction(funcName) {
+    let anyThis = this;
+    while (anyThis.__proto__[funcName]) {
+      anyThis = anyThis.__proto__;
+    }
+    return anyThis[funcName];
+  }
+  _noOverride(functionName) {
+    const thisFunc = this[functionName];
+    const rootFunc = this._getRootFunction(functionName);
+    (0, import_assert.assertEx)(thisFunc === rootFunc, () => `Override not allowed for [${functionName}] - override ${functionName}Handler instead`);
+  }
+  create(params) {
+    const factory5 = this;
+    const schema = factory5.creatableModule.defaultConfigSchema;
+    const mergedParams = (0, import_lodash.merge)({}, factory5.defaultParams, params, {
+      config: (0, import_lodash.merge)({}, factory5.defaultParams?.config, params?.config, {
+        schema
+      })
+    });
+    return factory5.creatableModule.create(mergedParams);
+  }
+  factory(_params) {
+    throw new Error("Method not implemented.");
+  }
+};
+
+// src/DetailsError.ts
+var ModuleDetailsError = class extends Error {
+  static {
+    __name(this, "ModuleDetailsError");
+  }
+  details;
+  constructor(message, details) {
+    super(message);
+    this.details = details;
+    this.name = "ModuleError";
+  }
+};
+
+// src/instance/asModuleInstance.ts
+var import_object5 = require("@xylabs/object");
+
+// src/instance/isModuleInstance.ts
+var import_object4 = require("@xylabs/object");
+
+// src/module/asModule.ts
+var import_object3 = require("@xylabs/object");
+
+// src/Queries/Manifest.ts
+var ModuleManifestQuerySchema = "network.xyo.query.module.manifest";
+
+// src/Queries/ModuleAddress/Query.ts
+var ModuleAddressQuerySchema = "network.xyo.query.module.address";
+
+// src/Queries/State.ts
+var ModuleStateQuerySchema = "network.xyo.query.module.state";
+
+// src/Queries/Subscribe.ts
+var ModuleSubscribeQuerySchema = "network.xyo.query.module.subscribe";
+
+// src/module/asModuleObject.ts
+var import_object2 = require("@xylabs/object");
+
+// src/module/isModuleObject.ts
+var import_object = require("@xylabs/object");
+var requiredModuleShape = {
+  address: "string",
+  queries: "array",
+  query: "function"
+};
+var factory = new import_object.IsObjectFactory();
+var isModuleObject = factory.create(requiredModuleShape);
+
+// src/module/asModuleObject.ts
+var asModuleObject = import_object2.AsObjectFactory.create(isModuleObject);
+
+// src/module/IsModuleFactory.ts
+var IsModuleFactory = class {
+  static {
+    __name(this, "IsModuleFactory");
+  }
+  create(expectedQueries, additionalChecks) {
+    return (obj, config) => {
+      const module2 = asModuleObject(obj);
+      const result = isModuleObject(module2, config) && (expectedQueries?.reduce((prev, query) => prev && module2.queries.includes(query), true) ?? true) && //perform additional checks
+      (additionalChecks?.reduce((prev, check) => prev && check(obj, config), true) ?? true);
+      return result;
+    };
+  }
+};
+
+// src/module/isModule.ts
+var requiredModuleQueries = [
+  ModuleStateQuerySchema
+];
+var factory2 = new IsModuleFactory();
+var isModule = factory2.create(requiredModuleQueries, [
+  isModuleObject
+]);
+
+// src/module/asModule.ts
+var asModule = import_object3.AsObjectFactory.create(isModule);
+
+// src/instance/isModuleInstance.ts
+var requiredModuleInstanceFunctions = {
+  manifest: "function",
+  state: "function"
+};
+var factory3 = new import_object4.IsObjectFactory();
+var isModuleInstance = factory3.create(requiredModuleInstanceFunctions, [
+  isModule
+]);
+
+// src/instance/asModuleInstance.ts
+var asModuleInstance = import_object5.AsObjectFactory.create(isModuleInstance);
+
+// src/instance/attachable/asAttachableInstance.ts
+var import_object7 = require("@xylabs/object");
+
+// src/instance/attachable/isAttachableInstance.ts
+var import_object6 = require("@xylabs/object");
+var requiredAttachableModuleInstanceFunctions = {
+  downResolver: "object",
+  upResolver: "object"
+};
+var factory4 = new import_object6.IsObjectFactory();
+var isAttachableModuleInstance = factory4.create(requiredAttachableModuleInstanceFunctions, [
+  isModuleInstance
+]);
+
+// src/instance/attachable/asAttachableInstance.ts
+var asAttachableModuleInstance = import_object7.AsObjectFactory.create(isAttachableModuleInstance);
+
+// src/instance/attachable/AttachableInstance.ts
+var import_object8 = require("@xylabs/object");
+var IsAttachableModuleInstanceFactory = class extends import_object8.IsObjectFactory {
+  static {
+    __name(this, "IsAttachableModuleInstanceFactory");
+  }
+};
+
+// src/instance/Instance.ts
+var import_object9 = require("@xylabs/object");
+var DeadModuleError = class _DeadModuleError extends Error {
+  static {
+    __name(this, "DeadModuleError");
+  }
+  id;
+  error;
+  constructor(id, error, msg = "Dead Module Error") {
+    super(`${msg} [${id}]: ${error?.message ?? (0, import_object9.toJsonString)(error)}`);
+    this.id = id;
+    this.error = error;
+    Object.setPrototypeOf(this, _DeadModuleError.prototype);
+  }
+};
+var IsInstanceFactory = class extends import_object9.IsObjectFactory {
+  static {
+    __name(this, "IsInstanceFactory");
+  }
+};
+
+// src/instance/ObjectFilter.ts
+var isAddressObjectFilter = /* @__PURE__ */ __name((value) => value.address !== void 0, "isAddressObjectFilter");
+var isNameObjectFilter = /* @__PURE__ */ __name((value) => value.name !== void 0, "isNameObjectFilter");
+var isQueryObjectFilter = /* @__PURE__ */ __name((value) => value.query !== void 0, "isQueryObjectFilter");
+
+// src/instance/ModuleFilter.ts
+var isAddressModuleFilter = isAddressObjectFilter;
+var isNameModuleFilter = isNameObjectFilter;
+var isQueryModuleFilter = isQueryObjectFilter;
+
+// src/instance/ObjectResolver.ts
+var isObjectResolver = /* @__PURE__ */ __name((value) => {
+  return typeof value.resolve === "function";
+}, "isObjectResolver");
+var ObjectResolverPriority;
+(function(ObjectResolverPriority2) {
+  ObjectResolverPriority2[ObjectResolverPriority2["Disabled"] = -1] = "Disabled";
+  ObjectResolverPriority2[ObjectResolverPriority2["VeryLow"] = 0] = "VeryLow";
+  ObjectResolverPriority2[ObjectResolverPriority2["Low"] = 1] = "Low";
+  ObjectResolverPriority2[ObjectResolverPriority2["Normal"] = 2] = "Normal";
+  ObjectResolverPriority2[ObjectResolverPriority2["High"] = 3] = "High";
+  ObjectResolverPriority2[ObjectResolverPriority2["VeryHigh"] = 4] = "VeryHigh";
+})(ObjectResolverPriority || (ObjectResolverPriority = {}));
+
+// src/instance/ModuleResolver.ts
+var isModuleResolver = isObjectResolver;
+
+// src/Labels/Labels.ts
+var hasAllLabels = /* @__PURE__ */ __name((source, required) => {
+  if (!required) return true;
+  return Object.entries(required).every(([key, value]) => {
+    return source?.hasOwnProperty(key) && source?.[key] === value;
+  });
+}, "hasAllLabels");
+
+// src/Labels/standard/View.ts
+var ModuleLimitationLabelName = "network.xyo.module.limitation";
+var ModuleLimitationViewLabel = {
+  ModuleLimitationLabelName: "view"
+};
+
+// src/lib/duplicateModules.ts
+var duplicateModules = /* @__PURE__ */ __name((value, index, array) => {
+  return array.findIndex((v) => v.address === value.address) === index;
+}, "duplicateModules");
+
+// src/lib/serializable.ts
+var import_lodash2 = require("@xylabs/lodash");
+var JSONPrimitiveChecks = [
+  import_lodash2.isUndefined,
+  import_lodash2.isNull,
+  import_lodash2.isBoolean,
+  import_lodash2.isNumber,
+  import_lodash2.isString
+];
+var JSONComplexChecks = [
+  import_lodash2.isPlainObject,
+  import_lodash2.isArray
+];
+var serializable = /* @__PURE__ */ __name((field, depth) => {
+  let depthExceeded = false;
+  const decrementDepth = /* @__PURE__ */ __name(() => depth ? depth-- : void 0, "decrementDepth");
+  const recursiveSerializable = /* @__PURE__ */ __name((field2) => {
+    if (depth !== void 0 && depth < 1) {
+      depthExceeded = true;
+      return false;
+    }
+    decrementDepth();
+    const nestedSerializable = /* @__PURE__ */ __name((field3) => (0, import_lodash2.overSome)(JSONComplexChecks)(field3) && (0, import_lodash2.every)(field3, recursiveSerializable), "nestedSerializable");
+    return (0, import_lodash2.overSome)([
+      ...JSONPrimitiveChecks,
+      nestedSerializable
+    ])(field2);
+  }, "recursiveSerializable");
+  const valid = recursiveSerializable(field);
+  return depthExceeded ? null : valid;
+}, "serializable");
+var serializableField = /* @__PURE__ */ __name((field) => {
+  return (0, import_lodash2.overSome)([
+    ...JSONPrimitiveChecks,
+    ...JSONComplexChecks
+  ])(field);
+}, "serializableField");
+
+// src/ModuleIdentifier.ts
+var import_hex = require("@xylabs/hex");
+var MODULE_PATH_SEPARATOR = ":";
+var DisallowedModuleIdentifierCharacters = {
+  " ": true,
+  "!": true,
+  '"': true,
+  "#": true,
+  $: true,
+  "%": true,
+  "&": true,
+  "'": true,
+  "(": true,
+  ")": true,
+  "*": true,
+  ",": true,
+  ".": true,
+  "/": true,
+  ":": true,
+  ";": true,
+  "<": true,
+  "=": true,
+  ">": true,
+  "?": true,
+  "@": true,
+  "[": true,
+  "]": true,
+  "^": true,
+  _: true,
+  "{": true,
+  "|": true,
+  "}": true,
+  "~": true
+};
+var ReservedModuleIdentifierCharacters = new Set(Object.keys(DisallowedModuleIdentifierCharacters));
+var isModuleName = /* @__PURE__ */ __name((value) => {
+  return typeof value === "string" && !(0, import_hex.isAddress)(value) && !includesReservedModuleIdentifierCharacter(value);
+}, "isModuleName");
+var includesReservedModuleIdentifierCharacter = /* @__PURE__ */ __name((value) => {
+  return typeof value === "string" && [
+    ...value
+  ].some((char) => ReservedModuleIdentifierCharacters.has(char));
+}, "includesReservedModuleIdentifierCharacter");
+var isModuleIdentifierPart = /* @__PURE__ */ __name((value) => {
+  return isModuleName(value) || (0, import_hex.isAddress)(value);
+}, "isModuleIdentifierPart");
+
+// src/Payload/Address.ts
+var AddressSchema = "network.xyo.address";
+var AddressChildSchema = "network.xyo.address.child";
+
+// src/Payload/AddressPreviousHash.ts
+var AddressPreviousHashSchema = "network.xyo.address.hash.previous";
+
+// src/Payload/Description.ts
+var ModuleDescriptionSchema = "network.xyo.module.description";
+
+// src/Payload/ModuleState.ts
+var import_payload_model = require("@xyo-network/payload-model");
+var ModuleStateSchema = "network.xyo.module.state";
+var isModuleState = /* @__PURE__ */ __name((payload) => {
+  return (0, import_payload_model.isPayloadOfSchemaType)(ModuleStateSchema)(payload);
+}, "isModuleState");
+var isModuleStateWithMeta = /* @__PURE__ */ __name((payload) => {
+  return (0, import_payload_model.isPayloadOfSchemaType)(ModuleStateSchema)(payload);
+}, "isModuleStateWithMeta");
+
+// src/ResolveHelper/resolveAddressToInstance.ts
+var resolveAddressToInstanceDown = /* @__PURE__ */ __name(async (root, address, includePrivate = false, ignore = []) => {
+  if (root.address === address) {
+    return root;
+  }
+  const cache = root.addressCache?.("up", includePrivate);
+  const privateChildren = (includePrivate ? await root.privateChildren?.() : []) ?? [];
+  const publicChildren = await root.publicChildren?.() ?? [];
+  const children = [
+    ...privateChildren,
+    ...publicChildren
+  ];
+  for (const child of children) {
+    const found = await resolveAddressToInstanceDown(child, address, includePrivate, ignore);
+    if (found) {
+      cache?.set(address, new WeakRef(found));
+      return found;
+    }
+  }
+  cache?.set(address, null);
+}, "resolveAddressToInstanceDown");
+var resolveAddressToInstanceSiblings = /* @__PURE__ */ __name(async (root, address, includePrivate = false, ignore = []) => {
+  const siblings = await root.siblings?.() ?? [];
+  for (const sibling of siblings) {
+    const found = await resolveAddressToInstanceDown(sibling, address, includePrivate, ignore);
+    if (found) {
+      return found;
+    }
+  }
+}, "resolveAddressToInstanceSiblings");
+var resolveAddressToInstanceUp = /* @__PURE__ */ __name(async (root, address, includePrivate = false, ignore = []) => {
+  const cache = root.addressCache?.("up", includePrivate);
+  const parents = await root.parents?.() ?? [];
+  for (const parent of parents) {
+    const found = await resolveAddressToInstance(parent, address, includePrivate, ignore);
+    if (found) {
+      cache?.set(address, new WeakRef(found));
+      return found;
+    }
+  }
+  cache?.set(address, null);
+}, "resolveAddressToInstanceUp");
+var resolveAddressToInstanceAll = /* @__PURE__ */ __name(async (root, address, includePrivate = false, ignore = []) => {
+  const cache = root.addressCache?.("all", includePrivate);
+  const result = await resolveAddressToInstanceDown(root, address, includePrivate ?? false, ignore) ?? await resolveAddressToInstanceUp(root, address, includePrivate ?? true, ignore);
+  cache?.set(address, result ? new WeakRef(result) : null);
+  return result;
+}, "resolveAddressToInstanceAll");
+var resolveAddressToInstance = /* @__PURE__ */ __name(async (root, address, includePrivate = false, ignore = [], direction = "all") => {
+  switch (direction) {
+    case "all": {
+      return await resolveAddressToInstanceAll(root, address, includePrivate, ignore);
+    }
+    case "up": {
+      return await resolveAddressToInstanceUp(root, address, includePrivate ?? true, ignore);
+    }
+    case "down": {
+      return await resolveAddressToInstanceDown(root, address, includePrivate ?? false, ignore);
+    }
+  }
+}, "resolveAddressToInstance");
+
+// src/ResolveHelper/ResolveHelper.ts
+var import_assert4 = require("@xylabs/assert");
+var import_exists = require("@xylabs/exists");
+var import_hex3 = require("@xylabs/hex");
+var import_logger = require("@xylabs/logger");
+var import_object10 = require("@xylabs/object");
+
+// src/ResolveHelper/ResolveHelperStatic.ts
+var ResolveHelperStatic = class {
+  static {
+    __name(this, "ResolveHelperStatic");
+  }
+  static defaultLogger;
+  static transformers = [];
+};
+
+// src/ResolveHelper/resolvePathToInstance.ts
+var import_assert2 = require("@xylabs/assert");
+var import_hex2 = require("@xylabs/hex");
+
+// src/ResolveHelper/resolveLocalNameToInstance.ts
+var resolveLocalNameToInstanceUp = /* @__PURE__ */ __name(async (root, modName) => {
+  const parents = await root.parents?.() ?? [];
+  return parents.find((parent) => parent.config.name === modName);
+}, "resolveLocalNameToInstanceUp");
+var resolveLocalNameToInstanceDown = /* @__PURE__ */ __name(async (root, modName, includePrivate = false) => {
+  const privateChildren = (includePrivate ? await root.privateChildren?.() : []) ?? [];
+  const publicChildren = await root.publicChildren?.() ?? [];
+  const children = [
+    ...privateChildren,
+    ...publicChildren
+  ];
+  return children.find((child) => child.config.name === modName);
+}, "resolveLocalNameToInstanceDown");
+var resolveLocalNameToInstanceAll = /* @__PURE__ */ __name(async (root, modName, includePrivate = false) => {
+  return await resolveLocalNameToInstanceDown(root, modName, includePrivate) ?? await resolveLocalNameToInstanceUp(root, modName);
+}, "resolveLocalNameToInstanceAll");
+var resolveLocalNameToInstance = /* @__PURE__ */ __name(async (root, modName, includePrivate = false, direction = "all") => {
+  switch (direction) {
+    case "all": {
+      return await resolveLocalNameToInstanceAll(root, modName, includePrivate);
+    }
+    case "up": {
+      return await resolveLocalNameToInstanceUp(root, modName);
+    }
+    case "down": {
+      return await resolveLocalNameToInstanceDown(root, modName, includePrivate);
+    }
+  }
+}, "resolveLocalNameToInstance");
+
+// src/ResolveHelper/resolveLocalNameToAddress.ts
+var resolveLocalNameToAddressUp = /* @__PURE__ */ __name(async (root, modName) => {
+  return (await resolveLocalNameToInstanceUp(root, modName))?.address;
+}, "resolveLocalNameToAddressUp");
+var resolveLocalNameToAddressDown = /* @__PURE__ */ __name(async (root, modName, includePrivate = false) => {
+  return (await resolveLocalNameToInstanceDown(root, modName, includePrivate))?.address;
+}, "resolveLocalNameToAddressDown");
+var resolveLocalNameToAddressAll = /* @__PURE__ */ __name(async (root, modName, includePrivate = false) => {
+  return (await resolveLocalNameToInstanceAll(root, modName, includePrivate))?.address;
+}, "resolveLocalNameToAddressAll");
+var resolveLocalNameToAddress = /* @__PURE__ */ __name(async (root, modName, includePrivate = false, direction = "all") => {
+  return (await resolveLocalNameToInstance(root, modName, includePrivate, direction))?.address;
+}, "resolveLocalNameToAddress");
+
+// src/ResolveHelper/transformModuleIdentifier.ts
+var transformModuleIdentifier = /* @__PURE__ */ __name(async (id, transformers) => {
+  let result = id;
+  for (const transformer of transformers) {
+    result = await transformer.transform(id);
+  }
+  return result;
+}, "transformModuleIdentifier");
+
+// src/ResolveHelper/resolvePathToInstance.ts
+var resolvePathToInstance = /* @__PURE__ */ __name(async (root, path, includePrivate = false, transformers = ResolveHelperStatic.transformers) => {
+  const parts = path.split(MODULE_PATH_SEPARATOR);
+  const first = await transformModuleIdentifier((0, import_assert2.assertEx)(parts.shift(), () => `First part is invalid [${path}]`), transformers);
+  if (!first) {
+    return void 0;
+  }
+  const firstAddress = (0, import_hex2.asAddress)(first) ?? await resolveLocalNameToAddress(root, first, includePrivate);
+  if (firstAddress) {
+    const firstModule = await resolveAddressToInstance(root, firstAddress, includePrivate);
+    if (firstModule && parts.length > 0) {
+      return resolvePathToInstance(firstModule, parts.join(MODULE_PATH_SEPARATOR));
+    }
+    return firstModule;
+  }
+}, "resolvePathToInstance");
+
+// src/ResolveHelper/resolvePathToAddress.ts
+var resolvePathToAddress = /* @__PURE__ */ __name(async (root, path, includePrivate = false, transformers = ResolveHelperStatic.transformers) => {
+  return (await resolvePathToInstance(root, path, includePrivate, transformers))?.address;
+}, "resolvePathToAddress");
+
+// src/ResolveHelper/traceModuleIdentifier.ts
+var import_assert3 = require("@xylabs/assert");
+var traceModuleIdentifier = /* @__PURE__ */ __name(async (resolver, path) => {
+  const parts = path.split(":");
+  const first = parts.shift();
+  const firstModule = asModuleInstance((0, import_assert3.assertEx)(await resolver.resolve(first, {
+    maxDepth: 1
+  }), () => `Failed to resolve [${first}]`), () => `Resolved invalid module instance [${first}]`);
+  if (firstModule) {
+    return parts.length > 0 ? [
+      firstModule.address,
+      ...await traceModuleIdentifier(firstModule, parts.join(":"))
+    ] : [
+      firstModule.address
+    ];
+  }
+  return [];
+}, "traceModuleIdentifier");
+
+// src/ResolveHelper/ResolveHelper.ts
+var ResolveHelper = class _ResolveHelper extends ResolveHelperStatic {
+  static {
+    __name(this, "ResolveHelper");
+  }
+  static async resolve(config, idOrFilter = "*", { maxDepth = 3, required = "log", ...options } = {}) {
+    const { transformers, module: module2, logger = this.defaultLogger, dead = false, upResolver, downResolver, privateResolver } = config;
+    const log = logger ? new import_logger.IdLogger(logger, () => `ResolveHelper [${module2.id}][${idOrFilter}]`) : void 0;
+    const downLocalOptions = {
+      ...options,
+      direction: "down",
+      maxDepth,
+      required: false
+    };
+    const upLocalOptions = {
+      ...downLocalOptions,
+      direction: "up"
+    };
+    const childOptions = {
+      ...options,
+      maxDepth: maxDepth - 1,
+      required: false
+    };
+    const direction = options?.direction ?? "all";
+    const up = direction === "up" || direction === "all";
+    const down = direction === "down" || direction === "all";
+    let result;
+    log?.debug("start", idOrFilter, maxDepth);
+    if (idOrFilter === "*") {
+      if (dead) {
+        log?.warn("failed [dead]", idOrFilter);
+        return [];
+      }
+      const modules = [
+        ...down ? await downResolver.resolve("*", downLocalOptions) : [],
+        ...up ? await upResolver.resolve("*", upLocalOptions) : []
+      ].filter(duplicateModules).filter((module3) => module3.address !== config.address);
+      if (modules.length > 0) {
+        log?.log("modules [count]", modules.length);
+        log?.debug("modules", (0, import_object10.toJsonString)(modules, 4));
+      }
+      if (maxDepth === 0) {
+        return modules;
+      }
+      const childModules = (await Promise.all(modules.map(async (module3) => await module3.resolve("*", childOptions)))).flat().filter(duplicateModules);
+      return [
+        ...modules,
+        ...childModules
+      ].filter(duplicateModules);
+    } else {
+      switch (typeof idOrFilter) {
+        case "string": {
+          if (dead) {
+            return void 0;
+          }
+          const id = await resolvePathToAddress(module2, idOrFilter, false, transformers) ?? idOrFilter;
+          if (id) {
+            const resolvers = [
+              [
+                downResolver,
+                downLocalOptions
+              ],
+              [
+                up ? upResolver : void 0,
+                upLocalOptions
+              ],
+              [
+                up ? privateResolver : void 0,
+                upLocalOptions
+              ]
+            ].filter(([resolver]) => (0, import_exists.exists)(resolver));
+            for (const resolver of resolvers) {
+              const [resolverInstance] = resolver;
+              if (!result) {
+                result = await this.resolveModuleIdentifier(resolverInstance, id);
+              }
+            }
+          }
+          break;
+        }
+        default: {
+          if (dead) {
+            return [];
+          }
+          const filter = idOrFilter;
+          result = [
+            ...down ? await downResolver.resolve(filter, downLocalOptions) : [],
+            ...up ? await upResolver.resolve(filter, upLocalOptions) : []
+          ].filter(duplicateModules);
+          break;
+        }
+      }
+    }
+    this.validateRequiredResolve(required, result, idOrFilter, logger);
+    return result;
+  }
+  //resolves a complex module path to addresses
+  static async resolveModuleIdentifier(resolver, path, required) {
+    const parts = path.split(":");
+    const first = parts.shift();
+    const firstIsAddress = (0, import_hex3.isAddress)(first);
+    const resolvedModule = await resolver.resolve(first, {
+      maxDepth: firstIsAddress ? 10 : 1
+    }) ?? (first ? await resolver.resolvePrivate(first, {
+      maxDepth: firstIsAddress ? 10 : 1
+    }) : void 0);
+    const finalModule = required ? (0, import_assert4.assertEx)(resolvedModule, () => `Failed to resolve [${first}] [${firstIsAddress}]`) : resolvedModule;
+    const firstModule = asModuleInstance(finalModule, () => `Resolved invalid module instance [${first}]`);
+    if (firstModule) {
+      return parts.length > 0 ? await this.resolveModuleIdentifier(firstModule, parts.join(":")) : firstModule;
+    }
+  }
+  //translates a complex module path to addresses
+  static traceModuleIdentifier(resolver, path) {
+    return traceModuleIdentifier(resolver, path);
+  }
+  static transformModuleIdentifier(identifier, transformers = _ResolveHelper.transformers) {
+    return transformModuleIdentifier(identifier, transformers);
+  }
+  static validateRequiredResolve(required, result, idOrFilter, logger = this.defaultLogger) {
+    const log = logger ? new import_logger.IdLogger(logger, () => `validateRequiredResolve [${idOrFilter}][${result}]`) : void 0;
+    if (required && (result === void 0 || Array.isArray(result) && result.length > 0)) {
+      switch (required) {
+        case "warn": {
+          log?.warn("resolve failed", idOrFilter);
+          break;
+        }
+        case "log": {
+          log?.log("resolve failed", idOrFilter);
+          break;
+        }
+        default: {
+          throw new Error(`resolve failed [${idOrFilter}]`);
+        }
+      }
+    }
+  }
+};
+
+// src/withModule.ts
+var WithFactory = {
+  create: /* @__PURE__ */ __name((typeCheck) => {
+    return (module2, closure) => {
+      return typeCheck(module2) ? closure(module2) : void 0;
+    };
+  }, "create")
+};
+var withModule = WithFactory.create(isModule);
+var withModuleInstance = WithFactory.create(isModuleInstance);
 //# sourceMappingURL=index.cjs.map