@ogcio/o11y-sdk-react 0.1.0-beta.2 → 0.1.0-beta.4

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.1.0-beta.4](https://github.com/ogcio/o11y/compare/@ogcio/o11y-sdk-react@v0.1.0-beta.3...@ogcio/o11y-sdk-react@v0.1.0-beta.4) (2025-02-18)
+
+
+### Features
+
+* remove pnpm test on prepublishOnly script ([#68](https://github.com/ogcio/o11y/issues/68)) ([41f6f57](https://github.com/ogcio/o11y/commit/41f6f57fa415c4f7adc29f49f983539274ef7320))
+
+## [0.1.0-beta.3](https://github.com/ogcio/o11y/compare/@ogcio/o11y-sdk-react@v0.1.0-beta.2...@ogcio/o11y-sdk-react@v0.1.0-beta.3) (2025-01-28)
+
+
+### Bug Fixes
+
+* prepublishOnly hook ([#60](https://github.com/ogcio/o11y/issues/60)) ([9fbd3ad](https://github.com/ogcio/o11y/commit/9fbd3ad0b45a1604cf2eccc26b2f8855640417a1))
+
 ## [0.1.0-beta.2](https://github.com/ogcio/o11y/compare/@ogcio/o11y-sdk-react@v0.1.0-beta.1...@ogcio/o11y-sdk-react@v0.1.0-beta.2) (2025-01-28)
 
 

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import { Faro, withFaroErrorBoundary, withFaroProfiler } from "@grafana/faro-react";
+import buildFaroInstrumentation from "./lib/instrumentation.faro.js";
+export * from "./lib/index.js";
+export { withFaroErrorBoundary, withFaroProfiler, Faro };
+export { buildFaroInstrumentation as instrumentFaro };

package/dist/index.js

@@ -0,0 +1,5 @@
+import { withFaroErrorBoundary, withFaroProfiler, } from "@grafana/faro-react";
+import buildFaroInstrumentation from "./lib/instrumentation.faro.js";
+export * from "./lib/index.js";
+export { withFaroErrorBoundary, withFaroProfiler };
+export { buildFaroInstrumentation as instrumentFaro };

package/dist/lib/index.d.ts

@@ -0,0 +1,39 @@
+interface SDKConfig {
+    /**
+     * The opentelemetry collector entrypoint GRPC url.
+     * If the collectoUrl is null or undefined, the instrumentation will not be activated.
+     * @example http://alloy:4317
+     */
+    collectorUrl: string;
+    /**
+     * Name of your application used for the collector to group logs
+     */
+    serviceName?: string;
+    /**
+     * Diagnostic log level for the internal runtime instrumentation
+     *
+     * @type string
+     * @default INFO
+     */
+    diagLogLevel?: SDKLogLevel;
+    /**
+     * Collector signals processing mode.
+     * signle: makes an http/grpc request for each signal and it is immediately processed inside grafana
+     * batch: sends multiple signals within a time window, optimized to reduce http/grpc calls in production
+     *
+     * @type string
+     * @default batch
+     */
+    collectorMode?: SDKCollectorMode;
+}
+export interface FaroSDKConfig extends SDKConfig {
+    /**
+     * String with single or multiple URLs separated by comma used by the instrumentation to ignore CORS errors and send signals through it
+     * @example http://localhost:9000,http://localhost:8000
+     * @example http://localhost:9000
+     */
+    corsTraceHeaders?: string;
+}
+export type SDKCollectorMode = "single" | "batch";
+export type SDKLogLevel = "NONE" | "ERROR" | "WARN" | "INFO" | "DEBUG" | "VERBOSE" | "ALL";
+export {};

package/dist/lib/index.js

@@ -0,0 +1 @@
+export {};

package/dist/lib/instrumentation.faro.d.ts

@@ -0,0 +1,3 @@
+import type { FaroSDKConfig } from "./index.js";
+import { type Faro } from "@grafana/faro-react";
+export default function buildFaroInstrumentation(config?: FaroSDKConfig): Faro | undefined;

package/dist/lib/instrumentation.faro.js

@@ -0,0 +1,69 @@
+import { ErrorsInstrumentation, getWebInstrumentations, initializeFaro, WebVitalsInstrumentation, } from "@grafana/faro-react";
+import { diag, DiagConsoleLogger, DiagLogLevel } from "@opentelemetry/api";
+import { W3CTraceContextPropagator } from "@opentelemetry/core";
+import { FetchInstrumentation } from "@opentelemetry/instrumentation-fetch";
+import { UserInteractionInstrumentation } from "@opentelemetry/instrumentation-user-interaction";
+import { DocumentLoadInstrumentation } from "@opentelemetry/instrumentation-document-load";
+import { TracingInstrumentation } from "@grafana/faro-web-tracing";
+export default function buildFaroInstrumentation(config) {
+    if (!config) {
+        console.warn("observability config not set. Skipping Faro OpenTelemetry instrumentation.");
+        return;
+    }
+    if (!config.collectorUrl) {
+        console.warn("collectorUrl not set. Skipping Faro OpenTelemetry instrumentation.");
+        return;
+    }
+    if (!isUrl(config.collectorUrl)) {
+        console.error("collectorUrl does not use a valid format. Skipping Faro OpenTelemetry instrumentation.");
+        return;
+    }
+    try {
+        diag.setLogger(new DiagConsoleLogger(), config.diagLogLevel
+            ? DiagLogLevel[config.diagLogLevel]
+            : DiagLogLevel.INFO);
+        const faro = initializeFaro({
+            url: config.collectorUrl,
+            app: {
+                name: config.serviceName,
+            },
+            batching: {
+                enabled: !(config.collectorMode === "single"),
+            },
+            instrumentations: [
+                ...getWebInstrumentations({
+                    captureConsole: true,
+                }),
+                new ErrorsInstrumentation(),
+                new WebVitalsInstrumentation(),
+                new TracingInstrumentation({
+                    propagator: new W3CTraceContextPropagator(),
+                    instrumentations: [
+                        new DocumentLoadInstrumentation(),
+                        new FetchInstrumentation({
+                            ignoreUrls: [config.collectorUrl], // ignore collector to avoid fetch loop
+                            propagateTraceHeaderCorsUrls: config.corsTraceHeaders
+                                ? config.corsTraceHeaders.split(",").map((s) => new RegExp(s))
+                                : undefined,
+                        }),
+                        new UserInteractionInstrumentation(),
+                    ],
+                }),
+            ],
+        });
+        console.log("Faro OpenTelemetry instrumentation started successfully.");
+        return faro;
+    }
+    catch (error) {
+        console.error("Error starting Faro OpenTelemetry instrumentation:", error);
+    }
+}
+function isUrl(url) {
+    try {
+        new URL(url);
+        return true;
+    }
+    catch (_) {
+        return false;
+    }
+}

package/dist/vitest.config.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vite").UserConfig;
+export default _default;

package/dist/vitest.config.js

@@ -0,0 +1,25 @@
+import { defineConfig } from "vitest/config";
+export default defineConfig({
+    test: {
+        globals: true,
+        watch: false,
+        include: ["**/test/*.test.ts"],
+        exclude: ["**/fixtures/**", "**/dist/**"],
+        poolOptions: {
+            threads: {
+                maxThreads: 8,
+            },
+        },
+        clearMocks: true,
+        testTimeout: 30_000,
+        coverage: {
+            enabled: true,
+            provider: "v8",
+            reportsDirectory: "coverage",
+            reporter: ["lcov", "cobertura"],
+            clean: true,
+        },
+        reporters: ["default", ["junit", { outputFile: "test-report.xml" }]],
+        environment: "node",
+    },
+});

package/lib/instrumentation.faro.ts

@@ -8,7 +8,6 @@ import {
 } from "@grafana/faro-react";
 import { diag, DiagConsoleLogger, DiagLogLevel } from "@opentelemetry/api";
 import { W3CTraceContextPropagator } from "@opentelemetry/core";
-import isUrl from "is-url";
 import { FetchInstrumentation } from "@opentelemetry/instrumentation-fetch";
 import { UserInteractionInstrumentation } from "@opentelemetry/instrumentation-user-interaction";
 import { DocumentLoadInstrumentation } from "@opentelemetry/instrumentation-document-load";
@@ -82,3 +81,12 @@ export default function buildFaroInstrumentation(
     console.error("Error starting Faro OpenTelemetry instrumentation:", error);
   }
 }
+
+function isUrl(url: string): boolean {
+  try {
+    new URL(url);
+    return true;
+  } catch (_) {
+    return false;
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ogcio/o11y-sdk-react",
-  "version": "0.1.0-beta.2",
+  "version": "0.1.0-beta.4",
   "description": "Opentelemetry standard instrumentation SDK for React based project",
   "main": "dist/index.js",
   "type": "module",
@@ -19,23 +19,21 @@
   "author": "team:ogcio/observability",
   "license": "ISC",
   "dependencies": {
-    "@grafana/faro-react": "^1.12.3",
-    "@grafana/faro-web-sdk": "^1.12.3",
-    "@grafana/faro-web-tracing": "^1.12.3",
+    "@grafana/faro-react": "^1.13.3",
+    "@grafana/faro-web-sdk": "^1.13.3",
+    "@grafana/faro-web-tracing": "^1.13.3",
     "@opentelemetry/api": "^1.9.0",
     "@opentelemetry/core": "1.30.1",
     "@opentelemetry/instrumentation-document-load": "^0.44.0",
-    "@opentelemetry/instrumentation-fetch": "^0.57.1",
-    "@opentelemetry/instrumentation-user-interaction": "^0.44.0",
-    "is-url": "^1.2.4"
+    "@opentelemetry/instrumentation-fetch": "^0.57.2",
+    "@opentelemetry/instrumentation-user-interaction": "^0.44.0"
   },
   "devDependencies": {
-    "@types/is-url": "^1.2.32",
-    "@types/node": "^22.12.0",
-    "@vitest/coverage-v8": "^3.0.4",
+    "@types/node": "^22.13.4",
+    "@vitest/coverage-v8": "^3.0.5",
     "tsx": "^4.19.2",
     "typescript": "^5.7.3",
-    "vitest": "^3.0.4"
+    "vitest": "^3.0.5"
   },
   "scripts": {
     "build": "rm -rf dist && tsc -p tsconfig.json",