@stratum-hq/lib 0.1.0

package/dist/telemetry.js

@@ -0,0 +1,94 @@
+"use strict";
+/**
+ * OpenTelemetry instrumentation helpers for Stratum.
+ *
+ * All telemetry is optional — if @opentelemetry/api is not installed the
+ * `traced()` helper simply executes the callback without creating spans.
+ *
+ * IMPORTANT: This file must NOT import @opentelemetry/api at the type level
+ * so TypeScript can compile without the package installed. All OTel types
+ * are represented as `any` at compile time.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.traced = exports.isTracingEnabled = exports.getTracer = void 0;
+// Lazy-loaded OTel API — stays `null` when the package is absent.
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+let otel = null;
+try {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    otel = require("@opentelemetry/api");
+}
+catch {
+    // @opentelemetry/api is not installed — telemetry is a no-op.
+}
+const TRACER_NAME = "@stratum-hq/lib";
+/** No-op span stub used when OTel is not available. */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const NOOP_SPAN = {
+    setAttribute: () => NOOP_SPAN,
+    setAttributes: () => NOOP_SPAN,
+    setStatus: () => NOOP_SPAN,
+    recordException: () => NOOP_SPAN,
+    end: () => { },
+    addEvent: () => NOOP_SPAN,
+    isRecording: () => false,
+    updateName: () => NOOP_SPAN,
+    spanContext: () => ({ traceId: "", spanId: "", traceFlags: 0 }),
+    addLink: () => NOOP_SPAN,
+};
+/**
+ * Returns the OpenTelemetry tracer for Stratum, or `null` when OTel is
+ * unavailable.
+ */
+function getTracer() {
+    return otel ? otel.trace.getTracer(TRACER_NAME) : null;
+}
+exports.getTracer = getTracer;
+/**
+ * Returns `true` when OpenTelemetry instrumentation is active.
+ */
+function isTracingEnabled() {
+    return otel !== null;
+}
+exports.isTracingEnabled = isTracingEnabled;
+/**
+ * Execute `fn` inside an OpenTelemetry span.
+ *
+ * When @opentelemetry/api is not installed the function is invoked directly
+ * without any overhead — the span parameter is a no-op stub.
+ */
+async function traced(name, attributes, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+fn) {
+    const tracer = getTracer();
+    if (!tracer || !otel) {
+        return fn(NOOP_SPAN);
+    }
+    const { SpanStatusCode } = otel;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    return tracer.startActiveSpan(`stratum.${name}`, async (span) => {
+        try {
+            for (const [key, value] of Object.entries(attributes)) {
+                if (value !== undefined) {
+                    span.setAttribute(`stratum.${key}`, value);
+                }
+            }
+            const result = await fn(span);
+            span.setStatus({ code: SpanStatusCode.OK });
+            return result;
+        }
+        catch (err) {
+            span.setStatus({
+                code: SpanStatusCode.ERROR,
+                message: err.message,
+            });
+            span.recordException(err);
+            throw err;
+        }
+        finally {
+            span.end();
+        }
+    });
+}
+exports.traced = traced;
+//# sourceMappingURL=telemetry.js.map

package/dist/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAEH,kEAAkE;AAClE,8DAA8D;AAC9D,IAAI,IAAI,GAAQ,IAAI,CAAC;AAErB,IAAI,CAAC;IACH,iEAAiE;IACjE,IAAI,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;AACvC,CAAC;AAAC,MAAM,CAAC;IACP,8DAA8D;AAChE,CAAC;AAED,MAAM,WAAW,GAAG,iBAAiB,CAAC;AAEtC,uDAAuD;AACvD,8DAA8D;AAC9D,MAAM,SAAS,GAAQ;IACrB,YAAY,EAAE,GAAG,EAAE,CAAC,SAAS;IAC7B,aAAa,EAAE,GAAG,EAAE,CAAC,SAAS;IAC9B,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS;IAC1B,eAAe,EAAE,GAAG,EAAE,CAAC,SAAS;IAChC,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC;IACb,QAAQ,EAAE,GAAG,EAAE,CAAC,SAAS;IACzB,WAAW,EAAE,GAAG,EAAE,CAAC,KAAK;IACxB,UAAU,EAAE,GAAG,EAAE,CAAC,SAAS;IAC3B,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;IAC/D,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;CACzB,CAAC;AAEF;;;GAGG;AACH,SAAgB,SAAS;IACvB,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACzD,CAAC;AAFD,8BAEC;AAED;;GAEG;AACH,SAAgB,gBAAgB;IAC9B,OAAO,IAAI,KAAK,IAAI,CAAC;AACvB,CAAC;AAFD,4CAEC;AAED;;;;;GAKG;AACI,KAAK,UAAU,MAAM,CAC1B,IAAY,EACZ,UAAiE;AACjE,8DAA8D;AAC9D,EAA6B;IAE7B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAE3B,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QACrB,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC;IACvB,CAAC;IAED,MAAM,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;IAEhC,8DAA8D;IAC9D,OAAO,MAAM,CAAC,eAAe,CAAC,WAAW,IAAI,EAAE,EAAE,KAAK,EAAE,IAAS,EAAE,EAAE;QACnE,IAAI,CAAC;YACH,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;gBACtD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACxB,IAAI,CAAC,YAAY,CAAC,WAAW,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC;gBAC7C,CAAC;YACH,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;YAC9B,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5C,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,SAAS,CAAC;gBACb,IAAI,EAAE,cAAc,CAAC,KAAK;gBAC1B,OAAO,EAAG,GAAa,CAAC,OAAO;aAChC,CAAC,CAAC;YACH,IAAI,CAAC,eAAe,CAAC,GAAY,CAAC,CAAC;YACnC,MAAM,GAAG,CAAC;QACZ,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,GAAG,EAAE,CAAC;QACb,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AApCD,wBAoCC"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@stratum-hq/lib",
+  "version": "0.1.0",
+  "description": "Stratum tenant management library - framework-agnostic business logic",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "lint": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "@opentelemetry/api": "^1.9.0",
+    "@stratum-hq/core": "*",
+    "pg": "^8.11.0"
+  },
+  "peerDependencies": {
+    "@opentelemetry/api": "^1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@opentelemetry/api": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/pg": "^8.11.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.6.0"
+  }
+}