@od-oneapp/observability 2026.1.1301

package/dist/server-next.mjs

@@ -0,0 +1,64 @@
+import { shouldEnableConsole } from "./index.mjs";
+import { env } from "./env.mjs";
+import { n as ObservabilityBuilder, r as ObservabilityManager, t as createObservability } from "./factory-DkY353r8.mjs";
+import { ConsolePlugin, createConsoleServerPlugin } 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/server-next.ts
+/**
+* @fileoverview Next.js server-specific observability export
+* Next.js server-specific observability export
+*/
+/**
+* Create auto-configured observability for Next.js server
+*/
+async function createServerObservability() {
+	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(createConsoleServerPlugin({
+		prefix: "[Next.js Server]",
+		enabled: enableConsole
+	}));
+	const sentryDSN = env$2.NEXT_PUBLIC_SENTRY_DSN;
+	if (sentryDSN) {
+		const sentry = createSentryPlugin({ dsn: sentryDSN });
+		await sentry.initialize();
+		builder.withPlugin(sentry);
+	}
+	const betterStackToken = env$1.BETTER_STACK_SOURCE_TOKEN ?? env$1.BETTERSTACK_SOURCE_TOKEN ?? env$1.LOGTAIL_SOURCE_TOKEN;
+	if (betterStackToken) {
+		const betterstack = createBetterStackPlugin({ sourceToken: betterStackToken });
+		await betterstack.initialize();
+		builder.withPlugin(betterstack);
+	}
+	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 createServerObservability();
+		} catch (error) {
+			initializationPromise = null;
+			throw error;
+		}
+	})();
+	return initializationPromise;
+}
+/**
+* @deprecated Configuration now happens through the observability system
+*/
+const configureLogger = () => {};
+
+//#endregion
+export { BetterStackPlugin, ConsolePlugin, ObservabilityBuilder, ObservabilityManager, SentryMicroFrontendPlugin, SentryPlugin, configureLogger, createObservability, createServerObservability, getObservability };
+//# sourceMappingURL=server-next.mjs.map

package/dist/server-next.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-next.mjs","names":["sentryEnv","betterStackEnv"],"sources":["../src/server-next.ts"],"sourcesContent":["/**\n * @fileoverview Next.js server-specific observability export\n * Next.js server-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 { createConsoleServerPlugin } 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 server\n */\nexport async function createServerObservability() {\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    createConsoleServerPlugin({\n      prefix: '[Next.js Server]',\n      enabled: enableConsole,\n    }),\n  );\n\n  // Auto-activate Sentry if DSN is provided\n  // Only use client-accessible DSN for auto-detection to avoid server/client boundary issues\n  const sentryDSN = sentryEnv.NEXT_PUBLIC_SENTRY_DSN;\n  if (sentryDSN) {\n    const sentry = createSentryPlugin({\n      dsn: sentryDSN,\n    });\n    await sentry.initialize();\n    builder.withPlugin(sentry);\n  }\n\n  // Auto-activate Better Stack if source token is provided\n  const betterStackToken =\n    betterStackEnv.BETTER_STACK_SOURCE_TOKEN ??\n    betterStackEnv.BETTERSTACK_SOURCE_TOKEN ??\n    betterStackEnv.LOGTAIL_SOURCE_TOKEN;\n\n  if (betterStackToken) {\n    const betterstack = createBetterStackPlugin({\n      sourceToken: betterStackToken,\n    });\n    await betterstack.initialize();\n    builder.withPlugin(betterstack);\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 createServerObservability();\n      } catch (error) {\n        // Reset cached promise on failure so callers can retry\n        initializationPromise = null;\n        throw error;\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';\nexport { ObservabilityManager } from \"./factory\";\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\n// Removed for Rollup compatibility\n// Removed for Rollup compatibility\n\n// Legacy function for backward compatibility (no-op)\n/**\n * @deprecated Configuration now happens through the observability system\n */\nexport const configureLogger = (): void => {\n  // No-op: Configuration now happens through the observability system\n};\n\n// Re-export type - removed for Rollup compatibility\n"],"mappings":";;;;;;;;;;;;;;;;;;AAoBA,eAAsB,4BAA4B;CAChD,MAAM,UAAU,qBAAqB,QAAQ;CAG7C,MAAM,gBAAgB,oBACpB,IAAI,sBACJ,IAAI,2CACJ,IAAI,gCACL;AAGD,SAAQ,WACN,0BAA0B;EACxB,QAAQ;EACR,SAAS;EACV,CAAC,CACH;CAID,MAAM,YAAYA,MAAU;AAC5B,KAAI,WAAW;EACb,MAAM,SAAS,mBAAmB,EAChC,KAAK,WACN,CAAC;AACF,QAAM,OAAO,YAAY;AACzB,UAAQ,WAAW,OAAO;;CAI5B,MAAM,mBACJC,MAAe,6BACfA,MAAe,4BACfA,MAAe;AAEjB,KAAI,kBAAkB;EACpB,MAAM,cAAc,wBAAwB,EAC1C,aAAa,kBACd,CAAC;AACF,QAAM,YAAY,YAAY;AAC9B,UAAQ,WAAW,YAAY;;AAGjC,QAAO,QAAQ,OAAO;;AAIxB,IAAI,wBAA8D;;;;;;AAOlE,eAAsB,mBAAkD;AACtE,KAAI,CAAC,sBACH,0BAAyB,YAAY;AACnC,MAAI;AACF,UAAO,MAAM,2BAA2B;WACjC,OAAO;AAEd,2BAAwB;AACxB,SAAM;;KAEN;AAEN,QAAO;;;;;AAuBT,MAAa,wBAA8B"}

package/dist/server.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/server.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=server.d.mts.map

package/dist/server.d.mts.map

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

package/dist/server.mjs

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

package/dist/server.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.mjs","names":[],"sources":["../src/server.ts"],"sourcesContent":["/**\n * @fileoverview Auto-configuring server export for Node.js environments (non-Next.js)\n * Auto-configuring server export for Node.js environments (non-Next.js)\n */\n\nimport { safeEnv } from '../env';\n\nimport { ObservabilityBuilder } from './factory/builder';\nimport { createConsoleServerPlugin } from './plugins/console';\nimport { shouldEnableConsole } from './shared';\n\n/**\n * Auto-configured observability for Node.js server 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 env = safeEnv();\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  createConsoleServerPlugin({\n    prefix: '[Server]',\n    enabled: enableConsole,\n  }),\n);\n\n// Note: Production providers would typically be configured by the app\n// This is just a fallback for non-Next.js server usage\n\n/**\n * Pre-configured observability instance for Node.js server 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 Node.js 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/server/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('Server started', { port: 3000 });\n * logError('Database connection failed', { 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,MAAM,SAAS;AACrB,MAAM,gBAAgB,oBACpB,IAAI,sBACJ,IAAI,2CACJ,IAAI,gCACL;AAGD,QAAQ,WACN,0BAA0B;CACxB,QAAQ;CACR,SAAS;CACV,CAAC,CACH;;;;;AASD,MAAa,gBAAgB,QAAQ,OAAO;;;;;;;;;;;;;;;;;;AAyB5C,MAAa,wBAAwB"}

package/dist/utils-CuGrTcD6.d.mts

@@ -0,0 +1,77 @@
+import { l as ObservabilityContext, o as LogLevel } from "./plugin-Bfq-o3nr.mjs";
+import { n as SentryPluginConfig } from "./plugin-Bt-ygG1m.mjs";
+import { SentryPlugin } from "@integrations/sentry/observability-plugin/plugin";
+
+//#region src/plugins/sentry-microfrontend/types.d.ts
+interface BackstageAppConfig {
+  name: string;
+  dsn?: string;
+  release?: string;
+  tags?: Record<string, string>;
+  pathPatterns?: (string | RegExp)[];
+}
+type MicroFrontendMode = 'host' | 'child' | 'standalone';
+interface SentryMicroFrontendConfig extends Omit<SentryPluginConfig, 'transport'> {
+  isHost?: boolean;
+  backstageApp?: string;
+  backstageApps?: BackstageAppConfig[];
+  detectParent?: boolean;
+  backstageAppDetector?: () => string | undefined;
+  addBackstageContext?: boolean;
+  fallbackDsn?: string;
+  useMultiplexedTransport?: boolean;
+  globalTags?: Record<string, string>;
+  preventDuplicateInit?: boolean;
+  integrationConfig?: {
+    nodeProfilingIntegration?: boolean;
+    captureConsoleIntegration?: boolean;
+    vercelAIIntegration?: boolean;
+  };
+  _experiments?: {
+    enableLogs?: boolean;
+  };
+}
+declare global {
+  interface Window {
+    Sentry?: any;
+    __SENTRY_MICRO_FRONTEND_HOST__?: boolean;
+    __SENTRY_MICRO_FRONTEND_APP__?: string;
+  }
+} //# sourceMappingURL=types.d.ts.map
+//#endregion
+//#region src/plugins/sentry-microfrontend/multiplexed-transport.d.ts
+declare function createMultiplexedTransport(backstage: BackstageAppConfig[], fallbackDsn?: string, sentryClient?: any): any;
+//#endregion
+//#region src/plugins/sentry-microfrontend/plugin.d.ts
+declare class SentryMicroFrontendPlugin extends SentryPlugin {
+  private mode;
+  private backstageApp;
+  private parentSentry;
+  private backstageScope;
+  private microFrontendConfig;
+  private eventProcessorCleanup?;
+  constructor(config?: SentryMicroFrontendConfig);
+  private static determineMode;
+  private static prepareConfig;
+  initialize(config?: SentryMicroFrontendConfig): Promise<void>;
+  private configureParentSentry;
+  private setupHostMode;
+  private shouldProcessEvent;
+  captureException(error: Error | unknown, context?: ObservabilityContext): void;
+  captureMessage(message: string, level?: LogLevel, context?: ObservabilityContext): void;
+  getMode(): MicroFrontendMode;
+  getBackstageApp(): string | undefined;
+  getZone(): string | undefined;
+  getDebugInfo(): Record<string, any>;
+  cleanup(): Promise<void>;
+  destroy(): Promise<void>;
+}
+declare const createSentryMicroFrontendPlugin: (config?: SentryMicroFrontendConfig) => SentryMicroFrontendPlugin;
+//#endregion
+//#region src/plugins/sentry-microfrontend/utils.d.ts
+declare function detectCurrentBackstageApp(customPatterns?: BackstageAppConfig[]): string | undefined;
+declare function isHostEnvironment(): boolean;
+declare function createBackstageScope(backstageApp: string, additionalTags?: Record<string, string>): unknown;
+//#endregion
+export { createSentryMicroFrontendPlugin as a, MicroFrontendMode as c, SentryMicroFrontendPlugin as i, SentryMicroFrontendConfig as l, detectCurrentBackstageApp as n, createMultiplexedTransport as o, isHostEnvironment as r, BackstageAppConfig as s, createBackstageScope as t };
+//# sourceMappingURL=utils-CuGrTcD6.d.mts.map

package/dist/utils-CuGrTcD6.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils-CuGrTcD6.d.mts","names":[],"sources":["../src/plugins/sentry-microfrontend/types.ts","../src/plugins/sentry-microfrontend/multiplexed-transport.ts","../src/plugins/sentry-microfrontend/plugin.ts","../src/plugins/sentry-microfrontend/utils.ts"],"mappings":";;;;;UAUiB,kBAAA;EAIf,IAAA;EAKA,GAAA;EAKA,OAAA;EAKA,IAAA,GAAO,MAAA;EAKP,YAAA,aAAyB,MAAA;AAAA;AAAA,KAMf,iBAAA;AAAA,UAKK,yBAAA,SAAkC,IAAA,CAAK,kBAAA;EAItD,MAAA;EAKA,YAAA;EAKA,aAAA,GAAgB,kBAAA;EAMhB,YAAA;EAKA,oBAAA;EAMA,mBAAA;EAKA,WAAA;EAMA,uBAAA;EAKA,UAAA,GAAa,MAAA;EAMb,oBAAA;EAKA,iBAAA;IACE,wBAAA;IACA,yBAAA;IACA,mBAAA;EAAA;EAOF,YAAA;IACE,UAAA;EAAA;AAAA;AAAA,QAOI,MAAA;EAAA,UACI,MAAA;IACR,MAAA;IAEA,8BAAA;IAEA,6BAAA;EAAA;AAAA;;;iBC1GY,0BAAA,CACd,SAAA,EAAW,kBAAA,IACX,WAAA,WAEA,YAAA;;;cCgBW,yBAAA,SAAkC,YAAA;EAAA,QACrC,IAAA;EAAA,QACA,YAAA;EAAA,QACA,YAAA;EAAA,QACA,cAAA;EAAA,QACA,mBAAA;EAAA,QACA,qBAAA;cAOI,MAAA,GAAQ,yBAAA;EAAA,eA2CL,aAAA;EAAA,eAwBA,aAAA;EAwBT,UAAA,CAAW,MAAA,GAAS,yBAAA,GAA4B,OAAA;EAAA,QAwC9C,qBAAA;EAAA,QA6CA,aAAA;EAAA,QA0CA,kBAAA;EAqBR,gBAAA,CAAiB,KAAA,EAAO,KAAA,YAAiB,OAAA,GAAU,oBAAA;EAuDnD,cAAA,CAAe,OAAA,UAAiB,KAAA,GAAO,QAAA,EAAmB,OAAA,GAAU,oBAAA;EAoDpE,OAAA,CAAA,GAAW,iBAAA;EAOX,eAAA,CAAA;EAOA,OAAA,CAAA;EAQA,YAAA,CAAA,GAAgB,MAAA;EAcV,OAAA,CAAA,GAAW,OAAA;EAkCX,OAAA,CAAA,GAAW,OAAA;AAAA;AAAA,cAyBN,+BAAA,GACX,MAAA,GAAS,yBAAA,KACR,yBAAA;;;iBCtda,yBAAA,CACd,cAAA,GAAiB,kBAAA;AAAA,iBA+DH,iBAAA,CAAA;AAAA,iBAkCA,oBAAA,CACd,YAAA,UACA,cAAA,GAAiB,MAAA"}

package/env.ts

@@ -0,0 +1,67 @@
+/**
+ * @fileoverview Core environment configuration for the observability package
+ * Core environment configuration for the observability package
+ * Provider-specific configurations are handled by their respective plugins
+ */
+
+import { logWarn } from '@repo/shared/logger';
+import { createEnv } from '@t3-oss/env-core';
+import { z } from 'zod/v4';
+
+// Create validated env object
+export const env = createEnv({
+  server: {
+    // Core observability config only - providers handle their own
+  },
+  clientPrefix: 'NEXT_PUBLIC_',
+  client: {
+    // Core configuration available on both client and server
+    NEXT_PUBLIC_NODE_ENV: z.enum(['development', 'test', 'production']).default('development'),
+    NEXT_PUBLIC_OBSERVABILITY_DEBUG: z
+      .string()
+      .optional()
+      .transform(val => val === 'true')
+      .default(false),
+    NEXT_PUBLIC_OBSERVABILITY_CONSOLE_ENABLED: z
+      .string()
+      .optional()
+      .transform(val => (val === 'true' ? true : val === 'false' ? false : undefined)),
+  },
+  runtimeEnv: process.env,
+  emptyStringAsUndefined: true,
+  onInvalidAccess: (variable: string) => {
+    throw new Error(
+      `❌ Attempted to access a server-side environment variable on the client: ${variable}`,
+    );
+  },
+  onValidationError: error => {
+    logWarn('Observability package environment validation failed', { error });
+    // Don't throw in packages - use fallbacks
+    return undefined as never;
+  },
+});
+
+// Helper for non-Next.js contexts (Node.js, workers, tests)
+export function safeEnv() {
+  try {
+    if (env && typeof env === 'object') return env;
+  } catch {
+    // Environment validation failed, use fallbacks
+  }
+
+  // Fallback values for resilience
+  return {
+    // Core configuration only
+    NEXT_PUBLIC_NODE_ENV: process.env.NODE_ENV ?? 'development',
+    NEXT_PUBLIC_OBSERVABILITY_DEBUG: process.env.NEXT_PUBLIC_OBSERVABILITY_DEBUG === 'true',
+    NEXT_PUBLIC_OBSERVABILITY_CONSOLE_ENABLED:
+      process.env.NEXT_PUBLIC_OBSERVABILITY_CONSOLE_ENABLED === 'true'
+        ? true
+        : process.env.NEXT_PUBLIC_OBSERVABILITY_CONSOLE_ENABLED === 'false'
+          ? false
+          : undefined,
+  };
+}
+
+// Export type
+export type Env = typeof env;

package/package.json

@@ -0,0 +1,147 @@
+{
+  "name": "@od-oneapp/observability",
+  "version": "2026.1.1301",
+  "private": false,
+  "description": "Clean observability package with provider subpackages",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/OneDigital-Product/monorepo.git",
+    "directory": "platform/packages/observability"
+  },
+  "license": "MIT",
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    },
+    "./client": {
+      "types": "./dist/client.d.mts",
+      "import": "./dist/client.mjs",
+      "default": "./dist/client.mjs"
+    },
+    "./server": {
+      "types": "./dist/server.d.mts",
+      "import": "./dist/server.mjs",
+      "default": "./dist/server.mjs"
+    },
+    "./client/next": {
+      "types": "./dist/client-next.d.mts",
+      "import": "./dist/client-next.mjs",
+      "default": "./dist/client-next.mjs"
+    },
+    "./server/next": {
+      "types": "./dist/server-next.d.mts",
+      "import": "./dist/server-next.mjs",
+      "default": "./dist/server-next.mjs"
+    },
+    "./server/edge": {
+      "types": "./dist/server-edge.d.mts",
+      "import": "./dist/server-edge.mjs",
+      "default": "./dist/server-edge.mjs"
+    },
+    "./env": {
+      "types": "./dist/env.d.mts",
+      "import": "./dist/env.mjs",
+      "default": "./dist/env.mjs"
+    },
+    "./plugins/console": {
+      "types": "./dist/plugins-console.d.mts",
+      "import": "./dist/plugins-console.mjs",
+      "default": "./dist/plugins-console.mjs"
+    },
+    "./plugins/sentry": {
+      "types": "./dist/plugins-sentry.d.mts",
+      "import": "./dist/plugins-sentry.mjs",
+      "default": "./dist/plugins-sentry.mjs"
+    },
+    "./plugins/sentry/env": {
+      "types": "./dist/plugins-sentry-env.d.mts",
+      "import": "./dist/plugins-sentry-env.mjs",
+      "default": "./dist/plugins-sentry-env.mjs"
+    },
+    "./plugins/betterstack": {
+      "types": "./dist/plugins-betterstack.d.mts",
+      "import": "./dist/plugins-betterstack.mjs",
+      "default": "./dist/plugins-betterstack.mjs"
+    },
+    "./plugins/betterstack/env": {
+      "types": "./dist/plugins-betterstack-env.d.mts",
+      "import": "./dist/plugins-betterstack-env.mjs",
+      "default": "./dist/plugins-betterstack-env.mjs"
+    },
+    "./plugins/sentry-microfrontend": {
+      "types": "./dist/plugins-sentry-microfrontend.d.mts",
+      "import": "./dist/plugins-sentry-microfrontend.mjs",
+      "default": "./dist/plugins-sentry-microfrontend.mjs"
+    },
+    "./plugins/sentry-microfrontend/env": {
+      "types": "./dist/plugins-sentry-microfrontend-env.d.mts",
+      "import": "./dist/plugins-sentry-microfrontend-env.mjs",
+      "default": "./dist/plugins-sentry-microfrontend-env.mjs"
+    },
+    "./hooks/useObservability": {
+      "types": "./dist/hooks-useObservability.d.mts",
+      "import": "./dist/hooks-useObservability.mjs",
+      "default": "./dist/hooks-useObservability.mjs"
+    }
+  },
+  "files": [
+    "src",
+    "env.ts",
+    "dist"
+  ],
+  "dependencies": {
+    "@sentry/nextjs": "^10.38.0",
+    "@t3-oss/env-core": "^0.13.10",
+    "zod": "4.3.6",
+    "@integrations/sentry": "2026.1.1301",
+    "@repo/shared": "2026.1.1301",
+    "@integrations/betterstack": "2026.1.1301"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.3.2",
+    "@types/node": "25.2.3",
+    "@types/react": "19.2.13",
+    "@vitest/coverage-v8": "4.0.18",
+    "eslint": "9.39.2",
+    "madge": "8.0.0",
+    "react": "^19.2.4",
+    "tsdown": "^0.20.3",
+    "typescript": "5.9.3",
+    "vite-tsconfig-paths": "6.1.0",
+    "vitest": "4.0.18",
+    "@od-oneapp/qa": "2026.1.1301",
+    "@repo/config": "2026.1.1301"
+  },
+  "peerDependencies": {
+    "next": "16.1.6",
+    "react": "^19.2.4"
+  },
+  "peerDependenciesMeta": {
+    "next": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    }
+  },
+  "publishConfig": {
+    "access": "restricted",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "build:publish": "tsdown && node ../../../scripts/prepare-publish.mjs",
+    "circular": "madge --circular --extensions ts,tsx,js,jsx .",
+    "clean": "rm -rf .turbo node_modules",
+    "format": "prettier --write --cache --ignore-unknown --ignore-path ../../../.prettierignore .",
+    "format:check": "prettier --check --cache --ignore-unknown --ignore-path ../../../.prettierignore .",
+    "lint": "eslint . --fix",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/src/client-next.ts

@@ -0,0 +1,131 @@
+/**
+ * @fileoverview Next.js client-specific observability export
+ * Next.js client-specific observability export
+ */
+
+import { env } from '../env';
+
+import { ObservabilityBuilder } from './factory/builder';
+import { createBetterStackPlugin } from './plugins/betterstack';
+import { env as betterStackEnv } from './plugins/betterstack/env';
+import { createConsolePlugin } from './plugins/console';
+import { createSentryPlugin } from './plugins/sentry';
+import { env as sentryEnv } from './plugins/sentry/env';
+import { shouldEnableConsole } from './shared';
+
+import type { ObservabilityManager } from './core/manager';
+
+/**
+ * Create auto-configured observability for Next.js client
+ */
+export async function createClientObservability() {
+  const builder = ObservabilityBuilder.create();
+
+  // Console logging control using shared utility
+  const enableConsole = shouldEnableConsole(
+    env.NEXT_PUBLIC_NODE_ENV,
+    env.NEXT_PUBLIC_OBSERVABILITY_CONSOLE_ENABLED,
+    env.NEXT_PUBLIC_OBSERVABILITY_DEBUG,
+  );
+
+  // Always add console plugin, control via enabled flag
+  builder.withPlugin(
+    createConsolePlugin({
+      prefix: '[Next.js Client]',
+      enabled: enableConsole,
+    }),
+  );
+
+  // Auto-activate Sentry if client DSN is provided
+  if (sentryEnv.NEXT_PUBLIC_SENTRY_DSN) {
+    builder.withPlugin(
+      createSentryPlugin({
+        dsn: sentryEnv.NEXT_PUBLIC_SENTRY_DSN,
+      }),
+    );
+  }
+
+  // Auto-activate Better Stack if client token is provided
+  const clientBetterStackToken =
+    betterStackEnv.NEXT_PUBLIC_BETTER_STACK_SOURCE_TOKEN ??
+    betterStackEnv.NEXT_PUBLIC_BETTERSTACK_TOKEN ??
+    betterStackEnv.NEXT_PUBLIC_LOGTAIL_TOKEN;
+
+  if (clientBetterStackToken) {
+    builder.withPlugin(
+      createBetterStackPlugin({
+        sourceToken: clientBetterStackToken,
+      }),
+    );
+  }
+
+  return builder.build();
+}
+
+// Lazy initialization for the observability instance using promise-based singleton
+let initializationPromise: Promise<ObservabilityManager> | null = 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
+ */
+export async function getObservability(): Promise<ObservabilityManager> {
+  if (!initializationPromise) {
+    initializationPromise = (async () => {
+      try {
+        return await createClientObservability();
+      } catch (error) {
+        // Reset cached promise on failure so callers can retry
+        initializationPromise = null;
+        throw error;
+      }
+    })();
+
+    // Set promise for React 19 hooks (dynamic import to avoid circular dependency)
+    void (async () => {
+      try {
+        const { setObservabilityPromise } = await import('./hooks/useObservability');
+        const promise = initializationPromise;
+        if (promise !== null) {
+          setObservabilityPromise(promise);
+        }
+      } catch {
+        // Hooks module not available or import failed - continue without hooks
+      }
+    })();
+  }
+  return initializationPromise;
+}
+
+// Export types and utilities
+export * from './core/types';
+export { createObservability } from './factory';
+export { ObservabilityBuilder } from './factory/builder';
+
+// Re-export plugins for direct access (excluding conflicting exports)
+export { BetterStackPlugin } from './plugins/betterstack';
+export { ConsolePlugin } from './plugins/console';
+export { SentryPlugin } from './plugins/sentry';
+export { SentryMicroFrontendPlugin } from './plugins/sentry-microfrontend';
+
+// Re-export plugin-specific types with aliases to avoid conflicts
+export type { Env as BetterStackEnv, BetterStackPluginConfig } from './plugins/betterstack';
+export type { ConsolePluginConfig } from './plugins/console';
+export type { Env as SentryEnv, SentryPluginConfig } from './plugins/sentry';
+export type {
+  BackstageAppConfig,
+  MicroFrontendMode,
+  SentryMicroFrontendConfig,
+} from './plugins/sentry-microfrontend';
+
+// Legacy function for backward compatibility (no-op)
+/**
+ * @deprecated Configuration now happens through the observability system
+ */
+export const configureLogger = () => {
+  // No-op: Configuration now happens through the observability system
+};
+
+// Re-export type
+export type LogContext = Record<string, any>;

package/src/client.ts

@@ -0,0 +1,70 @@
+/**
+ * @fileoverview Auto-configuring client export for browser environments (non-Next.js)
+ * Auto-configuring client export for browser environments (non-Next.js)
+ */
+
+import { env } from '../env';
+
+import { ObservabilityBuilder } from './factory/builder';
+import { createConsolePlugin } from './plugins/console';
+import { shouldEnableConsole } from './shared';
+
+/**
+ * Auto-configured observability for browser environments
+ * Automatically sets up console logging based on environment variables
+ */
+const builder = ObservabilityBuilder.create();
+
+// Console logging control using shared utility
+const enableConsole = shouldEnableConsole(
+  env.NEXT_PUBLIC_NODE_ENV,
+  env.NEXT_PUBLIC_OBSERVABILITY_CONSOLE_ENABLED,
+  env.NEXT_PUBLIC_OBSERVABILITY_DEBUG,
+);
+
+// Always add console plugin, control via enabled flag
+builder.withPlugin(
+  createConsolePlugin({
+    prefix: '[Browser]',
+    enabled: enableConsole,
+  }),
+);
+
+// Note: Sentry and Better Stack would typically be configured by the app
+// This is just a fallback for non-Next.js browser usage
+
+/**
+ * Pre-configured observability instance for browser environments
+ * Includes console logging with automatic environment-based configuration
+ */
+export const observability = builder.build();
+
+// Export types and utilities
+export * from './core/types';
+export { createObservability } from './factory';
+export { ObservabilityBuilder } from './factory/builder';
+
+/**
+ * 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 `@repo/observability/client/next` instead,
+ * which provides async loggers that support lazy initialization.
+ *
+ * @example
+ * ```typescript
+ * import { logInfo, logError } from '@repo/shared/logger';
+ * logInfo('User logged in', { userId: '123' });
+ * logError('Failed to save data', { error: err });
+ * ```
+ */
+// Legacy function for backward compatibility (no-op)
+/**
+ * @deprecated Configuration now happens through the observability system
+ */
+export const configureLogger = () => {
+  // No-op: Configuration now happens through the observability system
+};
+
+// Re-export type
+export type LogContext = Record<string, any>;

package/src/core/index.ts

@@ -0,0 +1,15 @@
+/**
+ * @fileoverview Core observability package exports
+ * Core observability package exports
+ * Provides types and interfaces for logging, monitoring, and telemetry
+ */
+
+export type {
+  Breadcrumb,
+  LogLevel,
+  ObservabilityClient,
+  ObservabilityConfig,
+  ObservabilityContext,
+  ObservabilityServer,
+  ObservabilityUser,
+} from './types';