@3sixty/telemetry-models 0.0.0-stage → 0.20.0-next.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2024 IOTA Stiftung.
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -1,3 +1,25 @@
-# Temporary Holding Version
+# 3Sixty Telemetry Models
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Shared telemetry models for connectors and services.
+
+## Installation
+
+```shell
+npm install @3sixty/telemetry-models
+```
+
+## Examples
+
+Usage of the APIs is shown in the examples [docs/examples.md](docs/examples.md)
+
+## Reference
+
+Detailed reference documentation for the API can be found in [docs/reference/index.md](docs/reference/index.md)
+
+## Changelog
+
+The changes between each version can be found in [docs/changelog.md](docs/changelog.md)
+
+## Origin
+
+This package is derived from the original [iotaledger/twin-telemetry](https://github.com/iotaledger/twin-telemetry/tree/next/packages/telemetry-models) repository.

package/dist/es/connectors/multiTelemetryConnector.js

@@ -0,0 +1,184 @@
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+import { Guards, Is, NotImplementedError, NotSupportedError } from "@3sixty/core";
+import { TelemetryConnectorFactory } from "../factories/telemetryConnectorFactory.js";
+import { MetricType } from "../models/metricType.js";
+/**
+ * Class for performing telemetry operations on multiple connectors.
+ */
+export class MultiTelemetryConnector {
+    /**
+     * The namespace for the class.
+     */
+    static NAMESPACE = "multi";
+    /**
+     * Runtime name for the class.
+     */
+    static CLASS_NAME = "MultiTelemetryConnector";
+    /**
+     * The connectors to send the telemetry entries to.
+     * @internal
+     */
+    _telemetryConnectors;
+    /**
+     * Create a new instance of MultiTelemetryConnector.
+     * @param options The options for the connector.
+     */
+    constructor(options) {
+        Guards.object(MultiTelemetryConnector.CLASS_NAME, "options", options);
+        Guards.arrayValue(MultiTelemetryConnector.CLASS_NAME, "options.telemetryConnectorTypes", options.telemetryConnectorTypes);
+        this._telemetryConnectors = options.telemetryConnectorTypes.map(t => TelemetryConnectorFactory.get(t));
+    }
+    /**
+     * Returns the class name of the component.
+     * @returns The class name of the component.
+     */
+    className() {
+        return MultiTelemetryConnector.CLASS_NAME;
+    }
+    /**
+     * Create one or more metrics.
+     * @param metric The metric details, or the details of several metrics.
+     * @returns A promise that resolves when the metrics have been created on all connectors.
+     */
+    async createMetric(metric) {
+        const metrics = Is.array(metric) ? metric : [metric];
+        for (const entry of metrics) {
+            Guards.object(MultiTelemetryConnector.CLASS_NAME, "entry", entry);
+            Guards.stringValue(MultiTelemetryConnector.CLASS_NAME, "entry.id", entry.id);
+            Guards.stringValue(MultiTelemetryConnector.CLASS_NAME, "entry.label", entry.label);
+            Guards.arrayOneOf(MultiTelemetryConnector.CLASS_NAME, "entry.type", entry.type, Object.values(MetricType));
+        }
+        await Promise.allSettled(this._telemetryConnectors.map(async (telemetryConnector) => telemetryConnector.createMetric(metric)));
+    }
+    /**
+     * Get the metric details and it's most recent value.
+     * @param id The metric id.
+     * @returns The metric details and it's most recent value.
+     */
+    async getMetric(id) {
+        Guards.stringValue(MultiTelemetryConnector.CLASS_NAME, "id", id);
+        for (const telemetryConnector of this._telemetryConnectors) {
+            const getMetricResult = telemetryConnector.getMetric?.(id);
+            if (!Is.empty(getMetricResult)) {
+                return getMetricResult;
+            }
+        }
+        throw new NotSupportedError(MultiTelemetryConnector.CLASS_NAME, "notSupported", {
+            methodName: "getMetric"
+        });
+    }
+    /**
+     * Get a specific metric value by its id.
+     * @param id The id of the metric.
+     * @param valueId The id of the metric value.
+     * @returns The metric value.
+     */
+    async getMetricValue(id, valueId) {
+        Guards.stringValue(MultiTelemetryConnector.CLASS_NAME, "id", id);
+        Guards.stringValue(MultiTelemetryConnector.CLASS_NAME, "valueId", valueId);
+        for (const telemetryConnector of this._telemetryConnectors) {
+            const getMetricValueResult = telemetryConnector.getMetricValue?.(id, valueId);
+            if (!Is.empty(getMetricValueResult)) {
+                return getMetricValueResult;
+            }
+        }
+        throw new NotSupportedError(MultiTelemetryConnector.CLASS_NAME, "notSupported", {
+            methodName: "getMetricValue"
+        });
+    }
+    /**
+     * Update metric.
+     * @param metric The metric details.
+     * @returns A promise that resolves when the metric has been updated on all connectors.
+     */
+    async updateMetric(metric) {
+        Guards.object(MultiTelemetryConnector.CLASS_NAME, "metric", metric);
+        Guards.stringValue(MultiTelemetryConnector.CLASS_NAME, "metric.id", metric.id);
+        Guards.stringValue(MultiTelemetryConnector.CLASS_NAME, "metric.label", metric.label);
+        await Promise.allSettled(this._telemetryConnectors.map(async (telemetryConnector) => telemetryConnector.updateMetric(metric)));
+    }
+    /**
+     * Add a metric value.
+     * @param id The id of the metric.
+     * @param value The value for the add operation.
+     * @param customData The custom data for the add operation.
+     * @returns The created metric value id.
+     */
+    async addMetricValue(id, value, customData) {
+        Guards.stringValue(MultiTelemetryConnector.CLASS_NAME, "id", id);
+        const results = await Promise.allSettled(this._telemetryConnectors.map(async (telemetryConnector) => telemetryConnector.addMetricValue(id, value, customData)));
+        if (results[0].status === "fulfilled") {
+            return results[0].value;
+        }
+        throw new NotSupportedError(MultiTelemetryConnector.CLASS_NAME, "notSupported", {
+            methodName: "addMetricValue"
+        });
+    }
+    /**
+     * Add multiple metric values.
+     * @param values The metric values to add.
+     * @returns The created metric value ids, in the order the values were supplied.
+     */
+    async addMetricValues(values) {
+        Guards.array(MultiTelemetryConnector.CLASS_NAME, "values", values);
+        const results = await Promise.allSettled(this._telemetryConnectors.map(async (telemetryConnector) => telemetryConnector.addMetricValues(values)));
+        if (results[0]?.status === "fulfilled") {
+            return results[0].value;
+        }
+        throw new NotSupportedError(MultiTelemetryConnector.CLASS_NAME, "notSupported", {
+            methodName: "addMetricValues"
+        });
+    }
+    /**
+     * Remove metric.
+     * @param id The id of the metric.
+     * @returns A promise that resolves when the metric has been removed from all connectors.
+     */
+    async removeMetric(id) {
+        Guards.stringValue(MultiTelemetryConnector.CLASS_NAME, "id", id);
+        await Promise.allSettled(this._telemetryConnectors.map(async (telemetryConnector) => telemetryConnector.removeMetric(id)));
+    }
+    /**
+     * Query the metrics.
+     * @param type The type of the metric.
+     * @param cursor The cursor to request the next chunk of entities.
+     * @param limit Limit the number of entities to return.
+     * @returns All the entities for the storage matching the conditions,
+     * and a cursor which can be used to request more entities.
+     * @throws NotImplementedError if the implementation does not support retrieval.
+     */
+    async query(type, cursor, limit) {
+        // See if we can find a connector that supports querying.
+        for (const telemetryConnector of this._telemetryConnectors) {
+            const queryBound = telemetryConnector.query?.bind(telemetryConnector);
+            if (Is.function(queryBound)) {
+                return queryBound(type, cursor, limit);
+            }
+        }
+        throw new NotImplementedError(MultiTelemetryConnector.CLASS_NAME, "query");
+    }
+    /**
+     * Query the metric values.
+     * @param id The id of the metric.
+     * @param timeStart The inclusive time as the start of the metric entries.
+     * @param timeEnd The inclusive time as the end of the metric entries.
+     * @param cursor The cursor to request the next chunk of entities.
+     * @param limit Limit the number of entities to return.
+     * @returns All the entities for the storage matching the conditions,
+     * and a cursor which can be used to request more entities.
+     * @throws NotImplementedError if the implementation does not support retrieval.
+     */
+    async queryValues(id, timeStart, timeEnd, cursor, limit) {
+        // See if we can find a connector that supports querying.
+        // If it throws anything other than not implemented, we should throw it.
+        for (const telemetryConnector of this._telemetryConnectors) {
+            const queryValuesBound = telemetryConnector.queryValues?.bind(telemetryConnector);
+            if (Is.function(queryValuesBound)) {
+                return queryValuesBound(id, timeStart, timeEnd, cursor, limit);
+            }
+        }
+        throw new NotImplementedError(MultiTelemetryConnector.CLASS_NAME, "queryValues");
+    }
+}
+//# sourceMappingURL=multiTelemetryConnector.js.map

package/dist/es/connectors/multiTelemetryConnector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multiTelemetryConnector.js","sourceRoot":"","sources":["../../../src/connectors/multiTelemetryConnector.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAElF,OAAO,EAAE,yBAAyB,EAAE,MAAM,2CAA2C,CAAC;AAOtF,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD;;GAEG;AACH,MAAM,OAAO,uBAAuB;IACnC;;OAEG;IACI,MAAM,CAAU,SAAS,GAAW,OAAO,CAAC;IAEnD;;OAEG;IACI,MAAM,CAAU,UAAU,6BAA6C;IAE9E;;;OAGG;IACc,oBAAoB,CAAwB;IAE7D;;;OAGG;IACH,YAAY,OAAmD;QAC9D,MAAM,CAAC,MAAM,CAAC,uBAAuB,CAAC,UAAU,aAAmB,OAAO,CAAC,CAAC;QAC5E,MAAM,CAAC,UAAU,CAChB,uBAAuB,CAAC,UAAU,qCAElC,OAAO,CAAC,uBAAuB,CAC/B,CAAC;QACF,IAAI,CAAC,oBAAoB,GAAG,OAAO,CAAC,uBAAuB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CACnE,yBAAyB,CAAC,GAAG,CAAC,CAAC,CAAC,CAChC,CAAC;IACH,CAAC;IAED;;;OAGG;IACI,SAAS;QACf,OAAO,uBAAuB,CAAC,UAAU,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,YAAY,CAAC,MAA6C;QACtE,MAAM,OAAO,GAAG,EAAE,CAAC,KAAK,CAAmB,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAEvE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,CAAC,MAAM,CAAmB,uBAAuB,CAAC,UAAU,WAAiB,KAAK,CAAC,CAAC;YAC1F,MAAM,CAAC,WAAW,CAAC,uBAAuB,CAAC,UAAU,cAAoB,KAAK,CAAC,EAAE,CAAC,CAAC;YACnF,MAAM,CAAC,WAAW,CAAC,uBAAuB,CAAC,UAAU,iBAAuB,KAAK,CAAC,KAAK,CAAC,CAAC;YACzF,MAAM,CAAC,UAAU,CAChB,uBAAuB,CAAC,UAAU,gBAElC,KAAK,CAAC,IAAI,EACV,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CACzB,CAAC;QACH,CAAC;QAED,MAAM,OAAO,CAAC,UAAU,CACvB,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,KAAK,EAAC,kBAAkB,EAAC,EAAE,CACxD,kBAAkB,CAAC,YAAY,CAAC,MAAM,CAAC,CACvC,CACD,CAAC;IACH,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,SAAS,CAAC,EAAU;QAIhC,MAAM,CAAC,WAAW,CAAC,uBAAuB,CAAC,UAAU,QAAc,EAAE,CAAC,CAAC;QAEvE,KAAK,MAAM,kBAAkB,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC5D,MAAM,eAAe,GAAG,kBAAkB,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;YAC3D,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE,CAAC;gBAChC,OAAO,eAAe,CAAC;YACxB,CAAC;QACF,CAAC;QACD,MAAM,IAAI,iBAAiB,CAAC,uBAAuB,CAAC,UAAU,EAAE,cAAc,EAAE;YAC/E,UAAU,EAAE,WAAW;SACvB,CAAC,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,cAAc,CAAC,EAAU,EAAE,OAAe;QACtD,MAAM,CAAC,WAAW,CAAC,uBAAuB,CAAC,UAAU,QAAc,EAAE,CAAC,CAAC;QACvE,MAAM,CAAC,WAAW,CAAC,uBAAuB,CAAC,UAAU,aAAmB,OAAO,CAAC,CAAC;QAEjF,KAAK,MAAM,kBAAkB,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC5D,MAAM,oBAAoB,GAAG,kBAAkB,CAAC,cAAc,EAAE,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;YAC9E,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,oBAAoB,CAAC,EAAE,CAAC;gBACrC,OAAO,oBAAoB,CAAC;YAC7B,CAAC;QACF,CAAC;QACD,MAAM,IAAI,iBAAiB,CAAC,uBAAuB,CAAC,UAAU,EAAE,cAAc,EAAE;YAC/E,UAAU,EAAE,gBAAgB;SAC5B,CAAC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,YAAY,CAAC,MAAsC;QAC/D,MAAM,CAAC,MAAM,CAAmB,uBAAuB,CAAC,UAAU,YAAkB,MAAM,CAAC,CAAC;QAC5F,MAAM,CAAC,WAAW,CAAC,uBAAuB,CAAC,UAAU,eAAqB,MAAM,CAAC,EAAE,CAAC,CAAC;QACrF,MAAM,CAAC,WAAW,CAAC,uBAAuB,CAAC,UAAU,kBAAwB,MAAM,CAAC,KAAK,CAAC,CAAC;QAE3F,MAAM,OAAO,CAAC,UAAU,CACvB,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,KAAK,EAAC,kBAAkB,EAAC,EAAE,CACxD,kBAAkB,CAAC,YAAY,CAAC,MAAM,CAAC,CACvC,CACD,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,cAAc,CAC1B,EAAU,EACV,KAAsC,EACtC,UAAuC;QAEvC,MAAM,CAAC,WAAW,CAAC,uBAAuB,CAAC,UAAU,QAAc,EAAE,CAAC,CAAC;QAEvE,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACvC,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,KAAK,EAAC,kBAAkB,EAAC,EAAE,CACxD,kBAAkB,CAAC,cAAc,CAAC,EAAE,EAAE,KAAK,EAAE,UAAU,CAAC,CACxD,CACD,CAAC;QAEF,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YACvC,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACzB,CAAC;QACD,MAAM,IAAI,iBAAiB,CAAC,uBAAuB,CAAC,UAAU,EAAE,cAAc,EAAE;YAC/E,UAAU,EAAE,gBAAgB;SAC5B,CAAC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,eAAe,CAAC,MAAoC;QAChE,MAAM,CAAC,KAAK,CACX,uBAAuB,CAAC,UAAU,YAElC,MAAM,CACN,CAAC;QAEF,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACvC,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,KAAK,EAAC,kBAAkB,EAAC,EAAE,CACxD,kBAAkB,CAAC,eAAe,CAAC,MAAM,CAAC,CAC1C,CACD,CAAC;QAEF,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,KAAK,WAAW,EAAE,CAAC;YACxC,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACzB,CAAC;QACD,MAAM,IAAI,iBAAiB,CAAC,uBAAuB,CAAC,UAAU,EAAE,cAAc,EAAE;YAC/E,UAAU,EAAE,iBAAiB;SAC7B,CAAC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,YAAY,CAAC,EAAU;QACnC,MAAM,CAAC,WAAW,CAAC,uBAAuB,CAAC,UAAU,QAAc,EAAE,CAAC,CAAC;QAEvE,MAAM,OAAO,CAAC,UAAU,CACvB,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,KAAK,EAAC,kBAAkB,EAAC,EAAE,CAAC,kBAAkB,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAC9F,CAAC;IACH,CAAC;IAED;;;;;;;;OAQG;IACI,KAAK,CAAC,KAAK,CACjB,IAAiB,EACjB,MAAe,EACf,KAAc;QAYd,yDAAyD;QACzD,KAAK,MAAM,kBAAkB,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC5D,MAAM,UAAU,GAAG,kBAAkB,CAAC,KAAK,EAAE,IAAI,CAAC,kBAAkB,CAAC,CAAC;YACtE,IAAI,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC7B,OAAO,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;YACxC,CAAC;QACF,CAAC;QAED,MAAM,IAAI,mBAAmB,CAAC,uBAAuB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC5E,CAAC;IAED;;;;;;;;;;OAUG;IACI,KAAK,CAAC,WAAW,CACvB,EAAU,EACV,SAAkB,EAClB,OAAgB,EAChB,MAAe,EACf,KAAc;QAiBd,yDAAyD;QACzD,wEAAwE;QACxE,KAAK,MAAM,kBAAkB,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC5D,MAAM,gBAAgB,GAAG,kBAAkB,CAAC,WAAW,EAAE,IAAI,CAAC,kBAAkB,CAAC,CAAC;YAClF,IAAI,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBACnC,OAAO,gBAAgB,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;YAChE,CAAC;QACF,CAAC;QAED,MAAM,IAAI,mBAAmB,CAAC,uBAAuB,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;IAClF,CAAC","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { Guards, Is, NotImplementedError, NotSupportedError } from \"@3sixty/core\";\nimport { nameof } from \"@3sixty/nameof\";\nimport { TelemetryConnectorFactory } from \"../factories/telemetryConnectorFactory.js\";\nimport type { IMultiTelemetryConnectorConstructorOptions } from \"../models/IMultiTelemetryConnectorConstructorOptions.js\";\nimport type { ITelemetryConnector } from \"../models/ITelemetryConnector.js\";\nimport type { ITelemetryMetric } from \"../models/ITelemetryMetric.js\";\nimport type { ITelemetryMetricValue } from \"../models/ITelemetryMetricValue.js\";\nimport type { ITelemetryMetricValueEntry } from \"../models/ITelemetryMetricValueEntry.js\";\nimport type { MetricCounterOperation } from \"../models/metricCounterOperation.js\";\nimport { MetricType } from \"../models/metricType.js\";\n\n/**\n * Class for performing telemetry operations on multiple connectors.\n */\nexport class MultiTelemetryConnector implements ITelemetryConnector {\n\t/**\n\t * The namespace for the class.\n\t */\n\tpublic static readonly NAMESPACE: string = \"multi\";\n\n\t/**\n\t * Runtime name for the class.\n\t */\n\tpublic static readonly CLASS_NAME: string = nameof<MultiTelemetryConnector>();\n\n\t/**\n\t * The connectors to send the telemetry entries to.\n\t * @internal\n\t */\n\tprivate readonly _telemetryConnectors: ITelemetryConnector[];\n\n\t/**\n\t * Create a new instance of MultiTelemetryConnector.\n\t * @param options The options for the connector.\n\t */\n\tconstructor(options: IMultiTelemetryConnectorConstructorOptions) {\n\t\tGuards.object(MultiTelemetryConnector.CLASS_NAME, nameof(options), options);\n\t\tGuards.arrayValue(\n\t\t\tMultiTelemetryConnector.CLASS_NAME,\n\t\t\tnameof(options.telemetryConnectorTypes),\n\t\t\toptions.telemetryConnectorTypes\n\t\t);\n\t\tthis._telemetryConnectors = options.telemetryConnectorTypes.map(t =>\n\t\t\tTelemetryConnectorFactory.get(t)\n\t\t);\n\t}\n\n\t/**\n\t * Returns the class name of the component.\n\t * @returns The class name of the component.\n\t */\n\tpublic className(): string {\n\t\treturn MultiTelemetryConnector.CLASS_NAME;\n\t}\n\n\t/**\n\t * Create one or more metrics.\n\t * @param metric The metric details, or the details of several metrics.\n\t * @returns A promise that resolves when the metrics have been created on all connectors.\n\t */\n\tpublic async createMetric(metric: ITelemetryMetric | ITelemetryMetric[]): Promise<void> {\n\t\tconst metrics = Is.array<ITelemetryMetric>(metric) ? metric : [metric];\n\n\t\tfor (const entry of metrics) {\n\t\t\tGuards.object<ITelemetryMetric>(MultiTelemetryConnector.CLASS_NAME, nameof(entry), entry);\n\t\t\tGuards.stringValue(MultiTelemetryConnector.CLASS_NAME, nameof(entry.id), entry.id);\n\t\t\tGuards.stringValue(MultiTelemetryConnector.CLASS_NAME, nameof(entry.label), entry.label);\n\t\t\tGuards.arrayOneOf(\n\t\t\t\tMultiTelemetryConnector.CLASS_NAME,\n\t\t\t\tnameof(entry.type),\n\t\t\t\tentry.type,\n\t\t\t\tObject.values(MetricType)\n\t\t\t);\n\t\t}\n\n\t\tawait Promise.allSettled(\n\t\t\tthis._telemetryConnectors.map(async telemetryConnector =>\n\t\t\t\ttelemetryConnector.createMetric(metric)\n\t\t\t)\n\t\t);\n\t}\n\n\t/**\n\t * Get the metric details and it's most recent value.\n\t * @param id The metric id.\n\t * @returns The metric details and it's most recent value.\n\t */\n\tpublic async getMetric(id: string): Promise<{\n\t\tmetric: ITelemetryMetric;\n\t\tvalue?: ITelemetryMetricValue;\n\t}> {\n\t\tGuards.stringValue(MultiTelemetryConnector.CLASS_NAME, nameof(id), id);\n\n\t\tfor (const telemetryConnector of this._telemetryConnectors) {\n\t\t\tconst getMetricResult = telemetryConnector.getMetric?.(id);\n\t\t\tif (!Is.empty(getMetricResult)) {\n\t\t\t\treturn getMetricResult;\n\t\t\t}\n\t\t}\n\t\tthrow new NotSupportedError(MultiTelemetryConnector.CLASS_NAME, \"notSupported\", {\n\t\t\tmethodName: \"getMetric\"\n\t\t});\n\t}\n\n\t/**\n\t * Get a specific metric value by its id.\n\t * @param id The id of the metric.\n\t * @param valueId The id of the metric value.\n\t * @returns The metric value.\n\t */\n\tpublic async getMetricValue(id: string, valueId: string): Promise<ITelemetryMetricValue> {\n\t\tGuards.stringValue(MultiTelemetryConnector.CLASS_NAME, nameof(id), id);\n\t\tGuards.stringValue(MultiTelemetryConnector.CLASS_NAME, nameof(valueId), valueId);\n\n\t\tfor (const telemetryConnector of this._telemetryConnectors) {\n\t\t\tconst getMetricValueResult = telemetryConnector.getMetricValue?.(id, valueId);\n\t\t\tif (!Is.empty(getMetricValueResult)) {\n\t\t\t\treturn getMetricValueResult;\n\t\t\t}\n\t\t}\n\t\tthrow new NotSupportedError(MultiTelemetryConnector.CLASS_NAME, \"notSupported\", {\n\t\t\tmethodName: \"getMetricValue\"\n\t\t});\n\t}\n\n\t/**\n\t * Update metric.\n\t * @param metric The metric details.\n\t * @returns A promise that resolves when the metric has been updated on all connectors.\n\t */\n\tpublic async updateMetric(metric: Omit<ITelemetryMetric, \"type\">): Promise<void> {\n\t\tGuards.object<ITelemetryMetric>(MultiTelemetryConnector.CLASS_NAME, nameof(metric), metric);\n\t\tGuards.stringValue(MultiTelemetryConnector.CLASS_NAME, nameof(metric.id), metric.id);\n\t\tGuards.stringValue(MultiTelemetryConnector.CLASS_NAME, nameof(metric.label), metric.label);\n\n\t\tawait Promise.allSettled(\n\t\t\tthis._telemetryConnectors.map(async telemetryConnector =>\n\t\t\t\ttelemetryConnector.updateMetric(metric)\n\t\t\t)\n\t\t);\n\t}\n\n\t/**\n\t * Add a metric value.\n\t * @param id The id of the metric.\n\t * @param value The value for the add operation.\n\t * @param customData The custom data for the add operation.\n\t * @returns The created metric value id.\n\t */\n\tpublic async addMetricValue(\n\t\tid: string,\n\t\tvalue: MetricCounterOperation | number,\n\t\tcustomData?: { [key: string]: unknown }\n\t): Promise<string> {\n\t\tGuards.stringValue(MultiTelemetryConnector.CLASS_NAME, nameof(id), id);\n\n\t\tconst results = await Promise.allSettled(\n\t\t\tthis._telemetryConnectors.map(async telemetryConnector =>\n\t\t\t\ttelemetryConnector.addMetricValue(id, value, customData)\n\t\t\t)\n\t\t);\n\n\t\tif (results[0].status === \"fulfilled\") {\n\t\t\treturn results[0].value;\n\t\t}\n\t\tthrow new NotSupportedError(MultiTelemetryConnector.CLASS_NAME, \"notSupported\", {\n\t\t\tmethodName: \"addMetricValue\"\n\t\t});\n\t}\n\n\t/**\n\t * Add multiple metric values.\n\t * @param values The metric values to add.\n\t * @returns The created metric value ids, in the order the values were supplied.\n\t */\n\tpublic async addMetricValues(values: ITelemetryMetricValueEntry[]): Promise<string[]> {\n\t\tGuards.array<ITelemetryMetricValueEntry>(\n\t\t\tMultiTelemetryConnector.CLASS_NAME,\n\t\t\tnameof(values),\n\t\t\tvalues\n\t\t);\n\n\t\tconst results = await Promise.allSettled(\n\t\t\tthis._telemetryConnectors.map(async telemetryConnector =>\n\t\t\t\ttelemetryConnector.addMetricValues(values)\n\t\t\t)\n\t\t);\n\n\t\tif (results[0]?.status === \"fulfilled\") {\n\t\t\treturn results[0].value;\n\t\t}\n\t\tthrow new NotSupportedError(MultiTelemetryConnector.CLASS_NAME, \"notSupported\", {\n\t\t\tmethodName: \"addMetricValues\"\n\t\t});\n\t}\n\n\t/**\n\t * Remove metric.\n\t * @param id The id of the metric.\n\t * @returns A promise that resolves when the metric has been removed from all connectors.\n\t */\n\tpublic async removeMetric(id: string): Promise<void> {\n\t\tGuards.stringValue(MultiTelemetryConnector.CLASS_NAME, nameof(id), id);\n\n\t\tawait Promise.allSettled(\n\t\t\tthis._telemetryConnectors.map(async telemetryConnector => telemetryConnector.removeMetric(id))\n\t\t);\n\t}\n\n\t/**\n\t * Query the metrics.\n\t * @param type The type of the metric.\n\t * @param cursor The cursor to request the next chunk of entities.\n\t * @param limit Limit the number of entities to return.\n\t * @returns All the entities for the storage matching the conditions,\n\t * and a cursor which can be used to request more entities.\n\t * @throws NotImplementedError if the implementation does not support retrieval.\n\t */\n\tpublic async query(\n\t\ttype?: MetricType,\n\t\tcursor?: string,\n\t\tlimit?: number\n\t): Promise<{\n\t\t/**\n\t\t * The metrics.\n\t\t */\n\t\tentities: ITelemetryMetric[];\n\n\t\t/**\n\t\t * An optional cursor, when defined can be used to call find to get more values.\n\t\t */\n\t\tcursor?: string;\n\t}> {\n\t\t// See if we can find a connector that supports querying.\n\t\tfor (const telemetryConnector of this._telemetryConnectors) {\n\t\t\tconst queryBound = telemetryConnector.query?.bind(telemetryConnector);\n\t\t\tif (Is.function(queryBound)) {\n\t\t\t\treturn queryBound(type, cursor, limit);\n\t\t\t}\n\t\t}\n\n\t\tthrow new NotImplementedError(MultiTelemetryConnector.CLASS_NAME, \"query\");\n\t}\n\n\t/**\n\t * Query the metric values.\n\t * @param id The id of the metric.\n\t * @param timeStart The inclusive time as the start of the metric entries.\n\t * @param timeEnd The inclusive time as the end of the metric entries.\n\t * @param cursor The cursor to request the next chunk of entities.\n\t * @param limit Limit the number of entities to return.\n\t * @returns All the entities for the storage matching the conditions,\n\t * and a cursor which can be used to request more entities.\n\t * @throws NotImplementedError if the implementation does not support retrieval.\n\t */\n\tpublic async queryValues(\n\t\tid: string,\n\t\ttimeStart?: number,\n\t\ttimeEnd?: number,\n\t\tcursor?: string,\n\t\tlimit?: number\n\t): Promise<{\n\t\t/**\n\t\t * The metric details.\n\t\t */\n\t\tmetric: ITelemetryMetric;\n\n\t\t/**\n\t\t * The values for the metric.\n\t\t */\n\t\tentities: ITelemetryMetricValue[];\n\n\t\t/**\n\t\t * An optional cursor, when defined can be used to call find to get more values.\n\t\t */\n\t\tcursor?: string;\n\t}> {\n\t\t// See if we can find a connector that supports querying.\n\t\t// If it throws anything other than not implemented, we should throw it.\n\t\tfor (const telemetryConnector of this._telemetryConnectors) {\n\t\t\tconst queryValuesBound = telemetryConnector.queryValues?.bind(telemetryConnector);\n\t\t\tif (Is.function(queryValuesBound)) {\n\t\t\t\treturn queryValuesBound(id, timeStart, timeEnd, cursor, limit);\n\t\t\t}\n\t\t}\n\n\t\tthrow new NotImplementedError(MultiTelemetryConnector.CLASS_NAME, \"queryValues\");\n\t}\n}\n"]}

package/dist/es/connectors/silentTelemetryConnector.js

@@ -0,0 +1,57 @@
+/**
+ * Class for performing telemetry operations to nowhere.
+ */
+export class SilentTelemetryConnector {
+    /**
+     * The namespace for the class.
+     */
+    static NAMESPACE = "silent";
+    /**
+     * Runtime name for the class.
+     */
+    static CLASS_NAME = "SilentTelemetryConnector";
+    /**
+     * Returns the class name of the component.
+     * @returns The class name of the component.
+     */
+    className() {
+        return SilentTelemetryConnector.CLASS_NAME;
+    }
+    /**
+     * Create one or more metrics.
+     * @param metric The metric details, or the details of several metrics.
+     * @returns A promise that resolves when the metric has been created.
+     */
+    async createMetric(metric) { }
+    /**
+     * Update metric.
+     * @param metric The metric details.
+     * @returns A promise that resolves when the metric has been updated.
+     */
+    async updateMetric(metric) { }
+    /**
+     * Update metric value.
+     * @param id The id of the metric.
+     * @param value The value for the update operation.
+     * @param customData The custom data for the update operation.
+     * @returns The created metric value id.
+     */
+    async addMetricValue(id, value, customData) {
+        return "";
+    }
+    /**
+     * Add multiple metric values.
+     * @param values The metric values to add.
+     * @returns The created metric value ids.
+     */
+    async addMetricValues(values) {
+        return values.map(() => "");
+    }
+    /**
+     * Remove metric.
+     * @param id The id of the metric.
+     * @returns A promise that resolves when the metric and all its values have been removed.
+     */
+    async removeMetric(id) { }
+}
+//# sourceMappingURL=silentTelemetryConnector.js.map

package/dist/es/connectors/silentTelemetryConnector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"silentTelemetryConnector.js","sourceRoot":"","sources":["../../../src/connectors/silentTelemetryConnector.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,MAAM,OAAO,wBAAwB;IACpC;;OAEG;IACI,MAAM,CAAU,SAAS,GAAW,QAAQ,CAAC;IAEpD;;OAEG;IACI,MAAM,CAAU,UAAU,8BAA8C;IAE/E;;;OAGG;IACI,SAAS;QACf,OAAO,wBAAwB,CAAC,UAAU,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,YAAY,CAAC,MAA6C,IAAkB,CAAC;IAE1F;;;;OAIG;IACI,KAAK,CAAC,YAAY,CAAC,MAAsC,IAAkB,CAAC;IAEnF;;;;;;OAMG;IACI,KAAK,CAAC,cAAc,CAC1B,EAAU,EACV,KAAsC,EACtC,UAAuC;QAEvC,OAAO,EAAE,CAAC;IACX,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,eAAe,CAAC,MAAoC;QAChE,OAAO,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,YAAY,CAAC,EAAU,IAAkB,CAAC","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { nameof } from \"@3sixty/nameof\";\nimport type { ITelemetryConnector } from \"../models/ITelemetryConnector.js\";\nimport type { ITelemetryMetric } from \"../models/ITelemetryMetric.js\";\nimport type { ITelemetryMetricValueEntry } from \"../models/ITelemetryMetricValueEntry.js\";\nimport type { MetricCounterOperation } from \"../models/metricCounterOperation.js\";\n\n/**\n * Class for performing telemetry operations to nowhere.\n */\nexport class SilentTelemetryConnector implements ITelemetryConnector {\n\t/**\n\t * The namespace for the class.\n\t */\n\tpublic static readonly NAMESPACE: string = \"silent\";\n\n\t/**\n\t * Runtime name for the class.\n\t */\n\tpublic static readonly CLASS_NAME: string = nameof<SilentTelemetryConnector>();\n\n\t/**\n\t * Returns the class name of the component.\n\t * @returns The class name of the component.\n\t */\n\tpublic className(): string {\n\t\treturn SilentTelemetryConnector.CLASS_NAME;\n\t}\n\n\t/**\n\t * Create one or more metrics.\n\t * @param metric The metric details, or the details of several metrics.\n\t * @returns A promise that resolves when the metric has been created.\n\t */\n\tpublic async createMetric(metric: ITelemetryMetric | ITelemetryMetric[]): Promise<void> {}\n\n\t/**\n\t * Update metric.\n\t * @param metric The metric details.\n\t * @returns A promise that resolves when the metric has been updated.\n\t */\n\tpublic async updateMetric(metric: Omit<ITelemetryMetric, \"type\">): Promise<void> {}\n\n\t/**\n\t * Update metric value.\n\t * @param id The id of the metric.\n\t * @param value The value for the update operation.\n\t * @param customData The custom data for the update operation.\n\t * @returns The created metric value id.\n\t */\n\tpublic async addMetricValue(\n\t\tid: string,\n\t\tvalue: MetricCounterOperation | number,\n\t\tcustomData?: { [key: string]: unknown }\n\t): Promise<string> {\n\t\treturn \"\";\n\t}\n\n\t/**\n\t * Add multiple metric values.\n\t * @param values The metric values to add.\n\t * @returns The created metric value ids.\n\t */\n\tpublic async addMetricValues(values: ITelemetryMetricValueEntry[]): Promise<string[]> {\n\t\treturn values.map(() => \"\");\n\t}\n\n\t/**\n\t * Remove metric.\n\t * @param id The id of the metric.\n\t * @returns A promise that resolves when the metric and all its values have been removed.\n\t */\n\tpublic async removeMetric(id: string): Promise<void> {}\n}\n"]}

package/dist/es/factories/metricsProducerFactory.js

@@ -0,0 +1,13 @@
+// Copyright 2026 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+import { Factory } from "@3sixty/core";
+/**
+ * Factory for `IMetricsProducer` implementations.
+ *
+ * The engine registers producers with `MetricsProducerFactory` during
+ * initialisation. Third-party apps can also register their own producers
+ * before `engine.start()` is called.
+ */
+// eslint-disable-next-line @typescript-eslint/naming-convention
+export const MetricsProducerFactory = Factory.createFactory("metrics-producer");
+//# sourceMappingURL=metricsProducerFactory.js.map

package/dist/es/factories/metricsProducerFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metricsProducerFactory.js","sourceRoot":"","sources":["../../../src/factories/metricsProducerFactory.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC;;;;;;GAMG;AACH,gEAAgE;AAChE,MAAM,CAAC,MAAM,sBAAsB,GAAG,OAAO,CAAC,aAAa,CAAmB,kBAAkB,CAAC,CAAC","sourcesContent":["// Copyright 2026 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { Factory } from \"@3sixty/core\";\nimport type { IMetricsProducer } from \"../models/IMetricsProducer.js\";\n\n/**\n * Factory for `IMetricsProducer` implementations.\n *\n * The engine registers producers with `MetricsProducerFactory` during\n * initialisation. Third-party apps can also register their own producers\n * before `engine.start()` is called.\n */\n// eslint-disable-next-line @typescript-eslint/naming-convention\nexport const MetricsProducerFactory = Factory.createFactory<IMetricsProducer>(\"metrics-producer\");\n"]}

package/dist/es/factories/telemetryConnectorFactory.js

@@ -0,0 +1,9 @@
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+import { Factory } from "@3sixty/core";
+/**
+ * Factory for creating telemetry connectors.
+ */
+// eslint-disable-next-line @typescript-eslint/naming-convention
+export const TelemetryConnectorFactory = Factory.createFactory("telemetry");
+//# sourceMappingURL=telemetryConnectorFactory.js.map

package/dist/es/factories/telemetryConnectorFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetryConnectorFactory.js","sourceRoot":"","sources":["../../../src/factories/telemetryConnectorFactory.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC;;GAEG;AACH,gEAAgE;AAChE,MAAM,CAAC,MAAM,yBAAyB,GAAG,OAAO,CAAC,aAAa,CAAsB,WAAW,CAAC,CAAC","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { Factory } from \"@3sixty/core\";\nimport type { ITelemetryConnector } from \"../models/ITelemetryConnector.js\";\n\n/**\n * Factory for creating telemetry connectors.\n */\n// eslint-disable-next-line @typescript-eslint/naming-convention\nexport const TelemetryConnectorFactory = Factory.createFactory<ITelemetryConnector>(\"telemetry\");\n"]}