@xyo-network/bridge-http 2.102.0

package/dist/node/index.js

@@ -0,0 +1,298 @@
+var __defProp = Object.defineProperty;
+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 __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __publicField = (obj, key, value) => {
+  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
+var __superGet = (cls, obj, key) => __reflectGet(__getProtoOf(cls), key, obj);
+
+// src/HttpBridge.ts
+import { assertEx as assertEx2 } from "@xylabs/assert";
+import { AxiosJson } from "@xylabs/axios";
+import { exists } from "@xylabs/exists";
+import { toJsonString } from "@xylabs/object";
+import { AbstractBridge } from "@xyo-network/abstract-bridge";
+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, Semaphore } from "async-mutex";
+import { LRUCache } from "lru-cache";
+
+// src/HttpBridgeConfig.ts
+var HttpBridgeConfigSchema = "network.xyo.bridge.http.config";
+
+// src/HttpBridgeModuleResolver.ts
+import { assertEx } from "@xylabs/assert";
+import { isAddress } from "@xylabs/hex";
+import { AbstractBridgeModuleResolver, wrapModuleWithType } from "@xyo-network/abstract-bridge";
+import { Account } from "@xyo-network/account";
+import { ConfigSchema } from "@xyo-network/config-payload-plugin";
+import { asModuleInstance, ModuleConfigSchema, ResolveHelper } from "@xyo-network/module-model";
+
+// src/ModuleProxy/ModuleProxy.ts
+import { AbstractModuleProxy } from "@xyo-network/abstract-bridge";
+var _HttpModuleProxy = class _HttpModuleProxy extends AbstractModuleProxy {
+  constructor(params) {
+    _HttpModuleProxy.createCount = _HttpModuleProxy.createCount + 1;
+    if (Math.floor(_HttpModuleProxy.createCount / 10) === _HttpModuleProxy.createCount / 10) {
+      console.log(`HttpModuleProxy.createCount: ${_HttpModuleProxy.createCount}`);
+    }
+    super(params);
+  }
+  async proxyQueryHandler(query, payloads = []) {
+    return await this.params.querySender.sendBridgeQuery(this.params.moduleAddress, query, payloads);
+  }
+};
+__name(_HttpModuleProxy, "HttpModuleProxy");
+__publicField(_HttpModuleProxy, "createCount", 0);
+var HttpModuleProxy = _HttpModuleProxy;
+
+// src/HttpBridgeModuleResolver.ts
+var _HttpBridgeModuleResolver = class _HttpBridgeModuleResolver extends AbstractBridgeModuleResolver {
+  get querySender() {
+    return this.params.querySender;
+  }
+  moduleUrl(address) {
+    return new URL(address, this.params.rootUrl);
+  }
+  async resolveHandler(id, options) {
+    var _a, _b;
+    const parentResult = await super.resolveHandler(id, options);
+    if (parentResult.length > 0) {
+      return parentResult;
+    }
+    if (id === "*") {
+      return [];
+    }
+    const idParts = id.split(":");
+    const untransformedFirstPart = assertEx(idParts.shift(), () => `Invalid module identifier: ${id}`);
+    const firstPart = await ResolveHelper.transformModuleIdentifier(untransformedFirstPart);
+    const moduleAddress = firstPart;
+    assertEx(isAddress(firstPart), () => `Invalid module address: ${firstPart}`);
+    const remainderParts = idParts.join(":");
+    const params = {
+      account: Account.randomSync(),
+      archiving: this.params.archiving,
+      config: {
+        schema: ModuleConfigSchema
+      },
+      host: this,
+      moduleAddress,
+      querySender: this.querySender
+    };
+    (_a = this.logger) == null ? void 0 : _a.debug(`creating HttpProxy [${moduleAddress}] ${id}`);
+    const proxy = new HttpModuleProxy(params);
+    if (proxy) {
+      const state = await proxy.state();
+      if (state) {
+        const configSchema = (_b = state.find((payload) => payload.schema === ConfigSchema)) == null ? void 0 : _b.config;
+        const config = assertEx(state.find((payload) => payload.schema === configSchema), () => "Unable to locate config");
+        proxy.setConfig(config);
+      }
+    }
+    await proxy.start();
+    const wrapped = assertEx(wrapModuleWithType(proxy, Account.randomSync()), () => `Failed to wrapModuleWithType [${id}]`);
+    const instance = assertEx(asModuleInstance(wrapped, {}), () => `Failed to asModuleInstance [${id}]`);
+    proxy.upResolver.add(instance);
+    proxy.downResolver.add(instance);
+    if (remainderParts.length > 0) {
+      const result = await wrapped.resolve(remainderParts, options);
+      return result ? [
+        result
+      ] : [];
+    }
+    return [
+      instance
+    ];
+  }
+};
+__name(_HttpBridgeModuleResolver, "HttpBridgeModuleResolver");
+var HttpBridgeModuleResolver = _HttpBridgeModuleResolver;
+
+// src/HttpBridge.ts
+function _ts_decorate(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function")
+    r = Reflect.decorate(decorators, target, key, desc);
+  else
+    for (var i = decorators.length - 1; i >= 0; i--)
+      if (d = decorators[i])
+        r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+__name(_ts_decorate, "_ts_decorate");
+var _HttpBridge = class _HttpBridge extends AbstractBridge {
+  _axios;
+  _discoverRootsMutex = new Mutex();
+  _failureTimeCache = new LRUCache({
+    max: _HttpBridge.maxFailureCacheSize
+  });
+  _querySemaphore;
+  _resolver;
+  get axios() {
+    this._axios = this._axios ?? new AxiosJson();
+    return this._axios;
+  }
+  get failureRetryTime() {
+    return this.config.failureRetryTime ?? _HttpBridge.defaultFailureRetryTime;
+  }
+  get maxConnections() {
+    return this.config.maxConnections ?? _HttpBridge.defaultMaxConnections;
+  }
+  get maxPayloadSizeWarning() {
+    return this.config.maxPayloadSizeWarning ?? _HttpBridge.defaultMaxPayloadSizeWarning;
+  }
+  get nodeUrl() {
+    return assertEx2(this.config.nodeUrl, () => "No Url Set");
+  }
+  get querySemaphore() {
+    this._querySemaphore = this._querySemaphore ?? new Semaphore(this.maxConnections);
+    return this._querySemaphore;
+  }
+  get resolver() {
+    this._resolver = this._resolver ?? new HttpBridgeModuleResolver({
+      archiving: {
+        ...this.archiving,
+        resolveArchivists: this.resolveArchivingArchivists.bind(this)
+      },
+      bridge: this,
+      querySender: this,
+      root: this,
+      rootUrl: this.nodeUrl,
+      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 () => {
+      var _a, _b;
+      if (this._roots === void 0 || force) {
+        const state = await this.getRootState();
+        (_a = this.logger) == null ? void 0 : _a.debug(`HttpBridge:discoverRoots.state [${state == null ? void 0 : state.length}]`);
+        const nodeManifest = state == null ? void 0 : state.find(isPayloadOfSchemaType(NodeManifestPayloadSchema));
+        if (nodeManifest) {
+          const mods = (await this.resolveRootNode(nodeManifest)).filter(exists);
+          (_b = this.logger) == null ? void 0 : _b.debug(`HttpBridge:discoverRoots [${mods.length}]`);
+          this._roots = mods;
+        } else {
+          this._roots = [];
+        }
+      }
+      return this._roots;
+    });
+  }
+  moduleUrl(address) {
+    return new URL(address, this.nodeUrl);
+  }
+  async sendBridgeQuery(targetAddress, query, payloads) {
+    var _a, _b, _c, _d;
+    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) {
+        (_a = this.logger) == null ? void 0 : _a.warn(`Large targetQuery being sent: ${payloadSize} bytes [${this.address}][${this.moduleAddress}] [${query.schema}] [${payloads == null ? void 0 : 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) {
+        (_b = this.logger) == null ? void 0 : _b.error(`targetQuery failed [${moduleUrl}]`);
+        throw `targetQuery failed [${moduleUrl}] [${result.status}]`;
+      }
+      return (_c = result.data) == null ? void 0 : _c.data;
+    } catch (ex) {
+      const error = ex;
+      (_d = this.logger) == null ? void 0 : _d.error(`Error: ${toJsonString(error)}`);
+      throw error;
+    } finally {
+      this.querySemaphore.release();
+    }
+  }
+  unexposeHandler(_id, _options) {
+    throw new Error("Unsupported");
+  }
+  async getRootState() {
+    var _a;
+    const queryPayload = {
+      schema: ModuleStateQuerySchema
+    };
+    const boundQuery = await this.bindQuery(queryPayload);
+    try {
+      const response = await this.axios.post(this.nodeUrl.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;
+      (_a = this.logger) == null ? void 0 : _a.warn(`Unable to connect to remote node: ${error.message} [${this.nodeUrl}]`);
+    }
+  }
+  async resolveRootNode(nodeManifest) {
+    var _a;
+    const rootModule = assertEx2((await this.resolver.resolveHandler(assertEx2((_a = nodeManifest.status) == null ? void 0 : _a.address, () => "Root has no address"))).at(0), () => {
+      var _a2;
+      return `Root not found [${(_a2 = nodeManifest.status) == null ? void 0 : _a2.address}]`;
+    });
+    assertEx2(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 [];
+  }
+};
+__name(_HttpBridge, "HttpBridge");
+__publicField(_HttpBridge, "configSchemas", [
+  ...__superGet(_HttpBridge, _HttpBridge, "configSchemas"),
+  HttpBridgeConfigSchema
+]);
+__publicField(_HttpBridge, "defaultConfigSchema", HttpBridgeConfigSchema);
+__publicField(_HttpBridge, "defaultFailureRetryTime", 1e3 * 60);
+__publicField(_HttpBridge, "defaultMaxConnections", 4);
+__publicField(_HttpBridge, "defaultMaxPayloadSizeWarning", 256 * 256);
+__publicField(_HttpBridge, "maxFailureCacheSize", 1e3);
+var HttpBridge = _HttpBridge;
+HttpBridge = _ts_decorate([
+  creatableModule()
+], HttpBridge);
+export {
+  HttpBridge,
+  HttpBridgeConfigSchema
+};
+//# sourceMappingURL=index.js.map

package/dist/node/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/HttpBridge.ts","../../src/HttpBridgeConfig.ts","../../src/HttpBridgeModuleResolver.ts","../../src/ModuleProxy/ModuleProxy.ts"],"sourcesContent":["import { assertEx } from '@xylabs/assert'\nimport { AxiosError, AxiosJson } from '@xylabs/axios'\nimport { exists } from '@xylabs/exists'\nimport { Address } from '@xylabs/hex'\nimport { toJsonString } from '@xylabs/object'\nimport { Promisable } from '@xylabs/promise'\nimport { AbstractBridge } from '@xyo-network/abstract-bridge'\nimport { ApiEnvelope } from '@xyo-network/api-models'\nimport { QueryBoundWitness } from '@xyo-network/boundwitness-model'\nimport { BridgeExposeOptions, BridgeModule, BridgeParams, BridgeUnexposeOptions } from '@xyo-network/bridge-model'\nimport { NodeManifestPayload, NodeManifestPayloadSchema } 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 { isPayloadOfSchemaType, Payload, Schema, WithMeta } from '@xyo-network/payload-model'\nimport { Mutex, Semaphore } from 'async-mutex'\nimport { LRUCache } from 'lru-cache'\n\nimport { HttpBridgeConfig, HttpBridgeConfigSchema } from './HttpBridgeConfig'\nimport { HttpBridgeModuleResolver } from './HttpBridgeModuleResolver'\nimport { BridgeQuerySender } from './ModuleProxy'\n\nexport interface HttpBridgeParams extends BridgeParams<AnyConfigSchema<HttpBridgeConfig>> {}\n\n@creatableModule()\nexport class HttpBridge<TParams extends HttpBridgeParams> extends AbstractBridge<TParams> implements BridgeModule<TParams>, BridgeQuerySender {\n  static override readonly configSchemas: Schema[] = [...super.configSchemas, HttpBridgeConfigSchema]\n  static override readonly defaultConfigSchema: Schema = HttpBridgeConfigSchema\n  static defaultFailureRetryTime = 1000 * 60\n  static defaultMaxConnections = 4\n  static defaultMaxPayloadSizeWarning = 256 * 256\n  static maxFailureCacheSize = 1000\n\n  private _axios?: AxiosJson\n  private _discoverRootsMutex = new Mutex()\n  private _failureTimeCache = new LRUCache<Address, number>({ max: HttpBridge.maxFailureCacheSize })\n  private _querySemaphore?: Semaphore\n  private _resolver?: HttpBridgeModuleResolver\n\n  get axios() {\n    this._axios = this._axios ?? new AxiosJson()\n    return this._axios\n  }\n\n  get failureRetryTime() {\n    return this.config.failureRetryTime ?? HttpBridge.defaultFailureRetryTime\n  }\n\n  get maxConnections() {\n    return this.config.maxConnections ?? HttpBridge.defaultMaxConnections\n  }\n\n  get maxPayloadSizeWarning() {\n    return this.config.maxPayloadSizeWarning ?? HttpBridge.defaultMaxPayloadSizeWarning\n  }\n\n  get nodeUrl() {\n    return assertEx(this.config.nodeUrl, () => 'No Url Set')\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        archiving: { ...this.archiving, resolveArchivists: this.resolveArchivingArchivists.bind(this) },\n        bridge: this,\n        querySender: this,\n        root: this,\n        rootUrl: this.nodeUrl,\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<WithMeta<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.nodeUrl)\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.nodeUrl.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.nodeUrl}]`)\n    }\n  }\n\n  private async resolveRootNode(nodeManifest: NodeManifestPayload): Promise<ModuleInstance[]> {\n    const rootModule = assertEx(\n      (await this.resolver.resolveHandler(assertEx(nodeManifest.status?.address, () => 'Root has no address'))).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 { EmptyObject } from '@xylabs/object'\nimport { BridgeConfig } from '@xyo-network/bridge-model'\n\nexport type HttpBridgeConfigSchema = 'network.xyo.bridge.http.config'\nexport const HttpBridgeConfigSchema: HttpBridgeConfigSchema = 'network.xyo.bridge.http.config'\n\nexport type HttpBridgeConfig<TConfig extends EmptyObject = EmptyObject, TSchema extends string | void = void> = BridgeConfig<\n  {\n    failureRetryTime?: number\n    failureTimeCacheMax?: number\n    maxConnections?: number\n    maxPayloadSizeWarning?: number\n    nodeUrl?: string\n    schema: HttpBridgeConfigSchema\n  } & TConfig,\n  TSchema extends string ? TSchema : HttpBridgeConfigSchema\n>\n","import { assertEx } from '@xylabs/assert'\nimport { Address, isAddress } from '@xylabs/hex'\nimport { AbstractBridgeModuleResolver, BridgeModuleResolverParams, wrapModuleWithType } from '@xyo-network/abstract-bridge'\nimport { Account } from '@xyo-network/account'\nimport { ConfigPayload, ConfigSchema } from '@xyo-network/config-payload-plugin'\nimport {\n  asModuleInstance,\n  ModuleConfig,\n  ModuleConfigSchema,\n  ModuleFilterOptions,\n  ModuleIdentifier,\n  ModuleInstance,\n  ResolveHelper,\n} from '@xyo-network/module-model'\n\nimport { BridgeQuerySender, HttpModuleProxy, HttpModuleProxyParams } from './ModuleProxy'\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  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>(id: ModuleIdentifier, options?: ModuleFilterOptions<T>): Promise<T[]> {\n    const parentResult = await super.resolveHandler(id, options)\n    if (parentResult.length > 0) {\n      return parentResult\n    }\n    if (id === '*') {\n      return []\n    }\n    const idParts = id.split(':')\n    const untransformedFirstPart = assertEx(idParts.shift(), () => `Invalid module identifier: ${id}`)\n    const firstPart = await ResolveHelper.transformModuleIdentifier(untransformedFirstPart)\n    const moduleAddress = firstPart as Address\n    assertEx(isAddress(firstPart), () => `Invalid module address: ${firstPart}`)\n    const remainderParts = idParts.join(':')\n    const params: HttpModuleProxyParams = {\n      account: Account.randomSync(),\n      archiving: this.params.archiving,\n      config: { schema: ModuleConfigSchema },\n      host: this,\n      moduleAddress,\n      querySender: this.querySender,\n    }\n\n    this.logger?.debug(`creating HttpProxy [${moduleAddress}] ${id}`)\n\n    const proxy = new HttpModuleProxy<T, HttpModuleProxyParams>(params)\n    //calling state here to get the config\n    if (proxy) {\n      const state = await proxy.state()\n      if (state) {\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    }\n\n    await proxy.start()\n\n    const wrapped = assertEx(wrapModuleWithType(proxy, Account.randomSync()) as unknown as T, () => `Failed to wrapModuleWithType [${id}]`)\n    const instance = assertEx(asModuleInstance<T>(wrapped, {}), () => `Failed to asModuleInstance [${id}]`)\n    proxy.upResolver.add(instance)\n    proxy.downResolver.add(instance)\n\n    if (remainderParts.length > 0) {\n      const result = await wrapped.resolve<T>(remainderParts, options)\n      return result ? [result] : []\n    }\n\n    //console.log(`resolved: ${proxy.address} [${wrapped.constructor.name}] [${as.constructor.name}]`)\n    return [instance]\n  }\n}\n","import { Address } from '@xylabs/hex'\nimport { AbstractModuleProxy, ModuleProxyParams } from '@xyo-network/abstract-bridge'\nimport { QueryBoundWitness } from '@xyo-network/boundwitness-model'\nimport { AttachableModuleInstance, ModuleInstance, ModuleQueryResult } from '@xyo-network/module-model'\nimport { 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{\n  static createCount = 0\n\n  constructor(params: TParams) {\n    HttpModuleProxy.createCount = HttpModuleProxy.createCount + 1\n    if (Math.floor(HttpModuleProxy.createCount / 10) === HttpModuleProxy.createCount / 10) {\n      console.log(`HttpModuleProxy.createCount: ${HttpModuleProxy.createCount}`)\n    }\n    super(params)\n  }\n\n  async proxyQueryHandler<T extends QueryBoundWitness = QueryBoundWitness>(query: T, payloads: Payload[] = []): Promise<ModuleQueryResult> {\n    return await this.params.querySender.sendBridgeQuery(this.params.moduleAddress, query, payloads)\n  }\n}\n"],"mappings":"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","names":["assertEx","AxiosJson","exists","toJsonString","AbstractBridge","NodeManifestPayloadSchema","creatableModule","ModuleStateQuerySchema","asAttachableNodeInstance","isPayloadOfSchemaType","Mutex","Semaphore","LRUCache","HttpBridgeConfigSchema","assertEx","isAddress","AbstractBridgeModuleResolver","wrapModuleWithType","Account","ConfigSchema","asModuleInstance","ModuleConfigSchema","ResolveHelper","AbstractModuleProxy","HttpModuleProxy","AbstractModuleProxy","constructor","params","createCount","Math","floor","console","log","proxyQueryHandler","query","payloads","querySender","sendBridgeQuery","moduleAddress","HttpBridgeModuleResolver","AbstractBridgeModuleResolver","querySender","params","moduleUrl","address","URL","rootUrl","resolveHandler","id","options","parentResult","length","idParts","split","untransformedFirstPart","assertEx","shift","firstPart","ResolveHelper","transformModuleIdentifier","moduleAddress","isAddress","remainderParts","join","account","Account","randomSync","archiving","config","schema","ModuleConfigSchema","host","logger","debug","proxy","HttpModuleProxy","state","configSchema","find","payload","ConfigSchema","setConfig","start","wrapped","wrapModuleWithType","instance","asModuleInstance","upResolver","add","downResolver","result","resolve","HttpBridge","AbstractBridge","_axios","_discoverRootsMutex","Mutex","_failureTimeCache","LRUCache","max","maxFailureCacheSize","_querySemaphore","_resolver","axios","AxiosJson","failureRetryTime","config","defaultFailureRetryTime","maxConnections","defaultMaxConnections","maxPayloadSizeWarning","defaultMaxPayloadSizeWarning","nodeUrl","assertEx","querySemaphore","Semaphore","resolver","HttpBridgeModuleResolver","archiving","resolveArchivists","resolveArchivingArchivists","bind","bridge","querySender","root","rootUrl","wrapperAccount","account","exposeHandler","_id","_options","Error","exposedHandler","getRoots","force","runExclusive","_roots","undefined","state","getRootState","logger","debug","length","nodeManifest","find","isPayloadOfSchemaType","NodeManifestPayloadSchema","mods","resolveRootNode","filter","exists","moduleUrl","address","URL","sendBridgeQuery","targetAddress","query","payloads","lastFailureTime","get","now","Date","timeSincePreviousFailure","delete","acquire","payloadSize","JSON","stringify","warn","moduleAddress","schema","href","result","post","status","error","data","ex","toJsonString","release","unexposeHandler","queryPayload","ModuleStateQuerySchema","boundQuery","bindQuery","response","toString","errors","message","rootModule","resolveHandler","at","constructor","name","rootNode","asAttachableNodeInstance","id","downResolver","addResolver","configSchemas","HttpBridgeConfigSchema","defaultConfigSchema","creatableModule"]}

package/package.json

@@ -0,0 +1,86 @@
+{
+  "name": "@xyo-network/bridge-http",
+  "author": {
+    "email": "support@xyo.network",
+    "name": "XYO Development Team",
+    "url": "https://xyo.network"
+  },
+  "bugs": {
+    "email": "support@xyo.network",
+    "url": "https://github.com/XYOracleNetwork/sdk-xyo-client-js/issues"
+  },
+  "dependencies": {
+    "@xylabs/assert": "^3.3.3",
+    "@xylabs/axios": "^3.3.3",
+    "@xylabs/exists": "^3.3.3",
+    "@xylabs/hex": "^3.3.3",
+    "@xylabs/object": "^3.3.3",
+    "@xylabs/promise": "^3.3.3",
+    "@xyo-network/abstract-bridge": "~2.102.0",
+    "@xyo-network/account": "~2.102.0",
+    "@xyo-network/api-models": "~2.102.0",
+    "@xyo-network/boundwitness-model": "~2.102.0",
+    "@xyo-network/bridge-model": "~2.102.0",
+    "@xyo-network/config-payload-plugin": "~2.102.0",
+    "@xyo-network/manifest-model": "~2.102.0",
+    "@xyo-network/module-model": "~2.102.0",
+    "@xyo-network/node-model": "~2.102.0",
+    "@xyo-network/payload-model": "~2.102.0",
+    "async-mutex": "^0.5.0",
+    "lru-cache": "^10.2.2"
+  },
+  "devDependencies": {
+    "@xylabs/ts-scripts-yarn3": "^3.10.4",
+    "@xylabs/tsconfig": "^3.10.4",
+    "@xyo-network/account": "~2.102.0",
+    "@xyo-network/archivist-model": "~2.102.0",
+    "@xyo-network/diviner-model": "~2.102.0",
+    "@xyo-network/module-resolver": "~2.102.0",
+    "@xyo-network/node-memory": "~2.102.0",
+    "@xyo-network/node-model": "~2.102.0",
+    "@xyo-network/payload-builder": "~2.102.0",
+    "@xyo-network/payload-wrapper": "~2.102.0",
+    "typescript": "^5.4.5"
+  },
+  "description": "Primary SDK for using XYO Protocol 2.0",
+  "types": "dist/node/index.d.ts",
+  "exports": {
+    ".": {
+      "browser": {
+        "require": {
+          "types": "./dist/browser/index.d.cts",
+          "default": "./dist/browser/index.cjs"
+        },
+        "import": {
+          "types": "./dist/browser/index.d.mts",
+          "default": "./dist/browser/index.js"
+        }
+      },
+      "node": {
+        "require": {
+          "types": "./dist/node/index.d.cts",
+          "default": "./dist/node/index.cjs"
+        },
+        "import": {
+          "types": "./dist/node/index.d.mts",
+          "default": "./dist/node/index.js"
+        }
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "dist/node/index.cjs",
+  "module": "dist/node/index.js",
+  "homepage": "https://xyo.network",
+  "license": "LGPL-3.0-only",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/XYOracleNetwork/sdk-xyo-client-js.git"
+  },
+  "sideEffects": false,
+  "version": "2.102.0",
+  "type": "module"
+}

package/src/HttpBridge.ts

@@ -0,0 +1,195 @@
+import { assertEx } from '@xylabs/assert'
+import { AxiosError, AxiosJson } from '@xylabs/axios'
+import { exists } from '@xylabs/exists'
+import { Address } from '@xylabs/hex'
+import { toJsonString } from '@xylabs/object'
+import { Promisable } from '@xylabs/promise'
+import { AbstractBridge } from '@xyo-network/abstract-bridge'
+import { ApiEnvelope } from '@xyo-network/api-models'
+import { QueryBoundWitness } from '@xyo-network/boundwitness-model'
+import { BridgeExposeOptions, BridgeModule, BridgeParams, BridgeUnexposeOptions } from '@xyo-network/bridge-model'
+import { NodeManifestPayload, NodeManifestPayloadSchema } from '@xyo-network/manifest-model'
+import {
+  AnyConfigSchema,
+  creatableModule,
+  ModuleInstance,
+  ModuleQueryResult,
+  ModuleResolverInstance,
+  ModuleStateQuery,
+  ModuleStateQuerySchema,
+} from '@xyo-network/module-model'
+import { asAttachableNodeInstance } from '@xyo-network/node-model'
+import { isPayloadOfSchemaType, Payload, Schema, WithMeta } from '@xyo-network/payload-model'
+import { Mutex, Semaphore } from 'async-mutex'
+import { LRUCache } from 'lru-cache'
+
+import { HttpBridgeConfig, HttpBridgeConfigSchema } from './HttpBridgeConfig'
+import { HttpBridgeModuleResolver } from './HttpBridgeModuleResolver'
+import { BridgeQuerySender } from './ModuleProxy'
+
+export interface HttpBridgeParams extends BridgeParams<AnyConfigSchema<HttpBridgeConfig>> {}
+
+@creatableModule()
+export class HttpBridge<TParams extends HttpBridgeParams> extends AbstractBridge<TParams> implements BridgeModule<TParams>, BridgeQuerySender {
+  static override readonly configSchemas: Schema[] = [...super.configSchemas, HttpBridgeConfigSchema]
+  static override readonly defaultConfigSchema: Schema = HttpBridgeConfigSchema
+  static defaultFailureRetryTime = 1000 * 60
+  static defaultMaxConnections = 4
+  static defaultMaxPayloadSizeWarning = 256 * 256
+  static maxFailureCacheSize = 1000
+
+  private _axios?: AxiosJson
+  private _discoverRootsMutex = new Mutex()
+  private _failureTimeCache = new LRUCache<Address, number>({ max: HttpBridge.maxFailureCacheSize })
+  private _querySemaphore?: Semaphore
+  private _resolver?: HttpBridgeModuleResolver
+
+  get axios() {
+    this._axios = this._axios ?? new AxiosJson()
+    return this._axios
+  }
+
+  get failureRetryTime() {
+    return this.config.failureRetryTime ?? HttpBridge.defaultFailureRetryTime
+  }
+
+  get maxConnections() {
+    return this.config.maxConnections ?? HttpBridge.defaultMaxConnections
+  }
+
+  get maxPayloadSizeWarning() {
+    return this.config.maxPayloadSizeWarning ?? HttpBridge.defaultMaxPayloadSizeWarning
+  }
+
+  get nodeUrl() {
+    return assertEx(this.config.nodeUrl, () => 'No Url Set')
+  }
+
+  get querySemaphore() {
+    this._querySemaphore = this._querySemaphore ?? new Semaphore(this.maxConnections)
+    return this._querySemaphore
+  }
+
+  override get resolver() {
+    this._resolver =
+      this._resolver ??
+      new HttpBridgeModuleResolver({
+        archiving: { ...this.archiving, resolveArchivists: this.resolveArchivingArchivists.bind(this) },
+        bridge: this,
+        querySender: this,
+        root: this,
+        rootUrl: this.nodeUrl,
+        wrapperAccount: this.account,
+      })
+    return this._resolver
+  }
+
+  override exposeHandler(_id: string, _options?: BridgeExposeOptions | undefined): Promisable<ModuleInstance[]> {
+    throw new Error('Unsupported')
+  }
+
+  override exposedHandler(): Promisable<Address[]> {
+    throw new Error('Unsupported')
+  }
+
+  async getRoots(force?: boolean): Promise<ModuleInstance[]> {
+    return await this._discoverRootsMutex.runExclusive(async () => {
+      if (this._roots === undefined || force) {
+        const state = await this.getRootState()
+        this.logger?.debug(`HttpBridge:discoverRoots.state [${state?.length}]`)
+        const nodeManifest = state?.find(isPayloadOfSchemaType<WithMeta<NodeManifestPayload>>(NodeManifestPayloadSchema))
+        if (nodeManifest) {
+          const mods = (await this.resolveRootNode(nodeManifest)).filter(exists)
+          this.logger?.debug(`HttpBridge:discoverRoots [${mods.length}]`)
+          this._roots = mods
+        } else {
+          this._roots = []
+        }
+      }
+      return this._roots
+    })
+  }
+
+  moduleUrl(address: Address) {
+    return new URL(address, this.nodeUrl)
+  }
+
+  async sendBridgeQuery<TOut extends Payload = Payload, TQuery extends QueryBoundWitness = QueryBoundWitness, TIn extends Payload = Payload>(
+    targetAddress: Address,
+    query: TQuery,
+    payloads?: TIn[],
+  ): Promise<ModuleQueryResult<TOut>> {
+    const lastFailureTime = this._failureTimeCache.get(targetAddress)
+    if (lastFailureTime !== undefined) {
+      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<ApiEnvelope<ModuleQueryResult<TOut>>>(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 as AxiosError
+      this.logger?.error(`Error: ${toJsonString(error)}`)
+      throw error
+    } finally {
+      this.querySemaphore.release()
+    }
+  }
+
+  override unexposeHandler(_id: string, _options?: BridgeUnexposeOptions | undefined): Promisable<ModuleInstance[]> {
+    throw new Error('Unsupported')
+  }
+
+  private async getRootState() {
+    const queryPayload: ModuleStateQuery = { schema: ModuleStateQuerySchema }
+    const boundQuery = await this.bindQuery(queryPayload)
+    try {
+      const response = await this.axios.post<ApiEnvelope<ModuleQueryResult>>(this.nodeUrl.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 as Error
+      this.logger?.warn(`Unable to connect to remote node: ${error.message} [${this.nodeUrl}]`)
+    }
+  }
+
+  private async resolveRootNode(nodeManifest: NodeManifestPayload): Promise<ModuleInstance[]> {
+    const rootModule = assertEx(
+      (await this.resolver.resolveHandler(assertEx(nodeManifest.status?.address, () => 'Root has no address'))).at(0),
+      () => `Root not found [${nodeManifest.status?.address}]`,
+    )
+    assertEx(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 as unknown as ModuleResolverInstance)
+      return [rootNode]
+    }
+    return []
+  }
+}

package/src/HttpBridgeConfig.ts

@@ -0,0 +1,17 @@
+import { EmptyObject } from '@xylabs/object'
+import { BridgeConfig } from '@xyo-network/bridge-model'
+
+export type HttpBridgeConfigSchema = 'network.xyo.bridge.http.config'
+export const HttpBridgeConfigSchema: HttpBridgeConfigSchema = 'network.xyo.bridge.http.config'
+
+export type HttpBridgeConfig<TConfig extends EmptyObject = EmptyObject, TSchema extends string | void = void> = BridgeConfig<
+  {
+    failureRetryTime?: number
+    failureTimeCacheMax?: number
+    maxConnections?: number
+    maxPayloadSizeWarning?: number
+    nodeUrl?: string
+    schema: HttpBridgeConfigSchema
+  } & TConfig,
+  TSchema extends string ? TSchema : HttpBridgeConfigSchema
+>