@adminforth/completion-adapter-google-gemini 1.0.2

package/Changelog.md

@@ -0,0 +1,5 @@
+## [1.0.0] - 2024-12-06
+
+### Added
+
+- Added Google Gemini completion adapter.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Devforth.io
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.js

@@ -0,0 +1,43 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { GoogleGenAI } from "@google/genai";
+export default class CompletionAdapterGoogleGemini {
+    constructor(options) {
+        this.complete = (content_1, ...args_1) => __awaiter(this, [content_1, ...args_1], void 0, function* (content, stop = ["."], maxTokens = 50) {
+            var _a, _b;
+            const ai = new GoogleGenAI({
+                apiKey: this.options.geminiApiKey,
+            });
+            try {
+                const response = yield ai.models.generateContent({
+                    model: this.options.model || "gemini-3-flash-preview",
+                    contents: content,
+                    config: {
+                        temperature: (_b = (_a = this.options.expert) === null || _a === void 0 ? void 0 : _a.temperature) !== null && _b !== void 0 ? _b : 0.7,
+                        maxOutputTokens: maxTokens,
+                        stopSequences: stop,
+                    },
+                });
+                return {
+                    content: response.text,
+                };
+            }
+            catch (error) {
+                return { error: error.message };
+            }
+        });
+        this.options = options;
+    }
+    validate() {
+        if (!this.options.geminiApiKey) {
+            throw new Error("geminiApiKey is required");
+        }
+    }
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/index.ts

@@ -0,0 +1,48 @@
+import type { AdapterOptions } from "./types.js";
+import type { CompletionAdapter } from "adminforth";
+import { GoogleGenAI } from "@google/genai";
+
+
+export default class CompletionAdapterGoogleGemini
+  implements CompletionAdapter
+{
+  options: AdapterOptions;
+
+  constructor(options: AdapterOptions) {
+    this.options = options;
+  }
+  
+  validate() {
+    if (!this.options.geminiApiKey) {
+      throw new Error("geminiApiKey is required");
+    }
+  }
+
+  complete = async (content: string, stop = ["."], maxTokens = 50): Promise<{
+    content?: string;
+    finishReason?: string;
+    error?: string;
+  }> => {
+
+    const ai = new GoogleGenAI({
+      apiKey: this.options.geminiApiKey,
+    });
+
+    try {
+      const response = await ai.models.generateContent({
+        model: this.options.model || "gemini-3-flash-preview",
+        contents: content,
+        config: {
+          temperature: this.options.expert?.temperature ?? 0.7,
+          maxOutputTokens: maxTokens,
+          stopSequences: stop,
+        },
+      });
+      return {
+        content: response.text,
+      };
+    } catch (error) {
+      return { error: (error as Error).message };
+    }
+  };
+}

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@adminforth/completion-adapter-google-gemini",
+  "version": "1.0.2",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "scripts": {
+    "build": "tsc && npm version patch",
+    "rollout": "npm run build && npm publish --access public",
+    "prepare": "npm link adminforth"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "description": "",
+  "dependencies": {
+    "@google/genai": "^1.35.0",
+    "adminforth": "next"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  }
+}

package/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "compilerOptions": {
+    "target": "es2016",                                  /* Set the JavaScript language version for emitted JavaScript and include*/ 
+    "module": "node16",                                /* Specify what module code is generated. */
+    "outDir": "./dist",                                   /* Specify an output folder for all emitted files. */
+    "esModuleInterop": true,                             /* Emit additional JavaScript to ease support for importing CommonJS modules.  */
+    "forceConsistentCasingInFileNames": true,            /* Ensure that casing is correct in imports. */
+    "strict": false,                                     /* Enable all strict type-checking options. */
+    "skipLibCheck": true,                                 /* Skip type checking all .d.ts files. */
+  },
+  "exclude": ["node_modules", "dist", "custom"],           /* Exclude files from compilation. */
+}

package/types.ts

@@ -0,0 +1,23 @@
+export interface AdapterOptions {
+  /**
+   * Google API key. Go to https://aistudio.google.com/api-keys, go to Dashboard -> API keys -> Create new secret key
+   * Set geminiApiKey: process.env.GEMINI_API_KEY to access it
+   */
+  geminiApiKey: string;
+
+  /**
+   * Model name. Go to https://ai.google.dev/gemini-api/docs/models, select model and copy name.
+   * Default is `gemini-3-flash-preview`. Use e.g. more expensive `gemini-3-pro-preview` for more powerful model.
+   */
+  model?: string;
+
+  /**
+   * Expert settings
+   */
+  expert?: {
+    /**
+     * Temperature (0-1). Lower is more deterministic, higher is more unpredicted creative. Default is 0.7.
+     */
+    temperature?: number;
+  };
+}