@matter/general 0.16.0-alpha.0-20251006-3fe1e7c57 → 0.16.0-alpha.0-20251013-89bb7099d

package/dist/esm/environment/Environment.js

@@ -51,18 +51,17 @@ class Environment {
       return mine;
     }
     if (mine === void 0) {
-      let instance = this.#parent?.maybeGet(type);
+      const instance = this.#parent?.maybeGet(type);
       if (instance !== void 0 && instance !== null) {
         return instance;
       }
-      if (type[Environmental.create]) {
-        instance = type[Environmental.create](this);
-        if (!(instance instanceof type)) {
-          throw new InternalError(`Service creation did not produce instance of ${type.name}`);
-        }
-        this.set(type, instance);
-        return instance;
+    }
+    if (type[Environmental.create]) {
+      const instance = type[Environmental.create](this);
+      if (!(instance instanceof type)) {
+        throw new InternalError(`Service creation did not produce instance of ${type.name}`);
       }
+      return instance;
     }
     throw new UnsupportedDependencyError(`Required dependency ${type.name}`, "is not available");
   }
@@ -75,47 +74,33 @@ class Environment {
     }
   }
   /**
-   * Remove an environmental service.
+   * Remove an environmental service and block further inheritance
    *
    * @param type the class of the service to remove
    * @param instance optional instance expected, if existing instance does not match it is not deleted
    */
   delete(type, instance) {
-    if (instance !== void 0 && this.#services?.get(type) !== instance) {
+    const localInstance = this.#services?.get(type);
+    this.#services?.set(type, null);
+    if (localInstance === void 0 || localInstance === null) {
       return;
     }
-    this.#services?.delete(type);
-    this.#parent?.delete(type);
-    this.#deleted.emit(type, instance);
+    if (instance !== void 0 && localInstance !== instance) {
+      return;
+    }
+    this.#deleted.emit(type, localInstance);
     const serviceEvents = this.#serviceEvents.get(type);
     if (serviceEvents) {
-      serviceEvents.deleted.emit(instance);
-    }
-  }
-  /**
-   * Prevent this environment from automatically instantiating or retrieving a service from parent environment.
-   *
-   * @param type the class of the service to block
-   */
-  block(type) {
-    const instance = this.#services?.get(type);
-    if (instance !== void 0 && instance !== null) {
-      this.#services?.delete(type);
-      this.#deleted.emit(type, instance);
-      const serviceEvents = this.#serviceEvents.get(type);
-      if (serviceEvents) {
-        serviceEvents.deleted.emit(instance);
-      }
+      serviceEvents.deleted.emit(localInstance);
     }
-    this.#services?.set(type, null);
   }
   /**
    * Remove and close an environmental service.
    */
   close(type) {
     const instance = this.maybeGet(type);
+    this.delete(type, instance);
     if (instance !== void 0) {
-      this.delete(type, instance);
       return instance.close?.();
     }
   }

package/dist/esm/environment/Environment.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/environment/Environment.ts"],
-  "mappings": "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",
+  "mappings": "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",
   "names": []
 }

package/dist/esm/environment/Environmental.d.ts

@@ -18,10 +18,24 @@ export declare namespace Environmental {
          */
         construction?: Promise<any>;
     }
+    /**
+     * An object used for service identification.
+     *
+     * We use classes as the key for service registration.  Classes serve as ideal keys because they are trivial to
+     * manage and allow us to manage services in a type-safe manner.
+     *
+     * Any class may be used as the service identifier; the only requirement is that a registered instance is a subclass
+     * of the {@link ServiceType}.
+     *
+     * Note that {@link Environment} only considers service available for the exact class under which they are
+     * registered.  You cannot retrieve a service registered for a subclass of a {@link ServiceType} using the base
+     * class.  You can however register the under both the base and derived {@link ServiceType}s.
+     */
+    type ServiceType<T extends object = object> = abstract new (...args: any[]) => T;
     /**
      * A factory for a {@link Service}.
      *
-     * A "factory" is just a class with a static {@link create} method that performs instantiation.
+     * A "factory" is a concrete {@link ServiceType} with a static {@link create} method that performs instantiation.
      */
     interface Factory<T extends object = object> {
         new (...args: any[]): T;
@@ -36,7 +50,7 @@ export declare namespace Environmental {
     /**
      * Events related to service lifecycle.
      */
-    interface ServiceEvents<T extends abstract new (...args: any[]) => T> {
+    interface ServiceEvents<T extends Environmental.ServiceType> {
         added: Observable<[instance: InstanceType<T>]>;
         deleted: Observable<[instance: InstanceType<T>]>;
     }

package/dist/esm/environment/Environmental.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Environmental.d.ts","sourceRoot":"","sources":["../../../src/environment/Environmental.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,yBAAiB,aAAa,CAAC;IACpB,MAAM,MAAM,eAAmB,CAAC;IAEvC;;;;OAIG;IACH,UAAiB,OAAO;QACpB;;WAEG;QACH,YAAY,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;KAC/B;IAED;;;;OAIG;IACH,UAAiB,OAAO,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;QAC9C,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QAExB;;;;;WAKG;QACH,CAAC,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,WAAW,KAAK,CAAC,CAAC;KAC7C;IAED;;OAEG;IACH,UAAiB,aAAa,CAAC,CAAC,SAAS,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC;QACvE,KAAK,EAAE,UAAU,CAAC,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/C,OAAO,EAAE,UAAU,CAAC,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KACpD;CACJ"}
+{"version":3,"file":"Environmental.d.ts","sourceRoot":"","sources":["../../../src/environment/Environmental.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,yBAAiB,aAAa,CAAC;IACpB,MAAM,MAAM,eAAmB,CAAC;IAEvC;;;;OAIG;IACH,UAAiB,OAAO;QACpB;;WAEG;QACH,YAAY,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;KAC/B;IAED;;;;;;;;;;;;OAYG;IACH,KAAY,WAAW,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IAExF;;;;OAIG;IACH,UAAiB,OAAO,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;QAC9C,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QAExB;;;;;WAKG;QACH,CAAC,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,WAAW,KAAK,CAAC,CAAC;KAC7C;IAED;;OAEG;IACH,UAAiB,aAAa,CAAC,CAAC,SAAS,aAAa,CAAC,WAAW;QAC9D,KAAK,EAAE,UAAU,CAAC,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/C,OAAO,EAAE,UAAU,CAAC,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KACpD;CACJ"}

package/dist/esm/log/Logger.js

@@ -165,7 +165,7 @@ class Logger {
     for (const name in Logger.destinations) {
       const dest = Logger.destinations[name];
       if (level < (dest.facilityLevels?.[this.#name] ?? dest.level)) {
-        return;
+        continue;
       }
       if (!dest.context) {
         dest.context = Diagnostic.Context();

package/dist/esm/net/Network.d.ts

@@ -10,6 +10,10 @@ export declare class NetworkError extends MatterError {
 }
 export declare class NoAddressAvailableError extends NetworkError {
 }
+export declare class BindError extends NetworkError {
+}
+export declare class AddressInUseError extends BindError {
+}
 export declare const STANDARD_MATTER_PORT = 5540;
 /**
  * @see {@link MatterSpecification.v11.Core} § 11.11.4.4

package/dist/esm/net/Network.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Network.d.ts","sourceRoot":"","sources":["../../../src/net/Network.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAEzE,qBAAa,YAAa,SAAQ,WAAW;CAAG;AAEhD,qBAAa,uBAAwB,SAAQ,YAAY;CAAG;AAE5D,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAEzC;;;GAGG;AACH,oBAAY,aAAa;IACrB;;OAEG;IACH,WAAW,IAAI;IAEf;;OAEG;IACH,IAAI,IAAI;IAER;;OAEG;IACH,QAAQ,IAAI;IAEZ;;OAEG;IACH,QAAQ,IAAI;IAEZ;;OAEG;IACH,MAAM,IAAI;CACb;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,aAAa,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,gBAAgB,GAAG,uBAAuB,CAAC;AAClF,8BAAsB,OAAO;IACzB,QAAQ,CAAC,gBAAgB,CAAC,aAAa,CAAC,EAAE,gBAAgB,EAAE,GAAG,YAAY,CAAC,gBAAgB,EAAE,CAAC;IAC/F,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,YAAY,CAAC,uBAAuB,GAAG,SAAS,CAAC;IAC1F,QAAQ,CAAC,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC;IAEpE,KAAK;CAGd"}
+{"version":3,"file":"Network.d.ts","sourceRoot":"","sources":["../../../src/net/Network.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAEzE,qBAAa,YAAa,SAAQ,WAAW;CAAG;AAEhD,qBAAa,uBAAwB,SAAQ,YAAY;CAAG;AAE5D,qBAAa,SAAU,SAAQ,YAAY;CAAG;AAE9C,qBAAa,iBAAkB,SAAQ,SAAS;CAAG;AAEnD,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAEzC;;;GAGG;AACH,oBAAY,aAAa;IACrB;;OAEG;IACH,WAAW,IAAI;IAEf;;OAEG;IACH,IAAI,IAAI;IAER;;OAEG;IACH,QAAQ,IAAI;IAEZ;;OAEG;IACH,QAAQ,IAAI;IAEZ;;OAEG;IACH,MAAM,IAAI;CACb;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,aAAa,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,gBAAgB,GAAG,uBAAuB,CAAC;AAClF,8BAAsB,OAAO;IACzB,QAAQ,CAAC,gBAAgB,CAAC,aAAa,CAAC,EAAE,gBAAgB,EAAE,GAAG,YAAY,CAAC,gBAAgB,EAAE,CAAC;IAC/F,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,YAAY,CAAC,uBAAuB,GAAG,SAAS,CAAC;IAC1F,QAAQ,CAAC,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC;IAEpE,KAAK;CAGd"}

package/dist/esm/net/Network.js

@@ -8,6 +8,10 @@ class NetworkError extends MatterError {
 }
 class NoAddressAvailableError extends NetworkError {
 }
+class BindError extends NetworkError {
+}
+class AddressInUseError extends BindError {
+}
 const STANDARD_MATTER_PORT = 5540;
 var InterfaceType = /* @__PURE__ */ ((InterfaceType2) => {
   InterfaceType2[InterfaceType2["Unspecified"] = 0] = "Unspecified";
@@ -22,6 +26,8 @@ class Network {
   }
 }
 export {
+  AddressInUseError,
+  BindError,
   InterfaceType,
   Network,
   NetworkError,

package/dist/esm/net/Network.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/net/Network.ts"],
-  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,mBAAmB;AAIrB,MAAM,qBAAqB,YAAY;AAAC;AAExC,MAAM,gCAAgC,aAAa;AAAC;AAEpD,MAAM,uBAAuB;AAM7B,IAAK,gBAAL,kBAAKA,mBAAL;AAIH,EAAAA,8BAAA,iBAAc,KAAd;AAKA,EAAAA,8BAAA,UAAO,KAAP;AAKA,EAAAA,8BAAA,cAAW,KAAX;AAKA,EAAAA,8BAAA,cAAW,KAAX;AAKA,EAAAA,8BAAA,YAAS,KAAT;AAxBQ,SAAAA;AAAA,GAAA;AAuCL,MAAe,QAAQ;AAAA,EAK1B,MAAM,QAAQ;AAAA,EAEd;AACJ;",
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,mBAAmB;AAIrB,MAAM,qBAAqB,YAAY;AAAC;AAExC,MAAM,gCAAgC,aAAa;AAAC;AAEpD,MAAM,kBAAkB,aAAa;AAAC;AAEtC,MAAM,0BAA0B,UAAU;AAAC;AAE3C,MAAM,uBAAuB;AAM7B,IAAK,gBAAL,kBAAKA,mBAAL;AAIH,EAAAA,8BAAA,iBAAc,KAAd;AAKA,EAAAA,8BAAA,UAAO,KAAP;AAKA,EAAAA,8BAAA,cAAW,KAAX;AAKA,EAAAA,8BAAA,cAAW,KAAX;AAKA,EAAAA,8BAAA,YAAS,KAAT;AAxBQ,SAAAA;AAAA,GAAA;AAuCL,MAAe,QAAQ;AAAA,EAK1B,MAAM,QAAQ;AAAA,EAEd;AACJ;",
   "names": ["InterfaceType"]
 }

package/dist/esm/net/ServerAddress.d.ts

@@ -31,6 +31,7 @@ export declare function ServerAddress(definition: ServerAddress.Definition): Ser
 export declare namespace ServerAddress {
     function urlFor(address: ServerAddress): string;
     function diagnosticFor(address: ServerAddress): Diagnostic;
+    function isEqual(a: ServerAddress, b: ServerAddress): boolean;
     function definitionOf(address: ServerAddress): Definition;
     interface Definition extends Omit<ServerAddress, "ttl"> {
         ttl?: Duration;

package/dist/esm/net/ServerAddress.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ServerAddress.d.ts","sourceRoot":"","sources":["../../../src/net/ServerAddress.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG/C,MAAM,MAAM,gBAAgB,GAAG;IAC3B,IAAI,EAAE,KAAK,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC3B,IAAI,EAAE,KAAK,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC3B,IAAI,EAAE,KAAK,CAAC;IACZ,iBAAiB,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,MAAM,WAAW,QAAQ;IACrB,0DAA0D;IAC1D,YAAY,EAAE,SAAS,CAAC;IAExB,6CAA6C;IAC7C,GAAG,EAAE,QAAQ,CAAC;CACjB;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,gBAAgB,GAAG,gBAAgB,GAAG,gBAAgB,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEzG,wBAAgB,aAAa,CAAC,UAAU,EAAE,aAAa,CAAC,UAAU,GAKzD,aAAa,CACrB;AAED,yBAAiB,aAAa,CAAC;IAC3B,SAAgB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAYrD;IAED,SAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,cAuBnD;IAED,SAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,UAAU,CAE/D;IAED,UAAiB,UAAW,SAAQ,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC;QAC1D,GAAG,CAAC,EAAE,QAAQ,CAAC;KAClB;CACJ"}
+{"version":3,"file":"ServerAddress.d.ts","sourceRoot":"","sources":["../../../src/net/ServerAddress.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG/C,MAAM,MAAM,gBAAgB,GAAG;IAC3B,IAAI,EAAE,KAAK,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC3B,IAAI,EAAE,KAAK,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC3B,IAAI,EAAE,KAAK,CAAC;IACZ,iBAAiB,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,MAAM,WAAW,QAAQ;IACrB,0DAA0D;IAC1D,YAAY,EAAE,SAAS,CAAC;IAExB,6CAA6C;IAC7C,GAAG,EAAE,QAAQ,CAAC;CACjB;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,gBAAgB,GAAG,gBAAgB,GAAG,gBAAgB,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEzG,wBAAgB,aAAa,CAAC,UAAU,EAAE,aAAa,CAAC,UAAU,GAKzD,aAAa,CACrB;AAED,yBAAiB,aAAa,CAAC;IAC3B,SAAgB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAYrD;IAED,SAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,cAuBnD;IAED,SAAgB,OAAO,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,aAAa,GAAG,OAAO,CAcnE;IAED,SAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,UAAU,CAE/D;IAED,UAAiB,UAAW,SAAQ,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC;QAC1D,GAAG,CAAC,EAAE,QAAQ,CAAC;KAClB;CACJ"}

package/dist/esm/net/ServerAddress.js

@@ -46,6 +46,19 @@ function ServerAddress(definition) {
     return Diagnostic.squash(...diagnostic);
   }
   ServerAddress2.diagnosticFor = diagnosticFor;
+  function isEqual(a, b) {
+    if (a.type !== b.type) {
+      return false;
+    }
+    if (a.type === "udp" && b.type === "udp") {
+      return a.ip === b.ip && a.port === b.port;
+    }
+    if (a.type === "ble" && b.type === "ble") {
+      return a.peripheralAddress === b.peripheralAddress;
+    }
+    return false;
+  }
+  ServerAddress2.isEqual = isEqual;
   function definitionOf(address) {
     return address;
   }

package/dist/esm/net/ServerAddress.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/net/ServerAddress.ts"],
-  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,kBAAkB;AAC3B,SAAS,gBAAgB;AAEzB,SAAS,eAAe;AA6BjB,SAAS,cAAc,YAAsC;AAChE,SAAO;AAAA,IACH,cAAc;AAAA,IACd,GAAG;AAAA,IACH,KAAK,QAAQ,WAAW,GAAG;AAAA,EAC/B;AACJ;AAAA,CAEO,CAAUA,mBAAV;AACI,WAAS,OAAO,SAAgC;AACnD,YAAQ,QAAQ,MAAM;AAAA,MAClB,KAAK;AAAA,MACL,KAAK;AACD,eAAO,GAAG,QAAQ,IAAI,MAAM,QAAQ,EAAE,IAAI,QAAQ,IAAI;AAAA,MAE1D,KAAK;AACD,eAAO,SAAS,QAAQ,iBAAiB;AAAA,MAE7C;AACI,eAAO,GAAI,QAAgB,IAAI;AAAA,IACvC;AAAA,EACJ;AAZO,EAAAA,eAAS;AAcT,WAAS,cAAc,SAAwB;AAClD,UAAM,aAAa,MAAe;AAElC,YAAQ,QAAQ,MAAM;AAAA,MAClB,KAAK;AAAA,MACL,KAAK;AACD,mBAAW,KAAK,GAAG,QAAQ,IAAI,OAAO,WAAW,OAAO,QAAQ,EAAE,GAAG,KAAK,QAAQ,IAAI;AACtF;AAAA,MAEJ,KAAK;AACD,mBAAW,KAAK,UAAU,WAAW,OAAO,QAAQ,iBAAiB,CAAC;AACtE;AAAA,MAEJ;AACI,mBAAW,KAAK,GAAI,QAAgB,IAAI,KAAK;AAC7C;AAAA,IACR;AAEA,QAAI,SAAS,WAAW,OAAO,QAAQ,QAAQ,UAAU;AACrD,iBAAW,KAAK,SAAS,SAAS,OAAO,QAAQ,GAAG,CAAC;AAAA,IACzD;AAEA,WAAO,WAAW,OAAO,GAAG,UAAU;AAAA,EAC1C;AAvBO,EAAAA,eAAS;AAyBT,WAAS,aAAa,SAAoC;AAC7D,WAAO;AAAA,EACX;AAFO,EAAAA,eAAS;AAAA,GAxCH;",
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,kBAAkB;AAC3B,SAAS,gBAAgB;AAEzB,SAAS,eAAe;AA6BjB,SAAS,cAAc,YAAsC;AAChE,SAAO;AAAA,IACH,cAAc;AAAA,IACd,GAAG;AAAA,IACH,KAAK,QAAQ,WAAW,GAAG;AAAA,EAC/B;AACJ;AAAA,CAEO,CAAUA,mBAAV;AACI,WAAS,OAAO,SAAgC;AACnD,YAAQ,QAAQ,MAAM;AAAA,MAClB,KAAK;AAAA,MACL,KAAK;AACD,eAAO,GAAG,QAAQ,IAAI,MAAM,QAAQ,EAAE,IAAI,QAAQ,IAAI;AAAA,MAE1D,KAAK;AACD,eAAO,SAAS,QAAQ,iBAAiB;AAAA,MAE7C;AACI,eAAO,GAAI,QAAgB,IAAI;AAAA,IACvC;AAAA,EACJ;AAZO,EAAAA,eAAS;AAcT,WAAS,cAAc,SAAwB;AAClD,UAAM,aAAa,MAAe;AAElC,YAAQ,QAAQ,MAAM;AAAA,MAClB,KAAK;AAAA,MACL,KAAK;AACD,mBAAW,KAAK,GAAG,QAAQ,IAAI,OAAO,WAAW,OAAO,QAAQ,EAAE,GAAG,KAAK,QAAQ,IAAI;AACtF;AAAA,MAEJ,KAAK;AACD,mBAAW,KAAK,UAAU,WAAW,OAAO,QAAQ,iBAAiB,CAAC;AACtE;AAAA,MAEJ;AACI,mBAAW,KAAK,GAAI,QAAgB,IAAI,KAAK;AAC7C;AAAA,IACR;AAEA,QAAI,SAAS,WAAW,OAAO,QAAQ,QAAQ,UAAU;AACrD,iBAAW,KAAK,SAAS,SAAS,OAAO,QAAQ,GAAG,CAAC;AAAA,IACzD;AAEA,WAAO,WAAW,OAAO,GAAG,UAAU;AAAA,EAC1C;AAvBO,EAAAA,eAAS;AAyBT,WAAS,QAAQ,GAAkB,GAA2B;AACjE,QAAI,EAAE,SAAS,EAAE,MAAM;AACnB,aAAO;AAAA,IACX;AAEA,QAAI,EAAE,SAAS,SAAS,EAAE,SAAS,OAAO;AACtC,aAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE;AAAA,IACzC;AAEA,QAAI,EAAE,SAAS,SAAS,EAAE,SAAS,OAAO;AACtC,aAAO,EAAE,sBAAsB,EAAE;AAAA,IACrC;AAEA,WAAO;AAAA,EACX;AAdO,EAAAA,eAAS;AAgBT,WAAS,aAAa,SAAoC;AAC7D,WAAO;AAAA,EACX;AAFO,EAAAA,eAAS;AAAA,GAxDH;",
   "names": ["ServerAddress"]
 }

package/dist/esm/net/http/HttpEndpoint.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { AppAddress } from "#net/AppAddress.js";
+import { Bytes } from "#util/Bytes.js";
+import { MaybePromise } from "#util/Promises.js";
+/**
+ * A platform-independent HTTP endpoint implementation.
+ *
+ * This provides a modern WinterTC-style interface with a focus on simplifying platform-specific implementations.
+ */
+export interface HttpEndpoint {
+    /**
+     * Handler for normal HTTP requests.
+     */
+    http?: HttpEndpoint.HttpHandler;
+    /**
+     * Handler for WebSocket upgrade requests.
+     */
+    ws?: HttpEndpoint.WsHandler;
+    /**
+     * Release resources for the endpoint.
+     */
+    close(): Promise<void>;
+}
+export declare namespace HttpEndpoint {
+    /**
+     * HTTP request callback.
+     */
+    type HttpHandler = (request: Request) => MaybePromise<void | Response>;
+    /**
+     * WebSocket request callback.
+     */
+    type WsHandler = (request: Request, upgrade: () => Promise<WsConnection>) => MaybePromise<void>;
+    /**
+     * A WebSocket connection.
+     */
+    interface WsConnection extends ReadableWritablePair<WsMessage, WsMessage> {
+    }
+    /**
+     * Raw WebSocket message payload.
+     */
+    type WsMessage = Bytes | string;
+    /**
+     * Configuration options.
+     */
+    interface Options {
+        address: AppAddress.Definition;
+    }
+}
+//# sourceMappingURL=HttpEndpoint.d.ts.map

package/dist/esm/net/http/HttpEndpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpEndpoint.d.ts","sourceRoot":"","sources":["../../../../src/net/http/HttpEndpoint.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;;;GAIG;AACH,MAAM,WAAW,YAAY;IACzB;;OAEG;IACH,IAAI,CAAC,EAAE,YAAY,CAAC,WAAW,CAAC;IAEhC;;OAEG;IACH,EAAE,CAAC,EAAE,YAAY,CAAC,SAAS,CAAC;IAE5B;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,yBAAiB,YAAY,CAAC;IAC1B;;OAEG;IACH,KAAY,WAAW,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,YAAY,CAAC,IAAI,GAAG,QAAQ,CAAC,CAAC;IAE9E;;OAEG;IACH,KAAY,SAAS,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,KAAK,YAAY,CAAC,IAAI,CAAC,CAAC;IAEvG;;OAEG;IACH,UAAiB,YAAa,SAAQ,oBAAoB,CAAC,SAAS,EAAE,SAAS,CAAC;KAAG;IAEnF;;OAEG;IACH,KAAY,SAAS,GAAG,KAAK,GAAG,MAAM,CAAC;IAEvC;;OAEG;IACH,UAAiB,OAAO;QACpB,OAAO,EAAE,UAAU,CAAC,UAAU,CAAC;KAClC;CACJ"}

package/dist/esm/net/http/HttpEndpoint.js

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+//# sourceMappingURL=HttpEndpoint.js.map

package/dist/esm/net/http/HttpEndpoint.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/net/http/HttpEndpoint.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "names": []
+}

package/dist/esm/net/http/HttpEndpointFactory.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { HttpEndpoint } from "./HttpEndpoint.js";
+/**
+ * Environmental component that creates HTTP endpoints.
+ *
+ * This component creates a dedicated HTTP server.  Use {@link HttpService} for shared access to HTTP endpoints.
+ */
+export declare abstract class HttpEndpointFactory {
+    /**
+     * Indicates support for HTTP handlers.
+     */
+    supportsHttp: boolean;
+    /**
+     * Indicates support for WebSocket handlers.
+     */
+    supportsWs: boolean;
+    abstract create(options: HttpEndpoint.Options): Promise<HttpEndpoint>;
+}
+//# sourceMappingURL=HttpEndpointFactory.d.ts.map

package/dist/esm/net/http/HttpEndpointFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpEndpointFactory.d.ts","sourceRoot":"","sources":["../../../../src/net/http/HttpEndpointFactory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD;;;;GAIG;AACH,8BAAsB,mBAAmB;IACrC;;OAEG;IACH,YAAY,UAAQ;IAEpB;;OAEG;IACH,UAAU,UAAQ;IAElB,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC;CACxE"}

package/dist/esm/net/http/HttpEndpointFactory.js

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class HttpEndpointFactory {
+  /**
+   * Indicates support for HTTP handlers.
+   */
+  supportsHttp = true;
+  /**
+   * Indicates support for WebSocket handlers.
+   */
+  supportsWs = true;
+}
+export {
+  HttpEndpointFactory
+};
+//# sourceMappingURL=HttpEndpointFactory.js.map

package/dist/esm/net/http/HttpEndpointFactory.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/net/http/HttpEndpointFactory.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAcO,MAAe,oBAAoB;AAAA;AAAA;AAAA;AAAA,EAItC,eAAe;AAAA;AAAA;AAAA;AAAA,EAKf,aAAa;AAGjB;",
+  "names": []
+}

package/dist/esm/net/http/HttpEndpointGroup.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { HttpEndpoint } from "./HttpEndpoint.js";
+/**
+ * A collection of HTTP endpoints that support the same set of handlers.
+ */
+export declare class HttpEndpointGroup implements HttpEndpoint {
+    #private;
+    constructor(endpoints: HttpEndpoint[]);
+    set http(handler: HttpEndpoint.HttpHandler);
+    set ws(handler: HttpEndpoint.WsHandler);
+    close(): Promise<void>;
+}
+//# sourceMappingURL=HttpEndpointGroup.d.ts.map

package/dist/esm/net/http/HttpEndpointGroup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpEndpointGroup.d.ts","sourceRoot":"","sources":["../../../../src/net/http/HttpEndpointGroup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAIjD;;GAEG;AACH,qBAAa,iBAAkB,YAAW,YAAY;;gBAGtC,SAAS,EAAE,YAAY,EAAE;IAIrC,IAAI,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,WAAW,EAIzC;IAED,IAAI,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC,SAAS,EAIrC;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ/B"}

package/dist/esm/net/http/HttpEndpointGroup.js

@@ -0,0 +1,36 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Logger } from "#log/Logger.js";
+import { MatterAggregateError } from "#MatterError.js";
+const logger = Logger.get("HttpEndpointGroup");
+class HttpEndpointGroup {
+  #endpoints;
+  constructor(endpoints) {
+    this.#endpoints = endpoints;
+  }
+  set http(handler) {
+    for (const endpoint of this.#endpoints) {
+      endpoint.http = handler;
+    }
+  }
+  set ws(handler) {
+    for (const endpoint of this.#endpoints) {
+      endpoint.ws = handler;
+    }
+  }
+  async close() {
+    try {
+      await MatterAggregateError.allSettled(this.#endpoints.map((endpoint) => endpoint.close()));
+    } catch (e) {
+      logger.error("Error closing HTTP endpoints", e);
+    }
+    this.#endpoints = [];
+  }
+}
+export {
+  HttpEndpointGroup
+};
+//# sourceMappingURL=HttpEndpointGroup.js.map

package/dist/esm/net/http/HttpEndpointGroup.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/net/http/HttpEndpointGroup.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,cAAc;AACvB,SAAS,4BAA4B;AAGrC,MAAM,SAAS,OAAO,IAAI,mBAAmB;AAKtC,MAAM,kBAA0C;AAAA,EACnD;AAAA,EAEA,YAAY,WAA2B;AACnC,SAAK,aAAa;AAAA,EACtB;AAAA,EAEA,IAAI,KAAK,SAAmC;AACxC,eAAW,YAAY,KAAK,YAAY;AACpC,eAAS,OAAO;AAAA,IACpB;AAAA,EACJ;AAAA,EAEA,IAAI,GAAG,SAAiC;AACpC,eAAW,YAAY,KAAK,YAAY;AACpC,eAAS,KAAK;AAAA,IAClB;AAAA,EACJ;AAAA,EAEA,MAAM,QAAuB;AACzB,QAAI;AACA,YAAM,qBAAqB,WAAW,KAAK,WAAW,IAAI,cAAY,SAAS,MAAM,CAAC,CAAC;AAAA,IAC3F,SAAS,GAAG;AACR,aAAO,MAAM,gCAAgC,CAAC;AAAA,IAClD;AACA,SAAK,aAAa,CAAC;AAAA,EACvB;AACJ;",
+  "names": []
+}

package/dist/esm/net/http/HttpService.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Environment } from "#environment/Environment.js";
+import { Environmental } from "#environment/Environmental.js";
+import { AppAddress } from "#net/AppAddress.js";
+import { HttpEndpoint } from "./HttpEndpoint.js";
+import { HttpEndpointFactory } from "./HttpEndpointFactory.js";
+/**
+ * An environmental service that manages shared access to a set of endpoints.
+ */
+export declare class HttpService {
+    #private;
+    constructor(factory: HttpEndpointFactory);
+    create(...addresses: AppAddress.Definition[]): Promise<HttpEndpoint>;
+    static [Environmental.create](env: Environment): HttpService;
+}
+//# sourceMappingURL=HttpService.d.ts.map

package/dist/esm/net/http/HttpService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpService.d.ts","sourceRoot":"","sources":["../../../../src/net/http/HttpService.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAE9D,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAI/D;;GAEG;AACH,qBAAa,WAAW;;gBAIR,OAAO,EAAE,mBAAmB;IAIlC,MAAM,CAAC,GAAG,SAAS,EAAE,UAAU,CAAC,UAAU,EAAE;IA2ClD,MAAM,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,WAAW;CAKjD"}

package/dist/esm/net/http/HttpService.js

@@ -0,0 +1,63 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Environmental } from "#environment/Environmental.js";
+import { ImplementationError } from "#MatterError.js";
+import { AppAddress } from "#net/AppAddress.js";
+import { HttpEndpointFactory } from "./HttpEndpointFactory.js";
+import { HttpEndpointGroup } from "./HttpEndpointGroup.js";
+import { HttpSharedEndpoint } from "./HttpSharedEndpoint.js";
+class HttpService {
+  #factory;
+  #endpoints = {};
+  constructor(factory) {
+    this.#factory = factory;
+  }
+  async create(...addresses) {
+    if (addresses.length === 1) {
+      return this.#forAddress(addresses[0]);
+    }
+    const endpoints = Array();
+    try {
+      for (const address of addresses) {
+        endpoints.push(await this.#forAddress(address));
+      }
+    } catch (e) {
+      await Promise.allSettled(endpoints.map((endpoint) => endpoint.close()));
+      throw e;
+    }
+    return new HttpEndpointGroup(endpoints);
+  }
+  async #forAddress(address) {
+    const addr = AppAddress.for(address);
+    if (addr.appProtocol !== "http" && addr.appProtocol !== "ws") {
+      throw new ImplementationError(`Unsupported address ${addr} for HTTP endpoint`);
+    }
+    const key = JSON.stringify(addr.transport);
+    let endpoint = this.#endpoints[key];
+    if (endpoint) {
+      if (endpoint.isTls !== addr.isTls) {
+        const addrIs = addr.isTls ? "encrypted" : "unencrypted";
+        const endpointIs = endpoint.isTls ? "encrypted" : "unencrypted";
+        throw new ImplementationError(
+          `Service address ${addr} is ${addrIs} but existing endpoint is ${endpointIs}`
+        );
+      }
+    } else {
+      endpoint = new HttpSharedEndpoint(addr.isTls, () => this.#factory.create({ address }));
+      this.#endpoints[key] = endpoint;
+    }
+    return await endpoint.use();
+  }
+  static [Environmental.create](env) {
+    const instance = new HttpService(env.get(HttpEndpointFactory));
+    env.set(HttpService, instance);
+    return instance;
+  }
+}
+export {
+  HttpService
+};
+//# sourceMappingURL=HttpService.js.map

package/dist/esm/net/http/HttpService.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/net/http/HttpService.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,SAAS,qBAAqB;AAC9B,SAAS,2BAA2B;AACpC,SAAS,kBAAkB;AAE3B,SAAS,2BAA2B;AACpC,SAAS,yBAAyB;AAClC,SAAS,0BAA0B;AAK5B,MAAM,YAAY;AAAA,EACrB;AAAA,EACA,aAAa,CAAC;AAAA,EAEd,YAAY,SAA8B;AACtC,SAAK,WAAW;AAAA,EACpB;AAAA,EAEA,MAAM,UAAU,WAAoC;AAChD,QAAI,UAAU,WAAW,GAAG;AACxB,aAAO,KAAK,YAAY,UAAU,CAAC,CAAC;AAAA,IACxC;AAEA,UAAM,YAAY,MAAoB;AAEtC,QAAI;AACA,iBAAW,WAAW,WAAW;AAC7B,kBAAU,KAAK,MAAM,KAAK,YAAY,OAAO,CAAC;AAAA,MAClD;AAAA,IACJ,SAAS,GAAG;AACR,YAAM,QAAQ,WAAW,UAAU,IAAI,cAAY,SAAS,MAAM,CAAC,CAAC;AACpE,YAAM;AAAA,IACV;AAEA,WAAO,IAAI,kBAAkB,SAAS;AAAA,EAC1C;AAAA,EAEA,MAAM,YAAY,SAAgC;AAC9C,UAAM,OAAO,WAAW,IAAI,OAAO;AACnC,QAAI,KAAK,gBAAgB,UAAU,KAAK,gBAAgB,MAAM;AAC1D,YAAM,IAAI,oBAAoB,uBAAuB,IAAI,oBAAoB;AAAA,IACjF;AAEA,UAAM,MAAM,KAAK,UAAU,KAAK,SAAS;AACzC,QAAI,WAAW,KAAK,WAAW,GAAG;AAClC,QAAI,UAAU;AACV,UAAI,SAAS,UAAU,KAAK,OAAO;AAC/B,cAAM,SAAS,KAAK,QAAQ,cAAc;AAC1C,cAAM,aAAa,SAAS,QAAQ,cAAc;AAClD,cAAM,IAAI;AAAA,UACN,mBAAmB,IAAI,OAAO,MAAM,6BAA6B,UAAU;AAAA,QAC/E;AAAA,MACJ;AAAA,IACJ,OAAO;AACH,iBAAW,IAAI,mBAAmB,KAAK,OAAO,MAAM,KAAK,SAAS,OAAO,EAAE,QAAQ,CAAC,CAAC;AACrF,WAAK,WAAW,GAAG,IAAI;AAAA,IAC3B;AAEA,WAAO,MAAM,SAAS,IAAI;AAAA,EAC9B;AAAA,EAEA,QAAQ,cAAc,MAAM,EAAE,KAAkB;AAC5C,UAAM,WAAW,IAAI,YAAY,IAAI,IAAI,mBAAmB,CAAC;AAC7D,QAAI,IAAI,aAAa,QAAQ;AAC7B,WAAO;AAAA,EACX;AACJ;",
+  "names": []
+}

package/dist/esm/net/http/HttpSharedEndpoint.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { HttpEndpoint } from "./HttpEndpoint.js";
+/**
+ * Shared access to a single underlying HTTP endpoint.
+ */
+export declare class HttpSharedEndpoint {
+    #private;
+    constructor(isTls: boolean, create: () => Promise<HttpEndpoint>);
+    get isTls(): boolean;
+    use(): Promise<HttpEndpoint>;
+}
+//# sourceMappingURL=HttpSharedEndpoint.d.ts.map

package/dist/esm/net/http/HttpSharedEndpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpSharedEndpoint.d.ts","sourceRoot":"","sources":["../../../../src/net/http/HttpSharedEndpoint.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAIjD;;GAEG;AACH,qBAAa,kBAAkB;;gBAMf,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC;IAK/D,IAAI,KAAK,YAER;IAEK,GAAG;CA0DZ"}