B2B-88: add starter kit structure and elements

packages/monitoring/baselime/README.md

@@ -0,0 +1,3 @@
+# Baselime Monitoring / @kit/baselime
+
+Please refer to the [documentation](https://makerkit.dev/docs/next-supabase-turbo/baselime).

packages/monitoring/baselime/eslint.config.mjs

@@ -0,0 +1,3 @@
+import eslintConfigBase from '@kit/eslint-config/base.js';
+
+export default eslintConfigBase;

packages/monitoring/baselime/node_modules/.bin/acorn

@@ -0,0 +1,17 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*) basedir=`cygpath -w "$basedir"`;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/acorn@8.14.1/node_modules/acorn/bin/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/acorn@8.14.1/node_modules/acorn/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/acorn@8.14.1/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/acorn@8.14.1/node_modules/acorn/bin/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/acorn@8.14.1/node_modules/acorn/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/acorn@8.14.1/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/acorn@8.14.1/node_modules/acorn/bin/acorn" "$@"
+else
+  exec node  "$basedir/../../../../../node_modules/.pnpm/acorn@8.14.1/node_modules/acorn/bin/acorn" "$@"
+fi

packages/monitoring/baselime/node_modules/.bin/tsc

@@ -0,0 +1,17 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*) basedir=`cygpath -w "$basedir"`;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/bin/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/typescript@5.8.3/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/bin/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/typescript@5.8.3/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/bin/tsc" "$@"
+else
+  exec node  "$basedir/../../../../../node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/bin/tsc" "$@"
+fi

packages/monitoring/baselime/node_modules/.bin/tsserver

@@ -0,0 +1,17 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*) basedir=`cygpath -w "$basedir"`;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/bin/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/typescript@5.8.3/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/bin/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/typescript@5.8.3/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/bin/tsserver" "$@"
+else
+  exec node  "$basedir/../../../../../node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/bin/tsserver" "$@"
+fi

packages/monitoring/baselime/node_modules/@baselime/node-opentelemetry

@@ -0,0 +1 @@
+../../../../../node_modules/.pnpm/@baselime+node-opentelemetry@0.5.8_@trpc+server@11.3.1_typescript@5.8.3_/node_modules/@baselime/node-opentelemetry

packages/monitoring/baselime/node_modules/@baselime/react-rum

@@ -0,0 +1 @@
+../../../../../node_modules/.pnpm/@baselime+react-rum@0.3.1_react@19.1.0/node_modules/@baselime/react-rum

packages/monitoring/baselime/node_modules/@kit/eslint-config

@@ -0,0 +1 @@
+../../../../../tooling/eslint

packages/monitoring/baselime/node_modules/@kit/monitoring-core

@@ -0,0 +1 @@
+../../../core

packages/monitoring/baselime/node_modules/@kit/prettier-config

@@ -0,0 +1 @@
+../../../../../tooling/prettier

packages/monitoring/baselime/node_modules/@kit/tsconfig

@@ -0,0 +1 @@
+../../../../../tooling/typescript

packages/monitoring/baselime/node_modules/@types/react

@@ -0,0 +1 @@
+../../../../../node_modules/.pnpm/@types+react@19.1.4/node_modules/@types/react

packages/monitoring/baselime/node_modules/react

@@ -0,0 +1 @@
+../../../../node_modules/.pnpm/react@19.1.0/node_modules/react

packages/monitoring/baselime/node_modules/zod

@@ -0,0 +1 @@
+../../../../node_modules/.pnpm/zod@3.25.56/node_modules/zod

packages/monitoring/baselime/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@kit/baselime",
+  "private": true,
+  "version": "0.1.0",
+  "scripts": {
+    "clean": "git clean -xdf .turbo node_modules",
+    "format": "prettier --check \"**/*.{ts,tsx}\"",
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit"
+  },
+  "prettier": "@kit/prettier-config",
+  "exports": {
+    "./server": "./src/server.ts",
+    "./client": "./src/client.ts",
+    "./instrumentation": "./src/instrumentation.ts",
+    "./provider": "./src/components/provider.tsx"
+  },
+  "dependencies": {
+    "@baselime/node-opentelemetry": "^0.5.8",
+    "@baselime/react-rum": "^0.3.1",
+    "@kit/monitoring-core": "workspace:*"
+  },
+  "devDependencies": {
+    "@kit/eslint-config": "workspace:*",
+    "@kit/prettier-config": "workspace:*",
+    "@kit/tsconfig": "workspace:*",
+    "@types/react": "19.1.4",
+    "react": "19.1.0",
+    "zod": "^3.24.4"
+  },
+  "typesVersions": {
+    "*": {
+      "*": [
+        "src/*"
+      ]
+    }
+  }
+}

packages/monitoring/baselime/src/client.ts

@@ -0,0 +1 @@
+export * from './hooks/use-baselime';

packages/monitoring/baselime/src/components/provider.tsx

@@ -0,0 +1,50 @@
+import { useRef } from 'react';
+
+import { BaselimeRum } from '@baselime/react-rum';
+
+import { MonitoringContext } from '@kit/monitoring-core';
+
+import { useBaselime } from '../hooks/use-baselime';
+
+export function BaselimeProvider({
+  children,
+  apiKey,
+  enableWebVitals,
+  ErrorPage,
+}: React.PropsWithChildren<{
+  apiKey?: string;
+  enableWebVitals?: boolean;
+  ErrorPage?: React.ReactElement;
+}>) {
+  const key = apiKey ?? process.env.NEXT_PUBLIC_BASELIME_KEY ?? '';
+
+  if (!key) {
+    console.warn(
+      'You configured Baselime as monitoring provider but did not provide a key. ' +
+        'Please provide a key to enable monitoring with Baselime using the variable NEXT_PUBLIC_BASELIME_KEY.',
+    );
+
+    return children;
+  }
+
+  return (
+    <BaselimeRum
+      apiKey={key}
+      enableWebVitals={enableWebVitals}
+      fallback={ErrorPage ?? null}
+    >
+      <MonitoringProvider>{children}</MonitoringProvider>
+    </BaselimeRum>
+  );
+}
+
+function MonitoringProvider(props: React.PropsWithChildren) {
+  const service = useBaselime();
+  const provider = useRef(service);
+
+  return (
+    <MonitoringContext.Provider value={provider.current}>
+      {props.children}
+    </MonitoringContext.Provider>
+  );
+}

packages/monitoring/baselime/src/hooks/use-baselime.ts

@@ -0,0 +1,30 @@
+import { useMemo } from 'react';
+
+import { useBaselimeRum } from '@baselime/react-rum';
+
+import { MonitoringService } from '@kit/monitoring-core';
+
+/**
+ * @name useBaselime
+ * @description Get the Baselime monitoring service for the browser.
+ */
+export function useBaselime(): MonitoringService {
+  const { captureException, setUser, sendEvent } = useBaselimeRum();
+
+  return useMemo(() => {
+    return {
+      captureException(error: Error, extra?: React.ErrorInfo) {
+        void captureException(error, extra);
+      },
+      identifyUser(params) {
+        setUser(params.id);
+      },
+      captureEvent<Extra extends object>(event: string, extra?: Extra) {
+        return sendEvent(event, extra);
+      },
+      ready() {
+        return Promise.resolve();
+      },
+    } satisfies MonitoringService;
+  }, [captureException, sendEvent, setUser]);
+}

packages/monitoring/baselime/src/instrumentation.ts

@@ -0,0 +1,38 @@
+/**
+ * @name registerInstrumentation
+ * @description This file is used to register Baselime instrumentation for your Next.js application.
+ *
+ * Please set the MONITORING_PROVIDER environment variable to 'baselime' to register Baselime instrumentation.
+ */
+export async function registerInstrumentation() {
+  if (process.env.ENABLE_MONITORING_INSTRUMENTATION !== 'true') {
+    return;
+  }
+
+  const serviceName = process.env.INSTRUMENTATION_SERVICE_NAME;
+
+  if (!serviceName) {
+    throw new Error(`
+      You have set the Baselime instrumentation provider, but have not set the INSTRUMENTATION_SERVICE_NAME environment variable. 
+      Please set the INSTRUMENTATION_SERVICE_NAME environment variable.
+    `);
+  }
+
+  if (process.env.NEXT_RUNTIME === 'nodejs') {
+    const { BaselimeSDK, BetterHttpInstrumentation, VercelPlugin } =
+      await import('@baselime/node-opentelemetry');
+
+    const sdk = new BaselimeSDK({
+      serverless: true,
+      service: serviceName,
+      baselimeKey: process.env.NEXT_PUBLIC_BASELIME_KEY,
+      instrumentations: [
+        new BetterHttpInstrumentation({
+          plugins: [new VercelPlugin()],
+        }),
+      ],
+    });
+
+    sdk.start();
+  }
+}

packages/monitoring/baselime/src/server.ts

@@ -0,0 +1 @@
+export * from './services/baselime-server-monitoring.service';

packages/monitoring/baselime/src/services/baselime-server-monitoring.service.ts

@@ -0,0 +1,115 @@
+import { z } from 'zod';
+
+import { MonitoringService } from '@kit/monitoring-core';
+
+const apiKey = z
+  .string({
+    required_error: 'NEXT_PUBLIC_BASELIME_KEY is required',
+    description: 'The Baseline API key',
+  })
+  .parse(process.env.NEXT_PUBLIC_BASELIME_KEY);
+
+export class BaselimeServerMonitoringService implements MonitoringService {
+  userId: string | null = null;
+
+  async captureException(
+    error: Error | null,
+    extra?: {
+      requestId?: string;
+      sessionId?: string;
+      namespace?: string;
+      service?: string;
+    },
+  ) {
+    const formattedError = error ? getFormattedError(error) : {};
+
+    const event = {
+      level: 'error',
+      data: { error },
+      error: {
+        ...formattedError,
+      },
+      message: error ? `${error.name}: ${error.message}` : `Unknown error`,
+    };
+
+    const response = await fetch(`https://events.baselime.io/v1/logs`, {
+      method: 'POST',
+      headers: {
+        contentType: 'application/json',
+        'x-api-key': apiKey,
+        'x-service': extra?.service ?? '',
+        'x-namespace': extra?.namespace ?? '',
+      },
+      body: JSON.stringify([
+        {
+          userId: this.userId,
+          sessionId: extra?.sessionId,
+          namespace: extra?.namespace,
+          ...event,
+        },
+      ]),
+    });
+
+    if (!response.ok) {
+      console.error(
+        {
+          response,
+          event,
+        },
+        'Failed to send event to Baselime',
+      );
+    }
+  }
+
+  async captureEvent<
+    Extra extends {
+      sessionId?: string;
+      namespace?: string;
+      service?: string;
+    },
+  >(event: string, extra?: Extra) {
+    const response = await fetch(`https://events.baselime.io/v1/logs`, {
+      method: 'POST',
+      headers: {
+        contentType: 'application/json',
+        'x-api-key': apiKey,
+        'x-service': extra?.service ?? '',
+        'x-namespace': extra?.namespace ?? '',
+      },
+      body: JSON.stringify([
+        {
+          userId: this.userId,
+          sessionId: extra?.sessionId,
+          namespace: extra?.namespace,
+          message: event,
+        },
+      ]),
+    });
+
+    if (!response.ok) {
+      console.error(
+        {
+          response,
+          event,
+        },
+        'Failed to send event to Baselime',
+      );
+    }
+  }
+
+  identifyUser<Info extends { id: string }>(info: Info) {
+    this.userId = info.id;
+  }
+
+  ready() {
+    return Promise.resolve();
+  }
+}
+
+function getFormattedError(error: Error) {
+  return {
+    name: error.name,
+    message: error.message,
+    stack: error.stack,
+  };
+}

packages/monitoring/baselime/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "@kit/tsconfig/base.json",
+  "compilerOptions": {
+    "tsBuildInfoFile": "node_modules/.cache/tsbuildinfo.json"
+  },
+  "include": ["*.ts", "src"],
+  "exclude": ["node_modules"]
+}