@interware/content-generator 0.5.0 → 0.6.0

package/dist/server/src/services/image-studio.d.ts

@@ -23,13 +23,17 @@ export interface GeneratedImage {
         }[];
     };
 }
+/** Cliente del Estudio: los modelos y el backend con que se creó (Gemini API o Vertex AI, S5.1). */
+export interface StudioClient {
+    models: ModelsApi;
+    backend: Backend;
+}
 /**
- * Generador del Estudio de imágenes (diseño S4.2). Recibe el cliente de Gemini por inyección para
- * probarse sin red; la llave nunca sale del servidor. `backend` indica con qué se creó el cliente:
- * hoy llave de API (Gemini API); al migrar a Vertex AI se crea con `vertexai: true` y se pasa
- * `'vertex'` (S4.14).
+ * Generador del Estudio de imágenes (diseño S4.2). Recibe el cliente por inyección para probarse sin red;
+ * las credenciales nunca salen del servidor. El cliente se pide en cada operación: si un admin configura o
+ * quita la cuenta de servicio en Ajustes, la siguiente petición ya usa el otro backend (S5.1).
  */
-export declare const createImageStudio: (getModels: () => Promise<ModelsApi>, read?: ReadFile, backend?: Backend) => {
+export declare const createImageStudio: (getClient: () => Promise<StudioClient>, read?: ReadFile) => {
     models(): Promise<{
         models: import("../image-studio/models").ImageModelInfo[];
         verified: boolean;

package/dist/server/src/services/index.d.ts

@@ -4,6 +4,9 @@ declare const _default: {
     service: ({ strapi }: {
         strapi: import("@strapi/types/dist/core").Strapi;
     }) => {
+        geminiClient({ allowVertex }?: {
+            allowVertex?: boolean;
+        }): Promise<import("../utils/geminiClient").GeminiClient>;
         geminiConfig(): Promise<import("@google/genai").GoogleGenAI>;
         getArticulos(sanitizedQueryParams: any): Promise<{
             id: import("@strapi/types/dist/data").ID;

package/dist/server/src/services/service.d.ts

@@ -2,9 +2,19 @@
 /// <reference types="node" />
 import type { Core } from '@strapi/strapi';
 import { GoogleGenAI, Video } from '@google/genai';
+import type { GeminiClient } from '../utils/geminiClient';
 declare const service: ({ strapi }: {
     strapi: Core.Strapi;
 }) => {
+    /**
+     * Cliente de Google y su backend (S5.1): con la cuenta de servicio de Ajustes, Vertex AI en `global`; si
+     * no, la llave (`GOOGLE_API_KEY` del entorno gana a la del store, como antes; D10). El video pide
+     * `allowVertex: false` (D7).
+     */
+    geminiClient({ allowVertex }?: {
+        allowVertex?: boolean;
+    }): Promise<GeminiClient>;
+    /** Atajo para los usos que solo necesitan el cliente (artículos). */
     geminiConfig(): Promise<GoogleGenAI>;
     getArticulos(sanitizedQueryParams: any): Promise<{
         id: import("@strapi/types/dist/data").ID;

package/dist/server/src/utils/geminiClient.d.ts

@@ -0,0 +1,24 @@
+import { GoogleGenAI } from '@google/genai';
+import type { Backend } from '../image-studio/geminiConfig';
+/** Región de Vertex AI: `global` (decisión de Israel, S5.1). Nano Banana 2 no está en la región de México. */
+export declare const VERTEX_LOCATION = "global";
+export interface GeminiClient {
+    ai: GoogleGenAI;
+    backend: Backend;
+}
+interface ClientInput {
+    /** JSON guardado en el plugin store (`VERTEX_SERVICE_ACCOUNT`), o null. */
+    serviceAccount: unknown;
+    /** Llave de la Gemini API (entorno o plugin store), o null. */
+    apiKey: unknown;
+    /** El video (Veo) usa la llave aunque haya cuenta de servicio (D7). */
+    allowVertex?: boolean;
+}
+type GenAIConstructor = new (options: ConstructorParameters<typeof GoogleGenAI>[0]) => GoogleGenAI;
+/**
+ * Crea el cliente de Google y dice con qué backend (S5.1): con cuenta de servicio, Vertex AI en `global`; si no,
+ * la llave de la Gemini API. Las credenciales nunca aparecen en los errores. Si Vertex falla después, el error
+ * llega tal cual: no se cae a la llave en silencio (D9).
+ */
+export declare const createGeminiClient: ({ serviceAccount, apiKey, allowVertex }: ClientInput, Ctor?: GenAIConstructor) => GeminiClient;
+export {};

package/dist/server/src/utils/serviceAccount.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Cuenta de servicio de Google Cloud para Vertex AI (S5.1). Un admin pega su JSON en Ajustes y se guarda
+ * en el plugin store (decisión de Israel). Se conserva solo lo que usa el cliente; los mensajes de error
+ * nombran campos, nunca repiten el contenido: la llave privada es un secreto.
+ */
+/** Clave de la cuenta de servicio en el plugin store (S5.1, D8). */
+export declare const VERTEX_KEY = "VERTEX_SERVICE_ACCOUNT";
+export interface ServiceAccount {
+    projectId: string;
+    clientEmail: string;
+    privateKey: string;
+}
+export type ParseResult = {
+    ok: true;
+    account: ServiceAccount;
+} | {
+    ok: false;
+    message: string;
+};
+/** Estado público para `GET /config`: proyecto y correo, nunca la llave. */
+export interface PublicServiceAccount {
+    configured: boolean;
+    projectId: string | null;
+    clientEmail: string | null;
+}
+export declare const parseServiceAccount: (value: unknown) => ParseResult;
+/** JSON mínimo que se guarda en el store: lo que `parseServiceAccount` vuelve a leer. */
+export declare const storedServiceAccount: (account: ServiceAccount) => string;
+export declare const publicServiceAccount: (stored: unknown) => PublicServiceAccount;

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.5.0",
+  "version": "0.6.0",
   "keywords": [],
   "type": "commonjs",
   "publishConfig": {
@@ -43,6 +43,7 @@
   },
   "dependencies": {
     "@google/genai": "^1.49.0",
+    "@radix-ui/react-tooltip": "1.0.7",
     "@reduxjs/toolkit": "^1.9.7",
     "@strapi/design-system": "^2.2.3",
     "@strapi/icons": "^2.2.3",