@xyo-network/bridge-http-express 3.14.0

package/LICENSE

@@ -0,0 +1,165 @@
+                   GNU LESSER GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+
+  This version of the GNU Lesser General Public License incorporates
+the terms and conditions of version 3 of the GNU General Public
+License, supplemented by the additional permissions listed below.
+
+  0. Additional Definitions.
+
+  As used herein, "this License" refers to version 3 of the GNU Lesser
+General Public License, and the "GNU GPL" refers to version 3 of the GNU
+General Public License.
+
+  "The Library" refers to a covered work governed by this License,
+other than an Application or a Combined Work as defined below.
+
+  An "Application" is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+  A "Combined Work" is a work produced by combining or linking an
+Application with the Library.  The particular version of the Library
+with which the Combined Work was made is also called the "Linked
+Version".
+
+  The "Minimal Corresponding Source" for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+  The "Corresponding Application Code" for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+  1. Exception to Section 3 of the GNU GPL.
+
+  You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+  2. Conveying Modified Versions.
+
+  If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+   a) under this License, provided that you make a good faith effort to
+   ensure that, in the event an Application does not supply the
+   function or data, the facility still operates, and performs
+   whatever part of its purpose remains meaningful, or
+
+   b) under the GNU GPL, with none of the additional permissions of
+   this License applicable to that copy.
+
+  3. Object Code Incorporating Material from Library Header Files.
+
+  The object code form of an Application may incorporate material from
+a header file that is part of the Library.  You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, inline functions and templates
+(ten or fewer lines in length), you do both of the following:
+
+   a) Give prominent notice with each copy of the object code that the
+   Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the object code with a copy of the GNU GPL and this license
+   document.
+
+  4. Combined Works.
+
+  You may convey a Combined Work under terms of your choice that,
+taken together, effectively do not restrict modification of the
+portions of the Library contained in the Combined Work and reverse
+engineering for debugging such modifications, if you also do each of
+the following:
+
+   a) Give prominent notice with each copy of the Combined Work that
+   the Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the Combined Work with a copy of the GNU GPL and this license
+   document.
+
+   c) For a Combined Work that displays copyright notices during
+   execution, include the copyright notice for the Library among
+   these notices, as well as a reference directing the user to the
+   copies of the GNU GPL and this license document.
+
+   d) Do one of the following:
+
+       0) Convey the Minimal Corresponding Source under the terms of this
+       License, and the Corresponding Application Code in a form
+       suitable for, and under terms that permit, the user to
+       recombine or relink the Application with a modified version of
+       the Linked Version to produce a modified Combined Work, in the
+       manner specified by section 6 of the GNU GPL for conveying
+       Corresponding Source.
+
+       1) Use a suitable shared library mechanism for linking with the
+       Library.  A suitable mechanism is one that (a) uses at run time
+       a copy of the Library already present on the user's computer
+       system, and (b) will operate properly with a modified version
+       of the Library that is interface-compatible with the Linked
+       Version.
+
+   e) Provide Installation Information, but only if you would otherwise
+   be required to provide such information under section 6 of the
+   GNU GPL, and only to the extent that such information is
+   necessary to install and execute a modified version of the
+   Combined Work produced by recombining or relinking the
+   Application with a modified version of the Linked Version. (If
+   you use option 4d0, the Installation Information must accompany
+   the Minimal Corresponding Source and Corresponding Application
+   Code. If you use option 4d1, you must provide the Installation
+   Information in the manner specified by section 6 of the GNU GPL
+   for conveying Corresponding Source.)
+
+  5. Combined Libraries.
+
+  You may place library facilities that are a work based on the
+Library side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License, and convey such a combined library under terms of your
+choice, if you do both of the following:
+
+   a) Accompany the combined library with a copy of the same work based
+   on the Library, uncombined with any other library facilities,
+   conveyed under the terms of this License.
+
+   b) Give prominent notice with the combined library that part of it
+   is a work based on the Library, and explaining where to find the
+   accompanying uncombined form of the same work.
+
+  6. Revised Versions of the GNU Lesser General Public License.
+
+  The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+  Each version is given a distinguishing version number. If the
+Library as you received it specifies that a certain numbered version
+of the GNU Lesser General Public License "or any later version"
+applies to it, you have the option of following the terms and
+conditions either of that published version or of any later version
+published by the Free Software Foundation. If the Library as you
+received it does not specify a version number of the GNU Lesser
+General Public License, you may choose any version of the GNU Lesser
+General Public License ever published by the Free Software Foundation.
+
+  If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
+Library.

package/README.md

@@ -0,0 +1,13 @@
+[![logo][]](https://xyo.network)
+
+Part of [sdk-xyo-client-js](https://www.npmjs.com/package/@xyo-network/sdk-xyo-client-js)
+
+## License
+
+> See the [LICENSE](LICENSE) file for license details
+
+## Credits
+
+[Made with 🔥 and ❄️ by XYO](https://xyo.network)
+
+[logo]: https://cdn.xy.company/img/brand/XYO_full_colored.png

package/dist/neutral/index.mjs

@@ -0,0 +1,191 @@
+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/HttpBridge.ts
+import { assertEx } from "@xylabs/assert";
+import { exists } from "@xylabs/exists";
+import {
+  asyncHandler,
+  customPoweredByHeader,
+  disableCaseSensitiveRouting,
+  disableExpressDefaultPoweredByHeader,
+  jsonBodyParser,
+  responseProfiler,
+  useRequestCounters
+} from "@xylabs/express";
+import { toJsonString } from "@xylabs/object";
+import { isQueryBoundWitness } from "@xyo-network/boundwitness-model";
+import { HttpBridge } from "@xyo-network/bridge-http";
+import {
+  creatableModule,
+  resolveAddressToInstanceUp
+} from "@xyo-network/module-model";
+import express from "express";
+import { StatusCodes } from "http-status-codes";
+var HttpBridgeExpressConfigSchema = "network.xyo.bridge.http.express.config";
+var HttpBridgeExpress = class extends HttpBridge {
+  _app;
+  _exposedModules = [];
+  _server;
+  get app() {
+    if (!this._app) this._app = this.initializeApp();
+    return assertEx(this._app, () => "App not initialized");
+  }
+  async exposeChild(mod, options) {
+    const { maxDepth = 5 } = options ?? {};
+    assertEx(this.config.host, () => "Not configured as a host");
+    this._exposedModules.push(new WeakRef(mod));
+    const children = maxDepth > 0 ? await mod.publicChildren?.() ?? [] : [];
+    this.logger.log(`childrenToExpose [${mod.id}][${mod.address}]: ${toJsonString(children.map((child) => child.id))}`);
+    const exposedChildren = (await Promise.all(children.map((child) => this.exposeChild(child, { maxDepth: maxDepth - 1, required: false })))).flat().filter(exists);
+    const allExposed = [mod, ...exposedChildren];
+    for (const exposedMod of allExposed) this.logger?.log(`exposed: ${exposedMod.address} [${mod.id}]`);
+    return allExposed;
+  }
+  async exposeHandler(address, options) {
+    const { required = true } = options ?? {};
+    const mod = await resolveAddressToInstanceUp(this, address);
+    if (required && !mod) {
+      throw new Error(`Unable to find required module: ${address}`);
+    }
+    if (mod) {
+      return this.exposeChild(mod, options);
+    }
+    return [];
+  }
+  exposedHandler() {
+    return this._exposedModules.map((ref) => ref.deref()?.address).filter(exists);
+  }
+  async startHandler() {
+    return await super.startHandler() && await this.startHttpServer();
+  }
+  async stopHandler(_timeout) {
+    return await super.stopHandler() && await this.stopHttpServer();
+  }
+  async unexposeHandler(address, options) {
+    const { maxDepth = 2, required = true } = options ?? {};
+    assertEx(this.config.host, () => "Not configured as a host");
+    const mod = this._exposedModules.find((ref) => ref.deref()?.address === address)?.deref();
+    assertEx(!required || mod, () => `Module not exposed: ${address}`);
+    this._exposedModules = this._exposedModules.filter((ref) => ref.deref()?.address !== address);
+    if (mod) {
+      const children = maxDepth > 0 ? await mod.publicChildren?.() ?? [] : [];
+      const exposedChildren = (await Promise.all(children.map((child) => this.unexposeHandler(child.address, { maxDepth: maxDepth - 1, required: false })))).flat().filter(exists);
+      return [mod, ...exposedChildren];
+    }
+    return [];
+  }
+  async callLocalModule(address, query, payloads) {
+    const mod = this._exposedModules.find((ref) => ref.deref()?.address === address)?.deref();
+    return mod ? await mod.query(query, payloads) : null;
+  }
+  async handleGet(req, res) {
+    const { address } = req.params;
+    try {
+      if (address == this.address) {
+        res.json(await this.stateQuery(this.account));
+      } else {
+        const mod = this._exposedModules.find((ref) => ref.deref()?.address === address)?.deref();
+        if (mod) {
+          res.json(await mod.stateQuery(this.account));
+        } else {
+          res.status(StatusCodes.NOT_FOUND).json({ error: "Module not found" });
+        }
+      }
+    } catch (ex) {
+      res.status(StatusCodes.INTERNAL_SERVER_ERROR).json({ error: ex.message });
+    }
+  }
+  async handlePost(req, res) {
+    const { address } = req.params;
+    const [bw, payloads = []] = Array.isArray(req.body) ? req.body : [];
+    const query = isQueryBoundWitness(bw) ? bw : void 0;
+    if (!query) {
+      res.status(StatusCodes.BAD_REQUEST).json({ error: "No query provided" });
+      return;
+    }
+    try {
+      if (address == this.address) {
+        const result = await this.query(query, payloads);
+        return res.json(result);
+      } else {
+        const result = await this.callLocalModule(address, query, payloads);
+        if (result === null) {
+          res.status(StatusCodes.NOT_FOUND).json({ error: "Module not found" });
+        } else {
+          res.json(result);
+        }
+      }
+    } catch (ex) {
+      res.status(StatusCodes.INTERNAL_SERVER_ERROR).json({ error: ex.message });
+    }
+  }
+  initializeApp() {
+    const app = express();
+    app.use(responseProfiler);
+    app.use(jsonBodyParser);
+    disableExpressDefaultPoweredByHeader(app);
+    app.use(customPoweredByHeader);
+    disableCaseSensitiveRouting(app);
+    useRequestCounters(app);
+    app.get("/", (_req, res) => res.redirect(StatusCodes.MOVED_TEMPORARILY, `/${this.address}`));
+    app.post("/", (_req, res) => res.redirect(StatusCodes.TEMPORARY_REDIRECT, `/${this.address}`));
+    app.get(
+      "/:address",
+      asyncHandler(async (req, res) => await this.handleGet(req, res))
+    );
+    app.post(
+      "/:address",
+      asyncHandler(async (req, res) => {
+        await this.handlePost(req, res);
+      })
+    );
+    return app;
+  }
+  startHttpServer() {
+    if (this.config.host) {
+      assertEx(!this._server, () => "Server already started");
+      this._server = this.app.listen(this.config.host?.port ?? 3030);
+    }
+    return Promise.resolve(true);
+  }
+  stopHttpServer() {
+    if (this.config.host) {
+      return new Promise((resolve, reject) => {
+        if (this._server) {
+          this._server.close((err) => {
+            if (err) {
+              reject(err);
+            } else {
+              this._server = void 0;
+              resolve(true);
+            }
+          });
+        }
+      });
+    }
+    return Promise.resolve(true);
+  }
+};
+__publicField(HttpBridgeExpress, "configSchemas", [...__superGet(HttpBridgeExpress, HttpBridgeExpress, "configSchemas"), HttpBridgeExpressConfigSchema]);
+HttpBridgeExpress = __decorateClass([
+  creatableModule()
+], HttpBridgeExpress);
+export {
+  HttpBridgeExpress,
+  HttpBridgeExpressConfigSchema
+};
+//# sourceMappingURL=index.mjs.map

package/dist/neutral/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/HttpBridge.ts"],"sourcesContent":["import { Server } from 'node:http'\n\nimport { assertEx } from '@xylabs/assert'\nimport { exists } from '@xylabs/exists'\nimport {\n  asyncHandler,\n  customPoweredByHeader,\n  disableCaseSensitiveRouting,\n  disableExpressDefaultPoweredByHeader,\n  jsonBodyParser,\n  responseProfiler,\n  useRequestCounters,\n} from '@xylabs/express'\nimport { Address } from '@xylabs/hex'\nimport { toJsonString } from '@xylabs/object'\nimport { isQueryBoundWitness, QueryBoundWitness } from '@xyo-network/boundwitness-model'\nimport { HttpBridge, HttpBridgeConfig } from '@xyo-network/bridge-http'\nimport {\n  BridgeExposeOptions, BridgeParams, BridgeUnexposeOptions,\n} from '@xyo-network/bridge-model'\n// import { standardResponses } from '@xyo-network/express-node-middleware'\nimport {\n  AnyConfigSchema, creatableModule, ModuleInstance, ModuleQueryResult, resolveAddressToInstanceUp,\n} from '@xyo-network/module-model'\nimport { Payload, Schema } from '@xyo-network/payload-model'\nimport express, {\n  Application, Request, Response,\n} from 'express'\nimport { StatusCodes } from 'http-status-codes'\n\n/**\n * The type of the path parameters for the address path.\n */\ntype AddressPathParams = {\n  address: Address\n}\n\n/**\n * The type of the request body for the address path.\n */\ntype PostAddressRequestBody = [QueryBoundWitness, undefined | Payload[]]\n\n// TODO: This does not match the error response shape of the legacy bridge BUT it its the\n// shape this bridge is currently returning.  Massage this into the standard\n// error shape constructed via middleware.\n/* type ErrorResponseBody = {\n  error: string\n} */\n\nexport const HttpBridgeExpressConfigSchema = 'network.xyo.bridge.http.express.config' as const\nexport type HttpBridgeExpressConfigSchema = typeof HttpBridgeExpressConfigSchema\n\nexport interface HttpBridgeExpressConfig extends HttpBridgeConfig<{}, HttpBridgeExpressConfigSchema> {}\n\nexport interface HttpBridgeExpressParams extends BridgeParams<AnyConfigSchema<HttpBridgeExpressConfig>> {}\n\n@creatableModule()\nexport class HttpBridgeExpress<TParams extends HttpBridgeExpressParams> extends HttpBridge<TParams> {\n  static override readonly configSchemas: Schema[] = [...super.configSchemas, HttpBridgeExpressConfigSchema]\n  protected _app?: Application\n  protected _exposedModules: WeakRef<ModuleInstance>[] = []\n  protected _server?: Server\n\n  protected get app() {\n    if (!this._app) this._app = this.initializeApp()\n    return assertEx(this._app, () => 'App not initialized')\n  }\n\n  async exposeChild(mod: ModuleInstance, options?: BridgeExposeOptions | undefined): Promise<ModuleInstance[]> {\n    const { maxDepth = 5 } = options ?? {}\n    assertEx(this.config.host, () => 'Not configured as a host')\n    this._exposedModules.push(new WeakRef(mod))\n    const children = maxDepth > 0 ? ((await mod.publicChildren?.()) ?? []) : []\n    this.logger.log(`childrenToExpose [${mod.id}][${mod.address}]: ${toJsonString(children.map(child => child.id))}`)\n    const exposedChildren = (await Promise.all(children.map(child => this.exposeChild(child, { maxDepth: maxDepth - 1, required: false }))))\n      .flat()\n      .filter(exists)\n    const allExposed = [mod, ...exposedChildren]\n\n    for (const exposedMod of allExposed) this.logger?.log(`exposed: ${exposedMod.address} [${mod.id}]`)\n\n    return allExposed\n  }\n\n  override async exposeHandler(address: Address, options?: BridgeExposeOptions | undefined): Promise<ModuleInstance[]> {\n    const { required = true } = options ?? {}\n    const mod = await resolveAddressToInstanceUp(this, address)\n    if (required && !mod) {\n      throw new Error(`Unable to find required module: ${address}`)\n    }\n    if (mod) {\n      return this.exposeChild(mod, options)\n    }\n    return []\n  }\n\n  override exposedHandler(): Address[] {\n    return this._exposedModules.map(ref => ref.deref()?.address).filter(exists)\n  }\n\n  override async startHandler(): Promise<boolean> {\n    return (await super.startHandler()) && (await this.startHttpServer())\n  }\n\n  override async stopHandler(_timeout?: number | undefined): Promise<boolean> {\n    return (await super.stopHandler()) && (await this.stopHttpServer())\n  }\n\n  override async unexposeHandler(address: Address, options?: BridgeUnexposeOptions | undefined): Promise<ModuleInstance[]> {\n    const { maxDepth = 2, required = true } = options ?? {}\n    assertEx(this.config.host, () => 'Not configured as a host')\n    const mod = this._exposedModules.find(ref => ref.deref()?.address === address)?.deref()\n    assertEx(!required || mod, () => `Module not exposed: ${address}`)\n    this._exposedModules = this._exposedModules.filter(ref => ref.deref()?.address !== address)\n    if (mod) {\n      const children = maxDepth > 0 ? ((await mod.publicChildren?.()) ?? []) : []\n      const exposedChildren = (\n        await Promise.all(children.map(child => this.unexposeHandler(child.address, { maxDepth: maxDepth - 1, required: false })))\n      )\n        .flat()\n        .filter(exists)\n      return [mod, ...exposedChildren]\n    }\n    return []\n  }\n\n  protected async callLocalModule(address: Address, query: QueryBoundWitness, payloads: Payload[]): Promise<ModuleQueryResult | null> {\n    const mod = this._exposedModules.find(ref => ref.deref()?.address === address)?.deref()\n    return mod ? await mod.query(query, payloads) : null\n  }\n\n  protected async handleGet(req: Request<AddressPathParams, ModuleQueryResult, PostAddressRequestBody>, res: Response) {\n    const { address } = req.params\n    try {\n      if (address == this.address) {\n        res.json(await this.stateQuery(this.account))\n      } else {\n        const mod = this._exposedModules.find(ref => ref.deref()?.address === address)?.deref()\n        // TODO: Use standard errors middleware\n        if (mod) {\n          res.json(await mod.stateQuery(this.account))\n        } else {\n          res.status(StatusCodes.NOT_FOUND).json({ error: 'Module not found' })\n        }\n      }\n    } catch (ex) {\n      // TODO: Sanitize message\n      res.status(StatusCodes.INTERNAL_SERVER_ERROR).json({ error: (ex as Error).message })\n    }\n  }\n\n  protected async handlePost(req: Request<AddressPathParams, ModuleQueryResult, PostAddressRequestBody>, res: Response) {\n    const { address } = req.params\n    const [bw, payloads = []] = Array.isArray(req.body) ? req.body : []\n    const query = isQueryBoundWitness(bw) ? bw : undefined\n    if (!query) {\n      // TODO: Use standard errors middleware\n      res.status(StatusCodes.BAD_REQUEST).json({ error: 'No query provided' })\n      return\n    }\n    try {\n      if (address == this.address) {\n        const result = await this.query(query, payloads)\n        return res.json(result)\n      } else {\n        const result = await this.callLocalModule(address, query, payloads)\n        // TODO: Use standard errors middleware\n        if (result === null) {\n          res.status(StatusCodes.NOT_FOUND).json({ error: 'Module not found' })\n        } else {\n          res.json(result)\n        }\n      }\n    } catch (ex) {\n      // TODO: Sanitize message\n      res.status(StatusCodes.INTERNAL_SERVER_ERROR).json({ error: (ex as Error).message })\n    }\n  }\n\n  protected initializeApp() {\n    // Create the express app\n    const app = express()\n\n    // Add middleware\n    app.use(responseProfiler)\n    app.use(jsonBodyParser)\n    // removed for now since this causes a cycle\n    // app.use(standardResponses)\n    disableExpressDefaultPoweredByHeader(app)\n    app.use(customPoweredByHeader)\n    disableCaseSensitiveRouting(app)\n    useRequestCounters(app)\n\n    // Add routes\n    // Redirect all requests to the root to this module's address\n    app.get('/', (_req, res) => res.redirect(StatusCodes.MOVED_TEMPORARILY, `/${this.address}`))\n    app.post('/', (_req, res) => res.redirect(StatusCodes.TEMPORARY_REDIRECT, `/${this.address}`))\n\n    app.get<AddressPathParams, ModuleQueryResult>(\n      '/:address',\n\n      asyncHandler(async (req, res) => await this.handleGet(req, res)),\n    )\n    app.post<AddressPathParams, ModuleQueryResult, PostAddressRequestBody>(\n      '/:address',\n\n      asyncHandler(async (req, res) => { await this.handlePost(req, res) }),\n    )\n    return app\n  }\n\n  protected startHttpServer(): Promise<boolean> {\n    if (this.config.host) {\n      assertEx(!this._server, () => 'Server already started')\n      this._server = this.app.listen(this.config.host?.port ?? 3030)\n    }\n    return Promise.resolve(true)\n  }\n\n  protected stopHttpServer(): Promise<boolean> {\n    if (this.config.host) {\n      return new Promise((resolve, reject) => {\n        if (this._server) {\n          this._server.close((err) => {\n            if (err) {\n              reject(err)\n            } else {\n              this._server = undefined\n              resolve(true)\n            }\n          })\n        }\n      })\n    }\n    return Promise.resolve(true)\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/types/HttpBridge.d.ts

@@ -0,0 +1,45 @@
+import { Server } from 'node:http';
+import { Address } from '@xylabs/hex';
+import { QueryBoundWitness } from '@xyo-network/boundwitness-model';
+import { HttpBridge, HttpBridgeConfig } from '@xyo-network/bridge-http';
+import { BridgeExposeOptions, BridgeParams, BridgeUnexposeOptions } from '@xyo-network/bridge-model';
+import { AnyConfigSchema, ModuleInstance, ModuleQueryResult } from '@xyo-network/module-model';
+import { Payload, Schema } from '@xyo-network/payload-model';
+import express, { Application, Request, Response } from 'express';
+/**
+ * The type of the path parameters for the address path.
+ */
+type AddressPathParams = {
+    address: Address;
+};
+/**
+ * The type of the request body for the address path.
+ */
+type PostAddressRequestBody = [QueryBoundWitness, undefined | Payload[]];
+export declare const HttpBridgeExpressConfigSchema: "network.xyo.bridge.http.express.config";
+export type HttpBridgeExpressConfigSchema = typeof HttpBridgeExpressConfigSchema;
+export interface HttpBridgeExpressConfig extends HttpBridgeConfig<{}, HttpBridgeExpressConfigSchema> {
+}
+export interface HttpBridgeExpressParams extends BridgeParams<AnyConfigSchema<HttpBridgeExpressConfig>> {
+}
+export declare class HttpBridgeExpress<TParams extends HttpBridgeExpressParams> extends HttpBridge<TParams> {
+    static readonly configSchemas: Schema[];
+    protected _app?: Application;
+    protected _exposedModules: WeakRef<ModuleInstance>[];
+    protected _server?: Server;
+    protected get app(): express.Application;
+    exposeChild(mod: ModuleInstance, options?: BridgeExposeOptions | undefined): Promise<ModuleInstance[]>;
+    exposeHandler(address: Address, options?: BridgeExposeOptions | undefined): Promise<ModuleInstance[]>;
+    exposedHandler(): Address[];
+    startHandler(): Promise<boolean>;
+    stopHandler(_timeout?: number | undefined): Promise<boolean>;
+    unexposeHandler(address: Address, options?: BridgeUnexposeOptions | undefined): Promise<ModuleInstance[]>;
+    protected callLocalModule(address: Address, query: QueryBoundWitness, payloads: Payload[]): Promise<ModuleQueryResult | null>;
+    protected handleGet(req: Request<AddressPathParams, ModuleQueryResult, PostAddressRequestBody>, res: Response): Promise<void>;
+    protected handlePost(req: Request<AddressPathParams, ModuleQueryResult, PostAddressRequestBody>, res: Response): Promise<express.Response<any, Record<string, any>> | undefined>;
+    protected initializeApp(): import(".store/@types-express-serve-static-core-npm-5.0.6-e41caf262c/package").Express;
+    protected startHttpServer(): Promise<boolean>;
+    protected stopHttpServer(): Promise<boolean>;
+}
+export {};
+//# sourceMappingURL=HttpBridge.d.ts.map

package/dist/types/HttpBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpBridge.d.ts","sourceRoot":"","sources":["../../src/HttpBridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAalC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAErC,OAAO,EAAuB,iBAAiB,EAAE,MAAM,iCAAiC,CAAA;AACxF,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AACvE,OAAO,EACL,mBAAmB,EAAE,YAAY,EAAE,qBAAqB,EACzD,MAAM,2BAA2B,CAAA;AAElC,OAAO,EACL,eAAe,EAAmB,cAAc,EAAE,iBAAiB,EACpE,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAA;AAC5D,OAAO,OAAO,EAAE,EACd,WAAW,EAAE,OAAO,EAAE,QAAQ,EAC/B,MAAM,SAAS,CAAA;AAGhB;;GAEG;AACH,KAAK,iBAAiB,GAAG;IACvB,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA;AAED;;GAEG;AACH,KAAK,sBAAsB,GAAG,CAAC,iBAAiB,EAAE,SAAS,GAAG,OAAO,EAAE,CAAC,CAAA;AASxE,eAAO,MAAM,6BAA6B,EAAG,wCAAiD,CAAA;AAC9F,MAAM,MAAM,6BAA6B,GAAG,OAAO,6BAA6B,CAAA;AAEhF,MAAM,WAAW,uBAAwB,SAAQ,gBAAgB,CAAC,EAAE,EAAE,6BAA6B,CAAC;CAAG;AAEvG,MAAM,WAAW,uBAAwB,SAAQ,YAAY,CAAC,eAAe,CAAC,uBAAuB,CAAC,CAAC;CAAG;AAE1G,qBACa,iBAAiB,CAAC,OAAO,SAAS,uBAAuB,CAAE,SAAQ,UAAU,CAAC,OAAO,CAAC;IACjG,gBAAyB,aAAa,EAAE,MAAM,EAAE,CAA0D;IAC1G,SAAS,CAAC,IAAI,CAAC,EAAE,WAAW,CAAA;IAC5B,SAAS,CAAC,eAAe,EAAE,OAAO,CAAC,cAAc,CAAC,EAAE,CAAK;IACzD,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IAE1B,SAAS,KAAK,GAAG,wBAGhB;IAEK,WAAW,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,SAAS,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAgB7F,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,SAAS,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAY3G,cAAc,IAAI,OAAO,EAAE;IAIrB,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC;IAIhC,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;IAI5D,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,SAAS,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;cAkBxG,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;cAKnH,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,iBAAiB,EAAE,iBAAiB,EAAE,sBAAsB,CAAC,EAAE,GAAG,EAAE,QAAQ;cAoBnG,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,iBAAiB,EAAE,iBAAiB,EAAE,sBAAsB,CAAC,EAAE,GAAG,EAAE,QAAQ;IA4BpH,SAAS,CAAC,aAAa;IAgCvB,SAAS,CAAC,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAQ7C,SAAS,CAAC,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;CAiB7C"}

package/dist/types/index.d.ts

@@ -0,0 +1,2 @@
+export * from './HttpBridge.ts';
+//# sourceMappingURL=index.d.ts.map

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

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

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@xyo-network/bridge-http-express",
+  "version": "3.14.0",
+  "description": "Primary SDK for using XYO Protocol 2.0",
+  "homepage": "https://xyo.network",
+  "bugs": {
+    "url": "git+https://github.com/XYOracleNetwork/sdk-xyo-client-js/issues",
+    "email": "support@xyo.network"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/XYOracleNetwork/sdk-xyo-client-js.git"
+  },
+  "license": "LGPL-3.0-only",
+  "author": {
+    "name": "XYO Development Team",
+    "email": "support@xyo.network",
+    "url": "https://xyo.network"
+  },
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "default": "./dist/neutral/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "module": "dist/neutral/index.mjs",
+  "types": "dist/types/index.d.ts",
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE",
+    "package.json"
+  ],
+  "dependencies": {
+    "@xylabs/assert": "^4.8.7",
+    "@xylabs/exists": "^4.8.7",
+    "@xylabs/hex": "^4.8.7",
+    "@xylabs/object": "^4.8.7",
+    "@xyo-network/account": "^3.14.0",
+    "@xyo-network/api-models": "^3.14.0",
+    "@xyo-network/boundwitness-model": "^3.14.0",
+    "@xyo-network/bridge-abstract": "^3.14.0",
+    "@xyo-network/bridge-http": "^3.14.0",
+    "@xyo-network/bridge-model": "^3.14.0",
+    "@xyo-network/module-model": "^3.14.0",
+    "@xyo-network/node-model": "^3.14.0",
+    "@xyo-network/payload-model": "^3.14.0",
+    "express": "^5.1.0",
+    "http-status-codes": "^2.3.0"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.1",
+    "@types/node": "^22.15.2",
+    "@xylabs/express": "^4.8.7",
+    "@xylabs/ts-scripts-yarn3": "^6.3.5",
+    "@xylabs/tsconfig": "^6.3.5",
+    "@xylabs/vitest-extended": "^4.8.7",
+    "@xyo-network/account": "^3.14.0",
+    "@xyo-network/archivist-model": "^3.14.0",
+    "@xyo-network/bridge-abstract": "^3.14.0",
+    "@xyo-network/diviner-model": "^3.14.0",
+    "@xyo-network/module-resolver": "^3.14.0",
+    "@xyo-network/node-memory": "^3.14.0",
+    "@xyo-network/node-model": "^3.14.0",
+    "@xyo-network/payload-builder": "^3.14.0",
+    "@xyo-network/payload-wrapper": "^3.14.0",
+    "get-port-please": "^3.1.2",
+    "typescript": "^5.8.3",
+    "vitest": "^3.1.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}