@xylabs/telemetry 4.9.5

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,69 @@
+[![logo][]](https://xylabs.com)
+
+# @xylabs/storage
+
+[![npm-badge][]][npm-link]
+[![npm-downloads-badge][]][npm-link]
+[![jsdelivr-badge][]][jsdelivr-link]
+[![npm-license-badge][]](LICENSE)
+[![socket-badge][]][socket-link]
+
+> XY Labs Indexed DB Helpers
+
+## Table of Contents
+
+-   [Description](#description)
+-   [Install](#install)
+-   [Maintainers](#maintainers)
+-   [License](#license)
+-   [Credits](#credits)
+
+## Description
+
+Various Indexed DB Helper Functions
+
+## Install
+
+Using npm:
+
+```sh
+npm i --save @xylabs/storage
+```
+
+Using yarn:
+
+```sh
+yarn add @xylabs/storage
+```
+
+## Documentation
+[Developer Reference](https://xylabs.github.io/sdk-js)
+
+## Maintainers
+
+-   [Arie Trouw](https://github.com/arietrouw) ([arietrouw.com](https://arietrouw.com))
+-   [Joel Carter](https://github.com/JoelBCarter)
+-   [Matt Jones](https://github.com/jonesmac)
+-   [Jordan Trouw](https://github.com/jordantrouw)
+
+## License
+
+See the [LICENSE](LICENSE) file for license details
+
+## Credits
+
+[Made with 🔥and ❄️ by XY Labs](https://xylabs.com)
+
+[logo]: https://cdn.xy.company/img/brand/XYPersistentCompany_Logo_Icon_Colored.svg
+
+[npm-badge]: https://img.shields.io/npm/v/@xylabs/storage.svg
+[npm-link]: https://www.npmjs.com/package/@xylabs/storage
+
+[npm-downloads-badge]: https://img.shields.io/npm/dw/@xylabs/storage
+[npm-license-badge]: https://img.shields.io/npm/l/@xylabs/storage
+
+[jsdelivr-badge]: https://data.jsdelivr.com/v1/package/npm/@xylabs/storage/badge
+[jsdelivr-link]: https://www.jsdelivr.com/package/npm/@xylabs/storage
+
+[socket-badge]: https://socket.dev/api/badge/npm/package/@xylabs/storage
+[socket-link]: https://socket.dev/npm/package/@xylabs/storage

package/dist/neutral/index.mjs

@@ -0,0 +1,63 @@
+// src/XyConsoleSpanExporter.ts
+import { ConsoleSpanExporter } from "@opentelemetry/sdk-trace-base";
+import chalk from "chalk";
+function spanDurationInMillis(span) {
+  return span.duration[0] * 1e3 + span.duration[1] / 1e6;
+}
+var XyConsoleSpanExporter = class _XyConsoleSpanExporter extends ConsoleSpanExporter {
+  static durationToLogLevel = [
+    0,
+    1,
+    10,
+    100,
+    1e3
+  ];
+  static logLevelToChalkColor = [
+    chalk.grey,
+    chalk.white,
+    chalk.green,
+    chalk.yellow,
+    chalk.red
+  ];
+  _logLevel;
+  constructor(logLevel = 0) {
+    super();
+    this._logLevel = logLevel;
+  }
+  get logLevel() {
+    return this._logLevel;
+  }
+  export(spans) {
+    for (const span of spans) {
+      const spanLevel = this.spanLevel(span);
+      if (spanLevel < this.logLevel) {
+        continue;
+      }
+      const duration = spanDurationInMillis(span);
+      console.log(chalk.grey([
+        `Span [${span.name}]`,
+        this.logColor(spanLevel)(`${duration}ms`),
+        `TraceId: ${span.spanContext().traceId}`
+      ].join(", ")));
+    }
+  }
+  logColor(level) {
+    return _XyConsoleSpanExporter.logLevelToChalkColor[level] ?? chalk.magenta;
+  }
+  spanLevel(span) {
+    let logLevel = 0;
+    const duration = spanDurationInMillis(span);
+    for (let x = _XyConsoleSpanExporter.durationToLogLevel.length - 1; x >= 0; x--) {
+      if (duration > _XyConsoleSpanExporter.durationToLogLevel[x]) {
+        logLevel = x;
+        break;
+      }
+    }
+    return logLevel;
+  }
+};
+export {
+  XyConsoleSpanExporter,
+  spanDurationInMillis
+};
+//# sourceMappingURL=index.mjs.map

package/dist/neutral/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/XyConsoleSpanExporter.ts"],"sourcesContent":["import type { ReadableSpan } from '@opentelemetry/sdk-trace-base'\nimport { ConsoleSpanExporter } from '@opentelemetry/sdk-trace-base'\nimport chalk from 'chalk'\n\nexport function spanDurationInMillis(span: ReadableSpan) {\n  return span.duration[0] * 1000 + span.duration[1] / 1e6\n}\n\nexport class XyConsoleSpanExporter extends ConsoleSpanExporter {\n  static readonly durationToLogLevel = [\n    0,\n    1,\n    10,\n    100,\n    1000,\n  ]\n\n  static readonly logLevelToChalkColor = [\n    chalk.grey,\n    chalk.white,\n    chalk.green,\n    chalk.yellow,\n    chalk.red,\n  ]\n\n  private _logLevel: number\n\n  constructor(logLevel = 0) {\n    super()\n    this._logLevel = logLevel\n  }\n\n  get logLevel() {\n    return this._logLevel\n  }\n\n  override export(spans: ReadableSpan[]): void {\n    for (const span of spans) {\n      const spanLevel = this.spanLevel(span)\n      if (spanLevel < this.logLevel) {\n        continue\n      }\n      const duration = spanDurationInMillis(span)\n      console.log(chalk.grey([\n        `Span [${span.name}]`,\n        this.logColor(spanLevel)(`${duration}ms`),\n        `TraceId: ${span.spanContext().traceId}`,\n      ].join(', ')))\n    }\n  }\n\n  logColor(level: number) {\n    return XyConsoleSpanExporter.logLevelToChalkColor[level] ?? chalk.magenta\n  }\n\n  spanLevel(span: ReadableSpan) {\n    let logLevel = 0\n    const duration = spanDurationInMillis(span)\n    for (let x = XyConsoleSpanExporter.durationToLogLevel.length - 1; x >= 0; x--) {\n      if (duration > XyConsoleSpanExporter.durationToLogLevel[x]) {\n        logLevel = x\n        break\n      }\n    }\n    return logLevel\n  }\n}\n"],"mappings":";AACA,SAAS,2BAA2B;AACpC,OAAO,WAAW;AAEX,SAAS,qBAAqB,MAAoB;AACvD,SAAO,KAAK,SAAS,CAAC,IAAI,MAAO,KAAK,SAAS,CAAC,IAAI;AACtD;AAEO,IAAM,wBAAN,MAAM,+BAA8B,oBAAoB;AAAA,EAC7D,OAAgB,qBAAqB;AAAA,IACnC;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EAEA,OAAgB,uBAAuB;AAAA,IACrC,MAAM;AAAA,IACN,MAAM;AAAA,IACN,MAAM;AAAA,IACN,MAAM;AAAA,IACN,MAAM;AAAA,EACR;AAAA,EAEQ;AAAA,EAER,YAAY,WAAW,GAAG;AACxB,UAAM;AACN,SAAK,YAAY;AAAA,EACnB;AAAA,EAEA,IAAI,WAAW;AACb,WAAO,KAAK;AAAA,EACd;AAAA,EAES,OAAO,OAA6B;AAC3C,eAAW,QAAQ,OAAO;AACxB,YAAM,YAAY,KAAK,UAAU,IAAI;AACrC,UAAI,YAAY,KAAK,UAAU;AAC7B;AAAA,MACF;AACA,YAAM,WAAW,qBAAqB,IAAI;AAC1C,cAAQ,IAAI,MAAM,KAAK;AAAA,QACrB,SAAS,KAAK,IAAI;AAAA,QAClB,KAAK,SAAS,SAAS,EAAE,GAAG,QAAQ,IAAI;AAAA,QACxC,YAAY,KAAK,YAAY,EAAE,OAAO;AAAA,MACxC,EAAE,KAAK,IAAI,CAAC,CAAC;AAAA,IACf;AAAA,EACF;AAAA,EAEA,SAAS,OAAe;AACtB,WAAO,uBAAsB,qBAAqB,KAAK,KAAK,MAAM;AAAA,EACpE;AAAA,EAEA,UAAU,MAAoB;AAC5B,QAAI,WAAW;AACf,UAAM,WAAW,qBAAqB,IAAI;AAC1C,aAAS,IAAI,uBAAsB,mBAAmB,SAAS,GAAG,KAAK,GAAG,KAAK;AAC7E,UAAI,WAAW,uBAAsB,mBAAmB,CAAC,GAAG;AAC1D,mBAAW;AACX;AAAA,MACF;AAAA,IACF;AACA,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/types/XyConsoleSpanExporter.d.ts

@@ -0,0 +1,14 @@
+import type { ReadableSpan } from '@opentelemetry/sdk-trace-base';
+import { ConsoleSpanExporter } from '@opentelemetry/sdk-trace-base';
+export declare function spanDurationInMillis(span: ReadableSpan): number;
+export declare class XyConsoleSpanExporter extends ConsoleSpanExporter {
+    static readonly durationToLogLevel: number[];
+    static readonly logLevelToChalkColor: import("chalk").ChalkInstance[];
+    private _logLevel;
+    constructor(logLevel?: number);
+    get logLevel(): number;
+    export(spans: ReadableSpan[]): void;
+    logColor(level: number): import("chalk").ChalkInstance;
+    spanLevel(span: ReadableSpan): number;
+}
+//# sourceMappingURL=XyConsoleSpanExporter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"XyConsoleSpanExporter.d.ts","sourceRoot":"","sources":["../../src/XyConsoleSpanExporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAA;AAGnE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,UAEtD;AAED,qBAAa,qBAAsB,SAAQ,mBAAmB;IAC5D,MAAM,CAAC,QAAQ,CAAC,kBAAkB,WAMjC;IAED,MAAM,CAAC,QAAQ,CAAC,oBAAoB,kCAMnC;IAED,OAAO,CAAC,SAAS,CAAQ;gBAEb,QAAQ,SAAI;IAKxB,IAAI,QAAQ,WAEX;IAEQ,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,IAAI;IAe5C,QAAQ,CAAC,KAAK,EAAE,MAAM;IAItB,SAAS,CAAC,IAAI,EAAE,YAAY;CAW7B"}

package/dist/types/index.d.ts

@@ -0,0 +1,2 @@
+export * from './XyConsoleSpanExporter.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,4BAA4B,CAAA"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@xylabs/telemetry",
+  "version": "4.9.5",
+  "description": "Base functionality used throughout XY Labs TypeScript/JavaScript libraries",
+  "keywords": [
+    "hex",
+    "xylabs",
+    "utility",
+    "typescript",
+    "esm"
+  ],
+  "homepage": "https://xylabs.com",
+  "bugs": {
+    "url": "git+https://github.com/xylabs/sdk-js/issues",
+    "email": "support@xylabs.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xylabs/sdk-js.git"
+  },
+  "license": "LGPL-3.0-only",
+  "author": {
+    "name": "XY Labs Development Team",
+    "email": "support@xylabs.com",
+    "url": "https://xylabs.com"
+  },
+  "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",
+  "workspaces": [
+    "packages/**/*"
+  ],
+  "dependencies": {
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/sdk-trace-base": "^2.0.0",
+    "chalk": "^5.4.1"
+  },
+  "devDependencies": {
+    "@xylabs/ts-scripts-yarn3": "^6.5.5",
+    "@xylabs/tsconfig": "^6.5.5",
+    "typescript": "^5.8.3"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/XyConsoleSpanExporter.ts

@@ -0,0 +1,67 @@
+import type { ReadableSpan } from '@opentelemetry/sdk-trace-base'
+import { ConsoleSpanExporter } from '@opentelemetry/sdk-trace-base'
+import chalk from 'chalk'
+
+export function spanDurationInMillis(span: ReadableSpan) {
+  return span.duration[0] * 1000 + span.duration[1] / 1e6
+}
+
+export class XyConsoleSpanExporter extends ConsoleSpanExporter {
+  static readonly durationToLogLevel = [
+    0,
+    1,
+    10,
+    100,
+    1000,
+  ]
+
+  static readonly logLevelToChalkColor = [
+    chalk.grey,
+    chalk.white,
+    chalk.green,
+    chalk.yellow,
+    chalk.red,
+  ]
+
+  private _logLevel: number
+
+  constructor(logLevel = 0) {
+    super()
+    this._logLevel = logLevel
+  }
+
+  get logLevel() {
+    return this._logLevel
+  }
+
+  override export(spans: ReadableSpan[]): void {
+    for (const span of spans) {
+      const spanLevel = this.spanLevel(span)
+      if (spanLevel < this.logLevel) {
+        continue
+      }
+      const duration = spanDurationInMillis(span)
+      console.log(chalk.grey([
+        `Span [${span.name}]`,
+        this.logColor(spanLevel)(`${duration}ms`),
+        `TraceId: ${span.spanContext().traceId}`,
+      ].join(', ')))
+    }
+  }
+
+  logColor(level: number) {
+    return XyConsoleSpanExporter.logLevelToChalkColor[level] ?? chalk.magenta
+  }
+
+  spanLevel(span: ReadableSpan) {
+    let logLevel = 0
+    const duration = spanDurationInMillis(span)
+    for (let x = XyConsoleSpanExporter.durationToLogLevel.length - 1; x >= 0; x--) {
+      if (duration > XyConsoleSpanExporter.durationToLogLevel[x]) {
+        logLevel = x
+        break
+      }
+    }
+    return logLevel
+  }
+}

package/src/index.ts

@@ -0,0 +1 @@
+export * from './XyConsoleSpanExporter.ts'

package/xy.config.ts

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