@mate-academy/llm-gateway 8.8.2 → 8.8.3

package/dist/client/snapshotRuntime.typedefs.d.ts

@@ -0,0 +1,13 @@
+import { type LLMPromptSnapshot, type LLMVariableValue } from '../client/promptSnapshot.typedefs';
+/**
+ * What a generated `compile<Prompt>()` helper hands to the snapshot compilers:
+ * the snapshot literal the generated file declares, the prompt name to look up
+ * in it, and the call-site variables to substitute. Passed as one named object
+ * so the generated call sites stay self-labeling and the two string-shaped
+ * arguments can never be transposed.
+ */
+export interface CompileFromSnapshotOptions {
+    snapshot: LLMPromptSnapshot;
+    name: string;
+    variables: Record<string, LLMVariableValue>;
+}

package/dist/client/snapshotRuntime.typedefs.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=snapshotRuntime.typedefs.js.map

package/dist/client/snapshotRuntime.typedefs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshotRuntime.typedefs.js","sourceRoot":"","sources":["../../src/client/snapshotRuntime.typedefs.ts"],"names":[],"mappings":""}

package/dist/client/validationGate.d.ts

@@ -0,0 +1,24 @@
+import { type LLMModel, type LLMProviders, type LLMPurposes } from '../LLMService.typedefs';
+import { type LLMPromptConfig } from '../client/llmConfig.schema';
+import { type LLMCapabilityRequirement } from '../client/defineLLMPrompts';
+export type GateFailureReason = 'config-parse' | 'unknown-model' | 'unmet-capabilities';
+export interface GateInput {
+    rawConfig: unknown;
+    requires: LLMCapabilityRequirement[];
+    purpose: LLMPurposes;
+}
+export type GateResult = {
+    valid: true;
+    config: LLMPromptConfig;
+    model: LLMModel<LLMProviders>;
+} | {
+    valid: false;
+    reason: GateFailureReason;
+    detail: string;
+};
+/**
+ * The runtime config gate, run on every prompt fetch (live or fallback). Prompt
+ * variables are a code-owned compile-time contract; this gate validates only
+ * routing configuration and model capabilities.
+ */
+export declare function runValidationGate(input: GateInput): GateResult;

package/dist/client/validationGate.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runValidationGate = runValidationGate;
+const LLMService_constants_1 = require("../LLMService.constants");
+const llmConfig_schema_1 = require("../client/llmConfig.schema");
+/**
+ * The runtime config gate, run on every prompt fetch (live or fallback). Prompt
+ * variables are a code-owned compile-time contract; this gate validates only
+ * routing configuration and model capabilities.
+ */
+function runValidationGate(input) {
+    const parsed = llmConfig_schema_1.llmPromptConfigSchema.safeParse(input.rawConfig);
+    if (!parsed.success) {
+        return {
+            valid: false,
+            reason: 'config-parse',
+            detail: parsed.error.issues
+                .map((issue) => `${issue.path.join('.')}: ${issue.message}`)
+                .join('; '),
+        };
+    }
+    const model = resolveModel(parsed.data, input.purpose);
+    if (!model) {
+        return {
+            valid: false,
+            reason: 'unknown-model',
+            detail: `model "${parsed.data.model}" is not in the gateway map for `
+                + `provider "${parsed.data.provider}" / purpose "${input.purpose}"`,
+        };
+    }
+    const missingCapabilities = findMissingCapabilities(model, input.requires);
+    if (missingCapabilities.length > 0) {
+        return {
+            valid: false,
+            reason: 'unmet-capabilities',
+            detail: `model "${parsed.data.model}" lacks required capabilities: `
+                + missingCapabilities.join(', '),
+        };
+    }
+    return { valid: true, config: parsed.data, model };
+}
+function resolveModel(config, purpose) {
+    const providerModels = LLMService_constants_1.LLM_SERVICE_MODELS[config.provider];
+    const purposeModels = providerModels[purpose];
+    return purposeModels?.[config.model];
+}
+function findMissingCapabilities(model, requires) {
+    const capabilities = model.capabilities;
+    if (!capabilities) {
+        return requires;
+    }
+    return requires.filter((capability) => !capabilities[capability]);
+}
+//# sourceMappingURL=validationGate.js.map

package/dist/client/validationGate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validationGate.js","sourceRoot":"","sources":["../../src/client/validationGate.ts"],"names":[],"mappings":";;AAyCA,8CAoCC;AAvED,iEAA4D;AAC5D,gEAGmC;AA0BnC;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,KAAgB;IAChD,MAAM,MAAM,GAAG,wCAAqB,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAEhE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,cAAc;YACtB,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;iBACxB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;iBAC3D,IAAI,CAAC,IAAI,CAAC;SACd,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAEvD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,eAAe;YACvB,MAAM,EAAE,UAAU,MAAM,CAAC,IAAI,CAAC,KAAK,kCAAkC;kBACjE,aAAa,MAAM,CAAC,IAAI,CAAC,QAAQ,gBAAgB,KAAK,CAAC,OAAO,GAAG;SACtE,CAAC;IACJ,CAAC;IAED,MAAM,mBAAmB,GAAG,uBAAuB,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IAE3E,IAAI,mBAAmB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,oBAAoB;YAC5B,MAAM,EAAE,UAAU,MAAM,CAAC,IAAI,CAAC,KAAK,iCAAiC;kBAChE,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC;SACnC,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;AACrD,CAAC;AAED,SAAS,YAAY,CACnB,MAAuB,EACvB,OAAoB;IAEpB,MAAM,cAAc,GAAG,yCAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC3D,MAAM,aAAa,GAAG,cAAc,CAAC,OAAO,CAE/B,CAAC;IAEd,OAAO,aAAa,EAAE,CAAC,MAAM,CAAC,KAAmC,CAAC,CAAC;AACrE,CAAC;AAED,SAAS,uBAAuB,CAC9B,KAA6B,EAC7B,QAAoC;IAEpC,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC;IAExC,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC;AACpE,CAAC"}

package/dist/codegen.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Codegen entry point, imported only by the `langfuse:generate` script and CI —
+ * never by runtime code (it pulls in `node:fs`). Kept off the main barrel so the
+ * client runtime carries no filesystem dependency.
+ */
+export * from './client/codegen';

package/dist/codegen.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Codegen entry point, imported only by the `langfuse:generate` script and CI —
+ * never by runtime code (it pulls in `node:fs`). Kept off the main barrel so the
+ * client runtime carries no filesystem dependency.
+ */
+__exportStar(require("./client/codegen"), exports);
+//# sourceMappingURL=codegen.js.map

package/dist/codegen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.js","sourceRoot":"","sources":["../src/codegen.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;GAIG;AACH,mDAAiC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export * from './LLMError';
+export * from './LLMService.constants';
+export * from './LLMService.factory';
+export * from './LLMService.typedefs';
+export * from './LLMGateway';
+export * from './LLMGateway.typedefs';
+export * from './providers';
+export * from './services';
+export * from './utilities';
+export * from './client';

package/dist/index.js

@@ -0,0 +1,27 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./LLMError"), exports);
+__exportStar(require("./LLMService.constants"), exports);
+__exportStar(require("./LLMService.factory"), exports);
+__exportStar(require("./LLMService.typedefs"), exports);
+__exportStar(require("./LLMGateway"), exports);
+__exportStar(require("./LLMGateway.typedefs"), exports);
+__exportStar(require("./providers"), exports);
+__exportStar(require("./services"), exports);
+__exportStar(require("./utilities"), exports);
+__exportStar(require("./client"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,yDAAuC;AACvC,uDAAqC;AACrC,wDAAsC;AACtC,+CAA6B;AAC7B,wDAAsC;AACtC,8CAA4B;AAC5B,6CAA2B;AAC3B,8CAA4B;AAC5B,2CAAyB"}