@lelemondev/sdk 0.3.0 → 0.4.0

package/dist/hono.mjs

@@ -0,0 +1,21 @@
+/* @lelemondev/sdk - LLM Observability */
+
+async function flush() {
+}
+
+// src/integrations/hono.ts
+function createMiddleware() {
+  return async (c, next) => {
+    await next();
+    if (c.executionCtx?.waitUntil) {
+      c.executionCtx.waitUntil(flush());
+    } else {
+      flush().catch(() => {
+      });
+    }
+  };
+}
+
+export { createMiddleware };
+//# sourceMappingURL=hono.mjs.map
+//# sourceMappingURL=hono.mjs.map

package/dist/hono.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/config.ts","../src/integrations/hono.ts"],"names":[],"mappings":";;AAuEA,eAAsB,KAAA,GAAuB;AAI7C;;;ACPO,SAAS,gBAAA,GAAmC;AACjD,EAAA,OAAO,OAAO,GAAG,IAAA,KAAS;AACxB,IAAA,MAAM,IAAA,EAAK;AAGX,IAAA,IAAI,CAAA,CAAE,cAAc,SAAA,EAAW;AAC7B,MAAA,CAAA,CAAE,YAAA,CAAa,SAAA,CAAU,KAAA,EAAO,CAAA;AAAA,IAClC,CAAA,MAAO;AAEL,MAAA,KAAA,EAAM,CAAE,MAAM,MAAM;AAAA,MAAC,CAAC,CAAA;AAAA,IACxB;AAAA,EACF,CAAA;AACF","file":"hono.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 * Hono Integration\n *\n * Middleware for Hono framework (Cloudflare Workers, Deno, Bun, Node.js).\n * Uses executionCtx.waitUntil() when available for non-blocking flush.\n *\n * @example\n * import { Hono } from 'hono';\n * import { createMiddleware } from '@lelemondev/sdk/hono';\n *\n * const app = new Hono();\n * app.use(createMiddleware());\n */\n\nimport { flush } from '../core/config';\n\n// ─────────────────────────────────────────────────────────────\n// Types (minimal to avoid requiring hono as dependency)\n// ─────────────────────────────────────────────────────────────\n\ninterface ExecutionContext {\n  waitUntil(promise: Promise<unknown>): void;\n  passThroughOnException(): void;\n}\n\ninterface HonoContext {\n  req: {\n    raw: Request;\n    [key: string]: unknown;\n  };\n  res: Response | undefined;\n  executionCtx?: ExecutionContext;\n  [key: string]: unknown;\n}\n\ntype NextFunction = () => Promise<void>;\n\ntype HonoMiddleware = (c: HonoContext, next: NextFunction) => Promise<void>;\n\n// ─────────────────────────────────────────────────────────────\n// Middleware\n// ─────────────────────────────────────────────────────────────\n\n/**\n * Create Hono middleware for automatic trace flushing\n *\n * On Cloudflare Workers/Deno Deploy: uses executionCtx.waitUntil() for non-blocking flush\n * On Node.js/Bun: flushes after response (fire-and-forget)\n *\n * @returns Hono middleware function\n *\n * @example\n * import { Hono } from 'hono';\n * import { createMiddleware } from '@lelemondev/sdk/hono';\n *\n * const app = new Hono();\n *\n * // Global middleware\n * app.use(createMiddleware());\n *\n * app.post('/chat', async (c) => {\n *   const openai = observe(new OpenAI());\n *   const result = await openai.chat.completions.create({...});\n *   return c.json(result);\n * });\n *\n * export default app;\n */\nexport function createMiddleware(): HonoMiddleware {\n  return async (c, next) => {\n    await next();\n\n    // Use waitUntil if available (Cloudflare Workers, Deno Deploy)\n    if (c.executionCtx?.waitUntil) {\n      c.executionCtx.waitUntil(flush());\n    } else {\n      // Fire-and-forget for Node.js/Bun\n      flush().catch(() => {});\n    }\n  };\n}\n"]}

package/dist/index.js

@@ -1,6 +1,6 @@
 'use strict';
 
-/* @lelemon/sdk - LLM Observability */
+/* @lelemondev/sdk - LLM Observability */
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);

package/dist/index.mjs

@@ -1,4 +1,4 @@
-/* @lelemon/sdk - LLM Observability */
+/* @lelemondev/sdk - LLM Observability */
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);

package/dist/integrations.d.mts

@@ -0,0 +1,4 @@
+export { n as next } from './next-0nso_zEN.mjs';
+export { l as lambda } from './lambda-DQmEfWXC.mjs';
+export { e as express } from './express-Cmb_A4sI.mjs';
+export { h as hono } from './hono-ChTmQk_V.mjs';

package/dist/integrations.d.ts

@@ -0,0 +1,4 @@
+export { n as next } from './next-0nso_zEN.js';
+export { l as lambda } from './lambda-DQmEfWXC.js';
+export { e as express } from './express-Cmb_A4sI.js';
+export { h as hono } from './hono-ChTmQk_V.js';

package/dist/integrations.js

@@ -0,0 +1,93 @@
+'use strict';
+
+/* @lelemondev/sdk - LLM Observability */
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/integrations/next.ts
+var next_exports = {};
+__export(next_exports, {
+  createWrapper: () => createWrapper,
+  withObserve: () => withObserve
+});
+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 });
+  };
+}
+
+// src/integrations/lambda.ts
+var lambda_exports = {};
+__export(lambda_exports, {
+  withObserve: () => withObserve2
+});
+function withObserve2(handler) {
+  return async (event, context) => {
+    try {
+      return await handler(event, context);
+    } finally {
+      await flush();
+    }
+  };
+}
+
+// src/integrations/express.ts
+var express_exports = {};
+__export(express_exports, {
+  createMiddleware: () => createMiddleware
+});
+function createMiddleware() {
+  return (_req, res, next) => {
+    res.on("finish", () => {
+      flush().catch(() => {
+      });
+    });
+    next();
+  };
+}
+
+// src/integrations/hono.ts
+var hono_exports = {};
+__export(hono_exports, {
+  createMiddleware: () => createMiddleware2
+});
+function createMiddleware2() {
+  return async (c, next) => {
+    await next();
+    if (c.executionCtx?.waitUntil) {
+      c.executionCtx.waitUntil(flush());
+    } else {
+      flush().catch(() => {
+      });
+    }
+  };
+}
+
+exports.express = express_exports;
+exports.hono = hono_exports;
+exports.lambda = lambda_exports;
+exports.next = next_exports;
+//# sourceMappingURL=integrations.js.map
+//# sourceMappingURL=integrations.js.map

package/dist/integrations.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/integrations/next.ts","../src/core/config.ts","../src/integrations/lambda.ts","../src/integrations/express.ts","../src/integrations/hono.ts"],"names":["withObserve","createMiddleware"],"mappings":";;;;;;;;;;AAAA,IAAA,YAAA,GAAA;AAAA,QAAA,CAAA,YAAA,EAAA;AAAA,EAAA,aAAA,EAAA,MAAA,aAAA;AAAA,EAAA,WAAA,EAAA,MAAA;AAAA,CAAA,CAAA;ACuEA,eAAsB,KAAA,GAAuB;AAI7C;;;ADYO,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;;;AElIA,IAAA,cAAA,GAAA;AAAA,QAAA,CAAA,cAAA,EAAA;AAAA,EAAA,WAAA,EAAA,MAAAA;AAAA,CAAA,CAAA;AAkFO,SAASA,aACd,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;;;AC7FA,IAAA,eAAA,GAAA;AAAA,QAAA,CAAA,eAAA,EAAA;AAAA,EAAA,gBAAA,EAAA,MAAA;AAAA,CAAA,CAAA;AA0DO,SAAS,gBAAA,GAAsC;AACpD,EAAA,OAAO,CAAC,IAAA,EAAM,GAAA,EAAK,IAAA,KAAS;AAE1B,IAAA,GAAA,CAAI,EAAA,CAAG,UAAU,MAAM;AACrB,MAAA,KAAA,EAAM,CAAE,MAAM,MAAM;AAAA,MAEpB,CAAC,CAAA;AAAA,IACH,CAAC,CAAA;AAED,IAAA,IAAA,EAAK;AAAA,EACP,CAAA;AACF;;;ACrEA,IAAA,YAAA,GAAA;AAAA,QAAA,CAAA,YAAA,EAAA;AAAA,EAAA,gBAAA,EAAA,MAAAC;AAAA,CAAA,CAAA;AAoEO,SAASA,iBAAAA,GAAmC;AACjD,EAAA,OAAO,OAAO,GAAG,IAAA,KAAS;AACxB,IAAA,MAAM,IAAA,EAAK;AAGX,IAAA,IAAI,CAAA,CAAE,cAAc,SAAA,EAAW;AAC7B,MAAA,CAAA,CAAE,YAAA,CAAa,SAAA,CAAU,KAAA,EAAO,CAAA;AAAA,IAClC,CAAA,MAAO;AAEL,MAAA,KAAA,EAAM,CAAE,MAAM,MAAM;AAAA,MAAC,CAAC,CAAA;AAAA,IACxB;AAAA,EACF,CAAA;AACF","file":"integrations.js","sourcesContent":["/**\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","/**\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","/**\n * Express Integration\n *\n * Middleware that automatically flushes traces when response finishes.\n *\n * @example\n * import express from 'express';\n * import { createMiddleware } from '@lelemondev/sdk/express';\n *\n * const app = express();\n * app.use(createMiddleware());\n */\n\nimport { flush } from '../core/config';\n\n// ─────────────────────────────────────────────────────────────\n// Types (minimal to avoid requiring express as dependency)\n// ─────────────────────────────────────────────────────────────\n\ninterface ExpressRequest {\n  [key: string]: unknown;\n}\n\ninterface ExpressResponse {\n  on(event: 'finish' | 'close' | 'error', listener: () => void): this;\n  [key: string]: unknown;\n}\n\ntype NextFunction = (error?: unknown) => void;\n\ntype ExpressMiddleware = (\n  req: ExpressRequest,\n  res: ExpressResponse,\n  next: NextFunction\n) => void;\n\n// ─────────────────────────────────────────────────────────────\n// Middleware\n// ─────────────────────────────────────────────────────────────\n\n/**\n * Create Express middleware for automatic trace flushing\n *\n * Flushes traces when the response finishes (after res.send/res.json).\n * This is fire-and-forget and doesn't block the response.\n *\n * @returns Express middleware function\n *\n * @example\n * // Global middleware\n * app.use(createMiddleware());\n *\n * @example\n * // Per-route middleware\n * app.post('/chat', createMiddleware(), async (req, res) => {\n *   res.json({ ok: true });\n * });\n */\nexport function createMiddleware(): ExpressMiddleware {\n  return (_req, res, next) => {\n    // Flush when response is finished (after headers + body sent)\n    res.on('finish', () => {\n      flush().catch(() => {\n        // Silently ignore flush errors - fire and forget\n      });\n    });\n\n    next();\n  };\n}\n","/**\n * Hono Integration\n *\n * Middleware for Hono framework (Cloudflare Workers, Deno, Bun, Node.js).\n * Uses executionCtx.waitUntil() when available for non-blocking flush.\n *\n * @example\n * import { Hono } from 'hono';\n * import { createMiddleware } from '@lelemondev/sdk/hono';\n *\n * const app = new Hono();\n * app.use(createMiddleware());\n */\n\nimport { flush } from '../core/config';\n\n// ─────────────────────────────────────────────────────────────\n// Types (minimal to avoid requiring hono as dependency)\n// ─────────────────────────────────────────────────────────────\n\ninterface ExecutionContext {\n  waitUntil(promise: Promise<unknown>): void;\n  passThroughOnException(): void;\n}\n\ninterface HonoContext {\n  req: {\n    raw: Request;\n    [key: string]: unknown;\n  };\n  res: Response | undefined;\n  executionCtx?: ExecutionContext;\n  [key: string]: unknown;\n}\n\ntype NextFunction = () => Promise<void>;\n\ntype HonoMiddleware = (c: HonoContext, next: NextFunction) => Promise<void>;\n\n// ─────────────────────────────────────────────────────────────\n// Middleware\n// ─────────────────────────────────────────────────────────────\n\n/**\n * Create Hono middleware for automatic trace flushing\n *\n * On Cloudflare Workers/Deno Deploy: uses executionCtx.waitUntil() for non-blocking flush\n * On Node.js/Bun: flushes after response (fire-and-forget)\n *\n * @returns Hono middleware function\n *\n * @example\n * import { Hono } from 'hono';\n * import { createMiddleware } from '@lelemondev/sdk/hono';\n *\n * const app = new Hono();\n *\n * // Global middleware\n * app.use(createMiddleware());\n *\n * app.post('/chat', async (c) => {\n *   const openai = observe(new OpenAI());\n *   const result = await openai.chat.completions.create({...});\n *   return c.json(result);\n * });\n *\n * export default app;\n */\nexport function createMiddleware(): HonoMiddleware {\n  return async (c, next) => {\n    await next();\n\n    // Use waitUntil if available (Cloudflare Workers, Deno Deploy)\n    if (c.executionCtx?.waitUntil) {\n      c.executionCtx.waitUntil(flush());\n    } else {\n      // Fire-and-forget for Node.js/Bun\n      flush().catch(() => {});\n    }\n  };\n}\n"]}

package/dist/integrations.mjs

@@ -0,0 +1,88 @@
+/* @lelemondev/sdk - LLM Observability */
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/integrations/next.ts
+var next_exports = {};
+__export(next_exports, {
+  createWrapper: () => createWrapper,
+  withObserve: () => withObserve
+});
+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 });
+  };
+}
+
+// src/integrations/lambda.ts
+var lambda_exports = {};
+__export(lambda_exports, {
+  withObserve: () => withObserve2
+});
+function withObserve2(handler) {
+  return async (event, context) => {
+    try {
+      return await handler(event, context);
+    } finally {
+      await flush();
+    }
+  };
+}
+
+// src/integrations/express.ts
+var express_exports = {};
+__export(express_exports, {
+  createMiddleware: () => createMiddleware
+});
+function createMiddleware() {
+  return (_req, res, next) => {
+    res.on("finish", () => {
+      flush().catch(() => {
+      });
+    });
+    next();
+  };
+}
+
+// src/integrations/hono.ts
+var hono_exports = {};
+__export(hono_exports, {
+  createMiddleware: () => createMiddleware2
+});
+function createMiddleware2() {
+  return async (c, next) => {
+    await next();
+    if (c.executionCtx?.waitUntil) {
+      c.executionCtx.waitUntil(flush());
+    } else {
+      flush().catch(() => {
+      });
+    }
+  };
+}
+
+export { express_exports as express, hono_exports as hono, lambda_exports as lambda, next_exports as next };
+//# sourceMappingURL=integrations.mjs.map
+//# sourceMappingURL=integrations.mjs.map

package/dist/integrations.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/integrations/next.ts","../src/core/config.ts","../src/integrations/lambda.ts","../src/integrations/express.ts","../src/integrations/hono.ts"],"names":["withObserve","createMiddleware"],"mappings":";;;;;;;;AAAA,IAAA,YAAA,GAAA;AAAA,QAAA,CAAA,YAAA,EAAA;AAAA,EAAA,aAAA,EAAA,MAAA,aAAA;AAAA,EAAA,WAAA,EAAA,MAAA;AAAA,CAAA,CAAA;ACuEA,eAAsB,KAAA,GAAuB;AAI7C;;;ADYO,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;;;AElIA,IAAA,cAAA,GAAA;AAAA,QAAA,CAAA,cAAA,EAAA;AAAA,EAAA,WAAA,EAAA,MAAAA;AAAA,CAAA,CAAA;AAkFO,SAASA,aACd,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;;;AC7FA,IAAA,eAAA,GAAA;AAAA,QAAA,CAAA,eAAA,EAAA;AAAA,EAAA,gBAAA,EAAA,MAAA;AAAA,CAAA,CAAA;AA0DO,SAAS,gBAAA,GAAsC;AACpD,EAAA,OAAO,CAAC,IAAA,EAAM,GAAA,EAAK,IAAA,KAAS;AAE1B,IAAA,GAAA,CAAI,EAAA,CAAG,UAAU,MAAM;AACrB,MAAA,KAAA,EAAM,CAAE,MAAM,MAAM;AAAA,MAEpB,CAAC,CAAA;AAAA,IACH,CAAC,CAAA;AAED,IAAA,IAAA,EAAK;AAAA,EACP,CAAA;AACF;;;ACrEA,IAAA,YAAA,GAAA;AAAA,QAAA,CAAA,YAAA,EAAA;AAAA,EAAA,gBAAA,EAAA,MAAAC;AAAA,CAAA,CAAA;AAoEO,SAASA,iBAAAA,GAAmC;AACjD,EAAA,OAAO,OAAO,GAAG,IAAA,KAAS;AACxB,IAAA,MAAM,IAAA,EAAK;AAGX,IAAA,IAAI,CAAA,CAAE,cAAc,SAAA,EAAW;AAC7B,MAAA,CAAA,CAAE,YAAA,CAAa,SAAA,CAAU,KAAA,EAAO,CAAA;AAAA,IAClC,CAAA,MAAO;AAEL,MAAA,KAAA,EAAM,CAAE,MAAM,MAAM;AAAA,MAAC,CAAC,CAAA;AAAA,IACxB;AAAA,EACF,CAAA;AACF","file":"integrations.mjs","sourcesContent":["/**\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","/**\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","/**\n * Express Integration\n *\n * Middleware that automatically flushes traces when response finishes.\n *\n * @example\n * import express from 'express';\n * import { createMiddleware } from '@lelemondev/sdk/express';\n *\n * const app = express();\n * app.use(createMiddleware());\n */\n\nimport { flush } from '../core/config';\n\n// ─────────────────────────────────────────────────────────────\n// Types (minimal to avoid requiring express as dependency)\n// ─────────────────────────────────────────────────────────────\n\ninterface ExpressRequest {\n  [key: string]: unknown;\n}\n\ninterface ExpressResponse {\n  on(event: 'finish' | 'close' | 'error', listener: () => void): this;\n  [key: string]: unknown;\n}\n\ntype NextFunction = (error?: unknown) => void;\n\ntype ExpressMiddleware = (\n  req: ExpressRequest,\n  res: ExpressResponse,\n  next: NextFunction\n) => void;\n\n// ─────────────────────────────────────────────────────────────\n// Middleware\n// ─────────────────────────────────────────────────────────────\n\n/**\n * Create Express middleware for automatic trace flushing\n *\n * Flushes traces when the response finishes (after res.send/res.json).\n * This is fire-and-forget and doesn't block the response.\n *\n * @returns Express middleware function\n *\n * @example\n * // Global middleware\n * app.use(createMiddleware());\n *\n * @example\n * // Per-route middleware\n * app.post('/chat', createMiddleware(), async (req, res) => {\n *   res.json({ ok: true });\n * });\n */\nexport function createMiddleware(): ExpressMiddleware {\n  return (_req, res, next) => {\n    // Flush when response is finished (after headers + body sent)\n    res.on('finish', () => {\n      flush().catch(() => {\n        // Silently ignore flush errors - fire and forget\n      });\n    });\n\n    next();\n  };\n}\n","/**\n * Hono Integration\n *\n * Middleware for Hono framework (Cloudflare Workers, Deno, Bun, Node.js).\n * Uses executionCtx.waitUntil() when available for non-blocking flush.\n *\n * @example\n * import { Hono } from 'hono';\n * import { createMiddleware } from '@lelemondev/sdk/hono';\n *\n * const app = new Hono();\n * app.use(createMiddleware());\n */\n\nimport { flush } from '../core/config';\n\n// ─────────────────────────────────────────────────────────────\n// Types (minimal to avoid requiring hono as dependency)\n// ─────────────────────────────────────────────────────────────\n\ninterface ExecutionContext {\n  waitUntil(promise: Promise<unknown>): void;\n  passThroughOnException(): void;\n}\n\ninterface HonoContext {\n  req: {\n    raw: Request;\n    [key: string]: unknown;\n  };\n  res: Response | undefined;\n  executionCtx?: ExecutionContext;\n  [key: string]: unknown;\n}\n\ntype NextFunction = () => Promise<void>;\n\ntype HonoMiddleware = (c: HonoContext, next: NextFunction) => Promise<void>;\n\n// ─────────────────────────────────────────────────────────────\n// Middleware\n// ─────────────────────────────────────────────────────────────\n\n/**\n * Create Hono middleware for automatic trace flushing\n *\n * On Cloudflare Workers/Deno Deploy: uses executionCtx.waitUntil() for non-blocking flush\n * On Node.js/Bun: flushes after response (fire-and-forget)\n *\n * @returns Hono middleware function\n *\n * @example\n * import { Hono } from 'hono';\n * import { createMiddleware } from '@lelemondev/sdk/hono';\n *\n * const app = new Hono();\n *\n * // Global middleware\n * app.use(createMiddleware());\n *\n * app.post('/chat', async (c) => {\n *   const openai = observe(new OpenAI());\n *   const result = await openai.chat.completions.create({...});\n *   return c.json(result);\n * });\n *\n * export default app;\n */\nexport function createMiddleware(): HonoMiddleware {\n  return async (c, next) => {\n    await next();\n\n    // Use waitUntil if available (Cloudflare Workers, Deno Deploy)\n    if (c.executionCtx?.waitUntil) {\n      c.executionCtx.waitUntil(flush());\n    } else {\n      // Fire-and-forget for Node.js/Bun\n      flush().catch(() => {});\n    }\n  };\n}\n"]}

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"]}