@statly/observe 0.1.0 → 0.1.2

package/README.md

@@ -5,6 +5,10 @@
 
 Error tracking and monitoring for JavaScript and TypeScript applications. Capture exceptions, track releases, and debug issues faster.
 
+**[📚 Full Documentation](https://docs.statly.live/sdk/javascript/installation)** | **[🚀 Get Started](https://statly.live)** | **[💬 Support](mailto:support@mail.kodydennon.com)**
+
+> **This SDK requires a [Statly](https://statly.live) account.** Sign up free at [statly.live](https://statly.live) to get your DSN and start tracking errors in minutes.
+
 ## Features
 
 - Automatic error capturing with stack traces
@@ -30,9 +34,21 @@ pnpm add @statly/observe
 1. Go to [statly.live/dashboard/observe/setup](https://statly.live/dashboard/observe/setup)
 2. Create an API key for Observe
 3. Copy your DSN (format: `https://<api-key>@statly.live/<org-slug>`)
+4. Add to your `.env` file: `STATLY_DSN=https://...`
 
 ## Quick Start
 
+The SDK automatically loads DSN from environment variables, so you can simply:
+
+```typescript
+import { Statly } from '@statly/observe';
+
+// Auto-loads STATLY_DSN from environment
+Statly.init();
+```
+
+Or pass it explicitly:
+
 ```typescript
 import { Statly } from '@statly/observe';
 
@@ -192,11 +208,23 @@ fastify.get('/', async () => {
 fastify.listen({ port: 3000 });
 ```
 
+## Environment Variables
+
+The SDK automatically loads configuration from environment variables:
+
+| Variable | Description |
+|----------|-------------|
+| `STATLY_DSN` | Your project's DSN (primary) |
+| `NEXT_PUBLIC_STATLY_DSN` | DSN for Next.js client-side |
+| `STATLY_OBSERVE_DSN` | Alternative DSN variable |
+| `STATLY_ENVIRONMENT` | Environment name |
+| `NODE_ENV` | Fallback for environment |
+
 ## Configuration Options
 
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
-| `dsn` | `string` | **Required** | Your project's Data Source Name |
+| `dsn` | `string` | `process.env.STATLY_DSN` | Your project's Data Source Name |
 | `environment` | `string` | `undefined` | Environment name (production, staging, development) |
 | `release` | `string` | `undefined` | Release/version identifier for tracking |
 | `debug` | `boolean` | `false` | Enable debug logging to console |
@@ -336,6 +364,26 @@ import type {
 - Node.js 16+
 - Works in browser environments (with bundler)
 
+## Resources
+
+- **[Statly Platform](https://statly.live)** - Sign up and manage your error tracking
+- **[Documentation](https://docs.statly.live/sdk/javascript/installation)** - Full SDK documentation
+- **[API Reference](https://docs.statly.live/sdk/javascript/api-reference)** - Complete API reference
+- **[Express Guide](https://docs.statly.live/sdk/javascript/express)** - Express integration
+- **[Next.js Guide](https://docs.statly.live/sdk/javascript/nextjs)** - Next.js integration
+- **[Fastify Guide](https://docs.statly.live/sdk/javascript/fastify)** - Fastify integration
+- **[MCP Server](https://github.com/KodyDennon/DD-StatusPage/tree/master/packages/mcp-docs-server)** - AI/Claude integration for docs
+
+## Why Statly?
+
+Statly is more than error tracking. Get:
+- **Status Pages** - Beautiful public status pages for your users
+- **Uptime Monitoring** - Multi-region HTTP/DNS checks every minute
+- **Error Tracking** - SDKs for JavaScript, Python, and Go
+- **Incident Management** - Track and communicate outages
+
+All on Cloudflare's global edge network. [Start free →](https://statly.live)
+
 ## License
 
 MIT

package/dist/{chunk-PETWPVHU.mjs → chunk-UNDSALI5.mjs}

@@ -886,12 +886,36 @@ function sanitizeHeaders2(headers) {
 
 // src/index.ts
 var client = null;
+function loadDsnFromEnv() {
+  if (typeof process !== "undefined" && process.env) {
+    return process.env.STATLY_DSN || process.env.NEXT_PUBLIC_STATLY_DSN || process.env.STATLY_OBSERVE_DSN;
+  }
+  return void 0;
+}
+function loadEnvironmentFromEnv() {
+  if (typeof process !== "undefined" && process.env) {
+    return process.env.STATLY_ENVIRONMENT || process.env.NODE_ENV;
+  }
+  return void 0;
+}
 function init(options) {
   if (client) {
     console.warn("[Statly] SDK already initialized. Call close() first to reinitialize.");
     return;
   }
-  client = new StatlyClient(options);
+  const dsn = options?.dsn || loadDsnFromEnv();
+  if (!dsn) {
+    console.error("[Statly] No DSN provided. Set STATLY_DSN in your environment or pass dsn to init().");
+    console.error("[Statly] Get your DSN at https://statly.live/dashboard/observe/setup");
+    return;
+  }
+  const environment = options?.environment || loadEnvironmentFromEnv();
+  const finalOptions = {
+    ...options,
+    dsn,
+    environment
+  };
+  client = new StatlyClient(finalOptions);
   client.init();
 }
 function captureException(error, context) {

package/dist/cli.d.mts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.js

@@ -0,0 +1,248 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/cli.ts
+var readline = __toESM(require("readline"));
+var fs = __toESM(require("fs"));
+var path = __toESM(require("path"));
+var COLORS = {
+  reset: "\x1B[0m",
+  bright: "\x1B[1m",
+  dim: "\x1B[2m",
+  green: "\x1B[32m",
+  yellow: "\x1B[33m",
+  blue: "\x1B[34m",
+  cyan: "\x1B[36m"
+};
+function print(msg) {
+  console.log(msg);
+}
+function printHeader() {
+  print("");
+  print(`${COLORS.cyan}${COLORS.bright}  _____ _        _   _       `);
+  print(`${COLORS.cyan} / ____| |      | | | |      `);
+  print(`${COLORS.cyan}| (___ | |_ __ _| |_| |_   _ `);
+  print(`${COLORS.cyan} \\___ \\| __/ _\` | __| | | | |`);
+  print(`${COLORS.cyan} ____) | || (_| | |_| | |_| |`);
+  print(`${COLORS.cyan}|_____/ \\__\\__,_|\\__|_|\\__, |`);
+  print(`${COLORS.cyan}                        __/ |`);
+  print(`${COLORS.cyan}                       |___/ ${COLORS.reset}`);
+  print("");
+  print(`${COLORS.bright}Statly Observe SDK Setup${COLORS.reset}`);
+  print(`${COLORS.dim}Error tracking for JavaScript applications${COLORS.reset}`);
+  print("");
+}
+function printStep(num, msg) {
+  print(`${COLORS.green}[${num}]${COLORS.reset} ${msg}`);
+}
+async function prompt(question) {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  return new Promise((resolve) => {
+    rl.question(`${COLORS.yellow}?${COLORS.reset} ${question} `, (answer) => {
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+}
+function detectFramework() {
+  const packageJsonPath = path.join(process.cwd(), "package.json");
+  if (fs.existsSync(packageJsonPath)) {
+    try {
+      const pkg = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
+      const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+      if (deps["next"]) return "nextjs";
+      if (deps["express"]) return "express";
+      if (deps["fastify"]) return "fastify";
+    } catch {
+    }
+  }
+  return null;
+}
+function generateCode(dsn, framework) {
+  if (framework === "express") {
+    return `// Add to your main server file (e.g., app.js or index.js)
+import express from 'express';
+import { Statly, requestHandler, expressErrorHandler } from '@statly/observe';
+
+const app = express();
+
+// Initialize Statly FIRST
+Statly.init({
+  dsn: '${dsn}',
+  environment: process.env.NODE_ENV || 'development',
+  release: process.env.npm_package_version,
+});
+
+// Add request handler before routes
+app.use(requestHandler());
+
+// Your routes here...
+
+// Add error handler LAST (after all routes)
+app.use(expressErrorHandler());
+
+app.listen(3000);
+`;
+  }
+  if (framework === "nextjs") {
+    return `// Create instrumentation.ts in your project root
+// instrumentation.ts
+import { Statly } from '@statly/observe';
+
+export function register() {
+  Statly.init({
+    dsn: '${dsn}',
+    environment: process.env.NODE_ENV || 'development',
+  });
+}
+
+// For API routes, wrap handlers:
+// app/api/example/route.ts
+import { withStatly } from '@statly/observe';
+
+export const GET = withStatly(async (request) => {
+  return Response.json({ ok: true });
+});
+
+// For error boundaries:
+// app/error.tsx
+'use client';
+import { useEffect } from 'react';
+import { captureNextJsError } from '@statly/observe';
+
+export default function Error({ error, reset }: { error: Error; reset: () => void }) {
+  useEffect(() => { captureNextJsError(error); }, [error]);
+  return <button onClick={reset}>Try again</button>;
+}
+`;
+  }
+  if (framework === "fastify") {
+    return `// Add to your Fastify server file
+import Fastify from 'fastify';
+import { Statly, statlyFastifyPlugin } from '@statly/observe';
+
+const fastify = Fastify();
+
+// Initialize Statly
+Statly.init({
+  dsn: '${dsn}',
+  environment: process.env.NODE_ENV || 'development',
+});
+
+// Register the plugin
+await fastify.register(statlyFastifyPlugin, {
+  captureValidationErrors: true,
+  skipStatusCodes: [400, 401, 403, 404],
+});
+
+fastify.get('/', async () => {
+  return { hello: 'world' };
+});
+
+await fastify.listen({ port: 3000 });
+`;
+  }
+  return `// Add to your application entry point
+import { Statly } from '@statly/observe';
+
+// Initialize the SDK
+Statly.init({
+  dsn: '${dsn}',
+  environment: process.env.NODE_ENV || 'development',
+  release: '1.0.0', // Your app version
+});
+
+// Errors are captured automatically
+
+// Manual capture example
+try {
+  riskyOperation();
+} catch (error) {
+  Statly.captureException(error);
+}
+
+// Set user context (after login)
+Statly.setUser({
+  id: 'user-123',
+  email: 'user@example.com',
+});
+
+// Flush before exit (important for serverless)
+await Statly.close();
+`;
+}
+async function main() {
+  const args = process.argv.slice(2);
+  const command = args[0];
+  if (command === "init") {
+    printHeader();
+    print(`${COLORS.dim}Get your DSN from: https://statly.live/dashboard/observe/setup${COLORS.reset}`);
+    print("");
+    const dsn = await prompt("Enter your DSN:");
+    if (!dsn) {
+      print(`${COLORS.yellow}No DSN provided. Get one at https://statly.live${COLORS.reset}`);
+      process.exit(1);
+    }
+    if (!dsn.match(/^https:\/\/[^@]+@statly\.live\/.+$/)) {
+      print(`${COLORS.yellow}Warning: DSN format looks incorrect.${COLORS.reset}`);
+      print(`${COLORS.dim}Expected format: https://<api-key>@statly.live/<org-slug>${COLORS.reset}`);
+    }
+    print("");
+    printStep(1, "Detecting your framework...");
+    const framework = detectFramework();
+    if (framework) {
+      print(`   ${COLORS.green}\u2713${COLORS.reset} Detected: ${COLORS.bright}${framework}${COLORS.reset}`);
+    } else {
+      print(`   ${COLORS.dim}No framework detected, using generic setup${COLORS.reset}`);
+    }
+    print("");
+    printStep(2, "Generated setup code:");
+    print("");
+    print(`${COLORS.dim}${"\u2500".repeat(50)}${COLORS.reset}`);
+    print(generateCode(dsn, framework));
+    print(`${COLORS.dim}${"\u2500".repeat(50)}${COLORS.reset}`);
+    print("");
+    printStep(3, "Next steps:");
+    print(`   ${COLORS.dim}1.${COLORS.reset} Copy the code above into your application`);
+    print(`   ${COLORS.dim}2.${COLORS.reset} Set your environment variables`);
+    print(`   ${COLORS.dim}3.${COLORS.reset} Trigger a test error to verify`);
+    print("");
+    print(`${COLORS.green}\u2713${COLORS.reset} Setup complete! View errors at ${COLORS.cyan}https://statly.live/dashboard/observe${COLORS.reset}`);
+    print("");
+    print(`${COLORS.dim}Documentation: https://docs.statly.live/sdk/javascript/installation${COLORS.reset}`);
+    print("");
+  } else {
+    print(`${COLORS.bright}Statly Observe CLI${COLORS.reset}`);
+    print("");
+    print("Usage:");
+    print(`  npx @statly/observe init    ${COLORS.dim}Setup Statly in your project${COLORS.reset}`);
+    print("");
+    print("Get started at https://statly.live");
+  }
+}
+main().catch(console.error);

package/dist/cli.mjs

@@ -0,0 +1,225 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import * as readline from "readline";
+import * as fs from "fs";
+import * as path from "path";
+var COLORS = {
+  reset: "\x1B[0m",
+  bright: "\x1B[1m",
+  dim: "\x1B[2m",
+  green: "\x1B[32m",
+  yellow: "\x1B[33m",
+  blue: "\x1B[34m",
+  cyan: "\x1B[36m"
+};
+function print(msg) {
+  console.log(msg);
+}
+function printHeader() {
+  print("");
+  print(`${COLORS.cyan}${COLORS.bright}  _____ _        _   _       `);
+  print(`${COLORS.cyan} / ____| |      | | | |      `);
+  print(`${COLORS.cyan}| (___ | |_ __ _| |_| |_   _ `);
+  print(`${COLORS.cyan} \\___ \\| __/ _\` | __| | | | |`);
+  print(`${COLORS.cyan} ____) | || (_| | |_| | |_| |`);
+  print(`${COLORS.cyan}|_____/ \\__\\__,_|\\__|_|\\__, |`);
+  print(`${COLORS.cyan}                        __/ |`);
+  print(`${COLORS.cyan}                       |___/ ${COLORS.reset}`);
+  print("");
+  print(`${COLORS.bright}Statly Observe SDK Setup${COLORS.reset}`);
+  print(`${COLORS.dim}Error tracking for JavaScript applications${COLORS.reset}`);
+  print("");
+}
+function printStep(num, msg) {
+  print(`${COLORS.green}[${num}]${COLORS.reset} ${msg}`);
+}
+async function prompt(question) {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  return new Promise((resolve) => {
+    rl.question(`${COLORS.yellow}?${COLORS.reset} ${question} `, (answer) => {
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+}
+function detectFramework() {
+  const packageJsonPath = path.join(process.cwd(), "package.json");
+  if (fs.existsSync(packageJsonPath)) {
+    try {
+      const pkg = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
+      const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+      if (deps["next"]) return "nextjs";
+      if (deps["express"]) return "express";
+      if (deps["fastify"]) return "fastify";
+    } catch {
+    }
+  }
+  return null;
+}
+function generateCode(dsn, framework) {
+  if (framework === "express") {
+    return `// Add to your main server file (e.g., app.js or index.js)
+import express from 'express';
+import { Statly, requestHandler, expressErrorHandler } from '@statly/observe';
+
+const app = express();
+
+// Initialize Statly FIRST
+Statly.init({
+  dsn: '${dsn}',
+  environment: process.env.NODE_ENV || 'development',
+  release: process.env.npm_package_version,
+});
+
+// Add request handler before routes
+app.use(requestHandler());
+
+// Your routes here...
+
+// Add error handler LAST (after all routes)
+app.use(expressErrorHandler());
+
+app.listen(3000);
+`;
+  }
+  if (framework === "nextjs") {
+    return `// Create instrumentation.ts in your project root
+// instrumentation.ts
+import { Statly } from '@statly/observe';
+
+export function register() {
+  Statly.init({
+    dsn: '${dsn}',
+    environment: process.env.NODE_ENV || 'development',
+  });
+}
+
+// For API routes, wrap handlers:
+// app/api/example/route.ts
+import { withStatly } from '@statly/observe';
+
+export const GET = withStatly(async (request) => {
+  return Response.json({ ok: true });
+});
+
+// For error boundaries:
+// app/error.tsx
+'use client';
+import { useEffect } from 'react';
+import { captureNextJsError } from '@statly/observe';
+
+export default function Error({ error, reset }: { error: Error; reset: () => void }) {
+  useEffect(() => { captureNextJsError(error); }, [error]);
+  return <button onClick={reset}>Try again</button>;
+}
+`;
+  }
+  if (framework === "fastify") {
+    return `// Add to your Fastify server file
+import Fastify from 'fastify';
+import { Statly, statlyFastifyPlugin } from '@statly/observe';
+
+const fastify = Fastify();
+
+// Initialize Statly
+Statly.init({
+  dsn: '${dsn}',
+  environment: process.env.NODE_ENV || 'development',
+});
+
+// Register the plugin
+await fastify.register(statlyFastifyPlugin, {
+  captureValidationErrors: true,
+  skipStatusCodes: [400, 401, 403, 404],
+});
+
+fastify.get('/', async () => {
+  return { hello: 'world' };
+});
+
+await fastify.listen({ port: 3000 });
+`;
+  }
+  return `// Add to your application entry point
+import { Statly } from '@statly/observe';
+
+// Initialize the SDK
+Statly.init({
+  dsn: '${dsn}',
+  environment: process.env.NODE_ENV || 'development',
+  release: '1.0.0', // Your app version
+});
+
+// Errors are captured automatically
+
+// Manual capture example
+try {
+  riskyOperation();
+} catch (error) {
+  Statly.captureException(error);
+}
+
+// Set user context (after login)
+Statly.setUser({
+  id: 'user-123',
+  email: 'user@example.com',
+});
+
+// Flush before exit (important for serverless)
+await Statly.close();
+`;
+}
+async function main() {
+  const args = process.argv.slice(2);
+  const command = args[0];
+  if (command === "init") {
+    printHeader();
+    print(`${COLORS.dim}Get your DSN from: https://statly.live/dashboard/observe/setup${COLORS.reset}`);
+    print("");
+    const dsn = await prompt("Enter your DSN:");
+    if (!dsn) {
+      print(`${COLORS.yellow}No DSN provided. Get one at https://statly.live${COLORS.reset}`);
+      process.exit(1);
+    }
+    if (!dsn.match(/^https:\/\/[^@]+@statly\.live\/.+$/)) {
+      print(`${COLORS.yellow}Warning: DSN format looks incorrect.${COLORS.reset}`);
+      print(`${COLORS.dim}Expected format: https://<api-key>@statly.live/<org-slug>${COLORS.reset}`);
+    }
+    print("");
+    printStep(1, "Detecting your framework...");
+    const framework = detectFramework();
+    if (framework) {
+      print(`   ${COLORS.green}\u2713${COLORS.reset} Detected: ${COLORS.bright}${framework}${COLORS.reset}`);
+    } else {
+      print(`   ${COLORS.dim}No framework detected, using generic setup${COLORS.reset}`);
+    }
+    print("");
+    printStep(2, "Generated setup code:");
+    print("");
+    print(`${COLORS.dim}${"\u2500".repeat(50)}${COLORS.reset}`);
+    print(generateCode(dsn, framework));
+    print(`${COLORS.dim}${"\u2500".repeat(50)}${COLORS.reset}`);
+    print("");
+    printStep(3, "Next steps:");
+    print(`   ${COLORS.dim}1.${COLORS.reset} Copy the code above into your application`);
+    print(`   ${COLORS.dim}2.${COLORS.reset} Set your environment variables`);
+    print(`   ${COLORS.dim}3.${COLORS.reset} Trigger a test error to verify`);
+    print("");
+    print(`${COLORS.green}\u2713${COLORS.reset} Setup complete! View errors at ${COLORS.cyan}https://statly.live/dashboard/observe${COLORS.reset}`);
+    print("");
+    print(`${COLORS.dim}Documentation: https://docs.statly.live/sdk/javascript/installation${COLORS.reset}`);
+    print("");
+  } else {
+    print(`${COLORS.bright}Statly Observe CLI${COLORS.reset}`);
+    print("");
+    print("Usage:");
+    print(`  npx @statly/observe init    ${COLORS.dim}Setup Statly in your project${COLORS.reset}`);
+    print("");
+    print("Get started at https://statly.live");
+  }
+}
+main().catch(console.error);

package/dist/index.d.mts

@@ -6,8 +6,11 @@ export { createRequestCapture, statlyFastifyPlugin, statlyPlugin } from './integ
  * Statly Observe SDK Types
  */
 interface StatlyOptions {
-    /** DSN for your organization: https://<api-key>@statly.live/<org-slug> */
-    dsn: string;
+    /**
+     * DSN for your organization: https://<api-key>@statly.live/<org-slug>
+     * Can be omitted if STATLY_DSN, NEXT_PUBLIC_STATLY_DSN, or STATLY_OBSERVE_DSN is set in environment
+     */
+    dsn?: string;
     /** Release/version identifier */
     release?: string;
     /** Environment (e.g., 'production', 'staging', 'development') */
@@ -110,7 +113,9 @@ declare class StatlyClient {
     private consoleIntegration;
     private user;
     private initialized;
-    constructor(options: StatlyOptions);
+    constructor(options: StatlyOptions & {
+        dsn: string;
+    });
     private mergeOptions;
     private detectEnvironment;
     /**
@@ -219,8 +224,20 @@ declare class StatlyClient {
 
 /**
  * Initialize the Statly SDK
+ *
+ * DSN can be passed explicitly or loaded from environment variables:
+ * - STATLY_DSN
+ * - NEXT_PUBLIC_STATLY_DSN (for Next.js)
+ * - STATLY_OBSERVE_DSN
+ *
+ * @example
+ * // Explicit DSN
+ * Statly.init({ dsn: 'https://sk_live_xxx@statly.live/your-org' });
+ *
+ * // Auto-load from .env
+ * Statly.init(); // Uses STATLY_DSN from environment
  */
-declare function init(options: StatlyOptions): void;
+declare function init(options?: Partial<StatlyOptions>): void;
 /**
  * Capture an exception
  */

package/dist/index.d.ts

@@ -6,8 +6,11 @@ export { createRequestCapture, statlyFastifyPlugin, statlyPlugin } from './integ
  * Statly Observe SDK Types
  */
 interface StatlyOptions {
-    /** DSN for your organization: https://<api-key>@statly.live/<org-slug> */
-    dsn: string;
+    /**
+     * DSN for your organization: https://<api-key>@statly.live/<org-slug>
+     * Can be omitted if STATLY_DSN, NEXT_PUBLIC_STATLY_DSN, or STATLY_OBSERVE_DSN is set in environment
+     */
+    dsn?: string;
     /** Release/version identifier */
     release?: string;
     /** Environment (e.g., 'production', 'staging', 'development') */
@@ -110,7 +113,9 @@ declare class StatlyClient {
     private consoleIntegration;
     private user;
     private initialized;
-    constructor(options: StatlyOptions);
+    constructor(options: StatlyOptions & {
+        dsn: string;
+    });
     private mergeOptions;
     private detectEnvironment;
     /**
@@ -219,8 +224,20 @@ declare class StatlyClient {
 
 /**
  * Initialize the Statly SDK
+ *
+ * DSN can be passed explicitly or loaded from environment variables:
+ * - STATLY_DSN
+ * - NEXT_PUBLIC_STATLY_DSN (for Next.js)
+ * - STATLY_OBSERVE_DSN
+ *
+ * @example
+ * // Explicit DSN
+ * Statly.init({ dsn: 'https://sk_live_xxx@statly.live/your-org' });
+ *
+ * // Auto-load from .env
+ * Statly.init(); // Uses STATLY_DSN from environment
  */
-declare function init(options: StatlyOptions): void;
+declare function init(options?: Partial<StatlyOptions>): void;
 /**
  * Capture an exception
  */

package/dist/index.js

@@ -1032,12 +1032,36 @@ function sanitizeHeaders3(headers) {
 
 // src/index.ts
 var client = null;
+function loadDsnFromEnv() {
+  if (typeof process !== "undefined" && process.env) {
+    return process.env.STATLY_DSN || process.env.NEXT_PUBLIC_STATLY_DSN || process.env.STATLY_OBSERVE_DSN;
+  }
+  return void 0;
+}
+function loadEnvironmentFromEnv() {
+  if (typeof process !== "undefined" && process.env) {
+    return process.env.STATLY_ENVIRONMENT || process.env.NODE_ENV;
+  }
+  return void 0;
+}
 function init(options) {
   if (client) {
     console.warn("[Statly] SDK already initialized. Call close() first to reinitialize.");
     return;
   }
-  client = new StatlyClient(options);
+  const dsn = options?.dsn || loadDsnFromEnv();
+  if (!dsn) {
+    console.error("[Statly] No DSN provided. Set STATLY_DSN in your environment or pass dsn to init().");
+    console.error("[Statly] Get your DSN at https://statly.live/dashboard/observe/setup");
+    return;
+  }
+  const environment = options?.environment || loadEnvironmentFromEnv();
+  const finalOptions = {
+    ...options,
+    dsn,
+    environment
+  };
+  client = new StatlyClient(finalOptions);
   client.init();
 }
 function captureException(error, context) {

package/dist/index.mjs

@@ -22,7 +22,7 @@ import {
   withStatlyGetStaticProps,
   withStatlyPagesApi,
   withStatlyServerAction
-} from "./chunk-PETWPVHU.mjs";
+} from "./chunk-UNDSALI5.mjs";
 export {
   Statly,
   StatlyClient,

package/dist/integrations/express.js

@@ -678,12 +678,36 @@ var StatlyClient = class {
 
 // src/index.ts
 var client = null;
+function loadDsnFromEnv() {
+  if (typeof process !== "undefined" && process.env) {
+    return process.env.STATLY_DSN || process.env.NEXT_PUBLIC_STATLY_DSN || process.env.STATLY_OBSERVE_DSN;
+  }
+  return void 0;
+}
+function loadEnvironmentFromEnv() {
+  if (typeof process !== "undefined" && process.env) {
+    return process.env.STATLY_ENVIRONMENT || process.env.NODE_ENV;
+  }
+  return void 0;
+}
 function init(options) {
   if (client) {
     console.warn("[Statly] SDK already initialized. Call close() first to reinitialize.");
     return;
   }
-  client = new StatlyClient(options);
+  const dsn = options?.dsn || loadDsnFromEnv();
+  if (!dsn) {
+    console.error("[Statly] No DSN provided. Set STATLY_DSN in your environment or pass dsn to init().");
+    console.error("[Statly] Get your DSN at https://statly.live/dashboard/observe/setup");
+    return;
+  }
+  const environment = options?.environment || loadEnvironmentFromEnv();
+  const finalOptions = {
+    ...options,
+    dsn,
+    environment
+  };
+  client = new StatlyClient(finalOptions);
   client.init();
 }
 function captureException(error, context) {

package/dist/integrations/express.mjs

@@ -1,7 +1,7 @@
 import {
   expressErrorHandler,
   requestHandler
-} from "../chunk-PETWPVHU.mjs";
+} from "../chunk-UNDSALI5.mjs";
 export {
   expressErrorHandler,
   requestHandler

package/dist/integrations/fastify.js

@@ -679,12 +679,36 @@ var StatlyClient = class {
 
 // src/index.ts
 var client = null;
+function loadDsnFromEnv() {
+  if (typeof process !== "undefined" && process.env) {
+    return process.env.STATLY_DSN || process.env.NEXT_PUBLIC_STATLY_DSN || process.env.STATLY_OBSERVE_DSN;
+  }
+  return void 0;
+}
+function loadEnvironmentFromEnv() {
+  if (typeof process !== "undefined" && process.env) {
+    return process.env.STATLY_ENVIRONMENT || process.env.NODE_ENV;
+  }
+  return void 0;
+}
 function init(options) {
   if (client) {
     console.warn("[Statly] SDK already initialized. Call close() first to reinitialize.");
     return;
   }
-  client = new StatlyClient(options);
+  const dsn = options?.dsn || loadDsnFromEnv();
+  if (!dsn) {
+    console.error("[Statly] No DSN provided. Set STATLY_DSN in your environment or pass dsn to init().");
+    console.error("[Statly] Get your DSN at https://statly.live/dashboard/observe/setup");
+    return;
+  }
+  const environment = options?.environment || loadEnvironmentFromEnv();
+  const finalOptions = {
+    ...options,
+    dsn,
+    environment
+  };
+  client = new StatlyClient(finalOptions);
   client.init();
 }
 function captureException(error, context) {

package/dist/integrations/fastify.mjs

@@ -2,7 +2,7 @@ import {
   createRequestCapture,
   statlyFastifyPlugin,
   statlyPlugin
-} from "../chunk-PETWPVHU.mjs";
+} from "../chunk-UNDSALI5.mjs";
 export {
   createRequestCapture,
   statlyFastifyPlugin,

package/dist/integrations/nextjs.js

@@ -682,12 +682,36 @@ var StatlyClient = class {
 
 // src/index.ts
 var client = null;
+function loadDsnFromEnv() {
+  if (typeof process !== "undefined" && process.env) {
+    return process.env.STATLY_DSN || process.env.NEXT_PUBLIC_STATLY_DSN || process.env.STATLY_OBSERVE_DSN;
+  }
+  return void 0;
+}
+function loadEnvironmentFromEnv() {
+  if (typeof process !== "undefined" && process.env) {
+    return process.env.STATLY_ENVIRONMENT || process.env.NODE_ENV;
+  }
+  return void 0;
+}
 function init(options) {
   if (client) {
     console.warn("[Statly] SDK already initialized. Call close() first to reinitialize.");
     return;
   }
-  client = new StatlyClient(options);
+  const dsn = options?.dsn || loadDsnFromEnv();
+  if (!dsn) {
+    console.error("[Statly] No DSN provided. Set STATLY_DSN in your environment or pass dsn to init().");
+    console.error("[Statly] Get your DSN at https://statly.live/dashboard/observe/setup");
+    return;
+  }
+  const environment = options?.environment || loadEnvironmentFromEnv();
+  const finalOptions = {
+    ...options,
+    dsn,
+    environment
+  };
+  client = new StatlyClient(finalOptions);
   client.init();
 }
 function captureException(error, context) {

package/dist/integrations/nextjs.mjs

@@ -5,7 +5,7 @@ import {
   withStatlyGetStaticProps,
   withStatlyPagesApi,
   withStatlyServerAction
-} from "../chunk-PETWPVHU.mjs";
+} from "../chunk-UNDSALI5.mjs";
 export {
   captureNextJsError,
   withStatly,

package/package.json

@@ -1,10 +1,13 @@
 {
   "name": "@statly/observe",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "JavaScript SDK for Statly Observe - Error tracking and monitoring",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
+  "bin": {
+    "statly-observe": "./dist/cli.js"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -30,10 +33,11 @@
   "files": [
     "dist",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "bin"
   ],
   "scripts": {
-    "build": "tsup src/index.ts src/integrations/express.ts src/integrations/nextjs.ts src/integrations/fastify.ts --format cjs,esm --dts --clean",
+    "build": "tsup src/index.ts src/integrations/express.ts src/integrations/nextjs.ts src/integrations/fastify.ts src/cli.ts --format cjs,esm --dts --clean",
     "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
     "lint": "eslint src --ext .ts",
     "test": "vitest run",
@@ -49,7 +53,7 @@
     "error-monitoring",
     "exception-tracking"
   ],
-  "author": "Statly <support@statly.live>",
+  "author": "Statly <support@mail.kodydennon.com>",
   "license": "MIT",
   "homepage": "https://statly.live",
   "repository": {
@@ -60,6 +64,7 @@
     "url": "https://github.com/KodyDennon/statly-node/issues"
   },
   "devDependencies": {
+    "@types/node": "^20.0.0",
     "tsup": "^8.0.0",
     "typescript": "^5.0.0",
     "vitest": "^1.0.0"