@monocle.sh/effect-agent 0.1.5 → 0.3.0

package/dist/src/layer.d.mts

@@ -10,7 +10,7 @@ import { Layer } from "effect";
  * Monocle authentication headers. Includes the MonocleSpanProcessor
  * for automatic exception enrichment.
  *
- * Returns an empty layer when no API key is available and dev mode
+ * Returns an empty layer when neither a DSN nor an API key is available and dev mode
  * is disabled, making it safe for local development.
  */
 declare function MonocleLayer(config: MonocleEffectConfig): Layer.Layer<Resource.Resource>;

package/dist/src/layer.mjs

@@ -6,7 +6,8 @@ import { PeriodicExportingMetricReader } from "@opentelemetry/sdk-metrics";
 import { BatchLogRecordProcessor } from "@opentelemetry/sdk-logs";
 import { NodeSdk } from "@effect/opentelemetry";
 import { Layer, Option, Redacted } from "effect";
-import { MonocleSpanProcessor } from "@monocle.sh/otel-utils";
+import { parseMonocleDsn } from "@monocle.sh/otel-utils/connection";
+import { MonocleSpanProcessor, buildNodejsMonocleResourceAttributes } from "@monocle.sh/otel-utils";
 //#region src/layer.ts
 const DEFAULT_ENDPOINT = "https://ingest.monocle.sh";
 const DEV_ENDPOINT = "http://localhost:4200";
@@ -21,14 +22,17 @@ const DEV_BATCH_CONFIG = {
 	scheduledDelayMillis: 100
 };
 function resolveSdkVersion() {
-	return "0.1.5";
+	return "0.3.0";
 }
 function buildNodejsResourceAttributes() {
-	const attributes = {
-		"monocle.language.name": "javascript",
-		"monocle.framework.name": "effect"
-	};
 	const sdkVersion = resolveSdkVersion();
+	const attributes = buildNodejsMonocleResourceAttributes({
+		framework: { name: "effect" },
+		sdk: {
+			name: "@monocle.sh/effect-agent",
+			version: sdkVersion
+		}
+	});
 	if (sdkVersion) attributes["telemetry.sdk.version"] = sdkVersion;
 	return attributes;
 }
@@ -55,14 +59,16 @@ function resolveEnvironment(configEnv) {
 * Monocle authentication headers. Includes the MonocleSpanProcessor
 * for automatic exception enrichment.
 *
-* Returns an empty layer when no API key is available and dev mode
+* Returns an empty layer when neither a DSN nor an API key is available and dev mode
 * is disabled, making it safe for local development.
 */
 function MonocleLayer(config) {
 	const isDev = config.dev;
-	const apiKey = resolveApiKey(config.apiKey);
+	const dsn = config.dsn ?? process.env.MONOCLE_DSN;
+	const connection = !isDev && dsn ? parseMonocleDsn(dsn) : void 0;
+	const apiKey = resolveApiKey(connection?.apiKey || config.apiKey);
 	if (!isDev && Option.isNone(apiKey)) return Layer.empty;
-	const endpoint = isDev ? config.endpoint || DEV_ENDPOINT : config.endpoint || DEFAULT_ENDPOINT;
+	const endpoint = isDev ? config.endpoint || DEV_ENDPOINT : connection?.endpoint || config.endpoint || DEFAULT_ENDPOINT;
 	const environment = resolveEnvironment(config.environment);
 	const batchConfig = isDev ? DEV_BATCH_CONFIG : DEFAULT_BATCH_CONFIG;
 	const resourceAttributes = {
@@ -70,11 +76,12 @@ function MonocleLayer(config) {
 		...buildNodejsResourceAttributes()
 	};
 	const headers = { "x-monocle-env": environment };
+	if (connection) headers["x-monocle-service-id"] = connection.serviceId;
 	if (Option.isSome(apiKey)) headers["x-api-key"] = Redacted.value(apiKey.value);
 	const monocleProcessor = new MonocleSpanProcessor();
 	return NodeSdk.layer(() => ({
 		resource: {
-			serviceName: config.serviceName,
+			serviceName: config.serviceName ?? "unknown_service",
 			serviceVersion: config.serviceVersion ?? "0.0.0",
 			attributes: resourceAttributes
 		},

package/dist/src/types.d.mts

@@ -13,15 +13,28 @@ interface MonocleEffectConfig {
    */
   dev?: boolean;
   /**
-   * Monocle API key (format: mk_live_xxx or mk_test_xxx).
+   * Monocle API key for legacy connections. Prefer dsn or MONOCLE_DSN.
+   * Format: mk_live_xxx or mk_test_xxx.
    * Falls back to the MONOCLE_API_KEY environment variable.
-   * When neither is set and dev mode is off, returns an empty layer.
+   * When neither a DSN nor an API key is set and dev mode is off, returns an empty layer.
+   * @deprecated Use dsn or MONOCLE_DSN copied from your service's connection settings.
+   * Existing API key configurations remain supported; no key rotation is required.
    */
   apiKey?: string;
   /**
-   * Service name for this application.
+   * Service name for legacy connections and local Studio.
+   * Existing API key and serviceName configurations remain supported.
+   * @deprecated For Monocle Cloud, use dsn or MONOCLE_DSN copied from your service's
+   * connection settings. The collector resolves the service name from the DSN.
+   * Keep this option when naming services in Studio.
    */
-  serviceName: string;
+  serviceName?: string;
+  /**
+   * Service connection copied from Monocle. No serviceName is needed.
+   * Takes precedence over apiKey and endpoint.
+   * Falls back to MONOCLE_DSN. Ignored in Studio mode.
+   */
+  dsn?: string;
   /**
    * Service version.
    */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@monocle.sh/effect-agent",
-  "version": "0.1.5",
+  "version": "0.3.0",
   "description": "Monocle observability agent for Effect applications",
   "keywords": [
     "effect",
@@ -38,7 +38,7 @@
     "@opentelemetry/sdk-logs": "^0.216.0",
     "@opentelemetry/sdk-metrics": "^2.7.1",
     "@opentelemetry/sdk-trace-node": "^2.7.1",
-    "@monocle.sh/otel-utils": "1.4.0"
+    "@monocle.sh/otel-utils": "1.6.0"
   },
   "devDependencies": {
     "@adonisjs/tsconfig": "^2.0.0",
@@ -51,6 +51,7 @@
   "scripts": {
     "build": "tsdown",
     "dev": "tsdown",
-    "typecheck": "tsgo --noEmit"
+    "typecheck": "tsgo --noEmit",
+    "test": "node --conditions=dev --experimental-transform-types --test tests/*.test.mjs"
   }
 }