@mate-academy/llm-gateway 3.0.1 → 3.0.4

package/dist/utilities/promptBuilder.d.ts

@@ -17,6 +17,10 @@
  *       This is a conditional section that will only appear if the value is truthy.
  *       Value can be used inside the section: {{valueAsCondition}}
  *     {{/valueAsCondition}}
+ *
+ *     {{#!skipSection}}
+ *       This negative conditional section will only appear if skipSection is falsy.
+ *     {{/skipSection}}
  *  `),
  * };
  *
@@ -33,8 +37,8 @@
 type RegularValue = string | number;
 type ConditionalValue = RegularValue | boolean | undefined | null;
 type ExtractAllVariables<T extends string> = T extends `${string}{{${infer Key}}}${infer Rest}` ? Key extends `${infer CleanKey}` ? CleanKey | ExtractAllVariables<Rest> : never : never;
-type ExtractSectionVariables<T extends string> = T extends `${string}{{#${infer Key}}}${infer Rest}` ? Key | ExtractSectionVariables<Rest> : T extends `${string}{{/${infer Key}}}${infer Rest}` ? Key | ExtractSectionVariables<Rest> : never;
-type ExtractRegularVariables<T extends string> = ExtractAllVariables<T> extends infer All ? All extends string ? All extends `#${string}` | `/${string}` ? never : All : never : never;
+type ExtractSectionVariables<T extends string> = T extends `${string}{{#!${infer Key}}}${infer Rest}` ? Key | ExtractSectionVariables<Rest> : T extends `${string}{{#${infer Key}}}${infer Rest}` ? Key | ExtractSectionVariables<Rest> : T extends `${string}{{/${infer Key}}}${infer Rest}` ? Key | ExtractSectionVariables<Rest> : never;
+type ExtractRegularVariables<T extends string> = ExtractAllVariables<T> extends infer All ? All extends string ? All extends `#!${string}` | `#${string}` | `/${string}` ? never : All : never : never;
 type CreateVariableRecord<T extends string> = ExtractRegularVariables<T> extends never ? ExtractSectionVariables<T> extends never ? Record<string, never> : Record<ExtractSectionVariables<T>, RegularValue> : ExtractSectionVariables<T> extends never ? Record<ExtractRegularVariables<T>, RegularValue> : Omit<Record<ExtractRegularVariables<T>, RegularValue>, ExtractSectionVariables<T>> & Record<ExtractSectionVariables<T>, ConditionalValue>;
 type HasVariables<T extends string> = ExtractAllVariables<T> extends never ? false : true;
 /**
@@ -44,6 +48,7 @@ type HasVariables<T extends string> = ExtractAllVariables<T> extends never ? fal
  * @param {T} template The template string with placeholders:
  * - for dynamic values (e.g., `{{topicTitle}}`)
  * - for conditional sections (e.g., `{{#section}}...{{/section}}`)
+ * - for negative conditional sections (e.g., `{{#!section}}...{{/section}}`)
  * - for sections that use conditional variables as values (e.g., `{{#bonus}}...{{bonus}}...{{/bonus}}`)
  * @returns A function that takes the dynamic values and returns the generated prompt.
  */

package/dist/utilities/promptBuilder.js

@@ -18,6 +18,10 @@
  *       This is a conditional section that will only appear if the value is truthy.
  *       Value can be used inside the section: {{valueAsCondition}}
  *     {{/valueAsCondition}}
+ *
+ *     {{#!skipSection}}
+ *       This negative conditional section will only appear if skipSection is falsy.
+ *     {{/skipSection}}
  *  `),
  * };
  *
@@ -41,8 +45,18 @@ function promptBuilder(prompt, variables) {
     // Replace all occurrences of the variable in the source string
     Object.entries(variables).reduce((acc, [key, value]) => (acc.replace(new RegExp(`{{\\s*${key}\\s*}}`, 'g'), String(value))), source));
     const processConditionalSections = (source) => {
-        // Process conditional sections recursively to handle nested sections
-        return source.replace(/{{#(\w+)}}([\s\S]*?){{\/\1}}/g, (_, sectionName, content) => {
+        // Process negative conditional sections first ({{#!condition}})
+        let result = source.replace(/{{#!(\w+)}}([\s\S]*?){{\/\1}}/g, (_, sectionName, content) => {
+            const value = variables[sectionName];
+            if (!value) {
+                // Recursively process nested conditional sections and then replace variables
+                const processedContent = processConditionalSections(content);
+                return replaceVariables(processedContent);
+            }
+            return '';
+        });
+        // Then process positive conditional sections ({{#condition}})
+        result = result.replace(/{{#(\w+)}}([\s\S]*?){{\/\1}}/g, (_, sectionName, content) => {
             const value = variables[sectionName];
             if (value) {
                 // Recursively process nested conditional sections and then replace variables
@@ -51,6 +65,7 @@ function promptBuilder(prompt, variables) {
             }
             return '';
         });
+        return result;
     };
     let result = prompt;
     // Process conditional sections first (with recursive handling for nested sections)
@@ -66,6 +81,7 @@ function promptBuilder(prompt, variables) {
  * @param {T} template The template string with placeholders:
  * - for dynamic values (e.g., `{{topicTitle}}`)
  * - for conditional sections (e.g., `{{#section}}...{{/section}}`)
+ * - for negative conditional sections (e.g., `{{#!section}}...{{/section}}`)
  * - for sections that use conditional variables as values (e.g., `{{#bonus}}...{{bonus}}...{{/bonus}}`)
  * @returns A function that takes the dynamic values and returns the generated prompt.
  */

package/dist/utilities/promptBuilder.js.map

@@ -1 +1 @@
-{"version":3,"file":"promptBuilder.js","sourceRoot":"","sources":["../../src/utilities/promptBuilder.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;;AAqHH,oDAQC;AA3DD,SAAS,aAAa,CACpB,MAAc,EACd,SAA2D;IAE3D,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,gBAAgB,GAAG,CAAC,MAAc,EAAU,EAAE,CAAC;IACnD,+DAA+D;IAC/D,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CACtD,GAAG,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,SAAS,GAAG,QAAQ,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAClE,EAAE,MAAM,CAAC,CACX,CAAC;IAEF,MAAM,0BAA0B,GAAG,CAAC,MAAc,EAAU,EAAE;QAC5D,qEAAqE;QACrE,OAAO,MAAM,CAAC,OAAO,CAAC,+BAA+B,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE;YACjF,MAAM,KAAK,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;YAErC,IAAI,KAAK,EAAE,CAAC;gBACV,6EAA6E;gBAC7E,MAAM,gBAAgB,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC;gBAC7D,OAAO,gBAAgB,CAAC,gBAAgB,CAAC,CAAC;YAC5C,CAAC;YAED,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,IAAI,MAAM,GAAG,MAAM,CAAC;IAEpB,mFAAmF;IACnF,MAAM,GAAG,0BAA0B,CAAC,MAAM,CAAC,CAAC;IAE5C,6CAA6C;IAC7C,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAElC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,oBAAoB,CAAmB,QAAW;IAChE,MAAM,eAAe,GAAG,QAAQ,CAAC,IAAI,EAAO,CAAC;IAE7C,OAAO,CACL,GAAG,IAEqC,EAChC,EAAE,CAAC,aAAa,CAAC,eAAe,EAAE,GAAG,IAAI,CAAC,CAAC;AACvD,CAAC"}
+{"version":3,"file":"promptBuilder.js","sourceRoot":"","sources":["../../src/utilities/promptBuilder.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;;AAwIH,oDAQC;AA3ED,SAAS,aAAa,CACpB,MAAc,EACd,SAA2D;IAE3D,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,gBAAgB,GAAG,CAAC,MAAc,EAAU,EAAE,CAAC;IACnD,+DAA+D;IAC/D,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CACtD,GAAG,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,SAAS,GAAG,QAAQ,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAClE,EAAE,MAAM,CAAC,CACX,CAAC;IAEF,MAAM,0BAA0B,GAAG,CAAC,MAAc,EAAU,EAAE;QAC5D,gEAAgE;QAChE,IAAI,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,gCAAgC,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE;YACxF,MAAM,KAAK,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;YAErC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,6EAA6E;gBAC7E,MAAM,gBAAgB,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC;gBAC7D,OAAO,gBAAgB,CAAC,gBAAgB,CAAC,CAAC;YAC5C,CAAC;YAED,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;QAEH,8DAA8D;QAC9D,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,+BAA+B,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE;YACnF,MAAM,KAAK,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;YAErC,IAAI,KAAK,EAAE,CAAC;gBACV,6EAA6E;gBAC7E,MAAM,gBAAgB,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC;gBAC7D,OAAO,gBAAgB,CAAC,gBAAgB,CAAC,CAAC;YAC5C,CAAC;YAED,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,IAAI,MAAM,GAAG,MAAM,CAAC;IAEpB,mFAAmF;IACnF,MAAM,GAAG,0BAA0B,CAAC,MAAM,CAAC,CAAC;IAE5C,6CAA6C;IAC7C,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAElC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,oBAAoB,CAAmB,QAAW;IAChE,MAAM,eAAe,GAAG,QAAQ,CAAC,IAAI,EAAO,CAAC;IAE7C,OAAO,CACL,GAAG,IAEqC,EAChC,EAAE,CAAC,aAAa,CAAC,eAAe,EAAE,GAAG,IAAI,CAAC,CAAC;AACvD,CAAC"}

package/dist/utilities/schema/adapters/SchemaAdapterRegistry.d.ts

@@ -1,4 +1,4 @@
-import type { LLMProviders } from '../../../LLMService.typedefs';
+import { LLMProviders } from '../../../LLMService.typedefs';
 import type { SchemaAdapterInterface } from './SchemaAdapterInterface';
 import { OpenAISchemaAdapter } from '../../../providers/OpenAI/schemas/OpenAISchemaAdapter';
 import { GoogleSchemaAdapter } from '../../../providers/GoogleGenerativeAI/schemas/GoogleSchemaAdapter';
@@ -22,7 +22,3 @@ export declare const SCHEMA_ADAPTER_REGISTRY: {
  * Returns null if the provider doesn't support structured output.
  */
 export declare function getSchemaAdapter(provider: LLMProviders): SchemaAdapterInterface | null;
-/**
- * Type-safe helper to check if a provider supports structured output.
- */
-export declare function providerSupportsStructuredOutput(provider: LLMProviders): boolean;

package/dist/utilities/schema/adapters/SchemaAdapterRegistry.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SCHEMA_ADAPTER_REGISTRY = void 0;
 exports.getSchemaAdapter = getSchemaAdapter;
-exports.providerSupportsStructuredOutput = providerSupportsStructuredOutput;
+const LLMService_typedefs_1 = require("../../../LLMService.typedefs");
 const OpenAISchemaAdapter_1 = require("../../../providers/OpenAI/schemas/OpenAISchemaAdapter");
 const GoogleSchemaAdapter_1 = require("../../../providers/GoogleGenerativeAI/schemas/GoogleSchemaAdapter");
 /**
@@ -17,8 +17,8 @@ const GoogleSchemaAdapter_1 = require("../../../providers/GoogleGenerativeAI/sch
  * This ensures compile-time safety and forces developers to handle all providers.
  */
 exports.SCHEMA_ADAPTER_REGISTRY = {
-    OpenAI: new OpenAISchemaAdapter_1.OpenAISchemaAdapter(),
-    GoogleGenerativeAI: new GoogleSchemaAdapter_1.GoogleSchemaAdapter(),
+    [LLMService_typedefs_1.LLMProviders.OpenAI]: new OpenAISchemaAdapter_1.OpenAISchemaAdapter(),
+    [LLMService_typedefs_1.LLMProviders.GoogleGenerativeAI]: new GoogleSchemaAdapter_1.GoogleSchemaAdapter(),
 };
 /**
  * Type-safe helper to get a schema adapter for a provider.
@@ -27,10 +27,4 @@ exports.SCHEMA_ADAPTER_REGISTRY = {
 function getSchemaAdapter(provider) {
     return exports.SCHEMA_ADAPTER_REGISTRY[provider];
 }
-/**
- * Type-safe helper to check if a provider supports structured output.
- */
-function providerSupportsStructuredOutput(provider) {
-    return exports.SCHEMA_ADAPTER_REGISTRY[provider] !== null;
-}
 //# sourceMappingURL=SchemaAdapterRegistry.js.map

package/dist/utilities/schema/adapters/SchemaAdapterRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"SchemaAdapterRegistry.js","sourceRoot":"","sources":["../../../../src/utilities/schema/adapters/SchemaAdapterRegistry.ts"],"names":[],"mappings":";;;AAyBA,4CAEC;AAKD,4EAEC;AAhCD,wFAAqF;AACrF,oGAAiG;AAEjG;;;;;;;;;;GAUG;AACU,QAAA,uBAAuB,GAAG;IACrC,MAAM,EAAE,IAAI,yCAAmB,EAAE;IACjC,kBAAkB,EAAE,IAAI,yCAAmB,EAAE;CACyB,CAAC;AAEzE;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,QAAsB;IACrD,OAAO,+BAAuB,CAAC,QAAQ,CAAC,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,SAAgB,gCAAgC,CAAC,QAAsB;IACrE,OAAO,+BAAuB,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;AACpD,CAAC"}
+{"version":3,"file":"SchemaAdapterRegistry.js","sourceRoot":"","sources":["../../../../src/utilities/schema/adapters/SchemaAdapterRegistry.ts"],"names":[],"mappings":";;;AAyBA,4CAEC;AA3BD,+DAAqD;AAErD,wFAAqF;AACrF,oGAAiG;AAEjG;;;;;;;;;;GAUG;AACU,QAAA,uBAAuB,GAAG;IACrC,CAAC,kCAAY,CAAC,MAAM,CAAC,EAAE,IAAI,yCAAmB,EAAE;IAChD,CAAC,kCAAY,CAAC,kBAAkB,CAAC,EAAE,IAAI,yCAAmB,EAAE;CACU,CAAC;AAEzE;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,QAAsB;IACrD,OAAO,+BAAuB,CAAC,QAAQ,CAAC,CAAC;AAC3C,CAAC"}

package/package.json

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