@xyo-network/module-model 2.99.2 → 2.99.3

package/dist/neutral/index.cjs

@@ -0,0 +1,785 @@
+"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, {
+  AddressPreviousHashSchema: () => AddressPreviousHashSchema,
+  DeadModuleError: () => DeadModuleError,
+  DisallowedModuleIdentifierCharacters: () => DisallowedModuleIdentifierCharacters,
+  IsAttachableModuleInstanceFactory: () => IsAttachableModuleInstanceFactory,
+  IsInstanceFactory: () => IsInstanceFactory,
+  IsModuleFactory: () => IsModuleFactory,
+  MODULE_PATH_SEPARATOR: () => MODULE_PATH_SEPARATOR,
+  ModuleAddressQuerySchema: () => ModuleAddressQuerySchema,
+  ModuleConfigSchema: () => ModuleConfigSchema,
+  ModuleDescriptionSchema: () => ModuleDescriptionSchema,
+  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,
+  resolveAddressToInstanceDown: () => resolveAddressToInstanceDown,
+  resolveAddressToInstanceSiblings: () => resolveAddressToInstanceSiblings,
+  resolveAddressToInstanceUp: () => resolveAddressToInstanceUp,
+  resolveLocalNameToAddress: () => resolveLocalNameToAddress,
+  resolveLocalNameToAddressDown: () => resolveLocalNameToAddressDown,
+  resolveLocalNameToAddressUp: () => resolveLocalNameToAddressUp,
+  resolvePathToAddress: () => resolvePathToAddress,
+  serializable: () => serializable,
+  serializableField: () => serializableField,
+  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/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/AddressPreviousHash.ts
+var import_address_payload_plugin = require("@xyo-network/address-payload-plugin");
+var AddressPreviousHashSchema = `${import_address_payload_plugin.AddressSchema}.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 resolveAddressToInstance = /* @__PURE__ */ __name(async (root, address, includePrivate = false, ignore = []) => {
+  const cache = root.addressCache?.("all", includePrivate);
+  const result = await resolveAddressToInstanceDown(root, address, includePrivate, ignore) ?? await resolveAddressToInstanceUp(root, address, includePrivate, ignore);
+  cache?.set(address, result ? new WeakRef(result) : null);
+  return result;
+}, "resolveAddressToInstance");
+
+// src/ResolveHelper/ResolveHelper.ts
+var import_assert3 = require("@xylabs/assert");
+var import_exists = require("@xylabs/exists");
+var import_hex2 = require("@xylabs/hex");
+var import_logger = require("@xylabs/logger");
+var import_object10 = require("@xylabs/object");
+
+// src/ResolveHelper/traceModuleIdentifier.ts
+var import_assert2 = require("@xylabs/assert");
+var traceModuleIdentifier = /* @__PURE__ */ __name(async (resolver, path) => {
+  const parts = path.split(":");
+  const first = parts.shift();
+  const firstModule = asModuleInstance((0, import_assert2.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/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/ResolveHelper.ts
+var ResolveHelper = class _ResolveHelper {
+  static {
+    __name(this, "ResolveHelper");
+  }
+  static defaultLogger;
+  static transformers = [];
+  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 this.transformModuleIdentifier(idOrFilter, transformers);
+          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_hex2.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_assert3.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/ResolveHelper/resolveLocalNameToAddress.ts
+var resolveLocalNameToAddressUp = /* @__PURE__ */ __name(async (root, localName) => {
+  const parents = await root.parents?.() ?? [];
+  return parents.find((parent) => parent.localName === localName)?.address;
+}, "resolveLocalNameToAddressUp");
+var resolveLocalNameToAddressDown = /* @__PURE__ */ __name(async (root, localName, includePrivate = false) => {
+  const privateChildren = (includePrivate ? await root.privateChildren?.() : []) ?? [];
+  const publicChildren = await root.publicChildren?.() ?? [];
+  const children = [
+    ...privateChildren,
+    ...publicChildren
+  ];
+  return children.find((child) => child.localName === localName)?.address;
+}, "resolveLocalNameToAddressDown");
+var resolveLocalNameToAddress = /* @__PURE__ */ __name(async (root, localName, includePrivate = false) => {
+  return await resolveLocalNameToAddressDown(root, localName, includePrivate) ?? await resolveLocalNameToAddressUp(root, localName);
+}, "resolveLocalNameToAddress");
+
+// src/ResolveHelper/resolvePathToAddress.ts
+var import_assert4 = require("@xylabs/assert");
+var import_hex3 = require("@xylabs/hex");
+var resolvePathToAddress = /* @__PURE__ */ __name(async (root, path, includePrivate = false, transformers = ResolveHelper.transformers) => {
+  const parts = path.split(MODULE_PATH_SEPARATOR);
+  const first = await transformModuleIdentifier((0, import_assert4.assertEx)(parts.shift(), () => `First part is invalid [${path}]`), transformers);
+  if (!first) {
+    return void 0;
+  }
+  const firstAddress = (0, import_hex3.asAddress)(first) ?? await resolveLocalNameToAddress(root, first, includePrivate);
+  if (firstAddress) {
+    const firstModule = await resolveAddressToInstance(root, firstAddress, includePrivate);
+    if (firstModule && parts.length > 0) {
+      return resolvePathToAddress(firstModule, parts.join(MODULE_PATH_SEPARATOR));
+    }
+    return firstAddress;
+  }
+}, "resolvePathToAddress");
+
+// src/withModule.ts
+var WithFactory = {
+  create: (typeCheck) => {
+    return (module2, closure) => {
+      return typeCheck(module2) ? closure(module2) : void 0;
+    };
+  }
+};
+var withModule = WithFactory.create(isModule);
+var withModuleInstance = WithFactory.create(isModuleInstance);
+//# sourceMappingURL=index.cjs.map