@xyo-network/bridge-http 3.10.2 → 3.10.4

package/dist/browser/{index-browser.mjs → index-client.mjs}

@@ -359,4 +359,4 @@ export {
   HttpBridge,
   HttpBridgeConfigSchema
 };
-//# sourceMappingURL=index-browser.mjs.map
+//# sourceMappingURL=index-client.mjs.map

package/dist/neutral/{index-browser.mjs → index-client.mjs}

@@ -359,4 +359,4 @@ export {
   HttpBridge,
   HttpBridgeConfigSchema
 };
-//# sourceMappingURL=index-browser.mjs.map
+//# sourceMappingURL=index-client.mjs.map

package/dist/node/index-client.mjs

@@ -0,0 +1,362 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getProtoOf = Object.getPrototypeOf;
+var __reflectGet = Reflect.get;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __superGet = (cls, obj, key) => __reflectGet(__getProtoOf(cls), key, obj);
+
+// src/HttpBridgeClientOnly.ts
+import { creatableModule as creatableModule2 } from "@xyo-network/module-model";
+
+// src/HttpBridgeBase.ts
+import { assertEx as assertEx3 } from "@xylabs/assert";
+import { AxiosJson } from "@xylabs/axios";
+import { exists as exists2 } from "@xylabs/exists";
+import { forget as forget2 } from "@xylabs/forget";
+import { toJsonString } from "@xylabs/object";
+import { AbstractBridge } from "@xyo-network/bridge-abstract";
+import {
+  NodeManifestPayloadSchema
+} from "@xyo-network/manifest-model";
+import {
+  creatableModule,
+  ModuleStateQuerySchema
+} from "@xyo-network/module-model";
+import { asAttachableNodeInstance } from "@xyo-network/node-model";
+import {
+  isPayloadOfSchemaType
+} from "@xyo-network/payload-model";
+import { Mutex as Mutex2, Semaphore } from "async-mutex";
+import { LRUCache as LRUCache2 } from "lru-cache";
+
+// src/HttpBridgeConfig.ts
+var HttpBridgeConfigSchema = "network.xyo.bridge.http.config";
+
+// src/HttpBridgeModuleResolver.ts
+import { assertEx as assertEx2 } from "@xylabs/assert";
+import { isAddress as isAddress2 } from "@xylabs/hex";
+import { Account } from "@xyo-network/account";
+import { AbstractBridgeModuleResolver, wrapModuleWithType } from "@xyo-network/bridge-abstract";
+import { ConfigSchema } from "@xyo-network/config-payload-plugin";
+import {
+  asModuleInstance,
+  isModuleInstance,
+  ModuleConfigSchema,
+  ResolveHelper as ResolveHelper2
+} from "@xyo-network/module-model";
+import { Mutex } from "async-mutex";
+import { LRUCache } from "lru-cache";
+
+// src/ModuleProxy/ModuleProxy.ts
+import { assertEx } from "@xylabs/assert";
+import { exists } from "@xylabs/exists";
+import { forget } from "@xylabs/forget";
+import { isAddress } from "@xylabs/hex";
+import { AbstractModuleProxy } from "@xyo-network/bridge-abstract";
+import { ResolveHelper } from "@xyo-network/module-model";
+var HttpModuleProxy = class _HttpModuleProxy extends AbstractModuleProxy {
+  static createCount = 0;
+  constructor(params) {
+    _HttpModuleProxy.createCount = _HttpModuleProxy.createCount + 1;
+    super(params);
+    if (Math.floor(_HttpModuleProxy.createCount / 10) === _HttpModuleProxy.createCount / 10) {
+      console.log(`HttpModuleProxy.createCount: ${_HttpModuleProxy.createCount}`);
+    }
+  }
+  async proxyQueryHandler(query, payloads = []) {
+    if (this.archiving && this.isAllowedArchivingQuery(query.schema)) {
+      forget(this.storeToArchivists([query, ...payloads ?? []]));
+    }
+    const result = await this.params.querySender.sendBridgeQuery(this.params.moduleAddress, query, payloads);
+    if (this.archiving && this.isAllowedArchivingQuery(query.schema)) {
+      forget(this.storeToArchivists(result.flat()));
+    }
+    return result;
+  }
+  async publicChildren() {
+    return (await Promise.all(
+      Object.values(await this.childAddressMap()).filter(exists).map((address) => this.resolve(address))
+    )).filter(exists);
+  }
+  async resolve(id = "*", options = {}) {
+    const config = {
+      address: this.address,
+      dead: this.dead,
+      downResolver: this.downResolver,
+      logger: this.logger,
+      mod: this,
+      transformers: this.moduleIdentifierTransformers,
+      upResolver: this.upResolver
+    };
+    if (id === "*") {
+      return [...await this.publicChildren(), await this.params.host.resolve(this.address)];
+    }
+    switch (typeof id) {
+      case "string": {
+        const parts = id.split(":");
+        const first = assertEx(parts.shift(), () => "Missing first");
+        const remainingPath = parts.join(":");
+        const address = isAddress(first) ? first : this.id === first ? this.address : this.childAddressByName(first);
+        if (!address) return void 0;
+        const firstInstance = await this.params.host.resolve(address);
+        return remainingPath ? await firstInstance?.resolve(remainingPath) : firstInstance;
+      }
+      default: {
+        return (await ResolveHelper.resolve(config, id, options)).filter((mod) => mod.address !== this.address);
+      }
+    }
+  }
+};
+
+// src/HttpBridgeModuleResolver.ts
+var NotFoundModule = { notFound: true };
+var HttpBridgeModuleResolver = class extends AbstractBridgeModuleResolver {
+  _resolvedCache = new LRUCache({ max: 1e3 });
+  _resolvedCacheMutex = new Mutex();
+  get querySender() {
+    return this.params.querySender;
+  }
+  moduleUrl(address) {
+    return new URL(address, this.params.rootUrl);
+  }
+  async resolveHandler(id, options, params) {
+    const parentResult = await super.resolveHandler(id, options);
+    if (parentResult.length > 0) {
+      return parentResult;
+    }
+    const idParts = id.split(":");
+    const untransformedFirstPart = assertEx2(idParts.shift(), () => "Missing module identifier");
+    const firstPart = await ResolveHelper2.transformModuleIdentifier(untransformedFirstPart);
+    assertEx2(isAddress2(firstPart), () => `Invalid module address: ${firstPart}`);
+    const remainderParts = idParts.join(":");
+    const instance = await this._resolvedCacheMutex.runExclusive(async () => {
+      const cachedMod = this._resolvedCache.get(firstPart);
+      if (cachedMod) {
+        if (isModuleInstance(cachedMod)) {
+          const result2 = idParts.length <= 0 ? cachedMod : cachedMod.resolve(remainderParts, { ...options, maxDepth: (options?.maxDepth ?? 5) - 1 });
+          return result2;
+        } else {
+          return;
+        }
+      }
+      const account = await Account.random();
+      const finalParams = {
+        account,
+        archiving: this.params.archiving,
+        config: { schema: ModuleConfigSchema },
+        host: this,
+        moduleAddress: firstPart,
+        onQuerySendFinished: this.params.onQuerySendFinished,
+        onQuerySendStarted: this.params.onQuerySendStarted,
+        querySender: this.params.querySender,
+        ...params
+      };
+      this.logger?.debug(`creating HttpProxy [${firstPart}] ${id}`);
+      const proxy = new HttpModuleProxy(finalParams);
+      let state;
+      try {
+        state = await proxy.state();
+      } catch (ex) {
+        const error = ex;
+        this.logger?.log(error.message);
+      }
+      if (!state) {
+        this._resolvedCache.set(firstPart, NotFoundModule);
+        return;
+      }
+      const configSchema = state.find((payload) => payload.schema === ConfigSchema)?.config;
+      const config = assertEx2(
+        state.find((payload) => payload.schema === configSchema),
+        () => "Unable to locate config"
+      );
+      proxy.setConfig(config);
+      this.logger?.log(`created HttpProxy [${firstPart}] ${proxy.id}`);
+      await proxy.start?.();
+      const wrapped = wrapModuleWithType(proxy, account);
+      assertEx2(asModuleInstance(wrapped, {}), () => `Failed to asModuleInstance [${id}]`);
+      this._resolvedCache.set(wrapped.address, wrapped);
+      return wrapped;
+    });
+    const result = remainderParts.length > 0 ? await instance?.resolve(remainderParts, options) : instance;
+    return result ? [result] : [];
+  }
+};
+
+// src/HttpBridgeBase.ts
+var HttpBridgeBase = class extends AbstractBridge {
+  _axios;
+  _discoverRootsMutex = new Mutex2();
+  _failureTimeCache = new LRUCache2({ max: HttpBridgeBase.maxFailureCacheSize });
+  _querySemaphore;
+  _resolver;
+  get axios() {
+    this._axios = this._axios ?? this.params.axios ?? HttpBridgeBase.axios;
+    return this._axios;
+  }
+  get clientUrl() {
+    return assertEx3(this.config.client?.url ?? this.config.nodeUrl, () => "No Url Set");
+  }
+  get failureRetryTime() {
+    return this.config.failureRetryTime ?? HttpBridgeBase.defaultFailureRetryTime;
+  }
+  get maxConnections() {
+    return this.config.maxConnections ?? HttpBridgeBase.defaultMaxConnections;
+  }
+  get maxPayloadSizeWarning() {
+    return this.config.maxPayloadSizeWarning ?? HttpBridgeBase.defaultMaxPayloadSizeWarning;
+  }
+  get querySemaphore() {
+    this._querySemaphore = this._querySemaphore ?? new Semaphore(this.maxConnections);
+    return this._querySemaphore;
+  }
+  get resolver() {
+    this._resolver = this._resolver ?? new HttpBridgeModuleResolver({
+      additionalSigners: this.additionalSigners,
+      archiving: { ...this.archiving, resolveArchivists: this.resolveArchivingArchivists.bind(this) },
+      bridge: this,
+      onQuerySendFinished: (args) => {
+        forget2(this.emit("querySendFinished", { mod: this, ...args }));
+      },
+      onQuerySendStarted: (args) => {
+        forget2(this.emit("querySendStarted", { mod: this, ...args }));
+      },
+      querySender: this,
+      root: this,
+      rootUrl: this.clientUrl,
+      wrapperAccount: this.account
+    });
+    return this._resolver;
+  }
+  exposeHandler(_id, _options) {
+    throw new Error("Unsupported");
+  }
+  exposedHandler() {
+    throw new Error("Unsupported");
+  }
+  async getRoots(force) {
+    return await this._discoverRootsMutex.runExclusive(async () => {
+      if (this._roots === void 0 || force) {
+        const state = await this.getRootState();
+        this.logger?.debug(`HttpBridge:discoverRoots.state [${state?.length}]`);
+        const nodeManifest = state?.find(isPayloadOfSchemaType(NodeManifestPayloadSchema));
+        if (nodeManifest) {
+          const mods = (await this.resolveRootNode(nodeManifest)).filter(exists2);
+          this.logger?.debug(`HttpBridge:discoverRoots [${mods.length}]`);
+          this._roots = mods;
+        } else {
+          this._roots = [];
+        }
+      }
+      return this._roots;
+    });
+  }
+  moduleUrl(address) {
+    return new URL(address, this.clientUrl);
+  }
+  async sendBridgeQuery(targetAddress, query, payloads) {
+    const lastFailureTime = this._failureTimeCache.get(targetAddress);
+    if (lastFailureTime !== void 0) {
+      const now = Date.now();
+      const timeSincePreviousFailure = now - lastFailureTime;
+      if (timeSincePreviousFailure > this.failureRetryTime) {
+        throw new Error(`target module failed recently [${targetAddress}] [${timeSincePreviousFailure}ms ago]`);
+      }
+      this._failureTimeCache.delete(targetAddress);
+    }
+    try {
+      await this.querySemaphore.acquire();
+      const payloadSize = JSON.stringify([query, payloads]).length;
+      if (payloadSize > this.maxPayloadSizeWarning) {
+        this.logger?.warn(
+          `Large targetQuery being sent: ${payloadSize} bytes [${this.address}][${this.moduleAddress}] [${query.schema}] [${payloads?.length}]`
+        );
+      }
+      const moduleUrl = this.moduleUrl(targetAddress).href;
+      const result = await this.axios.post(moduleUrl, [query, payloads]);
+      if (result.status === 404) {
+        throw `target module not found [${moduleUrl}] [${result.status}]`;
+      }
+      if (result.status >= 400) {
+        this.logger?.error(`targetQuery failed [${moduleUrl}]`);
+        throw `targetQuery failed [${moduleUrl}] [${result.status}]`;
+      }
+      return result.data?.data;
+    } catch (ex) {
+      const error = ex;
+      this.logger?.error(`Error: ${toJsonString(error)}`);
+      throw error;
+    } finally {
+      this.querySemaphore.release();
+    }
+  }
+  unexposeHandler(_id, _options) {
+    throw new Error("Unsupported");
+  }
+  async getRootState() {
+    const queryPayload = { schema: ModuleStateQuerySchema };
+    const boundQuery = await this.bindQuery(queryPayload);
+    try {
+      const response = await this.axios.post(this.clientUrl.toString(), boundQuery);
+      if (response.status === 404) {
+        return [];
+      }
+      const [, payloads, errors] = response.data.data;
+      if (errors.length > 0) {
+        throw new Error(`getRootState failed: ${JSON.stringify(errors, null, 2)}`);
+      }
+      return payloads;
+    } catch (ex) {
+      const error = ex;
+      this.logger?.warn(`Unable to connect to remote node: ${error.message} [${this.clientUrl}]`);
+    }
+  }
+  async resolveRootNode(nodeManifest) {
+    const rootModule = assertEx3(
+      (await this.resolver.resolveHandler(
+        assertEx3(nodeManifest.status?.address, () => "Root has no address"),
+        void 0,
+        { manifest: nodeManifest }
+      )).at(0),
+      () => `Root not found [${nodeManifest.status?.address}]`
+    );
+    assertEx3(rootModule.constructor.name !== "HttpModuleProxy", () => "rootModule is not a Wrapper");
+    const rootNode = asAttachableNodeInstance(rootModule, "Root modules is not a node");
+    if (rootNode) {
+      this.logger.debug(`rootNode: ${rootNode.id}`);
+      this.downResolver.addResolver(rootNode);
+      return [rootNode];
+    }
+    return [];
+  }
+};
+__publicField(HttpBridgeBase, "axios", new AxiosJson());
+__publicField(HttpBridgeBase, "configSchemas", [...__superGet(HttpBridgeBase, HttpBridgeBase, "configSchemas"), HttpBridgeConfigSchema]);
+__publicField(HttpBridgeBase, "defaultConfigSchema", HttpBridgeConfigSchema);
+__publicField(HttpBridgeBase, "defaultFailureRetryTime", 1e3 * 60);
+__publicField(HttpBridgeBase, "defaultMaxConnections", 4);
+__publicField(HttpBridgeBase, "defaultMaxPayloadSizeWarning", 256 * 256);
+__publicField(HttpBridgeBase, "maxFailureCacheSize", 1e3);
+HttpBridgeBase = __decorateClass([
+  creatableModule()
+], HttpBridgeBase);
+
+// src/HttpBridgeClientOnly.ts
+var HttpBridge = class extends HttpBridgeBase {
+};
+HttpBridge = __decorateClass([
+  creatableModule2()
+], HttpBridge);
+export {
+  HttpBridge,
+  HttpBridgeConfigSchema
+};
+//# sourceMappingURL=index-client.mjs.map

package/dist/node/index-client.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/HttpBridgeClientOnly.ts","../../src/HttpBridgeBase.ts","../../src/HttpBridgeConfig.ts","../../src/HttpBridgeModuleResolver.ts","../../src/ModuleProxy/ModuleProxy.ts"],"sourcesContent":["import { BridgeParams } from '@xyo-network/bridge-model'\nimport { AnyConfigSchema, creatableModule } from '@xyo-network/module-model'\n\nimport { HttpBridgeBase } from './HttpBridgeBase.ts'\nimport { HttpBridgeConfig } from './HttpBridgeConfig.ts'\n\nexport interface HttpBridgeParams extends BridgeParams<AnyConfigSchema<HttpBridgeConfig>> {}\n\n@creatableModule()\nexport class HttpBridge<TParams extends HttpBridgeParams> extends HttpBridgeBase<TParams> {}\n","import { assertEx } from '@xylabs/assert'\nimport { AxiosJson } from '@xylabs/axios'\nimport { exists } from '@xylabs/exists'\nimport { forget } from '@xylabs/forget'\nimport { Address } from '@xylabs/hex'\nimport { toJsonString } from '@xylabs/object'\nimport { Promisable } from '@xylabs/promise'\nimport { ApiEnvelope } from '@xyo-network/api-models'\nimport { QueryBoundWitness } from '@xyo-network/boundwitness-model'\nimport { AbstractBridge } from '@xyo-network/bridge-abstract'\nimport {\n  BridgeExposeOptions,\n  BridgeModule,\n  BridgeParams,\n  BridgeUnexposeOptions,\n  QuerySendFinishedEventArgs,\n  QuerySendStartedEventArgs,\n} from '@xyo-network/bridge-model'\nimport {\n  ModuleManifestPayload, NodeManifestPayload, NodeManifestPayloadSchema,\n} from '@xyo-network/manifest-model'\nimport {\n  AnyConfigSchema,\n  creatableModule,\n  ModuleInstance,\n  ModuleQueryResult,\n  ModuleResolverInstance,\n  ModuleStateQuery,\n  ModuleStateQuerySchema,\n} from '@xyo-network/module-model'\nimport { asAttachableNodeInstance } from '@xyo-network/node-model'\nimport {\n  isPayloadOfSchemaType, Payload, Schema,\n} from '@xyo-network/payload-model'\nimport { Mutex, Semaphore } from 'async-mutex'\nimport { AxiosError } from 'axios'\nimport { LRUCache } from 'lru-cache'\n\nimport { HttpBridgeConfig, HttpBridgeConfigSchema } from './HttpBridgeConfig.ts'\nimport { HttpBridgeModuleResolver } from './HttpBridgeModuleResolver.ts'\nimport { BridgeQuerySender } from './ModuleProxy/index.ts'\n\nexport interface HttpBridgeParams extends BridgeParams<AnyConfigSchema<HttpBridgeConfig>> {\n  axios?: AxiosJson\n}\n\n@creatableModule()\nexport class HttpBridgeBase<TParams extends HttpBridgeParams> extends AbstractBridge<TParams> implements BridgeModule<TParams>, BridgeQuerySender {\n  static readonly axios = new AxiosJson()\n  static override readonly configSchemas: Schema[] = [...super.configSchemas, HttpBridgeConfigSchema]\n  static override readonly defaultConfigSchema: Schema = HttpBridgeConfigSchema\n  static readonly defaultFailureRetryTime = 1000 * 60\n  static readonly defaultMaxConnections = 4\n  static readonly defaultMaxPayloadSizeWarning = 256 * 256\n  static readonly maxFailureCacheSize = 1000\n\n  private _axios?: AxiosJson\n  private _discoverRootsMutex = new Mutex()\n  private _failureTimeCache = new LRUCache<Address, number>({ max: HttpBridgeBase.maxFailureCacheSize })\n  private _querySemaphore?: Semaphore\n  private _resolver?: HttpBridgeModuleResolver\n\n  get axios() {\n    this._axios = this._axios ?? this.params.axios ?? HttpBridgeBase.axios\n    return this._axios\n  }\n\n  get clientUrl() {\n    // eslint-disable-next-line sonarjs/deprecation\n    return assertEx(this.config.client?.url ?? this.config.nodeUrl, () => 'No Url Set')\n  }\n\n  get failureRetryTime() {\n    return this.config.failureRetryTime ?? HttpBridgeBase.defaultFailureRetryTime\n  }\n\n  get maxConnections() {\n    return this.config.maxConnections ?? HttpBridgeBase.defaultMaxConnections\n  }\n\n  get maxPayloadSizeWarning() {\n    return this.config.maxPayloadSizeWarning ?? HttpBridgeBase.defaultMaxPayloadSizeWarning\n  }\n\n  get querySemaphore() {\n    this._querySemaphore = this._querySemaphore ?? new Semaphore(this.maxConnections)\n    return this._querySemaphore\n  }\n\n  override get resolver() {\n    this._resolver\n      = this._resolver\n        ?? new HttpBridgeModuleResolver({\n          additionalSigners: this.additionalSigners,\n          archiving: { ...this.archiving, resolveArchivists: this.resolveArchivingArchivists.bind(this) },\n          bridge: this,\n          onQuerySendFinished: (args: Omit<QuerySendFinishedEventArgs, 'mod'>) => {\n            forget(this.emit('querySendFinished', { mod: this, ...args }))\n          },\n          onQuerySendStarted: (args: Omit<QuerySendStartedEventArgs, 'mod'>) => {\n            forget(this.emit('querySendStarted', { mod: this, ...args }))\n          },\n          querySender: this,\n          root: this,\n          rootUrl: this.clientUrl,\n          wrapperAccount: this.account,\n        })\n    return this._resolver\n  }\n\n  override exposeHandler(_id: string, _options?: BridgeExposeOptions | undefined): Promisable<ModuleInstance[]> {\n    throw new Error('Unsupported')\n  }\n\n  override exposedHandler(): Promisable<Address[]> {\n    throw new Error('Unsupported')\n  }\n\n  async getRoots(force?: boolean): Promise<ModuleInstance[]> {\n    return await this._discoverRootsMutex.runExclusive(async () => {\n      if (this._roots === undefined || force) {\n        const state = await this.getRootState()\n        this.logger?.debug(`HttpBridge:discoverRoots.state [${state?.length}]`)\n        const nodeManifest = state?.find(isPayloadOfSchemaType<NodeManifestPayload>(NodeManifestPayloadSchema))\n        if (nodeManifest) {\n          const mods = (await this.resolveRootNode(nodeManifest)).filter(exists)\n          this.logger?.debug(`HttpBridge:discoverRoots [${mods.length}]`)\n          this._roots = mods\n        } else {\n          this._roots = []\n        }\n      }\n      return this._roots\n    })\n  }\n\n  moduleUrl(address: Address) {\n    return new URL(address, this.clientUrl)\n  }\n\n  async sendBridgeQuery<TOut extends Payload = Payload, TQuery extends QueryBoundWitness = QueryBoundWitness, TIn extends Payload = Payload>(\n    targetAddress: Address,\n    query: TQuery,\n    payloads?: TIn[],\n  ): Promise<ModuleQueryResult<TOut>> {\n    const lastFailureTime = this._failureTimeCache.get(targetAddress)\n    if (lastFailureTime !== undefined) {\n      const now = Date.now()\n      const timeSincePreviousFailure = now - lastFailureTime\n      if (timeSincePreviousFailure > this.failureRetryTime) {\n        throw new Error(`target module failed recently [${targetAddress}] [${timeSincePreviousFailure}ms ago]`)\n      }\n      this._failureTimeCache.delete(targetAddress)\n    }\n    try {\n      await this.querySemaphore.acquire()\n      const payloadSize = JSON.stringify([query, payloads]).length\n      if (payloadSize > this.maxPayloadSizeWarning) {\n        this.logger?.warn(\n          `Large targetQuery being sent: ${payloadSize} bytes [${this.address}][${this.moduleAddress}] [${query.schema}] [${payloads?.length}]`,\n        )\n      }\n      const moduleUrl = this.moduleUrl(targetAddress).href\n      const result = await this.axios.post<ApiEnvelope<ModuleQueryResult<TOut>>>(moduleUrl, [query, payloads])\n      if (result.status === 404) {\n        throw `target module not found [${moduleUrl}] [${result.status}]`\n      }\n      if (result.status >= 400) {\n        this.logger?.error(`targetQuery failed [${moduleUrl}]`)\n        throw `targetQuery failed [${moduleUrl}] [${result.status}]`\n      }\n      return result.data?.data\n    } catch (ex) {\n      const error = ex as AxiosError\n      this.logger?.error(`Error: ${toJsonString(error)}`)\n      throw error\n    } finally {\n      this.querySemaphore.release()\n    }\n  }\n\n  override unexposeHandler(_id: string, _options?: BridgeUnexposeOptions | undefined): Promisable<ModuleInstance[]> {\n    throw new Error('Unsupported')\n  }\n\n  private async getRootState() {\n    const queryPayload: ModuleStateQuery = { schema: ModuleStateQuerySchema }\n    const boundQuery = await this.bindQuery(queryPayload)\n    try {\n      const response = await this.axios.post<ApiEnvelope<ModuleQueryResult>>(this.clientUrl.toString(), boundQuery)\n      if (response.status === 404) {\n        return []\n      }\n      const [, payloads, errors] = response.data.data\n      if (errors.length > 0) {\n        throw new Error(`getRootState failed: ${JSON.stringify(errors, null, 2)}`)\n      }\n      return payloads\n    } catch (ex) {\n      const error = ex as Error\n      this.logger?.warn(`Unable to connect to remote node: ${error.message} [${this.clientUrl}]`)\n    }\n  }\n\n  private async resolveRootNode(nodeManifest: ModuleManifestPayload): Promise<ModuleInstance[]> {\n    const rootModule = assertEx(\n      (\n        await this.resolver.resolveHandler(\n          assertEx(nodeManifest.status?.address, () => 'Root has no address'),\n          undefined,\n          { manifest: nodeManifest },\n        )\n      ).at(0),\n      () => `Root not found [${nodeManifest.status?.address}]`,\n    )\n    assertEx(rootModule.constructor.name !== 'HttpModuleProxy', () => 'rootModule is not a Wrapper')\n    const rootNode = asAttachableNodeInstance(rootModule, 'Root modules is not a node')\n    if (rootNode) {\n      this.logger.debug(`rootNode: ${rootNode.id}`)\n      this.downResolver.addResolver(rootNode as unknown as ModuleResolverInstance)\n      return [rootNode]\n    }\n    return []\n  }\n}\n","import type { EmptyObject } from '@xylabs/object'\nimport type { BridgeConfig } from '@xyo-network/bridge-model'\n\nexport const HttpBridgeConfigSchema = 'network.xyo.bridge.http.config' as const\nexport type HttpBridgeConfigSchema = typeof HttpBridgeConfigSchema\n\nexport type HttpBridgeConfig<TConfig extends EmptyObject = EmptyObject, TSchema extends string | void = void> = BridgeConfig<\n  {\n    client?: BridgeConfig['client'] & {\n      url: string\n    }\n    failureRetryTime?: number\n    failureTimeCacheMax?: number\n    host?: {\n      port: number\n    }\n    maxConnections?: number\n    maxPayloadSizeWarning?: number\n    /** @deprecated use client.url instead */\n    nodeUrl?: string\n    schema: HttpBridgeConfigSchema\n  } & TConfig,\n  TSchema extends string ? TSchema : HttpBridgeConfigSchema\n>\n","import { assertEx } from '@xylabs/assert'\nimport type { Address } from '@xylabs/hex'\nimport { isAddress } from '@xylabs/hex'\nimport { Account } from '@xyo-network/account'\nimport type { BridgeModuleResolverParams } from '@xyo-network/bridge-abstract'\nimport { AbstractBridgeModuleResolver, wrapModuleWithType } from '@xyo-network/bridge-abstract'\nimport type { ConfigPayload } from '@xyo-network/config-payload-plugin'\nimport { ConfigSchema } from '@xyo-network/config-payload-plugin'\nimport type {\n  ModuleConfig,\n  ModuleFilterOptions,\n  ModuleIdentifier,\n  ModuleInstance,\n} from '@xyo-network/module-model'\nimport {\n  asModuleInstance,\n  isModuleInstance,\n  ModuleConfigSchema,\n  ResolveHelper,\n} from '@xyo-network/module-model'\nimport type { Payload } from '@xyo-network/payload-model'\nimport { Mutex } from 'async-mutex'\nimport { LRUCache } from 'lru-cache'\n\nimport type { BridgeQuerySender, HttpModuleProxyParams } from './ModuleProxy/index.ts'\nimport { HttpModuleProxy } from './ModuleProxy/index.ts'\n\nconst NotFoundModule = { notFound: true }\n\nexport interface HttpBridgeModuleResolverParams extends BridgeModuleResolverParams {\n  querySender: BridgeQuerySender\n  rootUrl: string\n}\n\nexport class HttpBridgeModuleResolver<\n  T extends HttpBridgeModuleResolverParams = HttpBridgeModuleResolverParams,\n> extends AbstractBridgeModuleResolver<T> {\n  protected _resolvedCache = new LRUCache<Address, ModuleInstance | typeof NotFoundModule>({ max: 1000 })\n  protected _resolvedCacheMutex = new Mutex()\n\n  get querySender() {\n    return this.params.querySender\n  }\n\n  moduleUrl(address: Address) {\n    return new URL(address, this.params.rootUrl)\n  }\n\n  override async resolveHandler<T extends ModuleInstance = ModuleInstance>(\n    id: ModuleIdentifier,\n    options?: ModuleFilterOptions<T>,\n    params?: Partial<HttpModuleProxyParams>,\n  ): Promise<T[]> {\n    const parentResult = await super.resolveHandler(id, options)\n    if (parentResult.length > 0) {\n      return parentResult\n    }\n    const idParts = id.split(':')\n    const untransformedFirstPart = assertEx(idParts.shift(), () => 'Missing module identifier')\n    const firstPart = await ResolveHelper.transformModuleIdentifier(untransformedFirstPart)\n    assertEx(isAddress(firstPart), () => `Invalid module address: ${firstPart}`)\n    const remainderParts = idParts.join(':')\n    const instance: T | undefined = await this._resolvedCacheMutex.runExclusive(async () => {\n      const cachedMod = this._resolvedCache.get(firstPart as Address)\n      if (cachedMod) {\n        if (isModuleInstance(cachedMod)) {\n          const result = idParts.length <= 0 ? cachedMod : cachedMod.resolve(remainderParts, { ...options, maxDepth: (options?.maxDepth ?? 5) - 1 })\n          return result as T\n        } else {\n          // return cached 404\n          return\n        }\n      }\n      const account = await Account.random()\n      const finalParams: HttpModuleProxyParams = {\n        account,\n        archiving: this.params.archiving,\n        config: { schema: ModuleConfigSchema },\n        host: this,\n        moduleAddress: firstPart as Address,\n        onQuerySendFinished: this.params.onQuerySendFinished,\n        onQuerySendStarted: this.params.onQuerySendStarted,\n        querySender: this.params.querySender,\n        ...params,\n      }\n\n      this.logger?.debug(`creating HttpProxy [${firstPart}] ${id}`)\n\n      const proxy = new HttpModuleProxy<T, HttpModuleProxyParams>(finalParams)\n\n      let state: Payload[] | undefined\n\n      try {\n        state = await proxy.state()\n      } catch (ex) {\n        const error = ex as Error\n        this.logger?.log(error.message)\n      }\n\n      if (!state) {\n        // cache the fact that it was not found\n        this._resolvedCache.set(firstPart as Address, NotFoundModule)\n        return\n      }\n\n      const configSchema = (state.find(payload => payload.schema === ConfigSchema) as ConfigPayload | undefined)?.config\n      const config = assertEx(\n        state.find(payload => payload.schema === configSchema),\n        () => 'Unable to locate config',\n      ) as ModuleConfig\n      proxy.setConfig(config)\n\n      this.logger?.log(`created HttpProxy [${firstPart}] ${proxy.id}`)\n\n      await proxy.start?.()\n      const wrapped = wrapModuleWithType(proxy, account) as unknown as T\n      assertEx(asModuleInstance<T>(wrapped, {}), () => `Failed to asModuleInstance [${id}]`)\n      this._resolvedCache.set(wrapped.address, wrapped)\n      return wrapped as ModuleInstance as T\n    })\n    const result = remainderParts.length > 0 ? await instance?.resolve(remainderParts, options) : instance\n    return result ? [result] : []\n  }\n}\n","import { assertEx } from '@xylabs/assert'\nimport { exists } from '@xylabs/exists'\nimport { forget } from '@xylabs/forget'\nimport type { Address } from '@xylabs/hex'\nimport { isAddress } from '@xylabs/hex'\nimport type { QueryBoundWitness } from '@xyo-network/boundwitness-model'\nimport type { ModuleProxyParams } from '@xyo-network/bridge-abstract'\nimport { AbstractModuleProxy } from '@xyo-network/bridge-abstract'\nimport type {\n  AttachableModuleInstance,\n  ModuleFilterOptions,\n  ModuleIdentifier,\n  ModuleInstance,\n  ModuleQueryResult,\n  ResolveHelperConfig,\n} from '@xyo-network/module-model'\nimport { ResolveHelper } from '@xyo-network/module-model'\nimport type { Payload } from '@xyo-network/payload-model'\n\nexport interface BridgeQuerySender {\n  sendBridgeQuery: <TOut extends Payload = Payload, TQuery extends QueryBoundWitness = QueryBoundWitness, TIn extends Payload = Payload>(\n    targetAddress: Address,\n    query: TQuery,\n    payloads?: TIn[],\n  ) => Promise<ModuleQueryResult<TOut>>\n}\n\nexport type HttpModuleProxyParams = ModuleProxyParams & {\n  querySender: BridgeQuerySender\n}\n\nexport class HttpModuleProxy<\n  TWrappedModule extends ModuleInstance = ModuleInstance,\n  TParams extends Omit<HttpModuleProxyParams, 'config'> & { config: TWrappedModule['config'] } = Omit<HttpModuleProxyParams, 'config'> & {\n    config: TWrappedModule['config']\n  },\n>\n  extends AbstractModuleProxy<TWrappedModule, TParams>\n  implements AttachableModuleInstance<TParams, TWrappedModule['eventData']> {\n  protected static createCount = 0\n\n  constructor(params: TParams) {\n    HttpModuleProxy.createCount = HttpModuleProxy.createCount + 1\n    super(params)\n    if (Math.floor(HttpModuleProxy.createCount / 10) === HttpModuleProxy.createCount / 10) {\n      console.log(`HttpModuleProxy.createCount: ${HttpModuleProxy.createCount}`)\n    }\n  }\n\n  async proxyQueryHandler<T extends QueryBoundWitness = QueryBoundWitness>(query: T, payloads: Payload[] = []): Promise<ModuleQueryResult> {\n    if (this.archiving && this.isAllowedArchivingQuery(query.schema)) {\n      forget(this.storeToArchivists([query, ...(payloads ?? [])]))\n    }\n    const result = await this.params.querySender.sendBridgeQuery(this.params.moduleAddress, query, payloads)\n    if (this.archiving && this.isAllowedArchivingQuery(query.schema)) {\n      forget(this.storeToArchivists(result.flat()))\n    }\n    return result\n  }\n\n  override async publicChildren(): Promise<ModuleInstance[]> {\n    return (\n      await Promise.all(\n        Object.values(await this.childAddressMap())\n          .filter(exists)\n          .map(address => this.resolve(address)),\n      )\n    ).filter(exists)\n  }\n\n  /** @deprecated do not pass undefined.  If trying to get all, pass '*' */\n  override async resolve(): Promise<ModuleInstance[]>\n  override async resolve<T extends ModuleInstance = ModuleInstance>(all: '*', options?: ModuleFilterOptions<T>): Promise<T[]>\n  override async resolve<T extends ModuleInstance = ModuleInstance>(id: ModuleIdentifier, options?: ModuleFilterOptions<T>): Promise<T | undefined>\n  override async resolve<T extends ModuleInstance = ModuleInstance>(\n    id: ModuleIdentifier = '*',\n    options: ModuleFilterOptions<T> = {},\n  ): Promise<T | T[] | undefined> {\n    const config: ResolveHelperConfig = {\n      address: this.address,\n      dead: this.dead,\n      downResolver: this.downResolver,\n      logger: this.logger,\n      mod: this,\n      transformers: this.moduleIdentifierTransformers,\n      upResolver: this.upResolver,\n    }\n    if (id === '*') {\n      return [...(await this.publicChildren()), await this.params.host.resolve(this.address)] as T[]\n    }\n    switch (typeof id) {\n      case 'string': {\n        const parts = id.split(':')\n        const first = assertEx(parts.shift(), () => 'Missing first')\n        const remainingPath = parts.join(':')\n        const address\n          = isAddress(first)\n            ? first\n            : this.id === first\n              ? this.address\n              : this.childAddressByName(first)\n        if (!address) return undefined\n        const firstInstance = (await this.params.host.resolve(address)) as ModuleInstance | undefined\n        return (remainingPath ? await firstInstance?.resolve(remainingPath) : firstInstance) as T | undefined\n      }\n      default: {\n        return (await ResolveHelper.resolve(config, id, options)).filter(mod => mod.address !== this.address)\n      }\n    }\n  }\n}\n"],"mappings":"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","names":["creatableModule","assertEx","exists","forget","Mutex","LRUCache","assertEx","isAddress","ResolveHelper","assertEx","ResolveHelper","isAddress","result","Mutex","LRUCache","assertEx","forget","exists","creatableModule"]}

package/dist/types/{index-browser.d.ts → index-client.d.ts}

@@ -1,3 +1,3 @@
 export * from './HttpBridgeClientOnly.ts';
 export * from './HttpBridgeConfig.ts';
-//# sourceMappingURL=index-browser.d.ts.map
+//# sourceMappingURL=index-client.d.ts.map

package/dist/types/index-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-client.d.ts","sourceRoot":"","sources":["../../src/index-client.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAA;AACzC,cAAc,uBAAuB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xyo-network/bridge-http",
-  "version": "3.10.2",
+  "version": "3.10.4",
   "description": "Primary SDK for using XYO Protocol 2.0",
   "homepage": "https://xyo.network",
   "bugs": {
@@ -22,38 +22,49 @@
   "exports": {
     ".": {
       "browser": {
-        "types": "./dist/types/index-browser.d.ts",
-        "default": "./dist/browser/index-browser.mjs"
+        "types": "./dist/types/index-client.d.ts",
+        "default": "./dist/browser/index-client.mjs"
       },
       "node": {
         "types": "./dist/types/index.d.ts",
         "default": "./dist/node/index.mjs"
       },
-      "types": "./dist/types/index-browser.d.ts",
-      "default": "./dist/neutral/index-browser.mjs"
+      "types": "./dist/types/index-client.d.ts",
+      "default": "./dist/neutral/index-client.mjs"
+    },
+    "./client": {
+      "types": "./dist/types/index-client.d.ts",
+      "default": "./dist/neutral/index-client.mjs"
     },
     "./package.json": "./package.json"
   },
-  "module": "dist/neutral/index-browser.mjs",
-  "types": "dist/types/index-browser.d.ts",
+  "module": "dist/neutral/index-client.mjs",
+  "types": "dist/types/index-client.d.ts",
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE",
+    "package.json"
+  ],
   "dependencies": {
-    "@xylabs/assert": "^4.7.7",
-    "@xylabs/axios": "^4.7.7",
-    "@xylabs/exists": "^4.7.7",
-    "@xylabs/forget": "^4.7.7",
-    "@xylabs/hex": "^4.7.7",
-    "@xylabs/object": "^4.7.7",
-    "@xylabs/promise": "^4.7.7",
-    "@xyo-network/account": "^3.10.2",
-    "@xyo-network/api-models": "^3.10.2",
-    "@xyo-network/boundwitness-model": "^3.10.2",
-    "@xyo-network/bridge-abstract": "^3.10.2",
-    "@xyo-network/bridge-model": "^3.10.2",
-    "@xyo-network/config-payload-plugin": "^3.10.2",
-    "@xyo-network/manifest-model": "^3.10.2",
-    "@xyo-network/module-model": "^3.10.2",
-    "@xyo-network/node-model": "^3.10.2",
-    "@xyo-network/payload-model": "^3.10.2",
+    "@xylabs/assert": "^4.7.11",
+    "@xylabs/axios": "^4.7.11",
+    "@xylabs/exists": "^4.7.11",
+    "@xylabs/forget": "^4.7.11",
+    "@xylabs/hex": "^4.7.11",
+    "@xylabs/object": "^4.7.11",
+    "@xylabs/promise": "^4.7.11",
+    "@xyo-network/account": "^3.10.4",
+    "@xyo-network/api-models": "^3.10.4",
+    "@xyo-network/boundwitness-model": "^3.10.4",
+    "@xyo-network/bridge-abstract": "^3.10.4",
+    "@xyo-network/bridge-model": "^3.10.4",
+    "@xyo-network/config-payload-plugin": "^3.10.4",
+    "@xyo-network/manifest-model": "^3.10.4",
+    "@xyo-network/module-model": "^3.10.4",
+    "@xyo-network/node-model": "^3.10.4",
+    "@xyo-network/payload-model": "^3.10.4",
     "async-mutex": "^0.5.0",
     "axios": "^1.8.4",
     "express": "^4.21.2",
@@ -62,21 +73,21 @@
   },
   "devDependencies": {
     "@types/express": "^5.0.1",
-    "@types/node": "^22.13.10",
+    "@types/node": "^22.13.11",
     "@xylabs/eslint-config-flat": "^6.1.4",
     "@xylabs/sdk-api-express-ecs": "^2.1.0",
     "@xylabs/ts-scripts-yarn3": "^6.1.4",
     "@xylabs/tsconfig": "^6.1.4",
-    "@xylabs/vitest-extended": "^4.7.7",
-    "@xyo-network/account": "^3.10.2",
-    "@xyo-network/archivist-model": "^3.10.2",
-    "@xyo-network/bridge-abstract": "^3.10.2",
-    "@xyo-network/diviner-model": "^3.10.2",
-    "@xyo-network/module-resolver": "^3.10.2",
-    "@xyo-network/node-memory": "^3.10.2",
-    "@xyo-network/node-model": "^3.10.2",
-    "@xyo-network/payload-builder": "^3.10.2",
-    "@xyo-network/payload-wrapper": "^3.10.2",
+    "@xylabs/vitest-extended": "^4.7.11",
+    "@xyo-network/account": "^3.10.4",
+    "@xyo-network/archivist-model": "^3.10.4",
+    "@xyo-network/bridge-abstract": "^3.10.4",
+    "@xyo-network/diviner-model": "^3.10.4",
+    "@xyo-network/module-resolver": "^3.10.4",
+    "@xyo-network/node-memory": "^3.10.4",
+    "@xyo-network/node-model": "^3.10.4",
+    "@xyo-network/payload-builder": "^3.10.4",
+    "@xyo-network/payload-wrapper": "^3.10.4",
     "get-port-please": "^3.1.2",
     "typescript": "^5.8.2",
     "vitest": "^3.0.9"

package/src/spec/HttpBridge.baddns.spec.ts

@@ -0,0 +1,43 @@
+import '@xylabs/vitest-extended'
+
+import { MemoryNode } from '@xyo-network/node-memory'
+import {
+  describe, expect, it,
+} from 'vitest'
+
+import { HttpBridgeConfigSchema } from '../HttpBridgeConfig.ts'
+import { HttpBridge } from '../HttpBridgeFull.ts'
+
+/**
+ * @group module
+ * @group bridge
+ */
+
+describe('HttpBridge', () => {
+  const baseUrl = 'https://sfjhskjdsfhdsk.com'
+
+  console.log(`HttpBridge:baseUrl ${baseUrl}`)
+  const cases = [
+    ['/', `${baseUrl}`],
+    /* ['/node', `${baseUrl}/node`], */
+  ]
+
+  it.each(cases)('HttpBridge: %s', async (_, nodeUrl) => {
+    const memNode = await MemoryNode.create({ account: 'random' })
+
+    const bridge = await HttpBridge.create({
+      account: 'random',
+      config: {
+        nodeUrl, schema: HttpBridgeConfigSchema, security: { allowAnonymous: true },
+      },
+    })
+
+    await bridge?.start?.()
+
+    await memNode.register(bridge)
+    await memNode.attach(bridge.address, true)
+
+    const modules = await memNode.resolve('*')
+    expect(modules.length).toBe(2)
+  })
+})

package/src/spec/HttpBridge.copilot.spec.ts

@@ -0,0 +1,62 @@
+import '@xylabs/vitest-extended'
+
+import {
+  beforeEach,
+  describe, expect, it,
+} from 'vitest'
+
+import { HttpBridgeConfigSchema } from '../HttpBridgeConfig.ts'
+import type { HttpBridgeParams } from '../HttpBridgeFull.ts'
+import { HttpBridge } from '../HttpBridgeFull.ts'
+
+describe('HttpBridge', () => {
+  let httpBridge: HttpBridge<HttpBridgeParams>
+
+  beforeEach(async () => {
+    httpBridge = await HttpBridge.create({
+      account: 'random',
+      config: {
+        name: 'TestBridge', nodeUrl: 'http://localhost:8080', schema: HttpBridgeConfigSchema, security: { allowAnonymous: true },
+      },
+    })
+  })
+
+  it('should create an instance of HttpBridge', () => {
+    expect(httpBridge).toBeInstanceOf(HttpBridge)
+  })
+
+  it('should have axios instance', () => {
+    expect(httpBridge.axios).toBeDefined()
+  })
+
+  it('should have nodeUrl defined', () => {
+    expect(httpBridge.clientUrl).toBe('http://localhost:8080')
+  })
+
+  it('should have resolver defined', () => {
+    expect(httpBridge.resolver).toBeDefined()
+  })
+
+  it('should return correct moduleUrl', () => {
+    const address = '0x1234'
+    expect(httpBridge.moduleUrl(address).toString()).toBe('http://localhost:8080/0x1234')
+  })
+
+  it('should throw error on call to exposeHandler', async () => {
+    try {
+      await httpBridge.exposeHandler('test')
+      expect('').toBe('exposeHandler should have thrown an error')
+    } catch (error) {
+      expect(error).toBeInstanceOf(Error)
+    }
+  })
+
+  it('should throw error on call to unexposeHandler', async () => {
+    try {
+      await httpBridge.unexposeHandler('test')
+      expect('').toBe('unexposeHandler should have thrown an error')
+    } catch (error) {
+      expect(error).toBeInstanceOf(Error)
+    }
+  })
+})

package/src/spec/HttpBridge.host.spec.ts

@@ -0,0 +1,155 @@
+import '@xylabs/vitest-extended'
+
+import type { ModuleDescriptionPayload } from '@xyo-network/module-model'
+import { ModuleDescriptionSchema } from '@xyo-network/module-model'
+import { MemoryNode } from '@xyo-network/node-memory'
+import { asAttachableNodeInstance } from '@xyo-network/node-model'
+import { isPayloadOfSchemaType } from '@xyo-network/payload-model'
+import { getPort } from 'get-port-please'
+import {
+  beforeAll,
+  beforeEach,
+  describe, expect, it,
+} from 'vitest'
+
+import type { HttpBridgeConfig } from '../HttpBridgeConfig.ts'
+import { HttpBridgeConfigSchema } from '../HttpBridgeConfig.ts'
+import type { HttpBridgeParams } from '../HttpBridgeFull.ts'
+import { HttpBridge } from '../HttpBridgeFull.ts'
+
+const account = 'random'
+const schema = HttpBridgeConfigSchema
+const security = { allowAnonymous: true }
+
+/**
+ * @group module
+ * @group bridge
+ */
+describe('HttpBridge', () => {
+  let port: number
+  let url: string
+  let hostBridge: HttpBridge<HttpBridgeParams>
+  let clientBridge: HttpBridge<HttpBridgeParams>
+  let hostNode: MemoryNode
+  let clientNode: MemoryNode
+  let hostSibling: MemoryNode
+  let clientSibling: MemoryNode
+  let hostDescendent: MemoryNode
+  let clientDescendent: MemoryNode
+
+  beforeAll(async () => {
+    // Create Host/Client Nodes
+    hostNode = await MemoryNode.create({ account })
+    clientNode = await MemoryNode.create({ account })
+
+    // Create Host/Client Bridges
+    port = await getPort()
+    url = `http://localhost:${port}`
+
+    const host: HttpBridgeConfig['host'] = { port }
+    const client: HttpBridgeConfig['client'] = { discoverRoots: 'start', url }
+    hostBridge = await HttpBridge.create({
+      account,
+      config: {
+        host, name: 'TestBridgeHost', schema, security,
+      },
+    })
+    clientBridge = await HttpBridge.create({
+      account,
+      config: {
+        client, name: 'TestBridgeClient', schema, security,
+      },
+    })
+
+    // Register Host/Client Bridges
+    await hostNode.register(hostBridge)
+    await hostNode.attach(hostBridge.address, true)
+    await clientNode.register(clientBridge)
+    await clientNode.attach(clientBridge.address, true)
+
+    // Create Host/Client Sibling Nodes
+    hostSibling = await MemoryNode.create({ account })
+    clientSibling = await MemoryNode.create({ account })
+
+    // Register Host/Client Siblings
+    await hostNode.register(hostSibling)
+    await hostNode.attach(hostSibling.address, true)
+    await clientNode.register(clientSibling)
+    await clientNode.attach(clientSibling.address, true)
+
+    // Create Host/Client Descendent Nodes
+    hostDescendent = await MemoryNode.create({ account })
+    clientDescendent = await MemoryNode.create({ account })
+
+    // Register Host/Client Siblings
+    await hostSibling.register(hostDescendent)
+    await hostSibling.attach(hostDescendent.address, true)
+    await clientSibling.register(clientDescendent)
+    await clientSibling.attach(clientDescendent.address, true)
+  })
+
+  describe('exposed module behavior', () => {
+    const cases: [string, () => MemoryNode][] = [
+      ['parent', () => hostNode],
+      ['sibling', () => hostSibling],
+      ['descendent', () => hostDescendent],
+    ]
+    describe.each(cases)('with %s module', (_, getSutModule) => {
+      let exposedMod: MemoryNode
+      beforeEach(() => {
+        exposedMod = getSutModule()
+      })
+      describe('before expose', () => {
+        it('should not be exposed', async () => {
+          expect(await hostBridge.exposed()).toBeEmpty()
+        })
+        it('should not be resolvable', async () => {
+          expect(await clientBridge.resolve(exposedMod.address)).toBeUndefined()
+        })
+      })
+      describe('after expose', () => {
+        beforeEach(async () => {
+          await hostBridge.expose(exposedMod.address)
+        })
+        it('should be exposed on host', async () => {
+          expect((await hostBridge.exposed()).includes(exposedMod.address)).toBeTrue()
+        })
+        it.skip('should be resolvable from client', async () => {
+          // TODO: Implement .connect on HttpBridge and call here before resolving
+          const result = await clientBridge.resolve(exposedMod.address)
+          expect(result).toBeDefined()
+          expect(asAttachableNodeInstance(result, () => `Failed to resolve correct object type [${result?.constructor.name}]`)).toBeDefined()
+        })
+        it.skip('should be queryable from client', async () => {
+          const bridgedHostedModule = await clientBridge.resolve(exposedMod.address)
+          expect(bridgedHostedModule).toBeDefined()
+
+          const bridgedHostedNode = asAttachableNodeInstance(
+            bridgedHostedModule,
+            () => `Failed to resolve correct object type [${bridgedHostedModule?.constructor.name}]`,
+          )
+
+          if (bridgedHostedNode) {
+            const state = await bridgedHostedNode.state()
+            const description = state.find(isPayloadOfSchemaType<ModuleDescriptionPayload>(ModuleDescriptionSchema))
+            expect(description?.children).toBeArray()
+            expect(description?.queries).toBeArray()
+            expect(description?.queries?.length).toBeGreaterThan(0)
+          }
+        })
+      })
+      describe('after unexpose', () => {
+        beforeEach(async () => {
+          await hostBridge.expose(exposedMod.address)
+          await hostBridge.unexpose(exposedMod.address)
+        })
+        it('should not be exposed', async () => {
+          expect(await hostBridge.exposed()).toBeEmpty()
+        })
+        it('should not be resolvable', async () => {
+          expect(await clientBridge.resolve(exposedMod.address)).toBeUndefined()
+        })
+      })
+    })
+  })
+})

package/src/spec/HttpBridge.legacy.spec.ts

@@ -0,0 +1,56 @@
+import '@xylabs/vitest-extended'
+
+import { MemoryNode } from '@xyo-network/node-memory'
+import type { NodeInstance } from '@xyo-network/node-model'
+import { NodeConfigSchema } from '@xyo-network/node-model'
+import {
+  describe, expect, it,
+} from 'vitest'
+
+import { HttpBridgeConfigSchema } from '../HttpBridgeConfig.ts'
+import { HttpBridge } from '../HttpBridgeFull.ts'
+
+/**
+ * @group module
+ * @group bridge
+ */
+
+describe('HttpBridge', () => {
+  const baseUrl = `${process.env.API_DOMAIN ?? 'http://localhost:8080'}`
+
+  console.log(`HttpBridge:baseUrl ${baseUrl}`)
+  it('Discover', async () => {
+    const nodeUrl = `${baseUrl}/`
+    const memNode = await MemoryNode.create({ account: 'random', config: { name: 'MemoryNode', schema: NodeConfigSchema } })
+
+    const bridge = await HttpBridge.create({
+      account: 'random',
+      config: {
+        discoverRoots: 'start', name: 'HttpBridge', nodeUrl, schema: HttpBridgeConfigSchema, security: { allowAnonymous: true },
+      },
+    })
+
+    await memNode.register(bridge)
+    await memNode.attach(bridge.address, true)
+
+    const publicNode = await bridge.resolve<NodeInstance>('XYOPublic')
+    expect(publicNode).toBeDefined()
+
+    if (publicNode) {
+      console.log(`publicNode[${publicNode.address}]: ${publicNode.modName}`)
+      const publicNodeModules = await publicNode.resolve('*', { direction: 'down' })
+      expect(publicNodeModules).toBeArray()
+      expect(publicNodeModules.length).toBeGreaterThan(0)
+    }
+
+    const bridgeModules = await bridge.resolve('*', { direction: 'down' })
+    expect(bridgeModules).toBeArray()
+    expect(bridgeModules.length).toBeGreaterThan(0)
+
+    /*
+    const modules = await memNode.resolve('*')
+    expect(modules).toBeArray()
+    expect(modules.length).toBeGreaterThan(20)
+    */
+  })
+})

package/src/spec/HttpBridge.spec.ts

@@ -0,0 +1,203 @@
+/* eslint-disable complexity */
+/* eslint-disable max-statements */
+
+import '@xylabs/vitest-extended'
+
+import { assertEx } from '@xylabs/assert'
+import { HDWallet } from '@xyo-network/account'
+import type { ApiConfig } from '@xyo-network/api-models'
+import type { AttachableArchivistInstance } from '@xyo-network/archivist-model'
+import {
+  asArchivistInstance,
+  asAttachableArchivistInstance,
+  isAttachableArchivistInstance,
+} from '@xyo-network/archivist-model'
+import type { ModuleDescriptionPayload } from '@xyo-network/module-model'
+import {
+  isModule, isModuleInstance, isModuleObject,
+  ModuleDescriptionSchema,
+} from '@xyo-network/module-model'
+import { MemoryNode } from '@xyo-network/node-memory'
+import { asAttachableNodeInstance, isNodeInstance } from '@xyo-network/node-model'
+import { PayloadBuilder } from '@xyo-network/payload-builder'
+import type { Payload } from '@xyo-network/payload-model'
+import { isPayloadOfSchemaType } from '@xyo-network/payload-model'
+import { PayloadWrapper } from '@xyo-network/payload-wrapper'
+import {
+  describe, expect, it,
+} from 'vitest'
+
+import { HttpBridgeConfigSchema } from '../HttpBridgeConfig.ts'
+import { HttpBridge } from '../HttpBridgeFull.ts'
+
+const archivistName = 'XYOPublic:Archivist' // TODO: This should be configurable
+const discoverRoots = 'start'
+const schema = HttpBridgeConfigSchema
+const security = { allowAnonymous: true }
+
+export const getApiConfig = (): ApiConfig => {
+  return { apiDomain: process.env.ARCHIVIST_API_DOMAIN || 'https://beta.api.archivist.xyo.network' }
+}
+
+export const getArchivist = async (config: ApiConfig = getApiConfig()): Promise<AttachableArchivistInstance> => {
+  return assertEx(await tryGetArchivist(config), () => 'Archivist not found')
+}
+
+export const tryGetArchivist = async (config: ApiConfig = getApiConfig()): Promise<AttachableArchivistInstance | undefined> => {
+  const url = config.root ? `${config.apiDomain}/${config.root}` : config.apiDomain
+  const account = await HDWallet.random()
+  const bridge = await HttpBridge.create({
+    account,
+    config: {
+      client: { discoverRoots, url }, schema, security,
+    },
+  })
+  await bridge.start()
+  const mod = await bridge.resolve(archivistName)
+  return isAttachableArchivistInstance(mod) ? mod : undefined
+}
+
+/**
+ * @group module
+ * @group bridge
+ */
+
+describe('HttpBridge', () => {
+  const baseUrl = `${process.env.API_DOMAIN ?? 'http://localhost:8080'}`
+
+  console.log(`HttpBridge:baseUrl ${baseUrl}`)
+  const cases = [
+    ['/', `${baseUrl}`],
+    /* ['/node', `${baseUrl}/node`], */
+  ]
+
+  it.each(cases)('HttpBridge: %s', async (_, nodeUrl) => {
+    const memNode = await MemoryNode.create({ account: 'random' })
+    const extraMemNode = await MemoryNode.create({ account: 'random' })
+
+    const bridge = await HttpBridge.create({
+      account: 'random',
+      config: {
+        discoverRoots: 'start', name: 'TestBridge', nodeUrl, schema: HttpBridgeConfigSchema, security: { allowAnonymous: true },
+      },
+    })
+
+    await bridge?.start?.()
+    await memNode.register(bridge)
+    await memNode.attach(bridge?.address, true)
+
+    const resolvedBridge = await memNode.resolve(bridge.id)
+    expect(resolvedBridge).toBeDefined()
+
+    const rootModule = await bridge?.resolve('XYOPublic')
+    expect(rootModule).toBeDefined()
+
+    const remoteNode = asAttachableNodeInstance(
+      rootModule,
+      () => `Failed to resolve correct object type [XYOPublic] [${rootModule?.constructor.name}]`,
+    )
+
+    const state = await remoteNode.state()
+    const description = state.find(isPayloadOfSchemaType<ModuleDescriptionPayload>(ModuleDescriptionSchema))
+    expect(description?.children).toBeArray()
+    expect(description?.children?.length).toBeGreaterThan(0)
+    expect(description?.queries).toBeArray()
+    expect(description?.queries?.length).toBeGreaterThan(0)
+
+    const archivistByName1 = await rootModule?.resolve('Archivist')
+    expect(archivistByName1).toBeDefined()
+    const archivistByName2 = await bridge.resolve('XYOPublic:Archivist')
+    expect(archivistByName2).toBeDefined()
+    const publicXyo = await bridge.resolve('XYOPublic')
+    expect(publicXyo).toBeDefined()
+    const publicXyoSelfResolve = publicXyo?.resolve('XYOPublic')
+    expect(publicXyoSelfResolve).toBeDefined()
+    if (publicXyo) {
+      const bridgedArchivist = await getArchivist()
+      expect(bridgedArchivist).toBeDefined()
+      if (bridgedArchivist) {
+        const attachablePublicXyo = asAttachableArchivistInstance(archivistByName2, 'Failed to cast publicXyo')
+        expect(attachablePublicXyo).toBeDefined()
+        await extraMemNode.register(bridgedArchivist)
+        await extraMemNode.attach(bridgedArchivist.address, true)
+        const publicXyoNodeResolveAddress = await extraMemNode?.resolve(bridgedArchivist.address)
+        expect(publicXyoNodeResolveAddress).toBeDefined()
+        const publicXyoNodeResolve = await extraMemNode?.resolve('Archivist')
+        expect(publicXyoNodeResolve).toBeDefined()
+      }
+    }
+    const archivistByName3 = await publicXyo?.resolve('Archivist')
+    expect(archivistByName3).toBeDefined()
+    expect(archivistByName3).toEqual(archivistByName1)
+    expect(archivistByName3).toEqual(archivistByName2)
+    expect(archivistByName2).toBeDefined()
+    const archivistInstance = asArchivistInstance(archivistByName2, 'Failed to cast archivist')
+    expect(archivistInstance).toBeDefined()
+    const knownPayload = PayloadWrapper.parse({ schema: 'network.xyo.test' })?.payload as Payload
+    expect(knownPayload).toBeDefined()
+    const knownHash = await PayloadBuilder.dataHash(knownPayload as Payload)
+    const insertResult = await archivistInstance.insert([knownPayload])
+    expect(insertResult).toBeDefined()
+    const roundTripPayload = (await archivistInstance.get([knownHash]))[0]
+    expect(roundTripPayload).toBeDefined()
+  })
+  it.each(cases)('HttpBridge - Nested: %s', async (_, nodeUrl) => {
+    const memNode1 = await MemoryNode.create({ account: 'random', config: { schema: 'network.xyo.node.config' } })
+    const memNode2 = await MemoryNode.create({ account: 'random', config: { schema: 'network.xyo.node.config' } })
+    const memNode3 = await MemoryNode.create({ account: 'random', config: { schema: 'network.xyo.node.config' } })
+
+    await memNode1.register(memNode2)
+    await memNode1.attach(memNode2.address, true)
+    await memNode2.register(memNode3)
+    await memNode2.attach(memNode3.address, true)
+
+    const bridge = await HttpBridge.create({
+      account: 'random',
+      config: {
+        nodeUrl, schema: HttpBridgeConfigSchema, security: { allowAnonymous: true },
+      },
+    })
+
+    await bridge.getRoots()
+    const mod = await bridge.resolve('XYOPublic')
+
+    expect(mod).toBeDefined()
+    expect(isModule(mod)).toBeTrue()
+    expect(isModuleObject(mod)).toBeTrue()
+
+    const remoteNode = asAttachableNodeInstance(mod, `Failed to resolve [XYOPublic] - ${mod?.address} [${mod?.id}] [${mod?.constructor.name}]`)
+
+    expect(isNodeInstance(remoteNode)).toBeTrue()
+    expect(isModuleInstance(remoteNode)).toBeTrue()
+
+    await memNode3.register(remoteNode)
+    await memNode3.attach(remoteNode?.address, true)
+    const description = (await remoteNode.state()).find(isPayloadOfSchemaType<ModuleDescriptionPayload>(ModuleDescriptionSchema))
+    expect(description?.children).toBeArray()
+    expect(description?.children?.length).toBeGreaterThan(0)
+    expect(description?.queries).toBeArray()
+    expect(description?.queries?.length).toBeGreaterThan(0)
+
+    // Works if you supply the known address for 'Archivist'
+    // const [archivistByAddress] = await memNode.resolve({ address: ['461fd6970770e97d9f66c71658f4b96212581f0b'] })
+    // expect(archivistByAddress).toBeDefined()
+
+    /* const mods = await bridge.resolve('*')
+    for (const mod of mods) {
+      console.log(`module [${mod.address}]: ${mod.modName}`)
+    } */
+
+    const node = await bridge.resolve('XYOPublic')
+    expect(node).toBeDefined()
+
+    const archivistByName1 = await node?.resolve('Archivist')
+    expect(archivistByName1).toBeDefined()
+
+    const archivistByName2 = (await node?.resolve('Archivist'))
+    expect(archivistByName2).toBeDefined()
+    const payloadStatsDivinerByName = (await node?.resolve('PayloadStatsDiviner'))
+    expect(payloadStatsDivinerByName).toBeDefined()
+    const boundwitnessStatsDivinerByName = (await node?.resolve('BoundWitnessStatsDiviner'))
+    expect(boundwitnessStatsDivinerByName).toBeDefined()
+  })
+})

package/src/spec/HttpBridge.tests.spec.ts

@@ -0,0 +1,86 @@
+/* eslint-disable sonarjs/assertions-in-tests */
+/* eslint-disable max-nested-callbacks */
+import '@xylabs/vitest-extended'
+
+import type { AbstractBridge } from '@xyo-network/bridge-abstract'
+import {
+  describe, expect, it,
+} from 'vitest'
+
+// TODO: Implement standard test suite for all Bridges here and then run
+// against specific bridges
+export const generateBridgeTests = (title: string, _bridge: AbstractBridge) => {
+  describe(title, () => {
+    describe('HttpBridge', () => {
+      describe('By name', () => {
+        it('should handle the case by name', () => {
+          // Add your test logic here
+        })
+      })
+
+      describe('By address', () => {
+        it('should handle the case by address', () => {
+          // Add your test logic here
+        })
+      })
+
+      describe('By exposed/unexposed', () => {
+        describe('Pre Exposed', () => {
+          it('should handle the case when pre exposed', () => {
+            // Add your test logic here
+          })
+        })
+
+        describe('Post Exposed', () => {
+          it('should handle the case when post exposed', () => {
+            // Add your test logic here
+          })
+        })
+
+        describe('Post Unexposed', () => {
+          it('should handle the case when post unexposed', () => {
+            // Add your test logic here
+          })
+        })
+      })
+
+      describe('By parent/sibling/child/grandchild', () => {
+        describe('ParentNode', () => {
+          it('should handle the case for ParentNode', () => {
+            // Add your test logic here
+          })
+
+          describe('Bridge', () => {
+            it('should handle the case for Bridge', () => {
+              // Add your test logic here
+            })
+          })
+
+          describe('SiblingNode', () => {
+            it('should handle the case for SiblingNode', () => {
+              // Add your test logic here
+            })
+
+            describe('ChildNode', () => {
+              it('should handle the case for ChildNode', () => {
+                // Add your test logic here
+              })
+            })
+          })
+        })
+
+        describe('GrandchildNode', () => {
+          it('should handle the case for GrandchildNode', () => {
+            // Add your test logic here
+          })
+        })
+      })
+    })
+  })
+}
+
+describe('HttpBridge', () => {
+  it('No tests', () => {
+    expect(true).toBeTruthy()
+  })
+})

package/src/spec/HttpBridge.xns.spec.ts

@@ -0,0 +1,55 @@
+import '@xylabs/vitest-extended'
+
+import { asDivinerInstance } from '@xyo-network/diviner-model'
+import { ResolveHelper } from '@xyo-network/module-model'
+import { NameRegistrarTransformer } from '@xyo-network/module-resolver'
+import { MemoryNode } from '@xyo-network/node-memory'
+import { asAttachableNodeInstance } from '@xyo-network/node-model'
+import {
+  describe, expect, it,
+} from 'vitest'
+
+import { HttpBridgeConfigSchema } from '../HttpBridgeConfig.ts'
+import { HttpBridge } from '../HttpBridgeFull.ts'
+
+/**
+ * @group module
+ * @group bridge
+ */
+
+describe('HttpBridge - Xns', () => {
+  it('HttpBridge-Xns: Simple Resolve', async () => {
+    const memNode = await MemoryNode.create({ account: 'random' })
+
+    const bridge = await HttpBridge.create({
+      account: 'random',
+      config: {
+        discoverRoots: 'start',
+        name: 'TestBridge',
+        nodeUrl: 'https://beta.xns.xyo.network',
+        schema: HttpBridgeConfigSchema,
+        security: { allowAnonymous: true },
+      },
+    })
+
+    await bridge?.start?.()
+    await memNode.register(bridge)
+    await memNode.attach(bridge?.address, true)
+    const resolvedBridge = await memNode.resolve(bridge.id)
+    expect(resolvedBridge).toBeDefined()
+
+    const rootModule = await bridge?.resolve('XNS')
+    expect(rootModule).toBeDefined()
+
+    const remoteNode = asAttachableNodeInstance(rootModule, () => `Failed to resolve correct object type [XYO] [${rootModule?.constructor.name}]`)
+
+    const registrarDiviner = asDivinerInstance(await remoteNode.resolve('XNS:AddressRecords:AddressRecordIndexDiviner'))
+    expect(registrarDiviner).toBeDefined()
+    if (registrarDiviner) {
+      const transformer = new NameRegistrarTransformer(registrarDiviner, 'xyo')
+      ResolveHelper.transformers = [transformer]
+      const address = await transformer.transform('nippyflight.xyo')
+      expect(address).toBe('c5fa710300a8a43568678d0fe72810e34d880357')
+    }
+  })
+})

package/dist/types/index-browser.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index-browser.d.ts","sourceRoot":"","sources":["../../src/index-browser.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAA;AACzC,cAAc,uBAAuB,CAAA"}

package/eslint.config.mjs

@@ -1 +0,0 @@
-export { config as default } from '@xylabs/eslint-config-flat'

package/typedoc.json

@@ -1,5 +0,0 @@
-{
-  "$schema": "https://typedoc.org/schema.json",
-  "entryPoints": ["src/index.ts"],
-  "tsconfig": "./tsconfig.typedoc.json"
-}

package/xy.config.ts

@@ -1,10 +0,0 @@
-import type { XyTsupConfig } from '@xylabs/ts-scripts-yarn3'
-const config: XyTsupConfig = {
-  compile: {
-    browser: { src: { entry: ['./src/index-browser.ts'] } },
-    neutral: { src: { entry: ['./src/index-browser.ts'] } },
-    node: { src: { entry: ['./src/index.ts'] } },
-  },
-}
-
-export default config