@mate-academy/llm-gateway 7.9.0 → 7.10.0

package/dist/LLMGateway.d.ts

@@ -1,7 +1,7 @@
 import { type LLMProviders, type LLMPurposes, type LLMServiceByPurpose, type LLMServiceOptions } from './LLMService.typedefs';
 import { type LLMGatewayOptions } from './LLMGateway.typedefs';
 import { type LLMReporterInterface } from './utilities/reporter';
-import { type LangfuseFallbackMetricDimensions, type LLMGatewayTracer, type LLMTraceContext } from './utilities/llmTracing';
+import { type LLMFallbackMetricDimensions, type LLMGatewayTracer, type LLMTraceContext } from './utilities/llmTracing';
 /**
  * An explicitly constructed gateway: every service it hands out is wired to the
  * tracer this instance was built with. `LLMServiceFactory` stays available for
@@ -25,6 +25,6 @@ export declare class LLMGateway {
      * long-running API calls it from its shutdown hook only.
      */
     flush(): Promise<void>;
-    emitFallbackServed(dimensions: LangfuseFallbackMetricDimensions): void;
+    emitFallbackServed(dimensions: LLMFallbackMetricDimensions): void;
     private traced;
 }

package/dist/LLMGateway.js.map

@@ -1 +1 @@
-{"version":3,"file":"LLMGateway.js","sourceRoot":"","sources":["../src/LLMGateway.ts"],"names":[],"mappings":";;;AAMA,6DAAyD;AAGzD,uDAOgC;AAMhC;;;;GAIG;AACH,MAAa,UAAU;IACJ,MAAM,CAAmB;IAEzB,qBAAqB,CAAgC;IAEtE,YAAY,UAA6B,EAAE;QACzC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,iCAAoB,CAAC;QACrD,IAAI,CAAC,qBAAqB;cACtB,OAAO,CAAC,qBAAqB,IAAI,sCAAyB,CAAC;IACjE,CAAC;IAED,oBAAoB,CAIlB,OAA8C;QAE9C,OAAO,IAAI,CAAC,MAAM,CAAC,sCAAiB,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,oBAAoB,CAIlB,OAA8C;QAE9C,OAAO,IAAI,CAAC,MAAM,CAAC,sCAAiB,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,sBAAsB,CAIpB,OAA8C;QAE9C,OAAO,IAAI,CAAC,MAAM,CAAC,sCAAiB,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC;IACxE,CAAC;IAED,sBAAsB,CAIpB,OAA8C;QAE9C,OAAO,IAAI,CAAC,MAAM,CAAC,sCAAiB,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC;IACxE,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,SAAS,CACP,IAAY,EACZ,OAAwB,EACxB,EAAyB;QAEzB,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;IAClD,CAAC;IAED;;;OAGG;IACH,KAAK;QACH,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;IAED,kBAAkB,CAAC,UAA4C;QAC7D,IAAI,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC;IACzC,CAAC;IAEO,MAAM,CAAmC,OAAgB;QAC/D,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEhC,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AA/ED,gCA+EC"}
+{"version":3,"file":"LLMGateway.js","sourceRoot":"","sources":["../src/LLMGateway.ts"],"names":[],"mappings":";;;AAMA,6DAAyD;AAGzD,uDAOgC;AAMhC;;;;GAIG;AACH,MAAa,UAAU;IACJ,MAAM,CAAmB;IAEzB,qBAAqB,CAA2B;IAEjE,YAAY,UAA6B,EAAE;QACzC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,iCAAoB,CAAC;QACrD,IAAI,CAAC,qBAAqB;cACtB,OAAO,CAAC,qBAAqB,IAAI,sCAAyB,CAAC;IACjE,CAAC;IAED,oBAAoB,CAIlB,OAA8C;QAE9C,OAAO,IAAI,CAAC,MAAM,CAAC,sCAAiB,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,oBAAoB,CAIlB,OAA8C;QAE9C,OAAO,IAAI,CAAC,MAAM,CAAC,sCAAiB,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,sBAAsB,CAIpB,OAA8C;QAE9C,OAAO,IAAI,CAAC,MAAM,CAAC,sCAAiB,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC;IACxE,CAAC;IAED,sBAAsB,CAIpB,OAA8C;QAE9C,OAAO,IAAI,CAAC,MAAM,CAAC,sCAAiB,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC;IACxE,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,SAAS,CACP,IAAY,EACZ,OAAwB,EACxB,EAAyB;QAEzB,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;IAClD,CAAC;IAED;;;OAGG;IACH,KAAK;QACH,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;IAED,kBAAkB,CAAC,UAAuC;QACxD,IAAI,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC;IACzC,CAAC;IAEO,MAAM,CAAmC,OAAgB;QAC/D,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEhC,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AA/ED,gCA+EC"}

package/dist/LLMGateway.typedefs.d.ts

@@ -1,5 +1,5 @@
-import { type LangfuseFallbackMetricEmitter, type LLMGatewayTracer } from './utilities/llmTracing';
+import { type LLMFallbackMetricEmitter, type LLMGatewayTracer } from './utilities/llmTracing';
 export interface LLMGatewayOptions {
     tracer?: LLMGatewayTracer;
-    fallbackMetricEmitter?: LangfuseFallbackMetricEmitter;
+    fallbackMetricEmitter?: LLMFallbackMetricEmitter;
 }

package/dist/utilities/llmTracing/llmTracing.constants.d.ts

@@ -1,6 +1,7 @@
 /**
- * CloudWatch namespace + metric name for the fallback-serving alarm. The alarm
- * is provisioned against these exact values, so they are a published contract.
+ * CloudWatch namespace + metric name for the prompt-fallback-serving alarm.
+ * The alarm is provisioned against these exact string values, so they are a
+ * published contract — renaming a value requires re-pointing the alarm first.
  */
-export declare const LANGFUSE_METRIC_NAMESPACE = "LLMGateway";
-export declare const LANGFUSE_FALLBACK_SERVED_METRIC = "LangfuseFallbackServed";
+export declare const LLM_GATEWAY_METRIC_NAMESPACE = "LLMGateway";
+export declare const PROMPT_FALLBACK_SERVED_METRIC = "LangfuseFallbackServed";

package/dist/utilities/llmTracing/llmTracing.constants.js

@@ -1,10 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LANGFUSE_FALLBACK_SERVED_METRIC = exports.LANGFUSE_METRIC_NAMESPACE = void 0;
+exports.PROMPT_FALLBACK_SERVED_METRIC = exports.LLM_GATEWAY_METRIC_NAMESPACE = void 0;
 /**
- * CloudWatch namespace + metric name for the fallback-serving alarm. The alarm
- * is provisioned against these exact values, so they are a published contract.
+ * CloudWatch namespace + metric name for the prompt-fallback-serving alarm.
+ * The alarm is provisioned against these exact string values, so they are a
+ * published contract — renaming a value requires re-pointing the alarm first.
  */
-exports.LANGFUSE_METRIC_NAMESPACE = 'LLMGateway';
-exports.LANGFUSE_FALLBACK_SERVED_METRIC = 'LangfuseFallbackServed';
+exports.LLM_GATEWAY_METRIC_NAMESPACE = 'LLMGateway';
+exports.PROMPT_FALLBACK_SERVED_METRIC = 'LangfuseFallbackServed';
 //# sourceMappingURL=llmTracing.constants.js.map

package/dist/utilities/llmTracing/llmTracing.constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"llmTracing.constants.js","sourceRoot":"","sources":["../../../src/utilities/llmTracing/llmTracing.constants.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACU,QAAA,yBAAyB,GAAG,YAAY,CAAC;AAEzC,QAAA,+BAA+B,GAAG,wBAAwB,CAAC"}
+{"version":3,"file":"llmTracing.constants.js","sourceRoot":"","sources":["../../../src/utilities/llmTracing/llmTracing.constants.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACU,QAAA,4BAA4B,GAAG,YAAY,CAAC;AAE5C,QAAA,6BAA6B,GAAG,wBAAwB,CAAC"}

package/dist/utilities/llmTracing/llmTracing.typedefs.d.ts

@@ -14,8 +14,8 @@ export interface LLMTraceContext {
 /**
  * Structural reference to the managed prompt a generation was produced from.
  * SDK-free by design: the gateway only carries `name`/`version`/`isFallback`,
- * and `@mate-academy/llm-tracer` turns it into a Langfuse prompt link (a
- * fallback prompt intentionally produces no link).
+ * and the tracer implementation turns it into a prompt link (a fallback
+ * prompt intentionally produces no link).
  */
 export interface LLMTracedPrompt {
     name: string;
@@ -45,7 +45,7 @@ export interface LLMGenerationTrace {
     metadata?: LLMTraceMetadata;
     /**
      * The managed prompt this generation used. Threaded through so the tracer can
-     * link the observation to its prompt version in Langfuse.
+     * link the observation to its prompt version.
      */
     prompt?: LLMTracedPrompt;
     /** Epoch milliseconds captured immediately before the provider call. */
@@ -66,7 +66,7 @@ export interface LLMGenerationTraceRecord extends LLMGenerationTrace {
 }
 /**
  * The tracing surface the gateway depends on. Any implementation (the no-op,
- * or `@mate-academy/llm-tracer`'s Langfuse-backed tracer) satisfies it, so
+ * or a real tracer from `@mate-academy/llm-tracer`) satisfies it, so
  * consumers hold a single type regardless of whether tracing is configured.
  */
 export interface LLMGatewayTracer {
@@ -87,7 +87,7 @@ export interface LLMGatewayTracer {
      */
     shutdown?(): Promise<void>;
 }
-export interface LangfuseFallbackMetricDimensions {
+export interface LLMFallbackMetricDimensions {
     feature?: string;
     promptName?: string;
     reason?: string;
@@ -97,4 +97,4 @@ export interface LangfuseFallbackMetricDimensions {
  * implementation when they build the gateway; the default is a no-op so the
  * gateway carries no AWS dependency and tracing stays fire-and-forget.
  */
-export type LangfuseFallbackMetricEmitter = (dimensions: LangfuseFallbackMetricDimensions) => void;
+export type LLMFallbackMetricEmitter = (dimensions: LLMFallbackMetricDimensions) => void;

package/dist/utilities/llmTracing/noopLLMTracing.d.ts

@@ -1,3 +1,3 @@
-import { type LangfuseFallbackMetricEmitter, type LLMGatewayTracer } from '../../utilities/llmTracing/llmTracing.typedefs';
+import { type LLMFallbackMetricEmitter, type LLMGatewayTracer } from '../../utilities/llmTracing/llmTracing.typedefs';
 export declare const noopLLMGatewayTracer: LLMGatewayTracer;
-export declare const noopFallbackMetricEmitter: LangfuseFallbackMetricEmitter;
+export declare const noopFallbackMetricEmitter: LLMFallbackMetricEmitter;

package/dist/utilities/llmTracing/noopLLMTracing.js.map

@@ -1 +1 @@
-{"version":3,"file":"noopLLMTracing.js","sourceRoot":"","sources":["../../../src/utilities/llmTracing/noopLLMTracing.ts"],"names":[],"mappings":";;;AAMA,MAAM,oBAAoB;IACf,SAAS,GAAG,KAAK,CAAC;IAE3B,KAAK,CAAC,SAAS,CACb,KAAa,EACb,QAAyB,EACzB,EAAyB;QAEzB,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;IAED,gBAAgB;QACd,sBAAsB;IACxB,CAAC;IAED,KAAK,CAAC,mBAAmB,CACvB,KAAa,EACb,MAAe,EACf,EAAyB;QAEzB,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;IAED,iBAAiB;QACf,sBAAsB;IACxB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,sBAAsB;IACxB,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,sBAAsB;IACxB,CAAC;CACF;AAEY,QAAA,oBAAoB,GAAqB,IAAI,oBAAoB,EAAE,CAAC;AAE1E,MAAM,yBAAyB,GAAkC,GAAG,EAAE;IAC3E,oCAAoC;AACtC,CAAC,CAAC;AAFW,QAAA,yBAAyB,6BAEpC"}
+{"version":3,"file":"noopLLMTracing.js","sourceRoot":"","sources":["../../../src/utilities/llmTracing/noopLLMTracing.ts"],"names":[],"mappings":";;;AAMA,MAAM,oBAAoB;IACf,SAAS,GAAG,KAAK,CAAC;IAE3B,KAAK,CAAC,SAAS,CACb,KAAa,EACb,QAAyB,EACzB,EAAyB;QAEzB,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;IAED,gBAAgB;QACd,sBAAsB;IACxB,CAAC;IAED,KAAK,CAAC,mBAAmB,CACvB,KAAa,EACb,MAAe,EACf,EAAyB;QAEzB,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;IAED,iBAAiB;QACf,sBAAsB;IACxB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,sBAAsB;IACxB,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,sBAAsB;IACxB,CAAC;CACF;AAEY,QAAA,oBAAoB,GAAqB,IAAI,oBAAoB,EAAE,CAAC;AAE1E,MAAM,yBAAyB,GAA6B,GAAG,EAAE;IACtE,oCAAoC;AACtC,CAAC,CAAC;AAFW,QAAA,yBAAyB,6BAEpC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mate-academy/llm-gateway",
-  "version": "7.9.0",
+  "version": "7.10.0",
   "description": "A gateway package for LLM services.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",