@pydantic/logfire-browser 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2023 - present Pydantic Services inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("@opentelemetry/api"),u=require("@opentelemetry/context-zone"),l=require("@opentelemetry/exporter-trace-otlp-http"),f=require("@opentelemetry/instrumentation"),T=require("@opentelemetry/resources"),c=require("@opentelemetry/sdk-trace-web"),t=require("@opentelemetry/semantic-conventions"),i=require("@opentelemetry/semantic-conventions/incubating"),s=require("@pydantic/logfire-api");function b(e){const o=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(e){for(const r in e)if(r!=="default"){const a=Object.getOwnPropertyDescriptor(e,r);Object.defineProperty(o,r,a.get?a:{enumerable:!0,get:()=>e[r]})}}return o.default=e,Object.freeze(o)}const E=b(s);function A(e){e.diagLogLevel!==void 0&&n.diag.setLogger(new n.DiagConsoleLogger,e.diagLogLevel),e.scrubbing!==void 0&&E.configureLogfireApi({scrubbing:e.scrubbing});const o=T.resourceFromAttributes({[i.ATTR_BROWSER_LANGUAGE]:navigator.language,[t.ATTR_SERVICE_NAME]:e.serviceName??"logfire-browser",[t.ATTR_SERVICE_VERSION]:e.serviceVersion??"0.0.1",[t.ATTR_TELEMETRY_SDK_LANGUAGE]:t.TELEMETRY_SDK_LANGUAGE_VALUE_WEBJS,[t.ATTR_TELEMETRY_SDK_NAME]:"logfire-browser",[t.ATTR_TELEMETRY_SDK_VERSION]:"0.2.0",...navigator.userAgentData?{[i.ATTR_BROWSER_BRANDS]:navigator.userAgentData.brands.map(g=>`${g.brand} ${g.version}`),[i.ATTR_BROWSER_MOBILE]:navigator.userAgentData.mobile,[i.ATTR_BROWSER_PLATFORM]:navigator.userAgentData.platform}:{[t.ATTR_USER_AGENT_ORIGINAL]:navigator.userAgent}});n.diag.info("logfire-browser: starting");const r=new c.WebTracerProvider({idGenerator:new s.ULIDGenerator,resource:o,spanProcessors:[new c.BatchSpanProcessor(new l.OTLPTraceExporter({url:e.traceUrl}),e.batchSpanProcessorConfig)]});e.enableZoneContextManager!==!1&&(n.diag.info("logfire-browser: enable zone context manager"),r.register({contextManager:new u.ZoneContextManager}));const a=f.registerInstrumentations({instrumentations:e.instrumentations??[],tracerProvider:r});return async()=>{n.diag.info("logfire-browser: shutting down"),a(),await r.forceFlush(),await r.shutdown(),n.diag.info("logfire-browser: shut down complete")}}Object.defineProperty(exports,"DiagLogLevel",{enumerable:!0,get:()=>n.DiagLogLevel});exports.configure=A;Object.keys(s).forEach(e=>{e!=="default"&&!Object.prototype.hasOwnProperty.call(exports,e)&&Object.defineProperty(exports,e,{enumerable:!0,get:()=>s[e]})});

package/dist/index.d.cts

@@ -0,0 +1,48 @@
+import { BufferConfig } from '@opentelemetry/sdk-trace-web';
+import { DiagLogLevel } from '@opentelemetry/api';
+import { Instrumentation } from '@opentelemetry/instrumentation';
+import * as logfireApi from '@pydantic/logfire-api';
+
+export declare function configure(options: LogfireConfigOptions): () => Promise<void>;
+
+export { DiagLogLevel }
+
+export declare interface LogfireConfigOptions {
+    /**
+     * The configuration of the batch span processor.
+     */
+    batchSpanProcessorConfig?: BufferConfig;
+    /**
+     * Defines the available internal logging levels for the diagnostic logger.
+     */
+    diagLogLevel?: DiagLogLevel;
+    /**
+     * Set to `false` to disable the [zone context manager](https://www.npmjs.com/package/@opentelemetry/context-zone) usage.
+     */
+    enableZoneContextManager?: boolean;
+    /**
+     * The instrumentations to register - a common one [is the fetch instrumentation](https://www.npmjs.com/package/@opentelemetry/instrumentation-fetch).
+     */
+    instrumentations?: (Instrumentation | Instrumentation[])[];
+    /**
+     * Options for scrubbing sensitive data. Set to False to disable.
+     */
+    scrubbing?: false | logfireApi.SrubbingOptions;
+    /**
+     * Name of this service.
+     */
+    serviceName?: string;
+    /**
+     * Version of this service.
+     */
+    serviceVersion?: string;
+    /**
+     * The URL of your trace exporter proxy endpoint.
+     */
+    traceUrl: string;
+}
+
+
+export * from "@pydantic/logfire-api";
+
+export { }

package/dist/index.d.ts

@@ -0,0 +1,48 @@
+import { BufferConfig } from '@opentelemetry/sdk-trace-web';
+import { DiagLogLevel } from '@opentelemetry/api';
+import { Instrumentation } from '@opentelemetry/instrumentation';
+import * as logfireApi from '@pydantic/logfire-api';
+
+export declare function configure(options: LogfireConfigOptions): () => Promise<void>;
+
+export { DiagLogLevel }
+
+export declare interface LogfireConfigOptions {
+    /**
+     * The configuration of the batch span processor.
+     */
+    batchSpanProcessorConfig?: BufferConfig;
+    /**
+     * Defines the available internal logging levels for the diagnostic logger.
+     */
+    diagLogLevel?: DiagLogLevel;
+    /**
+     * Set to `false` to disable the [zone context manager](https://www.npmjs.com/package/@opentelemetry/context-zone) usage.
+     */
+    enableZoneContextManager?: boolean;
+    /**
+     * The instrumentations to register - a common one [is the fetch instrumentation](https://www.npmjs.com/package/@opentelemetry/instrumentation-fetch).
+     */
+    instrumentations?: (Instrumentation | Instrumentation[])[];
+    /**
+     * Options for scrubbing sensitive data. Set to False to disable.
+     */
+    scrubbing?: false | logfireApi.SrubbingOptions;
+    /**
+     * Name of this service.
+     */
+    serviceName?: string;
+    /**
+     * Version of this service.
+     */
+    serviceVersion?: string;
+    /**
+     * The URL of your trace exporter proxy endpoint.
+     */
+    traceUrl: string;
+}
+
+
+export * from "@pydantic/logfire-api";
+
+export { }

package/dist/index.js

@@ -0,0 +1,51 @@
+import { diag as e, DiagConsoleLogger as i } from "@opentelemetry/api";
+import { DiagLogLevel as V } from "@opentelemetry/api";
+import { ZoneContextManager as g } from "@opentelemetry/context-zone";
+import { OTLPTraceExporter as s } from "@opentelemetry/exporter-trace-otlp-http";
+import { registerInstrumentations as f } from "@opentelemetry/instrumentation";
+import { resourceFromAttributes as E } from "@opentelemetry/resources";
+import { WebTracerProvider as T, BatchSpanProcessor as m } from "@opentelemetry/sdk-trace-web";
+import { TELEMETRY_SDK_LANGUAGE_VALUE_WEBJS as A, ATTR_USER_AGENT_ORIGINAL as R, ATTR_TELEMETRY_SDK_VERSION as _, ATTR_TELEMETRY_SDK_NAME as c, ATTR_TELEMETRY_SDK_LANGUAGE as u, ATTR_SERVICE_VERSION as L, ATTR_SERVICE_NAME as l } from "@opentelemetry/semantic-conventions";
+import { ATTR_BROWSER_PLATFORM as b, ATTR_BROWSER_MOBILE as w, ATTR_BROWSER_BRANDS as S, ATTR_BROWSER_LANGUAGE as v } from "@opentelemetry/semantic-conventions/incubating";
+import * as p from "@pydantic/logfire-api";
+import { ULIDGenerator as d } from "@pydantic/logfire-api";
+export * from "@pydantic/logfire-api";
+function U(r) {
+  r.diagLogLevel !== void 0 && e.setLogger(new i(), r.diagLogLevel), r.scrubbing !== void 0 && p.configureLogfireApi({ scrubbing: r.scrubbing });
+  const a = E({
+    [v]: navigator.language,
+    [l]: r.serviceName ?? "logfire-browser",
+    [L]: r.serviceVersion ?? "0.0.1",
+    [u]: A,
+    [c]: "logfire-browser",
+    // eslint-disable-next-line no-undef
+    [_]: "0.2.0",
+    ...navigator.userAgentData ? {
+      [S]: navigator.userAgentData.brands.map((t) => `${t.brand} ${t.version}`),
+      [w]: navigator.userAgentData.mobile,
+      [b]: navigator.userAgentData.platform
+    } : {
+      [R]: navigator.userAgent
+    }
+  });
+  e.info("logfire-browser: starting");
+  const o = new T({
+    idGenerator: new d(),
+    resource: a,
+    spanProcessors: [new m(new s({ url: r.traceUrl }), r.batchSpanProcessorConfig)]
+  });
+  r.enableZoneContextManager !== !1 && (e.info("logfire-browser: enable zone context manager"), o.register({
+    contextManager: new g()
+  }));
+  const n = f({
+    instrumentations: r.instrumentations ?? [],
+    tracerProvider: o
+  });
+  return async () => {
+    e.info("logfire-browser: shutting down"), n(), await o.forceFlush(), await o.shutdown(), e.info("logfire-browser: shut down complete");
+  };
+}
+export {
+  V as DiagLogLevel,
+  U as configure
+};

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@pydantic/logfire-browser",
+  "description": "JavaScript Browser SDK for Logfire - https://pydantic.dev/logfire",
+  "author": {
+    "name": "The Pydantic Team",
+    "email": "engineering@pydantic.dev",
+    "url": "https://pydantic.dev"
+  },
+  "sideEffects": false,
+  "homepage": "https://pydantic.dev/logfire",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "logfire",
+    "observability",
+    "opentelemetry",
+    "tracing",
+    "profiling",
+    "stats",
+    "monitoring"
+  ],
+  "version": "0.2.0",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "scripts": {
+    "dev": "vite build",
+    "build": "vite build",
+    "lint": "eslint",
+    "preview": "vite preview",
+    "typecheck": "tsc",
+    "prepack": "cp ../../LICENSE .",
+    "postpack": "rm LICENSE",
+    "test": "vitest --passWithNoTests"
+  },
+  "dependencies": {
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.202.0",
+    "@opentelemetry/instrumentation": "^0.202.0",
+    "@opentelemetry/resources": "^2.0.1",
+    "@pydantic/logfire-api": "*"
+  },
+  "peerDependencies": {
+    "@opentelemetry/sdk-trace-web": "^2.0.1",
+    "@opentelemetry/semantic-conventions": "^1.34.0"
+  },
+  "devDependencies": {
+    "@opentelemetry/sdk-trace-web": "^2.0.1",
+    "@opentelemetry/semantic-conventions": "^1.34.0",
+    "eslint": "^9.22.0",
+    "prettier": "3.5.3",
+    "typescript": "^5.8.2",
+    "user-agent-data-types": "^0.4.2",
+    "vite": "^6.2.0",
+    "vite-plugin-dts": "^4.5.3",
+    "vitest": "^3.1.1"
+  },
+  "files": [
+    "dist",
+    "LICENSE"
+  ]
+}