gemini-branch 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 kz7c
+
+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.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACL,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACnB;AAwBD,wBAAsB,YAAY,CAAE,IAAI,EAAE,mBAAmB,GAAI,OAAO,CAAC,kBAAkB,CAAC,CAkE3F"}

package/dist/index.js

@@ -0,0 +1,79 @@
+import { GoogleGenAI } from '@google/genai';
+/* ======================
+ * Fail function (Error handling)
+ * ====================== */
+function fail(message, args) {
+    var _a, _b;
+    if ((_a = args.consoleErrors) !== null && _a !== void 0 ? _a : false) {
+        console.error(message);
+    }
+    return {
+        response: false,
+        result: (_b = args.else) !== null && _b !== void 0 ? _b : "",
+        message,
+    };
+}
+/* ======================
+ * Main function
+ * ====================== */
+export async function GeminiBranch(args) {
+    var _a, _b;
+    try {
+        // condition is non-empty string check
+        if (typeof args.condition !== "string" || args.condition.trim() === "") {
+            return fail("condition must be a non-empty string", args);
+        }
+        // choices is non-empty array check
+        if (!Array.isArray(args.choices) || args.choices.length === 0) {
+            return fail("choices must be a non-empty array", args);
+        }
+        // Gemini API call
+        const ai = new GoogleGenAI({ apiKey: args.apiKey });
+        const response = await ai.models.generateContent({
+            model: args.model,
+            contents: `
+      You are a strict conditional branching engine.
+      From the "choices" array in the JSON below, output **exactly one element that matches completely**.
+
+      {
+        "condition": ${JSON.stringify(args.condition)},
+        "choices": ${JSON.stringify(args.choices)}
+      }
+
+      Output rules:
+      - Output exactly one element from "choices"
+      - Do NOT output JSON
+      - Do NOT add explanations
+      - Do NOT add extra spaces or line breaks
+      - Do NOT output anything other than an element from "choices"
+      - If no element matches, output ${(_a = args.else) !== null && _a !== void 0 ? _a : ""}
+      `,
+        });
+        const responsemsg = String((_b = response.text) !== null && _b !== void 0 ? _b : "").trim();
+        // args.else was selected(≒ Success)
+        if (args.else && responsemsg === (args.else)) {
+            return {
+                response: true,
+                result: args.else,
+                message: "No matching choice"
+            };
+        }
+        // response is not in args.choices
+        if (!args.choices.includes(responsemsg)) {
+            return fail("Response by Gemini is not in choices: " + responsemsg, args);
+        }
+        // Success
+        return {
+            response: true,
+            result: responsemsg,
+            message: "Success"
+        };
+    }
+    catch (e) {
+        // Gemini API error
+        return fail("Gemini API error: " + String(e), args);
+    }
+    // Unknown error
+    return fail("Unknown error", args);
+}
+//# 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,OAAO,EAAC,WAAW,EAAC,MAAM,eAAe,CAAC;AAyB1C;;4BAE4B;AAC5B,SAAS,IAAI,CACX,OAAe,EACf,IAAgD;;IAEhD,IAAI,MAAA,IAAI,CAAC,aAAa,mCAAI,KAAK,EAAE,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,KAAK;QACf,MAAM,EAAE,MAAA,IAAI,CAAC,IAAI,mCAAI,EAAE;QACvB,OAAO;KACR,CAAC;AACJ,CAAC;AAGD;;4BAE4B;AAC5B,MAAM,CAAC,KAAK,UAAU,YAAY,CAAE,IAAyB;;IAC3D,IAAI,CAAC;QACH,sCAAsC;QACtC,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACvE,OAAO,IAAI,CAAC,sCAAsC,EAAE,IAAI,CAAC,CAAC;QAC5D,CAAC;QAED,mCAAmC;QACnC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9D,OAAO,IAAI,CAAC,mCAAmC,EAAE,IAAI,CAAC,CAAC;QACzD,CAAC;QAED,kBAAkB;QAClB,MAAM,EAAE,GAAG,IAAI,WAAW,CAAC,EAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAC,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,MAAM,CAAC,eAAe,CAAC;YAC/C,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,QAAQ,EAAE;;;;;uBAKO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC;qBAChC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC;;;;;;;;;wCAST,MAAA,IAAI,CAAC,IAAI,mCAAI,EAAE;OAChD;SACF,CAAC,CAAC;QAEH,MAAM,WAAW,GAAG,MAAM,CAAC,MAAA,QAAQ,CAAC,IAAI,mCAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAEvD,oCAAoC;QACpC,IAAI,IAAI,CAAC,IAAI,IAAI,WAAW,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7C,OAAO;gBACL,QAAQ,EAAE,IAAI;gBACd,MAAM,EAAE,IAAI,CAAC,IAAI;gBACjB,OAAO,EAAE,oBAAoB;aAC9B,CAAC;QACJ,CAAC;QAED,kCAAkC;QAClC,IAAG,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAC,CAAC;YACtC,OAAO,IAAI,CAAC,wCAAwC,GAAG,WAAW,EAAE,IAAI,CAAC,CAAC;QAC5E,CAAC;QAED,UAAU;QACV,OAAO;YACL,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,WAAW;YACnB,OAAO,EAAE,SAAS;SACnB,CAAC;IAEJ,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,mBAAmB;QACnB,OAAO,IAAI,CAAC,oBAAoB,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACtD,CAAC;IAGD,gBAAgB;IAChB,OAAO,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;AACrC,CAAC"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "gemini-branch",
+  "version": "1.0.0",
+  "description": "Perform conditional branching using Gemini in natural language.",
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsc"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kz7c/GeminiBranch.git"
+  },
+  "keywords": [
+    "AI",
+    "Gemini",
+    "Branching",
+    "Google",
+    "GenAI",
+    "Natural Language"
+  ],
+  "author": "kz7c",
+  "license": "MIT",
+  "type": "module",
+  "bugs": {
+    "url": "https://github.com/kz7c/GeminiBranch/issues"
+  },
+  "homepage": "https://github.com/kz7c/GeminiBranch#readme",
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@google/genai": "^1.35.0"
+  }
+}