@gurulu/node 1.0.2 → 1.0.3

package/dist/core.d.ts

@@ -1,3 +1,4 @@
+import { type LlmCaptureInput, type WrapOptions } from './llm.ts';
 import { type ExpressMiddlewareOptions } from './middleware/express.ts';
 import { type FastifyPluginOptions } from './middleware/fastify.ts';
 import { createNextHandler, type NextHandlerOptions } from './middleware/next.ts';
@@ -16,6 +17,22 @@ export declare class Gurulu {
     identify(externalUserId: string, traits?: IdentifyTraits, explicitContext?: ServerContext): Promise<IdentifyResult>;
     /** Outcome event track (queue + auto-flush). */
     track(eventKey: string, properties?: Record<string, unknown>, explicitContext?: ServerContext, eventType?: EventClass): TrackResult;
+    /**
+     * M46 LLM Analytics (K31) — müşterinin AI özelliği için `llm_request` capture.
+     * Interaction (gözlem) — outcome ÜRETMEZ (K16). Content default kapalı; opt-in
+     * için input.promptContent/responseContent + captureContent.
+     */
+    get llm(): {
+        capture: (input: LlmCaptureInput, captureContent?: boolean) => TrackResult;
+    };
+    /**
+     * OpenAI client'ı yerinde instrument eder — her chat/embedding çağrısı
+     * `llm_request` gönderir (token/latency/status otomatik). Zero-dep: OpenAI SDK
+     * import edilmez, structural typing. `const ai = gurulu.wrapOpenAI(openai)`.
+     */
+    wrapOpenAI<T>(client: T, opts?: WrapOptions): T;
+    /** Anthropic client'ı yerinde instrument eder (messages.create). */
+    wrapAnthropic<T>(client: T, opts?: WrapOptions): T;
     /** Manual flush (force send current queue). */
     flush(): Promise<FlushResult>;
     /** Graceful shutdown — flush + cancel timer + max 10s timeout. */

package/dist/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAKA,OAAO,EAA2B,KAAK,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACjG,OAAO,EAAuB,KAAK,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACzF,OAAO,EAAE,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAIlF,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,cAAc,EACd,cAAc,EACd,aAAa,EAGb,aAAa,EACb,eAAe,EACf,WAAW,EACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,KAAK,0BAA0B,EAC/B,KAAK,oBAAoB,EAE1B,MAAM,sBAAsB,CAAC;AA2C9B,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,cAAc,CAA6B;gBAEvC,OAAO,CAAC,EAAE,eAAe;IAIrC,6DAA6D;IAC7D,IAAI,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAOlC,OAAO,CAAC,aAAa;IAKrB,uDAAuD;IACjD,QAAQ,CACZ,cAAc,EAAE,MAAM,EACtB,MAAM,CAAC,EAAE,cAAc,EACvB,eAAe,CAAC,EAAE,aAAa,GAC9B,OAAO,CAAC,cAAc,CAAC;IAO1B,gDAAgD;IAChD,KAAK,CACH,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,eAAe,CAAC,EAAE,aAAa,EAC/B,SAAS,GAAE,UAAsB,GAChC,WAAW;IAad,+CAA+C;IACzC,KAAK,IAAI,OAAO,CAAC,WAAW,CAAC;IAKnC,kEAAkE;IAC5D,QAAQ,CAAC,SAAS,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;IASxD,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,aAAa;IAUrB,+CAA+C;IAC/C,IAAI,QAAQ;;;qFA5BS,CAAC;iGAOnB,CAAC;;;;;mGAjCgB,CAAC;;;;;6GAIQ,CAAC;;0BA2DR,0BAA0B,KAAG,oBAAoB;MAGtE;IAED,qDAAqD;IACrD,IAAI,OAAO;4BACoB,wBAAwB;MACtD;IAED,IAAI,OAAO;wBACgB,oBAAoB;MAC9C;IAED,IAAI,IAAI;;MAEP;CACF;AAED,wFAAwF;AACxF,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAE5D;AAKD,wBAAgB,UAAU,IAAI,MAAM,CAGnC;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAI3D;AAED,YAAY,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,CAAC"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,WAAW,EAGjB,MAAM,UAAU,CAAC;AAClB,OAAO,EAA2B,KAAK,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACjG,OAAO,EAAuB,KAAK,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACzF,OAAO,EAAE,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAIlF,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,cAAc,EACd,cAAc,EACd,aAAa,EAGb,aAAa,EACb,eAAe,EACf,WAAW,EACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,KAAK,0BAA0B,EAC/B,KAAK,oBAAoB,EAE1B,MAAM,sBAAsB,CAAC;AA2C9B,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,cAAc,CAA6B;gBAEvC,OAAO,CAAC,EAAE,eAAe;IAIrC,6DAA6D;IAC7D,IAAI,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAOlC,OAAO,CAAC,aAAa;IAKrB,uDAAuD;IACjD,QAAQ,CACZ,cAAc,EAAE,MAAM,EACtB,MAAM,CAAC,EAAE,cAAc,EACvB,eAAe,CAAC,EAAE,aAAa,GAC9B,OAAO,CAAC,cAAc,CAAC;IAO1B,gDAAgD;IAChD,KAAK,CACH,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,eAAe,CAAC,EAAE,aAAa,EAC/B,SAAS,GAAE,UAAsB,GAChC,WAAW;IAad;;;;OAIG;IACH,IAAI,GAAG;yBAGc,eAAe,+BAA2B,WAAW;MAQzE;IAED;;;;OAIG;IACH,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,CAAC;IAW/C,oEAAoE;IACpE,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,CAAC;IAWlD,+CAA+C;IACzC,KAAK,IAAI,OAAO,CAAC,WAAW,CAAC;IAKnC,kEAAkE;IAC5D,QAAQ,CAAC,SAAS,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;IASxD,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,aAAa;IAUrB,+CAA+C;IAC/C,IAAI,QAAQ;;;qFA5E2C,CAAA;iGAGf,CAAC;;;;;mGAjCR,CAAC;;;;;6GAMJ,CAAA;;0BA6GR,0BAA0B,KAAG,oBAAoB;MAGtE;IAED,qDAAqD;IACrD,IAAI,OAAO;4BACoB,wBAAwB;MACtD;IAED,IAAI,OAAO;wBACgB,oBAAoB;MAC9C;IAED,IAAI,IAAI;;MAEP;CACF;AAED,wFAAwF;AACxF,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAE5D;AAKD,wBAAgB,UAAU,IAAI,MAAM,CAGnC;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAI3D;AAED,YAAY,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export declare const VERSION = "0.1.0";
 export { contextStorage, getContext, mergeContext, runWithContext } from './context.ts';
 export { createGurulu, Gurulu, getDefault, initDefault } from './core.ts';
 export { GuruluSDKError, InvalidWorkspaceKeyError, NotInitializedError, QueueOverflowError, TransportError, WebhookMappingNotFoundError, WebhookSignatureError, } from './errors.ts';
+export { buildLlmProperties, type LlmCaptureFn, type LlmCaptureInput, type LlmOperation, type LlmProvider, type LlmStatus, type WrapOptions, wrapAnthropicClient, wrapOpenAIClient, } from './llm.ts';
 export { createExpressMiddleware, type ExpressMiddlewareOptions, } from './middleware/express.ts';
 export { createFastifyPlugin, type FastifyPluginOptions } from './middleware/fastify.ts';
 export { createNextHandler, type NextHandlerOptions } from './middleware/next.ts';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAkBA,eAAO,MAAM,OAAO,UAAU,CAAC;AAG/B,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAExF,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG1E,OAAO,EACL,cAAc,EACd,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,uBAAuB,EACvB,KAAK,wBAAwB,GAC9B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,mBAAmB,EAAE,KAAK,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACzF,OAAO,EAAE,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAElF,YAAY,EACV,UAAU,EACV,WAAW,EACX,YAAY,EACZ,cAAc,EACd,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,qBAAqB,EACrB,aAAa,EACb,cAAc,EACd,eAAe,EACf,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAExF,OAAO,EACL,4BAA4B,EAC5B,KAAK,yBAAyB,EAC9B,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,KAAK,oBAAoB,EACzB,aAAa,GACd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,cAAc,EACd,sBAAsB,EACtB,+BAA+B,EAC/B,KAAK,mBAAmB,EACxB,YAAY,GACb,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAkBA,eAAO,MAAM,OAAO,UAAU,CAAC;AAG/B,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAExF,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG1E,OAAO,EACL,cAAc,EACd,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,uBAAuB,EACvB,KAAK,wBAAwB,GAC9B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,mBAAmB,EAAE,KAAK,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACzF,OAAO,EAAE,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAElF,YAAY,EACV,UAAU,EACV,WAAW,EACX,YAAY,EACZ,cAAc,EACd,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,qBAAqB,EACrB,aAAa,EACb,cAAc,EACd,eAAe,EACf,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAExF,OAAO,EACL,4BAA4B,EAC5B,KAAK,yBAAyB,EAC9B,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,KAAK,oBAAoB,EACzB,aAAa,GACd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,cAAc,EACd,sBAAsB,EACtB,+BAA+B,EAC/B,KAAK,mBAAmB,EACxB,YAAY,GACb,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -548,6 +548,181 @@ function buildIdentify(input) {
   return payload;
 }
 
+// src/llm.ts
+function buildLlmProperties(input, captureContent) {
+  const total = input.totalTokens ?? input.promptTokens + input.completionTokens;
+  const props = {
+    provider: input.provider,
+    model: input.model,
+    operation: input.operation,
+    prompt_tokens: input.promptTokens,
+    completion_tokens: input.completionTokens,
+    total_tokens: total,
+    latency_ms: input.latencyMs,
+    status: input.status
+  };
+  if (input.cost != null)
+    props.cost = input.cost;
+  if (input.currency != null)
+    props.currency = input.currency;
+  if (input.errorType != null)
+    props.error_type = input.errorType;
+  if (input.feature != null)
+    props.feature = input.feature;
+  if (input.cacheHit != null)
+    props.cache_hit = input.cacheHit;
+  if (input.stream != null)
+    props.stream = input.stream;
+  if (captureContent) {
+    if (input.promptContent !== undefined)
+      props.prompt_content = input.promptContent;
+    if (input.responseContent !== undefined)
+      props.response_content = input.responseContent;
+  }
+  return props;
+}
+function asRecord(v) {
+  return typeof v === "object" && v !== null ? v : null;
+}
+function numField(rec, key) {
+  const v = rec?.[key];
+  return typeof v === "number" ? v : 0;
+}
+function extractOpenAIUsage(result) {
+  const rec = asRecord(result);
+  const usage = asRecord(rec?.usage);
+  if (!usage)
+    return null;
+  const cachedRec = asRecord(usage.prompt_tokens_details);
+  const cached = numField(cachedRec, "cached_tokens");
+  return {
+    promptTokens: numField(usage, "prompt_tokens"),
+    completionTokens: numField(usage, "completion_tokens"),
+    model: typeof rec?.model === "string" ? rec.model : null,
+    ...cached > 0 ? { cacheHit: true } : {}
+  };
+}
+function extractAnthropicUsage(result) {
+  const rec = asRecord(result);
+  const usage = asRecord(rec?.usage);
+  if (!usage)
+    return null;
+  const cacheRead = numField(usage, "cache_read_input_tokens");
+  return {
+    promptTokens: numField(usage, "input_tokens"),
+    completionTokens: numField(usage, "output_tokens"),
+    model: typeof rec?.model === "string" ? rec.model : null,
+    ...cacheRead > 0 ? { cacheHit: true } : {}
+  };
+}
+function classifyError(err) {
+  const rec = asRecord(err);
+  const httpStatus = typeof rec?.status === "number" ? rec.status : undefined;
+  const name = typeof rec?.name === "string" ? rec.name : "Error";
+  if (httpStatus === 429)
+    return { status: "rate_limited", errorType: "rate_limit" };
+  if (name.toLowerCase().includes("timeout") || rec?.code === "ETIMEDOUT") {
+    return { status: "timeout", errorType: "timeout" };
+  }
+  if (httpStatus != null)
+    return { status: "error", errorType: `http_${httpStatus}` };
+  return { status: "error", errorType: name };
+}
+function instrumentCreate(owner, method, provider, operation, extractUsage, capture, opts) {
+  const original = owner[method];
+  if (typeof original !== "function")
+    return;
+  const fn = original;
+  owner[method] = function patched(...args) {
+    const params = asRecord(args[0]);
+    const isStream = params?.stream === true;
+    const start = Date.now();
+    let result;
+    try {
+      result = fn.apply(this, args);
+    } catch (err) {
+      emitError(err);
+      throw err;
+    }
+    if (result != null && typeof result.then === "function") {
+      return result.then((resolved) => {
+        emitSuccess(resolved, isStream);
+        return resolved;
+      }, (err) => {
+        emitError(err);
+        throw err;
+      });
+    }
+    emitSuccess(result, isStream);
+    return result;
+    function emitSuccess(resolved, stream) {
+      if (stream)
+        return;
+      const usage = extractUsage(resolved);
+      if (!usage)
+        return;
+      const fallbackModel = typeof params?.model === "string" ? params.model : "unknown";
+      capture({
+        provider,
+        model: usage.model ?? fallbackModel,
+        operation,
+        promptTokens: usage.promptTokens,
+        completionTokens: usage.completionTokens,
+        latencyMs: Date.now() - start,
+        status: "success",
+        ...usage.cacheHit != null ? { cacheHit: usage.cacheHit } : {},
+        ...opts.feature != null ? { feature: opts.feature } : {},
+        ...opts.captureContent ? { promptContent: params?.messages ?? params?.input ?? params?.prompt } : {},
+        ...opts.captureContent ? { responseContent: resolved } : {}
+      });
+    }
+    function emitError(err) {
+      const { status, errorType } = classifyError(err);
+      const fallbackModel = typeof params?.model === "string" ? params.model : "unknown";
+      capture({
+        provider,
+        model: fallbackModel,
+        operation,
+        promptTokens: 0,
+        completionTokens: 0,
+        latencyMs: Date.now() - start,
+        status,
+        errorType,
+        ...opts.feature != null ? { feature: opts.feature } : {}
+      });
+    }
+  };
+}
+function wrapOpenAIClient(capture, client, opts = {}) {
+  const root = asRecord(client);
+  if (!root)
+    return client;
+  const chat = asRecord(root.chat);
+  const completions = asRecord(chat?.completions);
+  if (completions) {
+    instrumentCreate(completions, "create", "openai", "chat", extractOpenAIUsage, capture, opts);
+  }
+  const embeddings = asRecord(root.embeddings);
+  if (embeddings) {
+    instrumentCreate(embeddings, "create", "openai", "embedding", extractOpenAIUsage, capture, opts);
+  }
+  const responses = asRecord(root.responses);
+  if (responses) {
+    instrumentCreate(responses, "create", "openai", "chat", extractOpenAIUsage, capture, opts);
+  }
+  return client;
+}
+function wrapAnthropicClient(capture, client, opts = {}) {
+  const root = asRecord(client);
+  if (!root)
+    return client;
+  const messages = asRecord(root.messages);
+  if (messages) {
+    instrumentCreate(messages, "create", "anthropic", "chat", extractAnthropicUsage, capture, opts);
+  }
+  return client;
+}
+
 // src/transport.ts
 var USER_AGENT = `gurulu-node/0.1.0 (${process.platform}; node ${process.version})`;
 function sleep(ms) {
@@ -576,7 +751,7 @@ async function postWithRetry(config, input) {
         headers: {
           "content-type": "application/json",
           "user-agent": USER_AGENT,
-          "x-gurulu-key": config.workspaceKey
+          authorization: `Bearer ${config.workspaceKey}`
         },
         body: payload
       });
@@ -840,6 +1015,24 @@ class Gurulu {
     const res = this.queue?.enqueue(event) ?? { queued: false, dropped: 0 };
     return { queued: res.queued, queueSize: this.queue?.size() ?? 0 };
   }
+  get llm() {
+    this.requireConfig();
+    return {
+      capture: (input, captureContent = false) => this.track("llm_request", buildLlmProperties(input, captureContent), undefined, "interaction")
+    };
+  }
+  wrapOpenAI(client, opts) {
+    const captureContent = opts?.captureContent ?? false;
+    return wrapOpenAIClient((input) => {
+      this.llm.capture(input, captureContent);
+    }, client, opts);
+  }
+  wrapAnthropic(client, opts) {
+    const captureContent = opts?.captureContent ?? false;
+    return wrapAnthropicClient((input) => {
+      this.llm.capture(input, captureContent);
+    }, client, opts);
+  }
   async flush() {
     this.requireConfig();
     return await this.queue?.flush() ?? { attempted: 0, succeeded: 0, dropped: 0 };
@@ -915,6 +1108,8 @@ function initDefault(config) {
 // src/index.ts
 var VERSION = "0.1.0";
 export {
+  wrapOpenAIClient,
+  wrapAnthropicClient,
   verifyStripe,
   verifyShopify,
   verifyLemonSqueezy,
@@ -931,6 +1126,7 @@ export {
   createFastifyPlugin,
   createExpressMiddleware,
   contextStorage,
+  buildLlmProperties,
   WebhookSignatureError,
   WebhookMappingNotFoundError,
   VERSION,

package/dist/llm.d.ts

@@ -0,0 +1,40 @@
+export type LlmProvider = 'openai' | 'anthropic' | 'google' | 'azure' | 'bedrock' | 'local' | 'other';
+export type LlmOperation = 'chat' | 'completion' | 'embedding' | 'rerank' | 'image';
+export type LlmStatus = 'success' | 'error' | 'timeout' | 'rate_limited';
+export interface LlmCaptureInput {
+    provider: LlmProvider | string;
+    model: string;
+    operation: LlmOperation | string;
+    promptTokens: number;
+    completionTokens: number;
+    /** Yoksa prompt+completion (capture türetir). */
+    totalTokens?: number;
+    latencyMs: number;
+    status: LlmStatus | string;
+    /** Müşteri ham $ cost — verilirse backend bunu kullanır (yoksa map'ten türer). */
+    cost?: number;
+    currency?: string;
+    errorType?: string;
+    /** Müşterinin AI özellik adı (chatbot/rag/copilot) — gruplama. */
+    feature?: string;
+    cacheHit?: boolean;
+    stream?: boolean;
+    /** Opt-in içerik — sadece captureContent:true ile gönderilir (K31). */
+    promptContent?: unknown;
+    responseContent?: unknown;
+}
+export interface WrapOptions {
+    /** AI özellik adı — yakalanan tüm çağrılara feature olarak eklenir. */
+    feature?: string;
+    /** Opt-in: prompt/response gövdesini de gönder (default false). */
+    captureContent?: boolean;
+}
+/** LlmCaptureInput → registry `llm_request` property paketi (snake_case, K17). */
+export declare function buildLlmProperties(input: LlmCaptureInput, captureContent: boolean): Record<string, unknown>;
+/** capture callback — Gurulu.llm.capture'a bağlanır. */
+export type LlmCaptureFn = (input: LlmCaptureInput) => void;
+/** OpenAI client'ı yerinde instrument eder (chat.completions + embeddings + responses). */
+export declare function wrapOpenAIClient<T>(capture: LlmCaptureFn, client: T, opts?: WrapOptions): T;
+/** Anthropic client'ı yerinde instrument eder (messages.create). */
+export declare function wrapAnthropicClient<T>(capture: LlmCaptureFn, client: T, opts?: WrapOptions): T;
+//# sourceMappingURL=llm.d.ts.map

package/dist/llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../src/llm.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,WAAW,GACnB,QAAQ,GACR,WAAW,GACX,QAAQ,GACR,OAAO,GACP,SAAS,GACT,OAAO,GACP,OAAO,CAAC;AAEZ,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,YAAY,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC;AACpF,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,cAAc,CAAC;AAEzE,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,WAAW,GAAG,MAAM,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,YAAY,GAAG,MAAM,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC;IAC3B,kFAAkF;IAClF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,uEAAuE;IACvE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,kFAAkF;AAClF,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,eAAe,EACtB,cAAc,EAAE,OAAO,GACtB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAwBzB;AAED,wDAAwD;AACxD,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;AA0J5D,2FAA2F;AAC3F,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,GAAE,WAAgB,GAAG,CAAC,CAyB/F;AAED,oEAAoE;AACpE,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,CAAC,EACT,IAAI,GAAE,WAAgB,GACrB,CAAC,CAQH"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gurulu/node",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "private": false,
   "license": "MIT",
   "publishConfig": {