@lelemondev/sdk 0.2.1 → 0.4.0

package/dist/lambda-DQmEfWXC.d.mts

@@ -0,0 +1,75 @@
+/**
+ * AWS Lambda Integration
+ *
+ * Wraps Lambda handlers to automatically flush traces before the function exits.
+ *
+ * @example
+ * import { withObserve } from '@lelemondev/sdk/lambda';
+ *
+ * export const handler = withObserve(async (event) => {
+ *   const openai = observe(new OpenAI());
+ *   const result = await openai.chat.completions.create({...});
+ *   return { statusCode: 200, body: JSON.stringify(result) };
+ * });
+ */
+/**
+ * AWS Lambda Context object
+ */
+interface LambdaContext {
+    functionName: string;
+    functionVersion: string;
+    invokedFunctionArn: string;
+    memoryLimitInMB: string;
+    awsRequestId: string;
+    logGroupName: string;
+    logStreamName: string;
+    getRemainingTimeInMillis(): number;
+    [key: string]: unknown;
+}
+/**
+ * Generic Lambda handler type
+ */
+type LambdaHandler<TEvent = unknown, TResult = unknown> = (event: TEvent, context: LambdaContext) => Promise<TResult>;
+/**
+ * Wrap an AWS Lambda handler with automatic trace flushing
+ *
+ * Always flushes before returning - Lambda freezes the container
+ * immediately after the handler returns, so this is required.
+ *
+ * @param handler - Your Lambda handler function
+ * @returns Wrapped handler that auto-flushes traces
+ *
+ * @example
+ * // API Gateway event
+ * export const handler = withObserve(async (event) => {
+ *   const body = JSON.parse(event.body);
+ *   const openai = observe(new OpenAI());
+ *   const result = await openai.chat.completions.create({
+ *     model: 'gpt-4',
+ *     messages: [{ role: 'user', content: body.message }],
+ *   });
+ *   return {
+ *     statusCode: 200,
+ *     body: JSON.stringify(result.choices[0].message),
+ *   };
+ * });
+ *
+ * @example
+ * // With typed events
+ * import type { APIGatewayProxyEvent, APIGatewayProxyResult } from 'aws-lambda';
+ *
+ * export const handler = withObserve<APIGatewayProxyEvent, APIGatewayProxyResult>(
+ *   async (event, context) => {
+ *     return { statusCode: 200, body: 'OK' };
+ *   }
+ * );
+ */
+declare function withObserve<TEvent = unknown, TResult = unknown>(handler: LambdaHandler<TEvent, TResult>): LambdaHandler<TEvent, TResult>;
+
+type lambda_LambdaContext = LambdaContext;
+declare const lambda_withObserve: typeof withObserve;
+declare namespace lambda {
+  export { type lambda_LambdaContext as LambdaContext, lambda_withObserve as withObserve };
+}
+
+export { type LambdaContext as L, lambda as l, withObserve as w };

package/dist/lambda-DQmEfWXC.d.ts

@@ -0,0 +1,75 @@
+/**
+ * AWS Lambda Integration
+ *
+ * Wraps Lambda handlers to automatically flush traces before the function exits.
+ *
+ * @example
+ * import { withObserve } from '@lelemondev/sdk/lambda';
+ *
+ * export const handler = withObserve(async (event) => {
+ *   const openai = observe(new OpenAI());
+ *   const result = await openai.chat.completions.create({...});
+ *   return { statusCode: 200, body: JSON.stringify(result) };
+ * });
+ */
+/**
+ * AWS Lambda Context object
+ */
+interface LambdaContext {
+    functionName: string;
+    functionVersion: string;
+    invokedFunctionArn: string;
+    memoryLimitInMB: string;
+    awsRequestId: string;
+    logGroupName: string;
+    logStreamName: string;
+    getRemainingTimeInMillis(): number;
+    [key: string]: unknown;
+}
+/**
+ * Generic Lambda handler type
+ */
+type LambdaHandler<TEvent = unknown, TResult = unknown> = (event: TEvent, context: LambdaContext) => Promise<TResult>;
+/**
+ * Wrap an AWS Lambda handler with automatic trace flushing
+ *
+ * Always flushes before returning - Lambda freezes the container
+ * immediately after the handler returns, so this is required.
+ *
+ * @param handler - Your Lambda handler function
+ * @returns Wrapped handler that auto-flushes traces
+ *
+ * @example
+ * // API Gateway event
+ * export const handler = withObserve(async (event) => {
+ *   const body = JSON.parse(event.body);
+ *   const openai = observe(new OpenAI());
+ *   const result = await openai.chat.completions.create({
+ *     model: 'gpt-4',
+ *     messages: [{ role: 'user', content: body.message }],
+ *   });
+ *   return {
+ *     statusCode: 200,
+ *     body: JSON.stringify(result.choices[0].message),
+ *   };
+ * });
+ *
+ * @example
+ * // With typed events
+ * import type { APIGatewayProxyEvent, APIGatewayProxyResult } from 'aws-lambda';
+ *
+ * export const handler = withObserve<APIGatewayProxyEvent, APIGatewayProxyResult>(
+ *   async (event, context) => {
+ *     return { statusCode: 200, body: 'OK' };
+ *   }
+ * );
+ */
+declare function withObserve<TEvent = unknown, TResult = unknown>(handler: LambdaHandler<TEvent, TResult>): LambdaHandler<TEvent, TResult>;
+
+type lambda_LambdaContext = LambdaContext;
+declare const lambda_withObserve: typeof withObserve;
+declare namespace lambda {
+  export { type lambda_LambdaContext as LambdaContext, lambda_withObserve as withObserve };
+}
+
+export { type LambdaContext as L, lambda as l, withObserve as w };

package/dist/lambda.d.mts

@@ -0,0 +1 @@
+export { L as LambdaContext, w as withObserve } from './lambda-DQmEfWXC.mjs';

package/dist/lambda.d.ts

@@ -0,0 +1 @@
+export { L as LambdaContext, w as withObserve } from './lambda-DQmEfWXC.js';

package/dist/lambda.js

@@ -0,0 +1,21 @@
+'use strict';
+
+/* @lelemondev/sdk - LLM Observability */
+
+async function flush() {
+}
+
+// src/integrations/lambda.ts
+function withObserve(handler) {
+  return async (event, context) => {
+    try {
+      return await handler(event, context);
+    } finally {
+      await flush();
+    }
+  };
+}
+
+exports.withObserve = withObserve;
+//# sourceMappingURL=lambda.js.map
+//# sourceMappingURL=lambda.js.map

package/dist/lambda.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/config.ts","../src/integrations/lambda.ts"],"names":[],"mappings":";;;;AAuEA,eAAsB,KAAA,GAAuB;AAI7C;;;ACOO,SAAS,YACd,OAAA,EACgC;AAChC,EAAA,OAAO,OAAO,OAAe,OAAA,KAA6C;AACxE,IAAA,IAAI;AACF,MAAA,OAAO,MAAM,OAAA,CAAQ,KAAA,EAAO,OAAO,CAAA;AAAA,IACrC,CAAA,SAAE;AAEA,MAAA,MAAM,KAAA,EAAM;AAAA,IACd;AAAA,EACF,CAAA;AACF","file":"lambda.js","sourcesContent":["/**\n * Global Configuration\n *\n * Manages SDK configuration and transport instance.\n */\n\nimport type { LelemonConfig } from './types';\nimport { Transport } from './transport';\n\n// ─────────────────────────────────────────────────────────────\n// Global State\n// ─────────────────────────────────────────────────────────────\n\nlet globalConfig: LelemonConfig = {};\nlet globalTransport: Transport | null = null;\nlet initialized = false;\n\n// ─────────────────────────────────────────────────────────────\n// Configuration\n// ─────────────────────────────────────────────────────────────\n\nconst DEFAULT_ENDPOINT = 'https://api.lelemon.dev';\n\n/**\n * Initialize the SDK\n * Call once at app startup\n */\nexport function init(config: LelemonConfig = {}): void {\n  globalConfig = config;\n  globalTransport = createTransport(config);\n  initialized = true;\n}\n\n/**\n * Get current config\n */\nexport function getConfig(): LelemonConfig {\n  return globalConfig;\n}\n\n/**\n * Check if SDK is initialized\n */\nexport function isInitialized(): boolean {\n  return initialized;\n}\n\n/**\n * Check if SDK is enabled\n */\nexport function isEnabled(): boolean {\n  return getTransport().isEnabled();\n}\n\n// ─────────────────────────────────────────────────────────────\n// Transport\n// ─────────────────────────────────────────────────────────────\n\n/**\n * Get or create transport instance\n */\nexport function getTransport(): Transport {\n  if (!globalTransport) {\n    globalTransport = createTransport(globalConfig);\n  }\n  return globalTransport;\n}\n\n/**\n * Flush all pending traces\n */\nexport async function flush(): Promise<void> {\n  if (globalTransport) {\n    await globalTransport.flush();\n  }\n}\n\n/**\n * Create transport instance\n */\nfunction createTransport(config: LelemonConfig): Transport {\n  const apiKey = config.apiKey ?? getEnvVar('LELEMON_API_KEY');\n\n  if (!apiKey && !config.disabled) {\n    console.warn(\n      '[Lelemon] No API key provided. Set apiKey in init() or LELEMON_API_KEY env var. Tracing disabled.'\n    );\n  }\n\n  return new Transport({\n    apiKey: apiKey ?? '',\n    endpoint: config.endpoint ?? DEFAULT_ENDPOINT,\n    debug: config.debug ?? false,\n    disabled: config.disabled ?? !apiKey,\n    batchSize: config.batchSize,\n    flushIntervalMs: config.flushIntervalMs,\n    requestTimeoutMs: config.requestTimeoutMs,\n  });\n}\n\n/**\n * Get environment variable (works in Node and edge)\n */\nfunction getEnvVar(name: string): string | undefined {\n  if (typeof process !== 'undefined' && process.env) {\n    return process.env[name];\n  }\n  return undefined;\n}\n","/**\n * AWS Lambda Integration\n *\n * Wraps Lambda handlers to automatically flush traces before the function exits.\n *\n * @example\n * import { withObserve } from '@lelemondev/sdk/lambda';\n *\n * export const handler = withObserve(async (event) => {\n *   const openai = observe(new OpenAI());\n *   const result = await openai.chat.completions.create({...});\n *   return { statusCode: 200, body: JSON.stringify(result) };\n * });\n */\n\nimport { flush } from '../core/config';\n\n// ─────────────────────────────────────────────────────────────\n// Types (minimal to avoid requiring @types/aws-lambda)\n// ─────────────────────────────────────────────────────────────\n\n/**\n * AWS Lambda Context object\n */\nexport interface LambdaContext {\n  functionName: string;\n  functionVersion: string;\n  invokedFunctionArn: string;\n  memoryLimitInMB: string;\n  awsRequestId: string;\n  logGroupName: string;\n  logStreamName: string;\n  getRemainingTimeInMillis(): number;\n  [key: string]: unknown;\n}\n\n/**\n * Generic Lambda handler type\n */\ntype LambdaHandler<TEvent = unknown, TResult = unknown> = (\n  event: TEvent,\n  context: LambdaContext\n) => Promise<TResult>;\n\n// ─────────────────────────────────────────────────────────────\n// Wrapper\n// ─────────────────────────────────────────────────────────────\n\n/**\n * Wrap an AWS Lambda handler with automatic trace flushing\n *\n * Always flushes before returning - Lambda freezes the container\n * immediately after the handler returns, so this is required.\n *\n * @param handler - Your Lambda handler function\n * @returns Wrapped handler that auto-flushes traces\n *\n * @example\n * // API Gateway event\n * export const handler = withObserve(async (event) => {\n *   const body = JSON.parse(event.body);\n *   const openai = observe(new OpenAI());\n *   const result = await openai.chat.completions.create({\n *     model: 'gpt-4',\n *     messages: [{ role: 'user', content: body.message }],\n *   });\n *   return {\n *     statusCode: 200,\n *     body: JSON.stringify(result.choices[0].message),\n *   };\n * });\n *\n * @example\n * // With typed events\n * import type { APIGatewayProxyEvent, APIGatewayProxyResult } from 'aws-lambda';\n *\n * export const handler = withObserve<APIGatewayProxyEvent, APIGatewayProxyResult>(\n *   async (event, context) => {\n *     return { statusCode: 200, body: 'OK' };\n *   }\n * );\n */\nexport function withObserve<TEvent = unknown, TResult = unknown>(\n  handler: LambdaHandler<TEvent, TResult>\n): LambdaHandler<TEvent, TResult> {\n  return async (event: TEvent, context: LambdaContext): Promise<TResult> => {\n    try {\n      return await handler(event, context);\n    } finally {\n      // Always flush - Lambda freezes immediately after return\n      await flush();\n    }\n  };\n}\n"]}

package/dist/lambda.mjs

@@ -0,0 +1,19 @@
+/* @lelemondev/sdk - LLM Observability */
+
+async function flush() {
+}
+
+// src/integrations/lambda.ts
+function withObserve(handler) {
+  return async (event, context) => {
+    try {
+      return await handler(event, context);
+    } finally {
+      await flush();
+    }
+  };
+}
+
+export { withObserve };
+//# sourceMappingURL=lambda.mjs.map
+//# sourceMappingURL=lambda.mjs.map

package/dist/lambda.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/config.ts","../src/integrations/lambda.ts"],"names":[],"mappings":";;AAuEA,eAAsB,KAAA,GAAuB;AAI7C;;;ACOO,SAAS,YACd,OAAA,EACgC;AAChC,EAAA,OAAO,OAAO,OAAe,OAAA,KAA6C;AACxE,IAAA,IAAI;AACF,MAAA,OAAO,MAAM,OAAA,CAAQ,KAAA,EAAO,OAAO,CAAA;AAAA,IACrC,CAAA,SAAE;AAEA,MAAA,MAAM,KAAA,EAAM;AAAA,IACd;AAAA,EACF,CAAA;AACF","file":"lambda.mjs","sourcesContent":["/**\n * Global Configuration\n *\n * Manages SDK configuration and transport instance.\n */\n\nimport type { LelemonConfig } from './types';\nimport { Transport } from './transport';\n\n// ─────────────────────────────────────────────────────────────\n// Global State\n// ─────────────────────────────────────────────────────────────\n\nlet globalConfig: LelemonConfig = {};\nlet globalTransport: Transport | null = null;\nlet initialized = false;\n\n// ─────────────────────────────────────────────────────────────\n// Configuration\n// ─────────────────────────────────────────────────────────────\n\nconst DEFAULT_ENDPOINT = 'https://api.lelemon.dev';\n\n/**\n * Initialize the SDK\n * Call once at app startup\n */\nexport function init(config: LelemonConfig = {}): void {\n  globalConfig = config;\n  globalTransport = createTransport(config);\n  initialized = true;\n}\n\n/**\n * Get current config\n */\nexport function getConfig(): LelemonConfig {\n  return globalConfig;\n}\n\n/**\n * Check if SDK is initialized\n */\nexport function isInitialized(): boolean {\n  return initialized;\n}\n\n/**\n * Check if SDK is enabled\n */\nexport function isEnabled(): boolean {\n  return getTransport().isEnabled();\n}\n\n// ─────────────────────────────────────────────────────────────\n// Transport\n// ─────────────────────────────────────────────────────────────\n\n/**\n * Get or create transport instance\n */\nexport function getTransport(): Transport {\n  if (!globalTransport) {\n    globalTransport = createTransport(globalConfig);\n  }\n  return globalTransport;\n}\n\n/**\n * Flush all pending traces\n */\nexport async function flush(): Promise<void> {\n  if (globalTransport) {\n    await globalTransport.flush();\n  }\n}\n\n/**\n * Create transport instance\n */\nfunction createTransport(config: LelemonConfig): Transport {\n  const apiKey = config.apiKey ?? getEnvVar('LELEMON_API_KEY');\n\n  if (!apiKey && !config.disabled) {\n    console.warn(\n      '[Lelemon] No API key provided. Set apiKey in init() or LELEMON_API_KEY env var. Tracing disabled.'\n    );\n  }\n\n  return new Transport({\n    apiKey: apiKey ?? '',\n    endpoint: config.endpoint ?? DEFAULT_ENDPOINT,\n    debug: config.debug ?? false,\n    disabled: config.disabled ?? !apiKey,\n    batchSize: config.batchSize,\n    flushIntervalMs: config.flushIntervalMs,\n    requestTimeoutMs: config.requestTimeoutMs,\n  });\n}\n\n/**\n * Get environment variable (works in Node and edge)\n */\nfunction getEnvVar(name: string): string | undefined {\n  if (typeof process !== 'undefined' && process.env) {\n    return process.env[name];\n  }\n  return undefined;\n}\n","/**\n * AWS Lambda Integration\n *\n * Wraps Lambda handlers to automatically flush traces before the function exits.\n *\n * @example\n * import { withObserve } from '@lelemondev/sdk/lambda';\n *\n * export const handler = withObserve(async (event) => {\n *   const openai = observe(new OpenAI());\n *   const result = await openai.chat.completions.create({...});\n *   return { statusCode: 200, body: JSON.stringify(result) };\n * });\n */\n\nimport { flush } from '../core/config';\n\n// ─────────────────────────────────────────────────────────────\n// Types (minimal to avoid requiring @types/aws-lambda)\n// ─────────────────────────────────────────────────────────────\n\n/**\n * AWS Lambda Context object\n */\nexport interface LambdaContext {\n  functionName: string;\n  functionVersion: string;\n  invokedFunctionArn: string;\n  memoryLimitInMB: string;\n  awsRequestId: string;\n  logGroupName: string;\n  logStreamName: string;\n  getRemainingTimeInMillis(): number;\n  [key: string]: unknown;\n}\n\n/**\n * Generic Lambda handler type\n */\ntype LambdaHandler<TEvent = unknown, TResult = unknown> = (\n  event: TEvent,\n  context: LambdaContext\n) => Promise<TResult>;\n\n// ─────────────────────────────────────────────────────────────\n// Wrapper\n// ─────────────────────────────────────────────────────────────\n\n/**\n * Wrap an AWS Lambda handler with automatic trace flushing\n *\n * Always flushes before returning - Lambda freezes the container\n * immediately after the handler returns, so this is required.\n *\n * @param handler - Your Lambda handler function\n * @returns Wrapped handler that auto-flushes traces\n *\n * @example\n * // API Gateway event\n * export const handler = withObserve(async (event) => {\n *   const body = JSON.parse(event.body);\n *   const openai = observe(new OpenAI());\n *   const result = await openai.chat.completions.create({\n *     model: 'gpt-4',\n *     messages: [{ role: 'user', content: body.message }],\n *   });\n *   return {\n *     statusCode: 200,\n *     body: JSON.stringify(result.choices[0].message),\n *   };\n * });\n *\n * @example\n * // With typed events\n * import type { APIGatewayProxyEvent, APIGatewayProxyResult } from 'aws-lambda';\n *\n * export const handler = withObserve<APIGatewayProxyEvent, APIGatewayProxyResult>(\n *   async (event, context) => {\n *     return { statusCode: 200, body: 'OK' };\n *   }\n * );\n */\nexport function withObserve<TEvent = unknown, TResult = unknown>(\n  handler: LambdaHandler<TEvent, TResult>\n): LambdaHandler<TEvent, TResult> {\n  return async (event: TEvent, context: LambdaContext): Promise<TResult> => {\n    try {\n      return await handler(event, context);\n    } finally {\n      // Always flush - Lambda freezes immediately after return\n      await flush();\n    }\n  };\n}\n"]}

package/dist/next-0nso_zEN.d.mts

@@ -0,0 +1,94 @@
+/**
+ * Next.js App Router Integration
+ *
+ * Wraps route handlers to automatically flush traces.
+ * Supports Next.js 15+ `after()` and Vercel's `waitUntil()`.
+ *
+ * @example
+ * import { withObserve } from '@lelemondev/sdk/next';
+ *
+ * export const POST = withObserve(async (req) => {
+ *   const openai = observe(new OpenAI());
+ *   const result = await openai.chat.completions.create({...});
+ *   return Response.json(result);
+ * });
+ */
+type NextRouteHandler<TContext = unknown> = (request: Request, context?: TContext) => Response | Promise<Response>;
+/**
+ * Options for the Next.js wrapper
+ */
+interface NextObserveOptions {
+    /**
+     * Next.js 15+ after() function from 'next/server'
+     * Preferred method - runs after response without blocking
+     *
+     * @example
+     * import { after } from 'next/server';
+     * export const POST = withObserve(handler, { after });
+     */
+    after?: (callback: () => void | Promise<void>) => void;
+    /**
+     * Vercel's waitUntil() from '@vercel/functions'
+     * Alternative for Vercel deployments
+     *
+     * @example
+     * import { waitUntil } from '@vercel/functions';
+     * export const POST = withObserve(handler, { waitUntil });
+     */
+    waitUntil?: (promise: Promise<unknown>) => void;
+}
+/**
+ * Wrap a Next.js App Router handler with automatic trace flushing
+ *
+ * @param handler - Your route handler function
+ * @param options - Optional: pass `after` (Next.js 15+) or `waitUntil` (Vercel)
+ * @returns Wrapped handler that auto-flushes traces
+ *
+ * @example
+ * // Basic usage (blocking flush)
+ * export const POST = withObserve(async (req) => {
+ *   return Response.json({ ok: true });
+ * });
+ *
+ * @example
+ * // Next.js 15+ with after() - non-blocking (recommended)
+ * import { after } from 'next/server';
+ *
+ * export const POST = withObserve(
+ *   async (req) => Response.json({ ok: true }),
+ *   { after }
+ * );
+ *
+ * @example
+ * // Vercel with waitUntil() - non-blocking
+ * import { waitUntil } from '@vercel/functions';
+ *
+ * export const POST = withObserve(
+ *   async (req) => Response.json({ ok: true }),
+ *   { waitUntil }
+ * );
+ */
+declare function withObserve<TContext = unknown>(handler: NextRouteHandler<TContext>, options?: NextObserveOptions): NextRouteHandler<TContext>;
+/**
+ * Create a pre-configured wrapper with default options
+ *
+ * @example
+ * import { after } from 'next/server';
+ * import { createWrapper } from '@lelemondev/sdk/next';
+ *
+ * const withObserve = createWrapper({ after });
+ *
+ * export const POST = withObserve(async (req) => {
+ *   return Response.json({ ok: true });
+ * });
+ */
+declare function createWrapper(defaultOptions: NextObserveOptions): <TContext = unknown>(handler: NextRouteHandler<TContext>, options?: NextObserveOptions) => NextRouteHandler<TContext>;
+
+type next_NextObserveOptions = NextObserveOptions;
+declare const next_createWrapper: typeof createWrapper;
+declare const next_withObserve: typeof withObserve;
+declare namespace next {
+  export { type next_NextObserveOptions as NextObserveOptions, next_createWrapper as createWrapper, next_withObserve as withObserve };
+}
+
+export { type NextObserveOptions as N, createWrapper as c, next as n, withObserve as w };

package/dist/next-0nso_zEN.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Next.js App Router Integration
+ *
+ * Wraps route handlers to automatically flush traces.
+ * Supports Next.js 15+ `after()` and Vercel's `waitUntil()`.
+ *
+ * @example
+ * import { withObserve } from '@lelemondev/sdk/next';
+ *
+ * export const POST = withObserve(async (req) => {
+ *   const openai = observe(new OpenAI());
+ *   const result = await openai.chat.completions.create({...});
+ *   return Response.json(result);
+ * });
+ */
+type NextRouteHandler<TContext = unknown> = (request: Request, context?: TContext) => Response | Promise<Response>;
+/**
+ * Options for the Next.js wrapper
+ */
+interface NextObserveOptions {
+    /**
+     * Next.js 15+ after() function from 'next/server'
+     * Preferred method - runs after response without blocking
+     *
+     * @example
+     * import { after } from 'next/server';
+     * export const POST = withObserve(handler, { after });
+     */
+    after?: (callback: () => void | Promise<void>) => void;
+    /**
+     * Vercel's waitUntil() from '@vercel/functions'
+     * Alternative for Vercel deployments
+     *
+     * @example
+     * import { waitUntil } from '@vercel/functions';
+     * export const POST = withObserve(handler, { waitUntil });
+     */
+    waitUntil?: (promise: Promise<unknown>) => void;
+}
+/**
+ * Wrap a Next.js App Router handler with automatic trace flushing
+ *
+ * @param handler - Your route handler function
+ * @param options - Optional: pass `after` (Next.js 15+) or `waitUntil` (Vercel)
+ * @returns Wrapped handler that auto-flushes traces
+ *
+ * @example
+ * // Basic usage (blocking flush)
+ * export const POST = withObserve(async (req) => {
+ *   return Response.json({ ok: true });
+ * });
+ *
+ * @example
+ * // Next.js 15+ with after() - non-blocking (recommended)
+ * import { after } from 'next/server';
+ *
+ * export const POST = withObserve(
+ *   async (req) => Response.json({ ok: true }),
+ *   { after }
+ * );
+ *
+ * @example
+ * // Vercel with waitUntil() - non-blocking
+ * import { waitUntil } from '@vercel/functions';
+ *
+ * export const POST = withObserve(
+ *   async (req) => Response.json({ ok: true }),
+ *   { waitUntil }
+ * );
+ */
+declare function withObserve<TContext = unknown>(handler: NextRouteHandler<TContext>, options?: NextObserveOptions): NextRouteHandler<TContext>;
+/**
+ * Create a pre-configured wrapper with default options
+ *
+ * @example
+ * import { after } from 'next/server';
+ * import { createWrapper } from '@lelemondev/sdk/next';
+ *
+ * const withObserve = createWrapper({ after });
+ *
+ * export const POST = withObserve(async (req) => {
+ *   return Response.json({ ok: true });
+ * });
+ */
+declare function createWrapper(defaultOptions: NextObserveOptions): <TContext = unknown>(handler: NextRouteHandler<TContext>, options?: NextObserveOptions) => NextRouteHandler<TContext>;
+
+type next_NextObserveOptions = NextObserveOptions;
+declare const next_createWrapper: typeof createWrapper;
+declare const next_withObserve: typeof withObserve;
+declare namespace next {
+  export { type next_NextObserveOptions as NextObserveOptions, next_createWrapper as createWrapper, next_withObserve as withObserve };
+}
+
+export { type NextObserveOptions as N, createWrapper as c, next as n, withObserve as w };

package/dist/next.d.mts

@@ -0,0 +1 @@
+export { N as NextObserveOptions, c as createWrapper, w as withObserve } from './next-0nso_zEN.mjs';

package/dist/next.d.ts

@@ -0,0 +1 @@
+export { N as NextObserveOptions, c as createWrapper, w as withObserve } from './next-0nso_zEN.js';

package/dist/next.js

@@ -0,0 +1,33 @@
+'use strict';
+
+/* @lelemondev/sdk - LLM Observability */
+
+async function flush() {
+}
+
+// src/integrations/next.ts
+function withObserve(handler, options) {
+  return async (request, context) => {
+    try {
+      return await handler(request, context);
+    } finally {
+      if (options?.after) {
+        options.after(() => flush());
+      } else if (options?.waitUntil) {
+        options.waitUntil(flush());
+      } else {
+        await flush();
+      }
+    }
+  };
+}
+function createWrapper(defaultOptions) {
+  return function(handler, options) {
+    return withObserve(handler, { ...defaultOptions, ...options });
+  };
+}
+
+exports.createWrapper = createWrapper;
+exports.withObserve = withObserve;
+//# sourceMappingURL=next.js.map
+//# sourceMappingURL=next.js.map

package/dist/next.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/config.ts","../src/integrations/next.ts"],"names":[],"mappings":";;;;AAuEA,eAAsB,KAAA,GAAuB;AAI7C;;;ACYO,SAAS,WAAA,CACd,SACA,OAAA,EAC4B;AAC5B,EAAA,OAAO,OAAO,SAAkB,OAAA,KAA0C;AACxE,IAAA,IAAI;AACF,MAAA,OAAO,MAAM,OAAA,CAAQ,OAAA,EAAS,OAAO,CAAA;AAAA,IACvC,CAAA,SAAE;AAEA,MAAA,IAAI,SAAS,KAAA,EAAO;AAElB,QAAA,OAAA,CAAQ,KAAA,CAAM,MAAM,KAAA,EAAO,CAAA;AAAA,MAC7B,CAAA,MAAA,IAAW,SAAS,SAAA,EAAW;AAE7B,QAAA,OAAA,CAAQ,SAAA,CAAU,OAAO,CAAA;AAAA,MAC3B,CAAA,MAAO;AAEL,QAAA,MAAM,KAAA,EAAM;AAAA,MACd;AAAA,IACF;AAAA,EACF,CAAA;AACF;AAeO,SAAS,cAAc,cAAA,EAAoC;AAChE,EAAA,OAAO,SACL,SACA,OAAA,EAC4B;AAC5B,IAAA,OAAO,YAAY,OAAA,EAAS,EAAE,GAAG,cAAA,EAAgB,GAAG,SAAS,CAAA;AAAA,EAC/D,CAAA;AACF","file":"next.js","sourcesContent":["/**\n * Global Configuration\n *\n * Manages SDK configuration and transport instance.\n */\n\nimport type { LelemonConfig } from './types';\nimport { Transport } from './transport';\n\n// ─────────────────────────────────────────────────────────────\n// Global State\n// ─────────────────────────────────────────────────────────────\n\nlet globalConfig: LelemonConfig = {};\nlet globalTransport: Transport | null = null;\nlet initialized = false;\n\n// ─────────────────────────────────────────────────────────────\n// Configuration\n// ─────────────────────────────────────────────────────────────\n\nconst DEFAULT_ENDPOINT = 'https://api.lelemon.dev';\n\n/**\n * Initialize the SDK\n * Call once at app startup\n */\nexport function init(config: LelemonConfig = {}): void {\n  globalConfig = config;\n  globalTransport = createTransport(config);\n  initialized = true;\n}\n\n/**\n * Get current config\n */\nexport function getConfig(): LelemonConfig {\n  return globalConfig;\n}\n\n/**\n * Check if SDK is initialized\n */\nexport function isInitialized(): boolean {\n  return initialized;\n}\n\n/**\n * Check if SDK is enabled\n */\nexport function isEnabled(): boolean {\n  return getTransport().isEnabled();\n}\n\n// ─────────────────────────────────────────────────────────────\n// Transport\n// ─────────────────────────────────────────────────────────────\n\n/**\n * Get or create transport instance\n */\nexport function getTransport(): Transport {\n  if (!globalTransport) {\n    globalTransport = createTransport(globalConfig);\n  }\n  return globalTransport;\n}\n\n/**\n * Flush all pending traces\n */\nexport async function flush(): Promise<void> {\n  if (globalTransport) {\n    await globalTransport.flush();\n  }\n}\n\n/**\n * Create transport instance\n */\nfunction createTransport(config: LelemonConfig): Transport {\n  const apiKey = config.apiKey ?? getEnvVar('LELEMON_API_KEY');\n\n  if (!apiKey && !config.disabled) {\n    console.warn(\n      '[Lelemon] No API key provided. Set apiKey in init() or LELEMON_API_KEY env var. Tracing disabled.'\n    );\n  }\n\n  return new Transport({\n    apiKey: apiKey ?? '',\n    endpoint: config.endpoint ?? DEFAULT_ENDPOINT,\n    debug: config.debug ?? false,\n    disabled: config.disabled ?? !apiKey,\n    batchSize: config.batchSize,\n    flushIntervalMs: config.flushIntervalMs,\n    requestTimeoutMs: config.requestTimeoutMs,\n  });\n}\n\n/**\n * Get environment variable (works in Node and edge)\n */\nfunction getEnvVar(name: string): string | undefined {\n  if (typeof process !== 'undefined' && process.env) {\n    return process.env[name];\n  }\n  return undefined;\n}\n","/**\n * Next.js App Router Integration\n *\n * Wraps route handlers to automatically flush traces.\n * Supports Next.js 15+ `after()` and Vercel's `waitUntil()`.\n *\n * @example\n * import { withObserve } from '@lelemondev/sdk/next';\n *\n * export const POST = withObserve(async (req) => {\n *   const openai = observe(new OpenAI());\n *   const result = await openai.chat.completions.create({...});\n *   return Response.json(result);\n * });\n */\n\nimport { flush } from '../core/config';\n\n// ─────────────────────────────────────────────────────────────\n// Types\n// ─────────────────────────────────────────────────────────────\n\ntype NextRouteHandler<TContext = unknown> = (\n  request: Request,\n  context?: TContext\n) => Response | Promise<Response>;\n\n/**\n * Options for the Next.js wrapper\n */\nexport interface NextObserveOptions {\n  /**\n   * Next.js 15+ after() function from 'next/server'\n   * Preferred method - runs after response without blocking\n   *\n   * @example\n   * import { after } from 'next/server';\n   * export const POST = withObserve(handler, { after });\n   */\n  after?: (callback: () => void | Promise<void>) => void;\n\n  /**\n   * Vercel's waitUntil() from '@vercel/functions'\n   * Alternative for Vercel deployments\n   *\n   * @example\n   * import { waitUntil } from '@vercel/functions';\n   * export const POST = withObserve(handler, { waitUntil });\n   */\n  waitUntil?: (promise: Promise<unknown>) => void;\n}\n\n// ─────────────────────────────────────────────────────────────\n// Wrapper\n// ─────────────────────────────────────────────────────────────\n\n/**\n * Wrap a Next.js App Router handler with automatic trace flushing\n *\n * @param handler - Your route handler function\n * @param options - Optional: pass `after` (Next.js 15+) or `waitUntil` (Vercel)\n * @returns Wrapped handler that auto-flushes traces\n *\n * @example\n * // Basic usage (blocking flush)\n * export const POST = withObserve(async (req) => {\n *   return Response.json({ ok: true });\n * });\n *\n * @example\n * // Next.js 15+ with after() - non-blocking (recommended)\n * import { after } from 'next/server';\n *\n * export const POST = withObserve(\n *   async (req) => Response.json({ ok: true }),\n *   { after }\n * );\n *\n * @example\n * // Vercel with waitUntil() - non-blocking\n * import { waitUntil } from '@vercel/functions';\n *\n * export const POST = withObserve(\n *   async (req) => Response.json({ ok: true }),\n *   { waitUntil }\n * );\n */\nexport function withObserve<TContext = unknown>(\n  handler: NextRouteHandler<TContext>,\n  options?: NextObserveOptions\n): NextRouteHandler<TContext> {\n  return async (request: Request, context?: TContext): Promise<Response> => {\n    try {\n      return await handler(request, context);\n    } finally {\n      // Priority: after() > waitUntil() > blocking flush\n      if (options?.after) {\n        // Next.js 15+ native - best option\n        options.after(() => flush());\n      } else if (options?.waitUntil) {\n        // Vercel platform\n        options.waitUntil(flush());\n      } else {\n        // Fallback: blocking flush\n        await flush();\n      }\n    }\n  };\n}\n\n/**\n * Create a pre-configured wrapper with default options\n *\n * @example\n * import { after } from 'next/server';\n * import { createWrapper } from '@lelemondev/sdk/next';\n *\n * const withObserve = createWrapper({ after });\n *\n * export const POST = withObserve(async (req) => {\n *   return Response.json({ ok: true });\n * });\n */\nexport function createWrapper(defaultOptions: NextObserveOptions) {\n  return function <TContext = unknown>(\n    handler: NextRouteHandler<TContext>,\n    options?: NextObserveOptions\n  ): NextRouteHandler<TContext> {\n    return withObserve(handler, { ...defaultOptions, ...options });\n  };\n}\n"]}

package/dist/next.mjs

@@ -0,0 +1,30 @@
+/* @lelemondev/sdk - LLM Observability */
+
+async function flush() {
+}
+
+// src/integrations/next.ts
+function withObserve(handler, options) {
+  return async (request, context) => {
+    try {
+      return await handler(request, context);
+    } finally {
+      if (options?.after) {
+        options.after(() => flush());
+      } else if (options?.waitUntil) {
+        options.waitUntil(flush());
+      } else {
+        await flush();
+      }
+    }
+  };
+}
+function createWrapper(defaultOptions) {
+  return function(handler, options) {
+    return withObserve(handler, { ...defaultOptions, ...options });
+  };
+}
+
+export { createWrapper, withObserve };
+//# sourceMappingURL=next.mjs.map
+//# sourceMappingURL=next.mjs.map

package/dist/next.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/config.ts","../src/integrations/next.ts"],"names":[],"mappings":";;AAuEA,eAAsB,KAAA,GAAuB;AAI7C;;;ACYO,SAAS,WAAA,CACd,SACA,OAAA,EAC4B;AAC5B,EAAA,OAAO,OAAO,SAAkB,OAAA,KAA0C;AACxE,IAAA,IAAI;AACF,MAAA,OAAO,MAAM,OAAA,CAAQ,OAAA,EAAS,OAAO,CAAA;AAAA,IACvC,CAAA,SAAE;AAEA,MAAA,IAAI,SAAS,KAAA,EAAO;AAElB,QAAA,OAAA,CAAQ,KAAA,CAAM,MAAM,KAAA,EAAO,CAAA;AAAA,MAC7B,CAAA,MAAA,IAAW,SAAS,SAAA,EAAW;AAE7B,QAAA,OAAA,CAAQ,SAAA,CAAU,OAAO,CAAA;AAAA,MAC3B,CAAA,MAAO;AAEL,QAAA,MAAM,KAAA,EAAM;AAAA,MACd;AAAA,IACF;AAAA,EACF,CAAA;AACF;AAeO,SAAS,cAAc,cAAA,EAAoC;AAChE,EAAA,OAAO,SACL,SACA,OAAA,EAC4B;AAC5B,IAAA,OAAO,YAAY,OAAA,EAAS,EAAE,GAAG,cAAA,EAAgB,GAAG,SAAS,CAAA;AAAA,EAC/D,CAAA;AACF","file":"next.mjs","sourcesContent":["/**\n * Global Configuration\n *\n * Manages SDK configuration and transport instance.\n */\n\nimport type { LelemonConfig } from './types';\nimport { Transport } from './transport';\n\n// ─────────────────────────────────────────────────────────────\n// Global State\n// ─────────────────────────────────────────────────────────────\n\nlet globalConfig: LelemonConfig = {};\nlet globalTransport: Transport | null = null;\nlet initialized = false;\n\n// ─────────────────────────────────────────────────────────────\n// Configuration\n// ─────────────────────────────────────────────────────────────\n\nconst DEFAULT_ENDPOINT = 'https://api.lelemon.dev';\n\n/**\n * Initialize the SDK\n * Call once at app startup\n */\nexport function init(config: LelemonConfig = {}): void {\n  globalConfig = config;\n  globalTransport = createTransport(config);\n  initialized = true;\n}\n\n/**\n * Get current config\n */\nexport function getConfig(): LelemonConfig {\n  return globalConfig;\n}\n\n/**\n * Check if SDK is initialized\n */\nexport function isInitialized(): boolean {\n  return initialized;\n}\n\n/**\n * Check if SDK is enabled\n */\nexport function isEnabled(): boolean {\n  return getTransport().isEnabled();\n}\n\n// ─────────────────────────────────────────────────────────────\n// Transport\n// ─────────────────────────────────────────────────────────────\n\n/**\n * Get or create transport instance\n */\nexport function getTransport(): Transport {\n  if (!globalTransport) {\n    globalTransport = createTransport(globalConfig);\n  }\n  return globalTransport;\n}\n\n/**\n * Flush all pending traces\n */\nexport async function flush(): Promise<void> {\n  if (globalTransport) {\n    await globalTransport.flush();\n  }\n}\n\n/**\n * Create transport instance\n */\nfunction createTransport(config: LelemonConfig): Transport {\n  const apiKey = config.apiKey ?? getEnvVar('LELEMON_API_KEY');\n\n  if (!apiKey && !config.disabled) {\n    console.warn(\n      '[Lelemon] No API key provided. Set apiKey in init() or LELEMON_API_KEY env var. Tracing disabled.'\n    );\n  }\n\n  return new Transport({\n    apiKey: apiKey ?? '',\n    endpoint: config.endpoint ?? DEFAULT_ENDPOINT,\n    debug: config.debug ?? false,\n    disabled: config.disabled ?? !apiKey,\n    batchSize: config.batchSize,\n    flushIntervalMs: config.flushIntervalMs,\n    requestTimeoutMs: config.requestTimeoutMs,\n  });\n}\n\n/**\n * Get environment variable (works in Node and edge)\n */\nfunction getEnvVar(name: string): string | undefined {\n  if (typeof process !== 'undefined' && process.env) {\n    return process.env[name];\n  }\n  return undefined;\n}\n","/**\n * Next.js App Router Integration\n *\n * Wraps route handlers to automatically flush traces.\n * Supports Next.js 15+ `after()` and Vercel's `waitUntil()`.\n *\n * @example\n * import { withObserve } from '@lelemondev/sdk/next';\n *\n * export const POST = withObserve(async (req) => {\n *   const openai = observe(new OpenAI());\n *   const result = await openai.chat.completions.create({...});\n *   return Response.json(result);\n * });\n */\n\nimport { flush } from '../core/config';\n\n// ─────────────────────────────────────────────────────────────\n// Types\n// ─────────────────────────────────────────────────────────────\n\ntype NextRouteHandler<TContext = unknown> = (\n  request: Request,\n  context?: TContext\n) => Response | Promise<Response>;\n\n/**\n * Options for the Next.js wrapper\n */\nexport interface NextObserveOptions {\n  /**\n   * Next.js 15+ after() function from 'next/server'\n   * Preferred method - runs after response without blocking\n   *\n   * @example\n   * import { after } from 'next/server';\n   * export const POST = withObserve(handler, { after });\n   */\n  after?: (callback: () => void | Promise<void>) => void;\n\n  /**\n   * Vercel's waitUntil() from '@vercel/functions'\n   * Alternative for Vercel deployments\n   *\n   * @example\n   * import { waitUntil } from '@vercel/functions';\n   * export const POST = withObserve(handler, { waitUntil });\n   */\n  waitUntil?: (promise: Promise<unknown>) => void;\n}\n\n// ─────────────────────────────────────────────────────────────\n// Wrapper\n// ─────────────────────────────────────────────────────────────\n\n/**\n * Wrap a Next.js App Router handler with automatic trace flushing\n *\n * @param handler - Your route handler function\n * @param options - Optional: pass `after` (Next.js 15+) or `waitUntil` (Vercel)\n * @returns Wrapped handler that auto-flushes traces\n *\n * @example\n * // Basic usage (blocking flush)\n * export const POST = withObserve(async (req) => {\n *   return Response.json({ ok: true });\n * });\n *\n * @example\n * // Next.js 15+ with after() - non-blocking (recommended)\n * import { after } from 'next/server';\n *\n * export const POST = withObserve(\n *   async (req) => Response.json({ ok: true }),\n *   { after }\n * );\n *\n * @example\n * // Vercel with waitUntil() - non-blocking\n * import { waitUntil } from '@vercel/functions';\n *\n * export const POST = withObserve(\n *   async (req) => Response.json({ ok: true }),\n *   { waitUntil }\n * );\n */\nexport function withObserve<TContext = unknown>(\n  handler: NextRouteHandler<TContext>,\n  options?: NextObserveOptions\n): NextRouteHandler<TContext> {\n  return async (request: Request, context?: TContext): Promise<Response> => {\n    try {\n      return await handler(request, context);\n    } finally {\n      // Priority: after() > waitUntil() > blocking flush\n      if (options?.after) {\n        // Next.js 15+ native - best option\n        options.after(() => flush());\n      } else if (options?.waitUntil) {\n        // Vercel platform\n        options.waitUntil(flush());\n      } else {\n        // Fallback: blocking flush\n        await flush();\n      }\n    }\n  };\n}\n\n/**\n * Create a pre-configured wrapper with default options\n *\n * @example\n * import { after } from 'next/server';\n * import { createWrapper } from '@lelemondev/sdk/next';\n *\n * const withObserve = createWrapper({ after });\n *\n * export const POST = withObserve(async (req) => {\n *   return Response.json({ ok: true });\n * });\n */\nexport function createWrapper(defaultOptions: NextObserveOptions) {\n  return function <TContext = unknown>(\n    handler: NextRouteHandler<TContext>,\n    options?: NextObserveOptions\n  ): NextRouteHandler<TContext> {\n    return withObserve(handler, { ...defaultOptions, ...options });\n  };\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lelemondev/sdk",
-  "version": "0.2.1",
-  "description": "Fire-and-forget LLM observability. 3 lines of code.",
+  "version": "0.4.0",
+  "description": "Automatic LLM observability. Wrap your client, everything is traced.",
   "author": "Lelemon <info@lelemon.dev>",
   "license": "MIT",
   "repository": {
@@ -18,15 +18,15 @@
     "tracing",
     "openai",
     "anthropic",
-    "gemini",
-    "bedrock",
+    "nextjs",
+    "lambda",
+    "express",
+    "hono",
     "claude",
     "gpt",
     "ai",
     "monitoring",
-    "analytics",
-    "langchain",
-    "agent"
+    "serverless"
   ],
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -34,19 +34,44 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "bun": "./dist/index.mjs",
-      "deno": "./dist/index.mjs",
       "import": "./dist/index.mjs",
-      "require": "./dist/index.js",
-      "default": "./dist/index.mjs"
+      "require": "./dist/index.js"
+    },
+    "./next": {
+      "types": "./dist/next.d.ts",
+      "import": "./dist/next.mjs",
+      "require": "./dist/next.js"
+    },
+    "./lambda": {
+      "types": "./dist/lambda.d.ts",
+      "import": "./dist/lambda.mjs",
+      "require": "./dist/lambda.js"
+    },
+    "./express": {
+      "types": "./dist/express.d.ts",
+      "import": "./dist/express.mjs",
+      "require": "./dist/express.js"
+    },
+    "./hono": {
+      "types": "./dist/hono.d.ts",
+      "import": "./dist/hono.mjs",
+      "require": "./dist/hono.js"
+    },
+    "./integrations": {
+      "types": "./dist/integrations.d.ts",
+      "import": "./dist/integrations.mjs",
+      "require": "./dist/integrations.js"
     },
     "./package.json": "./package.json"
   },
   "typesVersions": {
     "*": {
-      "*": [
-        "./dist/index.d.ts"
-      ]
+      "next": ["./dist/next.d.ts"],
+      "lambda": ["./dist/lambda.d.ts"],
+      "express": ["./dist/express.d.ts"],
+      "hono": ["./dist/hono.d.ts"],
+      "integrations": ["./dist/integrations.d.ts"],
+      "*": ["./dist/index.d.ts"]
     }
   },
   "files": [