@od-oneapp/observability 2026.1.1301

package/README.md

@@ -0,0 +1,523 @@
+# @repo/observability
+
+A comprehensive, type-safe observability package for the OneApp monorepo. Provides unified logging, error tracking,
+performance monitoring, and tracing across client, server, and edge environments with support for multiple providers
+(Sentry, BetterStack, Console).
+
+## Quick Reference
+
+- **Can build:** NO (TypeScript library, no build step required)
+- **Version:** 2025.11.1201
+- **License:** MIT
+
+### Exports
+
+**Core:**
+
+- `.` - Shared utilities and types
+- `./client` - Browser (non-Next.js)
+- `./server` - Node.js server
+- `./client/next` - Next.js client components
+- `./server/next` - Next.js server components
+- `./server/edge` - Edge runtime
+- `./env` - Environment configuration
+
+**Plugins:**
+
+- `./plugins/console` - Console logging plugin
+- `./plugins/sentry` - Sentry error tracking
+- `./plugins/betterstack` - BetterStack logging
+- `./plugins/logtape` - LogTape integration
+- `./plugins/sentry-microfrontend` - Micro-frontend Sentry
+
+**Environment Configs:** Each plugin exports `./plugins/{name}/env`
+
+### AI Usage Hints
+
+```typescript
+// ✅ CORRECT: Logging (Canonical)
+import { logInfo, logError } from "@repo/shared/logger";
+
+// ✅ CORRECT: Observability initialization (Next.js Server Component)
+import { observability } from "@repo/observability/server/next";
+
+// ✅ CORRECT: Observability initialization (Next.js Client Component)
+import { getObservability } from "@repo/observability/client/next";
+
+// ✅ CORRECT: Edge Runtime (Middleware, Edge API Routes)
+import { observability } from "@repo/observability/server/edge";
+```
+
+## Features
+
+- 🔌 **Plugin-Based**: Extensible architecture supporting multiple providers
+- 🌐 **Multi-Environment**: Client, server, Next.js, edge runtime support
+- 📊 **Performance Monitoring**: Web Vitals, custom metrics, distributed tracing
+- 🛡️ **Type-Safe**: Full TypeScript with strict type checking
+- 🔄 **Graceful Degradation**: Continues operation if providers fail
+- 🎯 **Error Tracking**: Structured error reporting with breadcrumbs
+- 🚀 **Zero-Config**: Auto-detection based on environment variables
+- 🔐 **Security-First**: Input validation and sanitization
+
+## Installation
+
+Already included in the monorepo. Add to your workspace:
+
+```bash
+pnpm add @repo/observability
+```
+
+## Quick Start
+
+### Next.js Client Component
+
+```tsx
+"use client";
+
+import { logInfo, logError } from "@repo/shared/logger";
+
+export function UserProfile() {
+  const handleClick = async () => {
+    try {
+      logInfo("User profile viewed", { userId: "123" });
+      // Your logic here
+    } catch (error) {
+      logError(error as Error, { component: "UserProfile" });
+    }
+  };
+
+  return <button onClick={handleClick}>View Profile</button>;
+}
+```
+
+### Next.js Server Component
+
+```tsx
+import { getObservability } from "@repo/observability/server-next";
+import { logInfo, logError } from "@repo/shared/logger";
+
+export default async function ServerPage() {
+  const observability = await getObservability();
+  logInfo("Server page rendered", { page: "/dashboard" });
+
+  try {
+    const data = await fetchData();
+    return <div>{data}</div>;
+  } catch (error) {
+    logError(error as Error);
+    observability.captureException(error as Error);
+    throw error;
+  }
+}
+```
+
+### API Route
+
+```typescript
+import { getObservability } from "@repo/observability/server-next";
+import { logInfo, logError } from "@repo/shared/logger";
+import { NextRequest, NextResponse } from "next/server";
+
+export async function POST(request: NextRequest) {
+  const observability = await getObservability();
+
+  try {
+    const body = await request.json();
+
+    observability.setUser({ id: body.userId, email: body.email });
+    logInfo("API request", { endpoint: "/api/users" });
+
+    const result = await processRequest(body);
+    return NextResponse.json({ success: true, data: result });
+  } catch (error) {
+    logError(error as Error, { endpoint: "/api/users" });
+    observability.captureException(error as Error, { endpoint: "/api/users" });
+    return NextResponse.json({ error: "Internal error" }, { status: 500 });
+  }
+}
+```
+
+## Environment Variables
+
+### Core Configuration
+
+```bash
+NODE_ENV=development | production
+NEXT_PUBLIC_OBSERVABILITY_DEBUG=true
+NEXT_PUBLIC_OBSERVABILITY_CONSOLE_ENABLED=true
+```
+
+### Sentry
+
+```bash
+SENTRY_DSN=https://key@sentry.io/project
+NEXT_PUBLIC_SENTRY_DSN=https://key@sentry.io/project # Client-side
+SENTRY_ENVIRONMENT=production
+SENTRY_RELEASE=v1.0.0
+SENTRY_ORG=your-org
+SENTRY_PROJECT=your-project
+SENTRY_TRACES_SAMPLE_RATE=0.1
+SENTRY_PROFILES_SAMPLE_RATE=0.1
+SENTRY_REPLAYS_SESSION_SAMPLE_RATE=0.1
+SENTRY_REPLAYS_ON_ERROR_SAMPLE_RATE=1.0
+```
+
+### BetterStack (Logtail)
+
+```bash
+BETTER_STACK_SOURCE_TOKEN=your-token
+NEXT_PUBLIC_BETTER_STACK_SOURCE_TOKEN=your-token # Client-side
+BETTER_STACK_INGESTING_URL=https://in.logs.betterstack.com
+BETTERSTACK_STATUS_PAGE_ID=your-page-id
+LOGTAIL_SOURCE_TOKEN=your-token # Legacy name
+```
+
+## Usage Examples
+
+### Basic Logging
+
+```typescript
+import { logDebug, logInfo, logWarn, logError } from "@repo/shared/logger";
+
+logDebug("Processing request", { requestId: "123" });
+logInfo("User logged in", { userId: "user-456" });
+logWarn("Rate limit approaching", { currentRate: 95 });
+logError("Failed to save data", { operation: "db.save" });
+```
+
+### Exception Tracking
+
+```typescript
+try {
+  await riskyOperation();
+} catch (error) {
+  observability.captureException(error, {
+    extra: { userId: user.id, operation: "checkout" },
+    tags: { environment: "production", feature: "checkout" }
+  });
+  throw error;
+}
+```
+
+### User Context
+
+```typescript
+// Set user context (attached to all future events)
+observability.setUser({
+  id: "user-123",
+  email: "john@example.com",
+  username: "johndoe"
+});
+
+// Clear user context (e.g., on logout)
+observability.setUser(null);
+```
+
+### Breadcrumbs
+
+```typescript
+// Track user journey
+observability.addBreadcrumb({
+  message: "User clicked checkout",
+  category: "user-action",
+  level: "info",
+  data: { cartTotal: 99.99 }
+});
+
+// When error occurs, breadcrumbs provide context
+observability.captureException(new Error("Payment failed"));
+```
+
+### Performance Monitoring (Sentry)
+
+```typescript
+import { observability, SentryPlugin } from "@repo/observability/server-next";
+
+const sentry = observability.getPlugin<SentryPlugin>("sentry");
+
+if (sentry) {
+  const transaction = sentry.startTransaction({
+    name: "Process Order",
+    op: "http.server"
+  });
+
+  try {
+    const span = sentry.startSpan({ name: "Validate Cart", op: "validation" });
+    await validateCart(cart);
+    span?.finish();
+
+    transaction?.finish();
+  } catch (error) {
+    transaction?.finish();
+    throw error;
+  }
+}
+```
+
+### Web Vitals (Client-Side)
+
+```tsx
+"use client";
+
+import { getObservability, SentryPlugin } from "@repo/observability/client-next";
+
+export function WebVitalsReporter() {
+  useEffect(() => {
+    const reportWebVitals = async (metric: any) => {
+      const obs = await getObservability();
+      const sentry = obs.getPlugin<SentryPlugin>("sentry");
+
+      if (sentry) {
+        sentry.recordWebVital(metric.name, metric.value, {
+          rating: metric.rating,
+          unit: "millisecond"
+        });
+      }
+    };
+
+    import("web-vitals").then(({ onCLS, onFID, onFCP, onLCP, onTTFB }) => {
+      onCLS(reportWebVitals);
+      onFID(reportWebVitals);
+      onFCP(reportWebVitals);
+      onLCP(reportWebVitals);
+      onTTFB(reportWebVitals);
+    });
+  }, []);
+
+  return null;
+}
+```
+
+## Provider Plugins
+
+### Sentry
+
+Error tracking, performance monitoring, session replay.
+
+```typescript
+import { createSentryPlugin } from "@repo/observability/plugins/sentry";
+
+const sentry = createSentryPlugin({
+  dsn: process.env.SENTRY_DSN,
+  environment: process.env.NODE_ENV,
+  tracesSampleRate: 1.0,
+  replaysSessionSampleRate: 0.1
+});
+```
+
+### BetterStack
+
+Structured logging and log aggregation.
+
+```typescript
+import { createBetterStackPlugin } from "@repo/observability/plugins/betterstack";
+
+const betterstack = createBetterStackPlugin({
+  sourceToken: process.env.BETTER_STACK_SOURCE_TOKEN,
+  batchInterval: 1000,
+  batchSize: 100
+});
+```
+
+### Console
+
+Development logging to console.
+
+```typescript
+import { createConsolePlugin } from "@repo/observability/plugins/console";
+
+const console = createConsolePlugin({
+  prefix: "[MyApp]",
+  enabled: process.env.NODE_ENV === "development"
+});
+```
+
+### Sentry MicroFrontend
+
+Specialized for micro-frontend architectures.
+
+```typescript
+import { createSentryMicroFrontendPlugin } from "@repo/observability/plugins/sentry-microfrontend";
+
+const sentry = createSentryMicroFrontendPlugin({
+  isHost: true,
+  backstageApp: "my-app",
+  backstageApps: {
+    "my-app": "https://app-dsn@sentry.io/123"
+  },
+  globalTags: { team: "platform", version: "1.0.0" }
+});
+```
+
+## Advanced Usage
+
+### Multi-Provider Setup
+
+```typescript
+import { ObservabilityBuilder } from "@repo/observability/factory/builder";
+import { createSentryPlugin } from "@repo/observability/plugins/sentry";
+import { createBetterStackPlugin } from "@repo/observability/plugins/betterstack";
+
+const observability = ObservabilityBuilder.create()
+  .withPlugin(createSentryPlugin({ dsn: process.env.SENTRY_DSN }))
+  .withPlugin(createBetterStackPlugin({ sourceToken: process.env.LOGTAIL_TOKEN }))
+  .withLifecycle({
+    onError: (error, plugin) => console.error(`${plugin.name} error:`, error),
+    onInitialized: (plugin) => console.log(`${plugin.name} initialized`)
+  })
+  .build();
+```
+
+### Custom Plugin
+
+```typescript
+import { ObservabilityPlugin } from "@repo/observability";
+
+class CustomPlugin implements ObservabilityPlugin {
+  name = "custom";
+  enabled = true;
+
+  getClient() {
+    return undefined;
+  }
+  async initialize() {
+    /* Setup */
+  }
+  async shutdown() {
+    /* Cleanup */
+  }
+
+  captureException(error: Error | unknown, context?: any) {
+    // Your implementation
+  }
+
+  captureMessage(message: string, level = "info", context?: any) {
+    // Your implementation
+  }
+
+  setUser(user: any) {
+    /* Your implementation */
+  }
+  addBreadcrumb(breadcrumb: any) {
+    /* Your implementation */
+  }
+  withScope(callback: any) {
+    callback({});
+  }
+}
+```
+
+## API Reference
+
+### ObservabilityManager
+
+- `addPlugin(plugin)` - Add plugin
+- `getPlugin<T>(name)` - Get plugin by name
+- `initialize()` - Initialize all plugins
+- `shutdown()` - Shutdown all plugins
+- `captureException(error, context?)` - Capture exception
+- `captureMessage(message, level?, context?)` - Capture message
+- `setUser(user)` - Set user context
+- `addBreadcrumb(breadcrumb)` - Add breadcrumb
+- `withScope(callback)` - Scoped context
+- `flush(timeout?)` - Flush pending events
+
+### Logging (Canonical)
+
+Logging is now handled by the `@repo/shared/logger` package.
+
+- `logDebug(message, context?)` - Debug logging
+- `logInfo(message, context?)` - Info logging
+- `logWarn(message, context?)` - Warning logging
+- `logError(message, context?)` - Error logging
+
+### ObservabilityBuilder
+
+- `create()` - New builder instance
+- `withPlugin(plugin)` - Add single plugin
+- `withPlugins(plugins)` - Add multiple plugins
+- `withLifecycle(lifecycle)` - Set lifecycle hooks
+- `withAutoInitialize(enabled)` - Configure auto-init
+- `build()` - Build manager
+- `buildWithAutoInit()` - Build and initialize
+
+## Testing
+
+```bash
+pnpm test          # Run tests
+pnpm test:coverage # With coverage
+pnpm typecheck     # Type checking
+pnpm lint          # Lint code
+```
+
+## Troubleshooting
+
+### Plugins not initializing
+
+```typescript
+if (observability.hasInitializationError()) {
+  console.error("Init failed:", observability.getInitializationError());
+}
+console.log("Enabled:", observability.getEnabledPluginNames());
+```
+
+### Events not in Sentry
+
+Check DSN, sampling rates, and debug mode:
+
+```bash
+SENTRY_DEBUG=true
+```
+
+### "Accessed server variable on client"
+
+Use `NEXT_PUBLIC_` prefix for client-side variables:
+
+```bash
+NEXT_PUBLIC_SENTRY_DSN=https://key@sentry.io/project
+```
+
+## Best Practices
+
+1. Use environment-specific exports
+2. Set user context after authentication
+3. Add breadcrumbs for error context
+4. Use structured context objects
+5. Sample performance data in production
+6. Flush before process termination
+7. Never log sensitive data (passwords, tokens, PII)
+
+## Security
+
+- ✅ User data automatically validated and sanitized
+- ✅ Field length limits prevent DoS
+- ✅ Unknown fields stripped for security
+- ✅ Environment variables type-checked
+- ⚠️ Use `beforeSend` hooks to scrub sensitive info
+
+## Documentation
+
+For comprehensive documentation, see:
+
+- **[Observability Package Overview](../apps/docs/packages/observability/overview.mdx)**
+- **Architecture**: See "Architecture" section above
+- **API Reference**: See "API Reference" section above
+
+## License
+
+MIT
+
+## Support
+
+Open an issue in the monorepo or contact the platform team.
+
+## 📚 Comprehensive Documentation
+
+For detailed documentation, see:
+
+- **[Audit Reports](../../apps/docs/content/docs/audits/observability/)** - Comprehensive audits, fixes, and security
+  reviews
+- **[Technical Guides](../../apps/docs/content/docs/packages/observability/)** - Implementation guides and best
+  practices
+
+All comprehensive documentation has been centralized in the docs app.

package/dist/client-next.d.mts

@@ -0,0 +1,20 @@
+import { a as Breadcrumb, c as ObservabilityConfig, d as ObservabilityServer, f as ObservabilityUser, l as ObservabilityContext, o as LogLevel, s as ObservabilityClient, u as ObservabilityScope } from "./plugin-Bfq-o3nr.mjs";
+import { t as ObservabilityManager } from "./manager-BxQqOPEg.mjs";
+import { n as ObservabilityBuilder, t as createObservability } from "./index-CpcdzWrF.mjs";
+import { n as BetterStackPluginConfig, t as BetterStackPlugin } from "./plugin-CaQxviDs.mjs";
+import { Env } from "./plugins-betterstack-env.mjs";
+import { ConsolePlugin, ConsolePluginConfig } from "./plugins-console.mjs";
+import { n as SentryPluginConfig, t as SentryPlugin } from "./plugin-Bt-ygG1m.mjs";
+import { Env as Env$1 } from "./plugins-sentry-env.mjs";
+import "./plugins-sentry.mjs";
+import { c as MicroFrontendMode, i as SentryMicroFrontendPlugin, l as SentryMicroFrontendConfig, s as BackstageAppConfig } from "./utils-CuGrTcD6.mjs";
+import "./plugins-sentry-microfrontend.mjs";
+
+//#region src/client-next.d.ts
+declare function createClientObservability(): Promise<ObservabilityManager>;
+declare function getObservability(): Promise<ObservabilityManager>;
+declare const configureLogger: () => void;
+type LogContext = Record<string, any>;
+//#endregion
+export { type BackstageAppConfig, type Env as BetterStackEnv, BetterStackPlugin, type BetterStackPluginConfig, Breadcrumb, ConsolePlugin, type ConsolePluginConfig, LogContext, LogLevel, type MicroFrontendMode, ObservabilityBuilder, ObservabilityClient, ObservabilityConfig, ObservabilityContext, ObservabilityScope, ObservabilityServer, ObservabilityUser, type Env$1 as SentryEnv, type SentryMicroFrontendConfig, SentryMicroFrontendPlugin, SentryPlugin, type SentryPluginConfig, configureLogger, createClientObservability, createObservability, getObservability };
+//# sourceMappingURL=client-next.d.mts.map

package/dist/client-next.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-next.d.mts","names":[],"sources":["../src/client-next.ts"],"mappings":";;;;;;;;;;;;;iBAoBsB,yBAAA,CAAA,GAAyB,OAAA,CAAA,oBAAA;AAAA,iBAoDzB,gBAAA,CAAA,GAAoB,OAAA,CAAQ,oBAAA;AAAA,cAqDrC,eAAA;AAAA,KAKD,UAAA,GAAa,MAAA"}

package/dist/client-next.mjs

@@ -0,0 +1,64 @@
+import { shouldEnableConsole } from "./index.mjs";
+import { env } from "./env.mjs";
+import { n as ObservabilityBuilder, t as createObservability } from "./factory-DkY353r8.mjs";
+import { ConsolePlugin, createConsolePlugin } from "./plugins-console.mjs";
+import { env as env$1 } from "./plugins-betterstack-env.mjs";
+import { n as createBetterStackPlugin, t as BetterStackPlugin } from "./plugin-lPdJirTY.mjs";
+import { env as env$2 } from "./plugins-sentry-env.mjs";
+import { n as createSentryPlugin, t as SentryPlugin } from "./plugin-CP895lBx.mjs";
+import { t as SentryMicroFrontendPlugin } from "./plugin-CLFwRERa.mjs";
+
+//#region src/client-next.ts
+/**
+* @fileoverview Next.js client-specific observability export
+* Next.js client-specific observability export
+*/
+/**
+* Create auto-configured observability for Next.js client
+*/
+async function createClientObservability() {
+	const builder = ObservabilityBuilder.create();
+	const enableConsole = shouldEnableConsole(env.NEXT_PUBLIC_NODE_ENV, env.NEXT_PUBLIC_OBSERVABILITY_CONSOLE_ENABLED, env.NEXT_PUBLIC_OBSERVABILITY_DEBUG);
+	builder.withPlugin(createConsolePlugin({
+		prefix: "[Next.js Client]",
+		enabled: enableConsole
+	}));
+	if (env$2.NEXT_PUBLIC_SENTRY_DSN) builder.withPlugin(createSentryPlugin({ dsn: env$2.NEXT_PUBLIC_SENTRY_DSN }));
+	const clientBetterStackToken = env$1.NEXT_PUBLIC_BETTER_STACK_SOURCE_TOKEN ?? env$1.NEXT_PUBLIC_BETTERSTACK_TOKEN ?? env$1.NEXT_PUBLIC_LOGTAIL_TOKEN;
+	if (clientBetterStackToken) builder.withPlugin(createBetterStackPlugin({ sourceToken: clientBetterStackToken }));
+	return builder.build();
+}
+let initializationPromise = null;
+/**
+* Get or create the observability instance
+* Uses promise-based singleton pattern to prevent race conditions in concurrent scenarios
+* @returns Promise resolving to the ObservabilityManager instance
+*/
+async function getObservability() {
+	if (!initializationPromise) {
+		initializationPromise = (async () => {
+			try {
+				return await createClientObservability();
+			} catch (error) {
+				initializationPromise = null;
+				throw error;
+			}
+		})();
+		(async () => {
+			try {
+				const { setObservabilityPromise } = await import("./hooks-useObservability.mjs");
+				const promise = initializationPromise;
+				if (promise !== null) setObservabilityPromise(promise);
+			} catch {}
+		})();
+	}
+	return initializationPromise;
+}
+/**
+* @deprecated Configuration now happens through the observability system
+*/
+const configureLogger = () => {};
+
+//#endregion
+export { BetterStackPlugin, ConsolePlugin, ObservabilityBuilder, SentryMicroFrontendPlugin, SentryPlugin, configureLogger, createClientObservability, createObservability, getObservability };
+//# sourceMappingURL=client-next.mjs.map

package/dist/client-next.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-next.mjs","names":["sentryEnv","betterStackEnv"],"sources":["../src/client-next.ts"],"sourcesContent":["/**\n * @fileoverview Next.js client-specific observability export\n * Next.js client-specific observability export\n */\n\nimport { env } from '../env';\n\nimport { ObservabilityBuilder } from './factory/builder';\nimport { createBetterStackPlugin } from './plugins/betterstack';\nimport { env as betterStackEnv } from './plugins/betterstack/env';\nimport { createConsolePlugin } from './plugins/console';\nimport { createSentryPlugin } from './plugins/sentry';\nimport { env as sentryEnv } from './plugins/sentry/env';\nimport { shouldEnableConsole } from './shared';\n\nimport type { ObservabilityManager } from './core/manager';\n\n/**\n * Create auto-configured observability for Next.js client\n */\nexport async function createClientObservability() {\n  const builder = ObservabilityBuilder.create();\n\n  // Console logging control using shared utility\n  const enableConsole = shouldEnableConsole(\n    env.NEXT_PUBLIC_NODE_ENV,\n    env.NEXT_PUBLIC_OBSERVABILITY_CONSOLE_ENABLED,\n    env.NEXT_PUBLIC_OBSERVABILITY_DEBUG,\n  );\n\n  // Always add console plugin, control via enabled flag\n  builder.withPlugin(\n    createConsolePlugin({\n      prefix: '[Next.js Client]',\n      enabled: enableConsole,\n    }),\n  );\n\n  // Auto-activate Sentry if client DSN is provided\n  if (sentryEnv.NEXT_PUBLIC_SENTRY_DSN) {\n    builder.withPlugin(\n      createSentryPlugin({\n        dsn: sentryEnv.NEXT_PUBLIC_SENTRY_DSN,\n      }),\n    );\n  }\n\n  // Auto-activate Better Stack if client token is provided\n  const clientBetterStackToken =\n    betterStackEnv.NEXT_PUBLIC_BETTER_STACK_SOURCE_TOKEN ??\n    betterStackEnv.NEXT_PUBLIC_BETTERSTACK_TOKEN ??\n    betterStackEnv.NEXT_PUBLIC_LOGTAIL_TOKEN;\n\n  if (clientBetterStackToken) {\n    builder.withPlugin(\n      createBetterStackPlugin({\n        sourceToken: clientBetterStackToken,\n      }),\n    );\n  }\n\n  return builder.build();\n}\n\n// Lazy initialization for the observability instance using promise-based singleton\nlet initializationPromise: Promise<ObservabilityManager> | null = null;\n\n/**\n * Get or create the observability instance\n * Uses promise-based singleton pattern to prevent race conditions in concurrent scenarios\n * @returns Promise resolving to the ObservabilityManager instance\n */\nexport async function getObservability(): Promise<ObservabilityManager> {\n  if (!initializationPromise) {\n    initializationPromise = (async () => {\n      try {\n        return await createClientObservability();\n      } catch (error) {\n        // Reset cached promise on failure so callers can retry\n        initializationPromise = null;\n        throw error;\n      }\n    })();\n\n    // Set promise for React 19 hooks (dynamic import to avoid circular dependency)\n    void (async () => {\n      try {\n        const { setObservabilityPromise } = await import('./hooks/useObservability');\n        const promise = initializationPromise;\n        if (promise !== null) {\n          setObservabilityPromise(promise);\n        }\n      } catch {\n        // Hooks module not available or import failed - continue without hooks\n      }\n    })();\n  }\n  return initializationPromise;\n}\n\n// Export types and utilities\nexport * from './core/types';\nexport { createObservability } from './factory';\nexport { ObservabilityBuilder } from './factory/builder';\n\n// Re-export plugins for direct access (excluding conflicting exports)\nexport { BetterStackPlugin } from './plugins/betterstack';\nexport { ConsolePlugin } from './plugins/console';\nexport { SentryPlugin } from './plugins/sentry';\nexport { SentryMicroFrontendPlugin } from './plugins/sentry-microfrontend';\n\n// Re-export plugin-specific types with aliases to avoid conflicts\nexport type { Env as BetterStackEnv, BetterStackPluginConfig } from './plugins/betterstack';\nexport type { ConsolePluginConfig } from './plugins/console';\nexport type { Env as SentryEnv, SentryPluginConfig } from './plugins/sentry';\nexport type {\n  BackstageAppConfig,\n  MicroFrontendMode,\n  SentryMicroFrontendConfig,\n} from './plugins/sentry-microfrontend';\n\n// Legacy function for backward compatibility (no-op)\n/**\n * @deprecated Configuration now happens through the observability system\n */\nexport const configureLogger = () => {\n  // No-op: Configuration now happens through the observability system\n};\n\n// Re-export type\nexport type LogContext = Record<string, any>;\n"],"mappings":";;;;;;;;;;;;;;;;;;AAoBA,eAAsB,4BAA4B;CAChD,MAAM,UAAU,qBAAqB,QAAQ;CAG7C,MAAM,gBAAgB,oBACpB,IAAI,sBACJ,IAAI,2CACJ,IAAI,gCACL;AAGD,SAAQ,WACN,oBAAoB;EAClB,QAAQ;EACR,SAAS;EACV,CAAC,CACH;AAGD,KAAIA,MAAU,uBACZ,SAAQ,WACN,mBAAmB,EACjB,KAAKA,MAAU,wBAChB,CAAC,CACH;CAIH,MAAM,yBACJC,MAAe,yCACfA,MAAe,iCACfA,MAAe;AAEjB,KAAI,uBACF,SAAQ,WACN,wBAAwB,EACtB,aAAa,wBACd,CAAC,CACH;AAGH,QAAO,QAAQ,OAAO;;AAIxB,IAAI,wBAA8D;;;;;;AAOlE,eAAsB,mBAAkD;AACtE,KAAI,CAAC,uBAAuB;AAC1B,2BAAyB,YAAY;AACnC,OAAI;AACF,WAAO,MAAM,2BAA2B;YACjC,OAAO;AAEd,4BAAwB;AACxB,UAAM;;MAEN;AAGJ,GAAM,YAAY;AAChB,OAAI;IACF,MAAM,EAAE,4BAA4B,MAAM,OAAO;IACjD,MAAM,UAAU;AAChB,QAAI,YAAY,KACd,yBAAwB,QAAQ;WAE5B;MAGN;;AAEN,QAAO;;;;;AA4BT,MAAa,wBAAwB"}

package/dist/client.d.mts

@@ -0,0 +1,11 @@
+import { a as Breadcrumb, c as ObservabilityConfig, d as ObservabilityServer, f as ObservabilityUser, l as ObservabilityContext, o as LogLevel, s as ObservabilityClient, u as ObservabilityScope } from "./plugin-Bfq-o3nr.mjs";
+import { t as ObservabilityManager } from "./manager-BxQqOPEg.mjs";
+import { n as ObservabilityBuilder, t as createObservability } from "./index-CpcdzWrF.mjs";
+
+//#region src/client.d.ts
+declare const observability: ObservabilityManager;
+declare const configureLogger: () => void;
+type LogContext = Record<string, any>;
+//#endregion
+export { Breadcrumb, LogContext, LogLevel, ObservabilityBuilder, ObservabilityClient, ObservabilityConfig, ObservabilityContext, ObservabilityScope, ObservabilityServer, ObservabilityUser, configureLogger, createObservability, observability };
+//# sourceMappingURL=client.d.mts.map

package/dist/client.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.mts","names":[],"sources":["../src/client.ts"],"mappings":";;;;;cAuCa,aAAA,EAA+B,oBAAA;AAAA,cAyB/B,eAAA;AAAA,KAKD,UAAA,GAAa,MAAA"}

package/dist/client.mjs

@@ -0,0 +1,47 @@
+import { shouldEnableConsole } from "./index.mjs";
+import { env } from "./env.mjs";
+import { n as ObservabilityBuilder, t as createObservability } from "./factory-DkY353r8.mjs";
+import { createConsolePlugin } from "./plugins-console.mjs";
+
+//#region src/client.ts
+/**
+* @fileoverview Auto-configuring client export for browser environments (non-Next.js)
+* Auto-configuring client export for browser environments (non-Next.js)
+*/
+/**
+* Auto-configured observability for browser environments
+* Automatically sets up console logging based on environment variables
+*/
+const builder = ObservabilityBuilder.create();
+const enableConsole = shouldEnableConsole(env.NEXT_PUBLIC_NODE_ENV, env.NEXT_PUBLIC_OBSERVABILITY_CONSOLE_ENABLED, env.NEXT_PUBLIC_OBSERVABILITY_DEBUG);
+builder.withPlugin(createConsolePlugin({
+	prefix: "[Browser]",
+	enabled: enableConsole
+}));
+/**
+* Pre-configured observability instance for browser environments
+* Includes console logging with automatic environment-based configuration
+*/
+const observability = builder.build();
+/**
+* Synchronous logger functions for non-Next.js browser environments.
+* These are bound to a pre-built observability instance at module load time.
+*
+* Note: For Next.js apps, use `@od-oneapp/observability/client/next` instead,
+* which provides async loggers that support lazy initialization.
+*
+* @example
+* ```typescript
+* import { logInfo, logError } from '@od-oneapp/shared/logger';
+* logInfo('User logged in', { userId: '123' });
+* logError('Failed to save data', { error: err });
+* ```
+*/
+/**
+* @deprecated Configuration now happens through the observability system
+*/
+const configureLogger = () => {};
+
+//#endregion
+export { ObservabilityBuilder, configureLogger, createObservability, observability };
+//# sourceMappingURL=client.mjs.map

package/dist/client.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.mjs","names":[],"sources":["../src/client.ts"],"sourcesContent":["/**\n * @fileoverview Auto-configuring client export for browser environments (non-Next.js)\n * Auto-configuring client export for browser environments (non-Next.js)\n */\n\nimport { env } from '../env';\n\nimport { ObservabilityBuilder } from './factory/builder';\nimport { createConsolePlugin } from './plugins/console';\nimport { shouldEnableConsole } from './shared';\n\n/**\n * Auto-configured observability for browser environments\n * Automatically sets up console logging based on environment variables\n */\nconst builder = ObservabilityBuilder.create();\n\n// Console logging control using shared utility\nconst enableConsole = shouldEnableConsole(\n  env.NEXT_PUBLIC_NODE_ENV,\n  env.NEXT_PUBLIC_OBSERVABILITY_CONSOLE_ENABLED,\n  env.NEXT_PUBLIC_OBSERVABILITY_DEBUG,\n);\n\n// Always add console plugin, control via enabled flag\nbuilder.withPlugin(\n  createConsolePlugin({\n    prefix: '[Browser]',\n    enabled: enableConsole,\n  }),\n);\n\n// Note: Sentry and Better Stack would typically be configured by the app\n// This is just a fallback for non-Next.js browser usage\n\n/**\n * Pre-configured observability instance for browser environments\n * Includes console logging with automatic environment-based configuration\n */\nexport const observability = builder.build();\n\n// Export types and utilities\nexport * from './core/types';\nexport { createObservability } from './factory';\nexport { ObservabilityBuilder } from './factory/builder';\n\n/**\n * Synchronous logger functions for non-Next.js browser environments.\n * These are bound to a pre-built observability instance at module load time.\n *\n * Note: For Next.js apps, use `@repo/observability/client/next` instead,\n * which provides async loggers that support lazy initialization.\n *\n * @example\n * ```typescript\n * import { logInfo, logError } from '@repo/shared/logger';\n * logInfo('User logged in', { userId: '123' });\n * logError('Failed to save data', { error: err });\n * ```\n */\n// Legacy function for backward compatibility (no-op)\n/**\n * @deprecated Configuration now happens through the observability system\n */\nexport const configureLogger = () => {\n  // No-op: Configuration now happens through the observability system\n};\n\n// Re-export type\nexport type LogContext = Record<string, any>;\n"],"mappings":";;;;;;;;;;;;;;AAeA,MAAM,UAAU,qBAAqB,QAAQ;AAG7C,MAAM,gBAAgB,oBACpB,IAAI,sBACJ,IAAI,2CACJ,IAAI,gCACL;AAGD,QAAQ,WACN,oBAAoB;CAClB,QAAQ;CACR,SAAS;CACV,CAAC,CACH;;;;;AASD,MAAa,gBAAgB,QAAQ,OAAO;;;;;;;;;;;;;;;;;;AAyB5C,MAAa,wBAAwB"}