@xyo-network/module-model 2.111.2 → 3.0.0

package/dist/node/index.cjs

@@ -1,1025 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-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);
-var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-
-// 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,
-  resolveAll: () => resolveAll,
-  resolveAllDown: () => resolveAllDown,
-  resolveAllUp: () => resolveAllUp,
-  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 primarySchemas = primary !== true && primary ? Array.isArray(primary) ? primary : [
-    primary
-  ] : [];
-  for (const primarySchema of primarySchemas) {
-    if (!factory5.configSchemas.includes(primarySchema)) {
-      console.warn(`Primary schema ${primary} not found in factory configSchemas`);
-    }
-  }
-  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) => {
-  for (const source of sources) for (const [schema, factories] of Object.entries(source)) {
-    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 {
-  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) {
-    var _a;
-    const factory5 = this;
-    const schema = factory5.creatableModule.defaultConfigSchema;
-    const mergedParams = (0, import_lodash.merge)({}, factory5.defaultParams, params, {
-      config: (0, import_lodash.merge)({}, (_a = factory5.defaultParams) == null ? void 0 : _a.config, params == null ? void 0 : params.config, {
-        schema
-      })
-    });
-    return factory5.creatableModule.create(mergedParams);
-  }
-  factory(_params) {
-    throw new Error("Method not implemented.");
-  }
-};
-__name(_ModuleFactory, "ModuleFactory");
-var ModuleFactory = _ModuleFactory;
-
-// src/DetailsError.ts
-var _ModuleDetailsError = class _ModuleDetailsError extends Error {
-  details;
-  constructor(message, details) {
-    super(message);
-    this.details = details;
-    this.name = "ModuleError";
-  }
-};
-__name(_ModuleDetailsError, "ModuleDetailsError");
-var ModuleDetailsError = _ModuleDetailsError;
-
-// 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 _IsModuleFactory {
-  create(expectedQueries, additionalChecks) {
-    return (obj, config) => {
-      const mod = asModuleObject(obj);
-      return isModuleObject(mod, config) && ((expectedQueries == null ? void 0 : expectedQueries.reduce((prev, query) => prev && mod.queries.includes(query), true)) ?? true) && ((additionalChecks == null ? void 0 : additionalChecks.reduce((prev, check) => prev && check(obj, config), true)) ?? true);
-    };
-  }
-};
-__name(_IsModuleFactory, "IsModuleFactory");
-var IsModuleFactory = _IsModuleFactory;
-
-// 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 _IsAttachableModuleInstanceFactory extends import_object8.IsObjectFactory {
-};
-__name(_IsAttachableModuleInstanceFactory, "IsAttachableModuleInstanceFactory");
-var IsAttachableModuleInstanceFactory = _IsAttachableModuleInstanceFactory;
-
-// src/instance/Instance.ts
-var import_object9 = require("@xylabs/object");
-var _DeadModuleError = class _DeadModuleError extends Error {
-  id;
-  error;
-  constructor(id, error, msg = "Dead Module Error") {
-    super(`${msg} [${id}]: ${(error == null ? void 0 : error.message) ?? (0, import_object9.toJsonString)(error)}`);
-    this.id = id;
-    this.error = error;
-    Object.setPrototypeOf(this, _DeadModuleError.prototype);
-  }
-};
-__name(_DeadModuleError, "DeadModuleError");
-var DeadModuleError = _DeadModuleError;
-var _IsInstanceFactory = class _IsInstanceFactory extends import_object9.IsObjectFactory {
-};
-__name(_IsInstanceFactory, "IsInstanceFactory");
-var IsInstanceFactory = _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 == null ? void 0 : source.hasOwnProperty(key)) && (source == null ? void 0 : 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 = void 0, ignore = []) => {
-  var _a, _b, _c;
-  if (root.address === address) {
-    return root;
-  }
-  const cache = (_a = root.addressCache) == null ? void 0 : _a.call(root, "up", !!includePrivate);
-  const privateChildren = (includePrivate ? await ((_b = root.privateChildren) == null ? void 0 : _b.call(root)) : []) ?? [];
-  const publicChildren = await ((_c = root.publicChildren) == null ? void 0 : _c.call(root)) ?? [];
-  const children = [
-    ...privateChildren,
-    ...publicChildren
-  ];
-  for (const child of children) {
-    const found = await resolveAddressToInstanceDown(child, address, includePrivate, ignore);
-    if (found) {
-      cache == null ? void 0 : cache.set(address, new WeakRef(found));
-      return found;
-    }
-  }
-  cache == null ? void 0 : cache.set(address, null);
-}, "resolveAddressToInstanceDown");
-var resolveAddressToInstanceSiblings = /* @__PURE__ */ __name(async (root, address, includePrivate = void 0, ignore = []) => {
-  var _a;
-  const siblings = await ((_a = root.siblings) == null ? void 0 : _a.call(root)) ?? [];
-  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 = void 0, ignore = []) => {
-  var _a, _b;
-  const cache = (_a = root.addressCache) == null ? void 0 : _a.call(root, "up", includePrivate ?? true);
-  const parents = await ((_b = root.parents) == null ? void 0 : _b.call(root)) ?? [];
-  for (const parent of parents) {
-    const found = await resolveAddressToInstance(parent, address, includePrivate, ignore);
-    if (found) {
-      cache == null ? void 0 : cache.set(address, new WeakRef(found));
-      return found;
-    }
-  }
-  cache == null ? void 0 : cache.set(address, null);
-}, "resolveAddressToInstanceUp");
-var resolveAddressToInstanceAll = /* @__PURE__ */ __name(async (root, address, includePrivate = void 0, ignore = []) => {
-  var _a;
-  const cache = (_a = root.addressCache) == null ? void 0 : _a.call(root, "all", !!includePrivate);
-  const result = await resolveAddressToInstanceDown(root, address, includePrivate ?? false, ignore) ?? await resolveAddressToInstanceUp(root, address, includePrivate ?? true, ignore);
-  cache == null ? void 0 : cache.set(address, result ? new WeakRef(result) : null);
-  return result;
-}, "resolveAddressToInstanceAll");
-var resolveAddressToInstance = /* @__PURE__ */ __name(async (root, address, includePrivate = void 0, 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/resolveAll.ts
-var resolveAllUp = /* @__PURE__ */ __name(async (root, maxDepth = 10, exclude = []) => {
-  if (maxDepth === 0) {
-    return [
-      root
-    ].filter((mod) => !exclude.includes(mod.address));
-  }
-  const parents = (await root.parents()).filter((mod) => !exclude.includes(mod.address));
-  return (maxDepth > 1 ? [
-    ...(await Promise.all(parents.map(async (mod) => await resolveAllUp(mod, maxDepth - 1, [
-      ...exclude,
-      root.address
-    ])))).flat(),
-    ...(await Promise.all(parents.map(async (mod) => await resolveAllDown(mod, maxDepth - 1, [
-      ...exclude,
-      root.address
-    ], true)))).flat(),
-    ...parents,
-    root
-  ] : [
-    ...parents,
-    root
-  ]).filter((mod) => !exclude.includes(mod.address)).filter(duplicateModules);
-}, "resolveAllUp");
-var resolveAllDown = /* @__PURE__ */ __name(async (root, maxDepth = 10, exclude = [], includePrivate = false) => {
-  if (maxDepth === 0) {
-    return [
-      root
-    ];
-  }
-  const children = (await root.publicChildren()).filter((mod) => !exclude.includes(mod.address));
-  const privateChildren = includePrivate ? (await root.privateChildren()).filter((mod) => !exclude.includes(mod.address)) : [];
-  return (maxDepth > 1 ? [
-    ...children,
-    ...(await Promise.all(children.map((child) => resolveAllDown(child, maxDepth - 1, [
-      ...exclude,
-      root.address
-    ])))).flat(),
-    ...(await Promise.all(privateChildren.map((child) => resolveAllDown(child, maxDepth - 1, [
-      ...exclude,
-      root.address
-    ])))).flat(),
-    root
-  ] : [
-    ...children,
-    root
-  ]).filter((mod) => !exclude.includes(mod.address)).filter(duplicateModules);
-}, "resolveAllDown");
-var resolveAll = /* @__PURE__ */ __name(async (root, maxDepth = 10, exclude = []) => {
-  if (maxDepth === 0) {
-    return [
-      root
-    ];
-  }
-  return [
-    ...await resolveAllUp(root, maxDepth, exclude),
-    ...await resolveAllDown(root, maxDepth, exclude)
-  ].filter(duplicateModules);
-}, "resolveAll");
-
-// 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 _ResolveHelperStatic {
-};
-__name(_ResolveHelperStatic, "ResolveHelperStatic");
-__publicField(_ResolveHelperStatic, "defaultLogger");
-__publicField(_ResolveHelperStatic, "transformers", []);
-var ResolveHelperStatic = _ResolveHelperStatic;
-
-// 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) => {
-  var _a;
-  const parents = await ((_a = root.parents) == null ? void 0 : _a.call(root)) ?? [];
-  return parents.find((parent) => parent.config.name === modName);
-}, "resolveLocalNameToInstanceUp");
-var resolveLocalNameToInstanceDown = /* @__PURE__ */ __name(async (root, modName, includePrivate = void 0) => {
-  var _a, _b;
-  const privateChildren = (includePrivate ? await ((_a = root.privateChildren) == null ? void 0 : _a.call(root)) : []) ?? [];
-  const publicChildren = await ((_b = root.publicChildren) == null ? void 0 : _b.call(root)) ?? [];
-  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) => {
-  var _a;
-  return (_a = await resolveLocalNameToInstanceUp(root, modName)) == null ? void 0 : _a.address;
-}, "resolveLocalNameToAddressUp");
-var resolveLocalNameToAddressDown = /* @__PURE__ */ __name(async (root, modName, includePrivate = void 0) => {
-  var _a;
-  return (_a = await resolveLocalNameToInstanceDown(root, modName, includePrivate)) == null ? void 0 : _a.address;
-}, "resolveLocalNameToAddressDown");
-var resolveLocalNameToAddressAll = /* @__PURE__ */ __name(async (root, modName, includePrivate = void 0) => {
-  var _a;
-  return (_a = await resolveLocalNameToInstanceAll(root, modName, includePrivate)) == null ? void 0 : _a.address;
-}, "resolveLocalNameToAddressAll");
-var resolveLocalNameToAddress = /* @__PURE__ */ __name(async (root, modName, includePrivate = void 0, direction = "all") => {
-  var _a;
-  return (_a = await resolveLocalNameToInstance(root, modName, includePrivate, direction)) == null ? void 0 : _a.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 = void 0, 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 = void 0, transformers = ResolveHelperStatic.transformers) => {
-  var _a;
-  return (_a = await resolvePathToInstance(root, path, includePrivate, transformers)) == null ? void 0 : _a.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 async resolve(config, idOrFilter = "*", { maxDepth = 3, required = "log", ...options } = {}) {
-    const { transformers, mod, logger = this.defaultLogger, dead = false, upResolver, downResolver, privateResolver } = config;
-    const log = logger ? new import_logger.IdLogger(logger, () => `ResolveHelper [${mod.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 == null ? void 0 : options.direction) ?? "all";
-    const up = direction === "up" || direction === "all";
-    const down = direction === "down" || direction === "all";
-    let result;
-    log == null ? void 0 : log.debug("start", idOrFilter, maxDepth);
-    if (idOrFilter === "*") {
-      if (dead) {
-        log == null ? void 0 : log.warn("failed [dead]", idOrFilter);
-        return [];
-      }
-      const modules = [
-        ...down ? await downResolver.resolve("*", downLocalOptions) : [],
-        ...up ? await upResolver.resolve("*", upLocalOptions) : []
-      ].filter(duplicateModules);
-      if (modules.length > 0) {
-        log == null ? void 0 : log.log("modules [count]", modules.length);
-        log == null ? void 0 : log.debug("modules", (0, import_object10.toJsonString)(modules, 4));
-      }
-      if (maxDepth === 0) {
-        return modules;
-      }
-      const childModules = (await Promise.all(modules.map(async (mod2) => await mod2.resolve("*", childOptions)))).flat().filter(duplicateModules);
-      return [
-        ...modules,
-        ...childModules,
-        mod
-      ].filter(duplicateModules);
-    } else {
-      switch (typeof idOrFilter) {
-        case "string": {
-          if (dead) {
-            return void 0;
-          }
-          const id = await resolvePathToAddress(mod, 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 == null ? void 0 : log.warn("resolve failed", idOrFilter);
-          break;
-        }
-        case "log": {
-          log == null ? void 0 : log.log("resolve failed", idOrFilter);
-          break;
-        }
-        default: {
-          throw new Error(`resolve failed [${idOrFilter}]`);
-        }
-      }
-    }
-  }
-};
-__name(_ResolveHelper, "ResolveHelper");
-var ResolveHelper = _ResolveHelper;
-
-// src/withModule.ts
-var WithFactory = {
-  create: /* @__PURE__ */ __name((typeCheck) => {
-    return (mod, closure) => {
-      return typeCheck(mod) ? closure(mod) : void 0;
-    };
-  }, "create")
-};
-var withModule = WithFactory.create(isModule);
-var withModuleInstance = WithFactory.create(isModuleInstance);
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  AddressChildSchema,
-  AddressPreviousHashSchema,
-  AddressSchema,
-  DeadModuleError,
-  DisallowedModuleIdentifierCharacters,
-  IsAttachableModuleInstanceFactory,
-  IsInstanceFactory,
-  IsModuleFactory,
-  MODULE_PATH_SEPARATOR,
-  ModuleAddressQuerySchema,
-  ModuleConfigSchema,
-  ModuleDescriptionSchema,
-  ModuleDetailsError,
-  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,
-  resolveAddressToInstanceAll,
-  resolveAddressToInstanceDown,
-  resolveAddressToInstanceSiblings,
-  resolveAddressToInstanceUp,
-  resolveAll,
-  resolveAllDown,
-  resolveAllUp,
-  resolveLocalNameToAddress,
-  resolveLocalNameToAddressAll,
-  resolveLocalNameToAddressDown,
-  resolveLocalNameToAddressUp,
-  resolveLocalNameToInstance,
-  resolveLocalNameToInstanceAll,
-  resolveLocalNameToInstanceDown,
-  resolveLocalNameToInstanceUp,
-  resolvePathToAddress,
-  resolvePathToInstance,
-  serializable,
-  serializableField,
-  transformModuleIdentifier,
-  withModule,
-  withModuleInstance
-});
-//# sourceMappingURL=index.cjs.map