@xyo-network/module-model 2.99.1 → 2.99.3

package/dist/neutral/index.js

@@ -0,0 +1,764 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// 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
+import { assertEx } from "@xylabs/assert";
+import { merge } from "@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;
+    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);
+    assertEx(thisFunc === rootFunc, () => `Override not allowed for [${functionName}] - override ${functionName}Handler instead`);
+  }
+  create(params) {
+    const factory5 = this;
+    const schema = factory5.creatableModule.defaultConfigSchema;
+    const mergedParams = merge({}, factory5.defaultParams, params, {
+      config: merge({}, factory5.defaultParams?.config, params?.config, {
+        schema
+      })
+    });
+    return factory5.creatableModule.create(mergedParams);
+  }
+  factory(_params) {
+    throw new Error("Method not implemented.");
+  }
+};
+
+// src/instance/asModuleInstance.ts
+import { AsObjectFactory as AsObjectFactory3 } from "@xylabs/object";
+
+// src/instance/isModuleInstance.ts
+import { IsObjectFactory as IsObjectFactory2 } from "@xylabs/object";
+
+// src/module/asModule.ts
+import { AsObjectFactory as AsObjectFactory2 } from "@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
+import { AsObjectFactory } from "@xylabs/object";
+
+// src/module/isModuleObject.ts
+import { IsObjectFactory } from "@xylabs/object";
+var requiredModuleShape = {
+  address: "string",
+  queries: "array",
+  query: "function"
+};
+var factory = new IsObjectFactory();
+var isModuleObject = factory.create(requiredModuleShape);
+
+// src/module/asModuleObject.ts
+var asModuleObject = AsObjectFactory.create(isModuleObject);
+
+// src/module/IsModuleFactory.ts
+var IsModuleFactory = class {
+  static {
+    __name(this, "IsModuleFactory");
+  }
+  create(expectedQueries, additionalChecks) {
+    return (obj, config) => {
+      const module = asModuleObject(obj);
+      const result = isModuleObject(module, config) && (expectedQueries?.reduce((prev, query) => prev && module.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 = AsObjectFactory2.create(isModule);
+
+// src/instance/isModuleInstance.ts
+var requiredModuleInstanceFunctions = {
+  manifest: "function",
+  state: "function"
+};
+var factory3 = new IsObjectFactory2();
+var isModuleInstance = factory3.create(requiredModuleInstanceFunctions, [
+  isModule
+]);
+
+// src/instance/asModuleInstance.ts
+var asModuleInstance = AsObjectFactory3.create(isModuleInstance);
+
+// src/instance/attachable/asAttachableInstance.ts
+import { AsObjectFactory as AsObjectFactory4 } from "@xylabs/object";
+
+// src/instance/attachable/isAttachableInstance.ts
+import { IsObjectFactory as IsObjectFactory3 } from "@xylabs/object";
+var requiredAttachableModuleInstanceFunctions = {
+  downResolver: "object",
+  upResolver: "object"
+};
+var factory4 = new IsObjectFactory3();
+var isAttachableModuleInstance = factory4.create(requiredAttachableModuleInstanceFunctions, [
+  isModuleInstance
+]);
+
+// src/instance/attachable/asAttachableInstance.ts
+var asAttachableModuleInstance = AsObjectFactory4.create(isAttachableModuleInstance);
+
+// src/instance/attachable/AttachableInstance.ts
+import { IsObjectFactory as IsObjectFactory4 } from "@xylabs/object";
+var IsAttachableModuleInstanceFactory = class extends IsObjectFactory4 {
+  static {
+    __name(this, "IsAttachableModuleInstanceFactory");
+  }
+};
+
+// src/instance/Instance.ts
+import { IsObjectFactory as IsObjectFactory5, toJsonString } from "@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 ?? toJsonString(error)}`);
+    this.id = id;
+    this.error = error;
+    Object.setPrototypeOf(this, _DeadModuleError.prototype);
+  }
+};
+var IsInstanceFactory = class extends IsObjectFactory5 {
+  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
+import { every, isArray, isBoolean, isNull, isNumber, isPlainObject, isString, isUndefined, overSome } from "@xylabs/lodash";
+var JSONPrimitiveChecks = [
+  isUndefined,
+  isNull,
+  isBoolean,
+  isNumber,
+  isString
+];
+var JSONComplexChecks = [
+  isPlainObject,
+  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) => overSome(JSONComplexChecks)(field3) && every(field3, recursiveSerializable), "nestedSerializable");
+    return overSome([
+      ...JSONPrimitiveChecks,
+      nestedSerializable
+    ])(field2);
+  }, "recursiveSerializable");
+  const valid = recursiveSerializable(field);
+  return depthExceeded ? null : valid;
+}, "serializable");
+var serializableField = /* @__PURE__ */ __name((field) => {
+  return overSome([
+    ...JSONPrimitiveChecks,
+    ...JSONComplexChecks
+  ])(field);
+}, "serializableField");
+
+// src/ModuleIdentifier.ts
+import { isAddress } from "@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" && !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) || isAddress(value);
+}, "isModuleIdentifierPart");
+
+// src/Payload/AddressPreviousHash.ts
+import { AddressSchema } from "@xyo-network/address-payload-plugin";
+var AddressPreviousHashSchema = `${AddressSchema}.hash.previous`;
+
+// src/Payload/Description.ts
+var ModuleDescriptionSchema = "network.xyo.module.description";
+
+// src/Payload/ModuleState.ts
+import { isPayloadOfSchemaType } from "@xyo-network/payload-model";
+var ModuleStateSchema = "network.xyo.module.state";
+var isModuleState = /* @__PURE__ */ __name((payload) => {
+  return isPayloadOfSchemaType(ModuleStateSchema)(payload);
+}, "isModuleState");
+var isModuleStateWithMeta = /* @__PURE__ */ __name((payload) => {
+  return 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
+import { assertEx as assertEx3 } from "@xylabs/assert";
+import { exists } from "@xylabs/exists";
+import { isAddress as isAddress2 } from "@xylabs/hex";
+import { IdLogger } from "@xylabs/logger";
+import { toJsonString as toJsonString2 } from "@xylabs/object";
+
+// src/ResolveHelper/traceModuleIdentifier.ts
+import { assertEx as assertEx2 } from "@xylabs/assert";
+var traceModuleIdentifier = /* @__PURE__ */ __name(async (resolver, path) => {
+  const parts = path.split(":");
+  const first = parts.shift();
+  const firstModule = asModuleInstance(assertEx2(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, logger = this.defaultLogger, dead = false, upResolver, downResolver, privateResolver } = config;
+    const log = logger ? new IdLogger(logger, () => `ResolveHelper [${module.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((module2) => module2.address !== config.address);
+      if (modules.length > 0) {
+        log?.log("modules [count]", modules.length);
+        log?.debug("modules", toJsonString2(modules, 4));
+      }
+      if (maxDepth === 0) {
+        return modules;
+      }
+      const childModules = (await Promise.all(modules.map(async (module2) => await module2.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]) => 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 = isAddress2(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 ? assertEx3(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 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
+import { assertEx as assertEx4 } from "@xylabs/assert";
+import { asAddress } from "@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(assertEx4(parts.shift(), () => `First part is invalid [${path}]`), transformers);
+  if (!first) {
+    return void 0;
+  }
+  const firstAddress = 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 (module, closure) => {
+      return typeCheck(module) ? closure(module) : void 0;
+    };
+  }
+};
+var withModule = WithFactory.create(isModule);
+var withModuleInstance = WithFactory.create(isModuleInstance);
+export {
+  AddressPreviousHashSchema,
+  DeadModuleError,
+  DisallowedModuleIdentifierCharacters,
+  IsAttachableModuleInstanceFactory,
+  IsInstanceFactory,
+  IsModuleFactory,
+  MODULE_PATH_SEPARATOR,
+  ModuleAddressQuerySchema,
+  ModuleConfigSchema,
+  ModuleDescriptionSchema,
+  ModuleFactory,
+  ModuleLimitationLabelName,
+  ModuleLimitationViewLabel,
+  ModuleManifestQuerySchema,
+  ModuleStateQuerySchema,
+  ModuleStateSchema,
+  ModuleSubscribeQuerySchema,
+  ObjectResolverPriority,
+  ReservedModuleIdentifierCharacters,
+  ResolveHelper,
+  WithFactory,
+  asAttachableModuleInstance,
+  asModule,
+  asModuleInstance,
+  asModuleObject,
+  assignCreatableModuleRegistry,
+  creatableModule,
+  creatableModuleFactory,
+  duplicateModules,
+  hasAllLabels,
+  hasLabels,
+  includesReservedModuleIdentifierCharacter,
+  isAddressModuleFilter,
+  isAddressObjectFilter,
+  isAttachableModuleInstance,
+  isModule,
+  isModuleIdentifierPart,
+  isModuleInstance,
+  isModuleName,
+  isModuleObject,
+  isModuleResolver,
+  isModuleState,
+  isModuleStateWithMeta,
+  isNameModuleFilter,
+  isNameObjectFilter,
+  isObjectResolver,
+  isQueryModuleFilter,
+  isQueryObjectFilter,
+  labeledCreatableModuleFactory,
+  registerCreatableModuleFactories,
+  registerCreatableModuleFactory,
+  requiredAttachableModuleInstanceFunctions,
+  requiredModuleInstanceFunctions,
+  requiredModuleQueries,
+  requiredModuleShape,
+  resolveAddressToInstance,
+  resolveAddressToInstanceDown,
+  resolveAddressToInstanceSiblings,
+  resolveAddressToInstanceUp,
+  resolveLocalNameToAddress,
+  resolveLocalNameToAddressDown,
+  resolveLocalNameToAddressUp,
+  resolvePathToAddress,
+  serializable,
+  serializableField,
+  withModule,
+  withModuleInstance
+};
+//# sourceMappingURL=index.js.map