@mate-academy/llm-gateway 2.3.0 → 2.4.0

package/dist/utilities/schema/LLMSchema.js

@@ -0,0 +1,286 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LLMSchema = void 0;
+const zod_1 = require("zod");
+const zod_to_json_schema_1 = require("zod-to-json-schema");
+const genai_1 = require("@google/genai");
+/**
+ * Concrete implementation of schema builder using Zod as the underlying validator.
+ * This implementation can be replaced with another validator without changing the public API.
+ */
+class LLMSchema {
+    zodSchema;
+    constructor(zodSchema) {
+        this.zodSchema = zodSchema;
+    }
+    // ============ Factory Methods ============
+    /**
+     * Creates a string schema
+     */
+    static string() {
+        return new LLMSchema(zod_1.z.string());
+    }
+    /**
+     * Creates a number schema
+     */
+    static number() {
+        return new LLMSchema(zod_1.z.number());
+    }
+    /**
+     * Creates a boolean schema
+     */
+    static boolean() {
+        return new LLMSchema(zod_1.z.boolean());
+    }
+    /**
+     * Creates an object schema
+     */
+    static object(shape) {
+        const zodShape = {};
+        for (const [key, schema] of Object.entries(shape)) {
+            zodShape[key] = schema.zodSchema;
+        }
+        return new LLMSchema(zod_1.z.object(zodShape));
+    }
+    /**
+     * Creates an array schema
+     */
+    static array(itemSchema) {
+        return new LLMSchema(zod_1.z.array(itemSchema.zodSchema));
+    }
+    /**
+     * Creates an enum schema
+     */
+    static enum(values) {
+        return new LLMSchema(zod_1.z.enum(values));
+    }
+    /**
+     * Creates a union schema
+     */
+    static union(schemas) {
+        const zodSchemas = schemas.map(s => s.zodSchema);
+        return new LLMSchema(zod_1.z.union(zodSchemas));
+    }
+    /**
+     * Creates a literal schema
+     */
+    static literal(value) {
+        return new LLMSchema(zod_1.z.literal(value));
+    }
+    // ============ Modifier Methods ============
+    /**
+     * Makes the schema optional
+     */
+    optional() {
+        return new LLMSchema(this.zodSchema.optional());
+    }
+    /**
+     * Makes the schema nullable
+     */
+    nullable() {
+        return new LLMSchema(this.zodSchema.nullable());
+    }
+    /**
+     * Sets a default value
+     */
+    default(value) {
+        return new LLMSchema(this.zodSchema.default(value));
+    }
+    /**
+     * Adds a description (for documentation)
+     */
+    describe(description) {
+        return new LLMSchema(this.zodSchema.describe(description));
+    }
+    // ============ String-specific Modifiers ============
+    /**
+     * Sets minimum string length
+     */
+    min(length) {
+        if (this.zodSchema instanceof zod_1.z.ZodString) {
+            return new LLMSchema(this.zodSchema.min(length));
+        }
+        return this;
+    }
+    /**
+     * Sets maximum string length
+     */
+    max(length) {
+        if (this.zodSchema instanceof zod_1.z.ZodString) {
+            return new LLMSchema(this.zodSchema.max(length));
+        }
+        return this;
+    }
+    /**
+     * Validates as email
+     */
+    email() {
+        if (this.zodSchema instanceof zod_1.z.ZodString) {
+            return new LLMSchema(this.zodSchema.email());
+        }
+        return this;
+    }
+    /**
+     * Validates as URL
+     */
+    url() {
+        if (this.zodSchema instanceof zod_1.z.ZodString) {
+            return new LLMSchema(this.zodSchema.url());
+        }
+        return this;
+    }
+    /**
+     * Validates as UUID
+     */
+    uuid() {
+        if (this.zodSchema instanceof zod_1.z.ZodString) {
+            return new LLMSchema(this.zodSchema.uuid());
+        }
+        return this;
+    }
+    // ============ Number-specific Modifiers ============
+    /**
+     * Validates as integer
+     */
+    int() {
+        if (this.zodSchema instanceof zod_1.z.ZodNumber) {
+            return new LLMSchema(this.zodSchema.int());
+        }
+        return this;
+    }
+    /**
+     * Validates as positive number
+     */
+    positive() {
+        if (this.zodSchema instanceof zod_1.z.ZodNumber) {
+            return new LLMSchema(this.zodSchema.positive());
+        }
+        return this;
+    }
+    /**
+     * Validates as negative number
+     */
+    negative() {
+        if (this.zodSchema instanceof zod_1.z.ZodNumber) {
+            return new LLMSchema(this.zodSchema.negative());
+        }
+        return this;
+    }
+    /**
+     * Validates as non-positive number
+     */
+    nonpositive() {
+        if (this.zodSchema instanceof zod_1.z.ZodNumber) {
+            return new LLMSchema(this.zodSchema.nonpositive());
+        }
+        return this;
+    }
+    /**
+     * Validates as non-negative number
+     */
+    nonnegative() {
+        if (this.zodSchema instanceof zod_1.z.ZodNumber) {
+            return new LLMSchema(this.zodSchema.nonnegative());
+        }
+        return this;
+    }
+    // ============ Internal Methods (Package Use Only) ============
+    /**
+     * @internal
+     * Parses data using the schema
+     */
+    _parse(data) {
+        const result = this.zodSchema.safeParse(data);
+        if (result.success) {
+            return {
+                success: true,
+                data: result.data,
+            };
+        }
+        return {
+            success: false,
+            error: result.error.message,
+        };
+    }
+    /**
+     * @internal
+     * Converts schema to OpenAI JSON Schema format
+     */
+    _toOpenAISchema() {
+        return (0, zod_to_json_schema_1.zodToJsonSchema)(this.zodSchema, {
+            target: 'openApi3',
+            $refStrategy: 'none',
+        });
+    }
+    /**
+     * @internal
+     * Converts schema to Google Generative AI format
+     */
+    _toGoogleSchema() {
+        const jsonSchema = (0, zod_to_json_schema_1.zodToJsonSchema)(this.zodSchema, {
+            target: 'jsonSchema7',
+            $refStrategy: 'none',
+        });
+        return this._convertJsonSchemaToGoogleFormat(jsonSchema);
+    }
+    /**
+     * @internal
+     * Converts JSON Schema to Google's Type-based format
+     */
+    _convertJsonSchemaToGoogleFormat(jsonSchema) {
+        // Handle null type
+        if (jsonSchema.type === 'null') {
+            return { type: genai_1.Type.STRING, nullable: true };
+        }
+        // Handle arrays with anyOf (for unions)
+        if (jsonSchema.anyOf) {
+            // For now, we'll use the first type in the union
+            // This is a simplification - full union support would be more complex
+            return this._convertJsonSchemaToGoogleFormat(jsonSchema.anyOf[0]);
+        }
+        // Handle objects
+        if (jsonSchema.type === 'object') {
+            const properties = {};
+            const required = jsonSchema.required || [];
+            for (const [key, value] of Object.entries(jsonSchema.properties || {})) {
+                const convertedProperty = this._convertJsonSchemaToGoogleFormat(value);
+                properties[key] = convertedProperty;
+            }
+            return {
+                type: genai_1.Type.OBJECT,
+                properties,
+                required,
+                propertyOrdering: Object.keys(properties),
+            };
+        }
+        // Handle arrays
+        if (jsonSchema.type === 'array') {
+            return {
+                type: genai_1.Type.ARRAY,
+                items: this._convertJsonSchemaToGoogleFormat(jsonSchema.items || {}),
+            };
+        }
+        // Handle strings
+        if (jsonSchema.type === 'string') {
+            if (jsonSchema.enum) {
+                return {
+                    type: genai_1.Type.STRING,
+                    enum: jsonSchema.enum,
+                };
+            }
+            return { type: genai_1.Type.STRING };
+        }
+        // Handle numbers
+        if (jsonSchema.type === 'number' || jsonSchema.type === 'integer') {
+            return { type: genai_1.Type.NUMBER };
+        }
+        // Handle booleans
+        if (jsonSchema.type === 'boolean') {
+            return { type: genai_1.Type.BOOLEAN };
+        }
+        // Default fallback
+        return { type: genai_1.Type.STRING };
+    }
+}
+exports.LLMSchema = LLMSchema;
+//# sourceMappingURL=LLMSchema.js.map

package/dist/utilities/schema/LLMSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LLMSchema.js","sourceRoot":"","sources":["../../../src/utilities/schema/LLMSchema.ts"],"names":[],"mappings":"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"}

package/dist/utilities/schema/LLMSchemaInterface.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Result of parsing data against a schema
+ */
+export interface ParseResult<T> {
+    success: boolean;
+    data?: T;
+    error?: string;
+}
+/**
+ * Abstract interface for schema implementations
+ * This allows for different validation libraries to be used internally
+ */
+export interface LLMSchemaInterface<T = any> {
+    /**
+     * Parse and validate data against the schema
+     * @internal - Used internally by the package
+     */
+    _parse(data: unknown): ParseResult<T>;
+    /**
+     * Convert schema to OpenAI JSON Schema format
+     * @internal - Used internally by the package
+     */
+    _toOpenAISchema(): any;
+    /**
+     * Convert schema to Google Generative AI format
+     * @internal - Used internally by the package
+     */
+    _toGoogleSchema(): any;
+    optional(): LLMSchemaInterface<T | undefined>;
+    nullable(): LLMSchemaInterface<T | null>;
+    default(value: any): LLMSchemaInterface<T>;
+    describe(description: string): LLMSchemaInterface<T>;
+    min(length: number): LLMSchemaInterface<T>;
+    max(length: number): LLMSchemaInterface<T>;
+    email(): LLMSchemaInterface<T>;
+    url(): LLMSchemaInterface<T>;
+    uuid(): LLMSchemaInterface<T>;
+    int(): LLMSchemaInterface<T>;
+    positive(): LLMSchemaInterface<T>;
+    negative(): LLMSchemaInterface<T>;
+    nonpositive(): LLMSchemaInterface<T>;
+    nonnegative(): LLMSchemaInterface<T>;
+}
+/**
+ * Type inference helper for schemas
+ */
+export type InferSchema<T> = T extends LLMSchemaInterface<infer U> ? U : never;

package/dist/utilities/schema/LLMSchemaInterface.js

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

package/dist/utilities/schema/LLMSchemaInterface.js.map

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

package/dist/utilities/schema/index.d.ts

@@ -0,0 +1,3 @@
+export { type LLMSchemaInterface, type InferSchema, type ParseResult } from './LLMSchemaInterface';
+export { LLMSchema } from './LLMSchema';
+export { LLMSchema as Schema } from './LLMSchema';

package/dist/utilities/schema/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Schema = exports.LLMSchema = void 0;
+// Export the concrete implementation as the main schema builder
+var LLMSchema_1 = require("./LLMSchema");
+Object.defineProperty(exports, "LLMSchema", { enumerable: true, get: function () { return LLMSchema_1.LLMSchema; } });
+// Re-export LLMSchema as the default schema interface implementation
+// This allows users to use LLMSchema while keeping implementation flexible
+var LLMSchema_2 = require("./LLMSchema");
+Object.defineProperty(exports, "Schema", { enumerable: true, get: function () { return LLMSchema_2.LLMSchema; } });
+//# sourceMappingURL=index.js.map

package/dist/utilities/schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utilities/schema/index.ts"],"names":[],"mappings":";;;AAGA,gEAAgE;AAChE,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AAElB,qEAAqE;AACrE,2EAA2E;AAC3E,yCAAkD;AAAzC,mGAAA,SAAS,OAAU"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mate-academy/llm-gateway",
-  "version": "2.3.0",
+  "version": "2.4.0",
   "description": "A gateway package for LLM services.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -45,35 +45,43 @@
       ],
       "services/*": [
         "dist/services/*"
+      ],
+      "utilities": [
+        "dist/utilities/index.d.ts"
+      ],
+      "utilities/*": [
+        "dist/utilities/*"
       ]
     }
   },
   "devDependencies": {
     "@mate-academy/ts-config": "^1.0.5",
     "@types/glob": "^9.0.0",
-    "@types/inquirer": "^9.0.8",
+    "@types/inquirer": "^9.0.9",
     "@types/jest": "^30.0.0",
     "@types/mime-types": "^3.0.1",
-    "@typescript-eslint/eslint-plugin": "^8.38.0",
+    "@typescript-eslint/eslint-plugin": "^8.39.0",
     "dotenv": "^17.2.1",
-    "eslint": "^9.31.0",
+    "eslint": "^9.32.0",
     "eslint-plugin-no-only-tests": "^3.3.0",
     "glob": "^11.0.3",
-    "inquirer": "^12.8.2",
+    "inquirer": "^12.9.0",
     "jest": "^30.0.5",
     "terser": "^5.43.1",
-    "ts-jest": "^29.4.0",
+    "ts-jest": "^29.4.1",
     "tsc-alias": "^1.8.16",
-    "typescript": "^5.8.3",
-    "typescript-eslint": "^8.38.0"
+    "typescript": "^5.9.2",
+    "typescript-eslint": "^8.39.0"
   },
   "dependencies": {
-    "@google/genai": "^1.11.0",
+    "@google/genai": "^1.13.0",
     "@mate-academy/core": "^1.10.4",
     "axios": "^1.11.0",
     "js-tiktoken": "^1.0.20",
     "mime-types": "^3.0.1",
-    "openai": "^5.10.2",
-    "uuid": "^11.1.0"
+    "openai": "^5.12.1",
+    "uuid": "^11.1.0",
+    "zod": "^3.25.76",
+    "zod-to-json-schema": "^3.24.6"
   }
 }

package/dist/functional.utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"functional.utils.js","sourceRoot":"","sources":["../src/functional.utils.ts"],"names":[],"mappings":";;;AAAO,MAAM,IAAI,GAAG,CAAuB,GAAM,EAAE,IAAS,EAAc,EAAE,CAAC,CAC3E,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;IACvB,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAExC,OAAO,GAAG,CAAC;AACb,CAAC,EAAE,EAAgB,CAAC,CACrB,CAAC;AANW,QAAA,IAAI,QAMf"}

package/dist/promptBuilder.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"promptBuilder.js","sourceRoot":"","sources":["../src/promptBuilder.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;;AAoHH,oDAQC;AA1DD,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;;;;;;;;GAQG;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"}