@objectstack/service-settings 7.3.0 → 7.4.1

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import * as _objectstack_spec_contracts from '@objectstack/spec/contracts';
-import { ICryptoProvider, IHttpRequest, IHttpServer } from '@objectstack/spec/contracts';
+import { ICryptoProvider, CryptoContext, CryptoHandle, IHttpRequest, IHttpServer } from '@objectstack/spec/contracts';
 import { SettingsActionResult, SpecifierScope, SettingsChangeHandler, SettingsUnsubscribe, SettingsManifest, ResolvedSettingValue, SettingsNamespacePayload, TranslationData, TranslationBundle } from '@objectstack/spec/system';
 export { ResolvedSettingValue, SettingsActionResult, SettingsManifest, SettingsNamespacePayload, SpecifierScope } from '@objectstack/spec/system';
 import { Plugin, PluginContext } from '@objectstack/core';
@@ -332,6 +332,20 @@ declare class SettingsService {
     private materialiseRow;
 }
 
+declare class InMemoryCryptoProvider implements ICryptoProvider {
+    private readonly key;
+    private readonly useNoble;
+    constructor(opts?: {
+        key?: Buffer;
+    });
+    encrypt(plain: string, ctx: CryptoContext): Promise<CryptoHandle>;
+    decrypt(handle: CryptoHandle, ctx: CryptoContext): Promise<string>;
+    rotateKey(handle: CryptoHandle, ctx: CryptoContext): Promise<CryptoHandle>;
+    digest(plain: string): string;
+    private encryptNode;
+    private aadOf;
+}
+
 /** Configuration options for the SettingsServicePlugin. */
 interface SettingsServicePluginOptions {
     /**
@@ -598,4 +612,4 @@ declare const jaJP: TranslationData;
 
 declare const settingsBuiltinTranslations: TranslationBundle;
 
-export { type CryptoAdapter, NoopCryptoAdapter, SETTINGS_PLUGIN_ID, SETTINGS_PLUGIN_VERSION, type SettingsActionHandler, type SettingsAuditSink, type SettingsContext, type SettingsEngine, SettingsLockedError, type SettingsRoutesOptions, type SettingsRow, SettingsService, type SettingsServiceOptions, SettingsServicePlugin, type SettingsServicePluginOptions, UnknownKeyError, UnknownNamespaceError, brandingSettingsManifest, builtinSettingsManifests, envKeyOf, featureFlagsSettingsManifest, mailSettingsManifest, mailTestActionHandler, registerSettingsRoutes, settingsBuiltinTranslations, settingsObjects, settingsPluginManifestHeader, en as settingsTranslationsEn, jaJP as settingsTranslationsJaJP, zhCN as settingsTranslationsZhCN, storageSettingsManifest, storageTestActionHandler };
+export { type CryptoAdapter, InMemoryCryptoProvider, NoopCryptoAdapter, SETTINGS_PLUGIN_ID, SETTINGS_PLUGIN_VERSION, type SettingsActionHandler, type SettingsAuditSink, type SettingsContext, type SettingsEngine, SettingsLockedError, type SettingsRoutesOptions, type SettingsRow, SettingsService, type SettingsServiceOptions, SettingsServicePlugin, type SettingsServicePluginOptions, UnknownKeyError, UnknownNamespaceError, brandingSettingsManifest, builtinSettingsManifests, envKeyOf, featureFlagsSettingsManifest, mailSettingsManifest, mailTestActionHandler, registerSettingsRoutes, settingsBuiltinTranslations, settingsObjects, settingsPluginManifestHeader, en as settingsTranslationsEn, jaJP as settingsTranslationsJaJP, zhCN as settingsTranslationsZhCN, storageSettingsManifest, storageTestActionHandler };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _objectstack_spec_contracts from '@objectstack/spec/contracts';
-import { ICryptoProvider, IHttpRequest, IHttpServer } from '@objectstack/spec/contracts';
+import { ICryptoProvider, CryptoContext, CryptoHandle, IHttpRequest, IHttpServer } from '@objectstack/spec/contracts';
 import { SettingsActionResult, SpecifierScope, SettingsChangeHandler, SettingsUnsubscribe, SettingsManifest, ResolvedSettingValue, SettingsNamespacePayload, TranslationData, TranslationBundle } from '@objectstack/spec/system';
 export { ResolvedSettingValue, SettingsActionResult, SettingsManifest, SettingsNamespacePayload, SpecifierScope } from '@objectstack/spec/system';
 import { Plugin, PluginContext } from '@objectstack/core';
@@ -332,6 +332,20 @@ declare class SettingsService {
     private materialiseRow;
 }
 
+declare class InMemoryCryptoProvider implements ICryptoProvider {
+    private readonly key;
+    private readonly useNoble;
+    constructor(opts?: {
+        key?: Buffer;
+    });
+    encrypt(plain: string, ctx: CryptoContext): Promise<CryptoHandle>;
+    decrypt(handle: CryptoHandle, ctx: CryptoContext): Promise<string>;
+    rotateKey(handle: CryptoHandle, ctx: CryptoContext): Promise<CryptoHandle>;
+    digest(plain: string): string;
+    private encryptNode;
+    private aadOf;
+}
+
 /** Configuration options for the SettingsServicePlugin. */
 interface SettingsServicePluginOptions {
     /**
@@ -598,4 +612,4 @@ declare const jaJP: TranslationData;
 
 declare const settingsBuiltinTranslations: TranslationBundle;
 
-export { type CryptoAdapter, NoopCryptoAdapter, SETTINGS_PLUGIN_ID, SETTINGS_PLUGIN_VERSION, type SettingsActionHandler, type SettingsAuditSink, type SettingsContext, type SettingsEngine, SettingsLockedError, type SettingsRoutesOptions, type SettingsRow, SettingsService, type SettingsServiceOptions, SettingsServicePlugin, type SettingsServicePluginOptions, UnknownKeyError, UnknownNamespaceError, brandingSettingsManifest, builtinSettingsManifests, envKeyOf, featureFlagsSettingsManifest, mailSettingsManifest, mailTestActionHandler, registerSettingsRoutes, settingsBuiltinTranslations, settingsObjects, settingsPluginManifestHeader, en as settingsTranslationsEn, jaJP as settingsTranslationsJaJP, zhCN as settingsTranslationsZhCN, storageSettingsManifest, storageTestActionHandler };
+export { type CryptoAdapter, InMemoryCryptoProvider, NoopCryptoAdapter, SETTINGS_PLUGIN_ID, SETTINGS_PLUGIN_VERSION, type SettingsActionHandler, type SettingsAuditSink, type SettingsContext, type SettingsEngine, SettingsLockedError, type SettingsRoutesOptions, type SettingsRow, SettingsService, type SettingsServiceOptions, SettingsServicePlugin, type SettingsServicePluginOptions, UnknownKeyError, UnknownNamespaceError, brandingSettingsManifest, builtinSettingsManifests, envKeyOf, featureFlagsSettingsManifest, mailSettingsManifest, mailTestActionHandler, registerSettingsRoutes, settingsBuiltinTranslations, settingsObjects, settingsPluginManifestHeader, en as settingsTranslationsEn, jaJP as settingsTranslationsJaJP, zhCN as settingsTranslationsZhCN, storageSettingsManifest, storageTestActionHandler };

package/dist/index.js

@@ -2622,11 +2622,328 @@ var jaJP = {
   }
 };
 
+// src/translations/es-ES.ts
+var esES = {
+  settingsCommon: {
+    sourceLabels: {
+      env: "Entorno",
+      global: "Global",
+      tenant: "Inquilino",
+      user: "Usuario",
+      default: "Predeterminado"
+    }
+  },
+  settings: {
+    mail: {
+      title: "Env\xEDo de correo",
+      description: "Configuraci\xF3n de SMTP y del proveedor de correo transaccional.",
+      groups: {
+        provider: { title: "Proveedor", description: "Elige c\xF3mo env\xEDa correo saliente este espacio de trabajo." },
+        smtp: { title: "SMTP" },
+        api_key: { title: "Clave de API" },
+        from_address: { title: "Direcci\xF3n de remitente" }
+      },
+      keys: {
+        provider: {
+          label: "Proveedor",
+          options: {
+            smtp: "SMTP",
+            sendgrid: "SendGrid",
+            ses: "Amazon SES",
+            postmark: "Postmark"
+          }
+        },
+        smtp_host: { label: "Host", help: "Ejemplo: smtp.example.com" },
+        smtp_port: { label: "Puerto" },
+        smtp_secure: { label: "Usar TLS" },
+        smtp_user: { label: "Usuario" },
+        smtp_password: { label: "Contrase\xF1a" },
+        api_key: { label: "Clave de API" },
+        from_email: { label: "Correo del remitente", help: "Ejemplo: no-reply@example.com" },
+        from_name: { label: "Nombre del remitente" }
+      },
+      actions: {
+        test: { label: "Enviar correo de prueba" }
+      }
+    },
+    branding: {
+      title: "Marca",
+      description: "Nombre del espacio de trabajo, logotipo y color de acento.",
+      groups: {
+        identity: { title: "Identidad" },
+        appearance: { title: "Apariencia" }
+      },
+      keys: {
+        workspace_name: { label: "Nombre del espacio de trabajo" },
+        support_email: { label: "Correo de soporte", help: "Ejemplo: support@example.com" },
+        theme_mode: {
+          label: "Tema predeterminado",
+          options: { light: "Claro", dark: "Oscuro", system: "Seg\xFAn el sistema" }
+        },
+        accent_color: { label: "Color de acento" },
+        logo_url: { label: "URL del logotipo", help: "Ejemplo: https://\u2026/logo.svg" }
+      }
+    },
+    feature_flags: {
+      title: "Indicadores de funci\xF3n",
+      description: "Activa funciones experimentales y en beta para este espacio de trabajo.",
+      groups: {
+        productivity: { title: "Productividad" },
+        collaboration: { title: "Colaboraci\xF3n" }
+      },
+      keys: {
+        ai_enabled: {
+          label: "Asistente de IA",
+          help: "Habilita el panel del asistente de IA dentro de la aplicaci\xF3n."
+        },
+        kanban_swimlanes: { label: "Carriles de Kanban" },
+        realtime_cursors: { label: "Cursores en tiempo real" },
+        inline_comments: { label: "Comentarios en l\xEDnea" }
+      }
+    },
+    storage: {
+      title: "Almacenamiento de archivos",
+      description: "Backend usado para adjuntos, exportaciones y subidas de usuarios. \u26A0 Cambiar de adaptador no migra los archivos existentes: los archivos subidos con el adaptador anterior dejan de ser accesibles a trav\xE9s del nuevo.",
+      groups: {
+        adapter: { title: "Backend", description: "Elige d\xF3nde se almacenan los archivos subidos." },
+        local: { title: "Local" },
+        s3: { title: "S3" },
+        limits: { title: "L\xEDmites" }
+      },
+      keys: {
+        adapter: {
+          label: "Adaptador",
+          options: { local: "Sistema de archivos local", s3: "S3 / compatible con S3" }
+        },
+        local_root: {
+          label: "Directorio ra\xEDz",
+          help: "Ruta del sistema de archivos donde se almacenan los archivos. Las rutas relativas se resuelven desde el directorio de trabajo del servidor."
+        },
+        s3_bucket: {
+          label: "Bucket",
+          help: "Bucket compartido del host. Los archivos de cada entorno se a\xEDslan mediante el prefijo projects/<environmentId>/."
+        },
+        s3_region: { label: "Regi\xF3n", help: "Ejemplo: us-east-1" },
+        s3_endpoint: {
+          label: "Endpoint",
+          help: "Endpoint personalizado para proveedores compatibles con S3 (R2, MinIO, Wasabi). D\xE9jalo en blanco para AWS S3."
+        },
+        s3_access_key_id: { label: "Access Key ID" },
+        s3_secret_access_key: { label: "Secret Access Key" },
+        s3_force_path_style: {
+          label: "Forzar URLs de tipo path",
+          help: "Act\xEDvalo para MinIO y la mayor\xEDa de proveedores compatibles con S3; desact\xEDvalo para AWS S3."
+        },
+        presigned_ttl: { label: "TTL de URL prefirmada (segundos)" },
+        session_ttl: {
+          label: "TTL de sesi\xF3n de subida (segundos)",
+          help: "Tiempo durante el cual una sesi\xF3n de subida por fragmentos sigue siendo reanudable."
+        },
+        max_upload_mb: { label: "Tama\xF1o m\xE1ximo de subida (MB)" }
+      },
+      actions: {
+        test: { label: "Probar conexi\xF3n" }
+      }
+    },
+    ai: {
+      title: "IA y Embedder",
+      description: "Proveedor de LLM, modelo, credenciales y configuraci\xF3n del embedder usados por los servicios de IA y de conocimiento de la plataforma.",
+      groups: {
+        provider: {
+          title: "Proveedor",
+          description: "Elige el backend de LLM. El modo Memory repite la entrada: \xFAtil para pruebas, nunca para producci\xF3n."
+        },
+        gateway: {
+          title: "Vercel AI Gateway",
+          description: "Enrutador multiproveedor. La especificaci\xF3n del modelo sigue `provider/model`, p. ej. `openai/gpt-4o`."
+        },
+        openai: { title: "OpenAI" },
+        anthropic: { title: "Anthropic" },
+        google: { title: "Google" },
+        defaults: {
+          title: "Valores predeterminados de generaci\xF3n",
+          description: "Se aplican cuando un agente o una solicitud de chat no especifica su propio valor."
+        },
+        observability: { title: "Observabilidad" },
+        embedder: {
+          title: "Embedder",
+          description: "Proveedor de texto \u2192 vector usado por las fuentes de conocimiento y RAG. Independiente del proveedor de chat anterior."
+        }
+      },
+      keys: {
+        provider: {
+          label: "Proveedor",
+          options: {
+            memory: "Memory (eco \u2014 solo pruebas)",
+            gateway: "Vercel AI Gateway",
+            openai: "OpenAI",
+            anthropic: "Anthropic",
+            google: "Google Generative AI"
+          }
+        },
+        gateway_model: {
+          label: "Modelo de Gateway",
+          help: "Se reenv\xEDa como AI_GATEWAY_MODEL. Ejemplo: openai/gpt-4o"
+        },
+        gateway_api_key: {
+          label: "Clave de API de Gateway",
+          help: "Opcional: solo se requiere si el gateway exige autenticaci\xF3n."
+        },
+        openai_api_key: {
+          label: "Clave de API de OpenAI",
+          help: "Se reenv\xEDa como OPENAI_API_KEY. Se almacena cifrada en reposo."
+        },
+        openai_model: {
+          label: "Modelo",
+          help: "ID de modelo predeterminado. Las anulaciones por agente tienen prioridad."
+        },
+        openai_base_url: {
+          label: "Base URL",
+          help: "Anulaci\xF3n para Azure OpenAI o gateways autoalojados. D\xE9jalo en blanco para api.openai.com."
+        },
+        anthropic_api_key: {
+          label: "Clave de API de Anthropic",
+          help: "Se reenv\xEDa como ANTHROPIC_API_KEY. Se almacena cifrada en reposo."
+        },
+        anthropic_model: { label: "Modelo" },
+        google_api_key: {
+          label: "Clave de API de Google",
+          help: "Se reenv\xEDa como GOOGLE_GENERATIVE_AI_API_KEY. Se almacena cifrada en reposo."
+        },
+        google_model: { label: "Modelo" },
+        temperature: {
+          label: "Temperatura",
+          help: "0 = determinista, 2 = muy creativo."
+        },
+        max_tokens: {
+          label: "M\xE1ximo de tokens de salida",
+          help: "L\xEDmite estricto de tokens generados por respuesta."
+        },
+        request_timeout_ms: { label: "Tiempo de espera de la solicitud (ms)" },
+        trace_enabled: {
+          label: "Registrar trazas",
+          help: "Persiste las trazas de prompt/respuesta en sys_ai_trace para depuraci\xF3n y reproducci\xF3n."
+        },
+        log_prompts: {
+          label: "Registrar prompts completos",
+          help: "Incluye los prompts renderizados (no solo metadatos) en las filas de traza. \u26A0 Puede filtrar PII: desact\xEDvalo en entornos regulados."
+        },
+        embedder_provider: {
+          label: "Proveedor",
+          options: {
+            none: "Deshabilitado (sin embeddings)",
+            openai: "OpenAI",
+            azure: "Azure OpenAI",
+            dashscope: "\u963F\u91CC\u901A\u4E49 DashScope",
+            zhipu: "\u667A\u8C31 BigModel",
+            siliconflow: "\u7845\u57FA\u6D41\u52A8 SiliconFlow",
+            doubao: "\u706B\u5C71\u5F15\u64CE Doubao",
+            minimax: "MiniMax",
+            ollama: "Ollama (local)",
+            custom: "Personalizado (compatible con OpenAI)"
+          }
+        },
+        embedder_api_key: {
+          label: "Clave de API del embedder",
+          help: "Token bearer enviado en la cabecera Authorization. Para Ollama sirve cualquier valor no vac\xEDo."
+        },
+        embedder_model: {
+          label: "Modelo",
+          help: "Ejemplos \u2014 OpenAI: text-embedding-3-small \xB7 \u963F\u91CC\u901A\u4E49: text-embedding-v3 \xB7 \u667A\u8C31: embedding-3 \xB7 \u7845\u57FA\u6D41\u52A8: BAAI/bge-m3 \xB7 Ollama: bge-m3"
+        },
+        embedder_base_url: {
+          label: "Base URL",
+          help: "Ra\xEDz del endpoint (sin /embeddings). Se autocompleta desde el preset; an\xFAlalo para proxys o gateways autoalojados."
+        },
+        embedder_dimensions: {
+          label: "Dimensiones",
+          help: "Anula la dimensionalidad de salida (solo modelos Matryoshka). D\xE9jalo en blanco para usar el valor predeterminado del modelo."
+        },
+        embedder_batch_size: {
+          label: "Tama\xF1o de lote",
+          help: "Fragmentos por llamada a embed(). Red\xFAcelo si alcanzas los l\xEDmites de tasa o tama\xF1o del proveedor."
+        }
+      },
+      actions: {
+        test: { label: "Probar conexi\xF3n" },
+        test_embedder: { label: "Probar embedder" }
+      }
+    },
+    knowledge: {
+      title: "Conocimiento",
+      description: "Backend de almac\xE9n de vectores para RAG / fuentes de conocimiento. \u26A0 Cambiar de adaptador NO migra los \xEDndices existentes.",
+      groups: {
+        adapter: {
+          title: "Backend",
+          description: "Elige d\xF3nde se almacenan los fragmentos de documento y sus vectores."
+        },
+        turso: {
+          title: "Turso / libSQL",
+          description: "Funciona con Turso gestionado, archivo local o en memoria."
+        },
+        ragflow: {
+          title: "RAGFlow",
+          description: "Despliegue externo de RAGFlow. Consulta https://ragflow.io para instrucciones de autoalojamiento."
+        },
+        indexing: {
+          title: "Valores predeterminados de indexaci\xF3n",
+          description: "Los valores por fuente en KnowledgeSource.adapterConfig tienen prioridad."
+        },
+        permissions: { title: "Permisos" }
+      },
+      keys: {
+        adapter: {
+          label: "Adaptador",
+          options: {
+            memory: "En memoria (solo desarrollo / pruebas)",
+            turso: "Turso / libSQL (nube o local)",
+            ragflow: "RAGFlow (externo)"
+          }
+        },
+        turso_url: {
+          label: "URL de conexi\xF3n",
+          help: "Ejemplos: libsql://your-tenant.turso.io \xB7 file:./.objectstack/knowledge.db \xB7 :memory:"
+        },
+        turso_auth_token: {
+          label: "Token de autenticaci\xF3n",
+          help: "Solo se requiere para URLs de Turso gestionado."
+        },
+        ragflow_base_url: { label: "Base URL", help: "Ejemplo: http://localhost:9380" },
+        ragflow_api_key: { label: "Clave de API" },
+        ragflow_default_dataset: {
+          label: "ID de dataset predeterminado",
+          help: "Se usa cuando una KnowledgeSource no especifica su propio dataset de RAGFlow."
+        },
+        chunk_target: {
+          label: "Tama\xF1o objetivo de fragmento (caracteres)",
+          help: "L\xEDmite flexible del tama\xF1o de fragmento antes de que act\xFAe la divisi\xF3n consciente de tokens."
+        },
+        chunk_overlap: {
+          label: "Solapamiento de fragmentos (caracteres)",
+          help: "Caracteres conservados del fragmento anterior para que el contexto sobreviva al l\xEDmite."
+        },
+        over_fetch: {
+          label: "Multiplicador de sobre-obtenci\xF3n",
+          help: "Se obtienen topK \xD7 overFetch candidatos internos para que el filtrado de metadatos en JS siga teniendo filas."
+        },
+        enforce_rls: {
+          label: "Aplicar RLS en la b\xFAsqueda",
+          help: "Vuelve a comprobar cada resultado contra los permisos a nivel de registro del solicitante. \u26A0 Desactivarlo omite la salvaguarda exclusiva de la plataforma."
+        }
+      },
+      actions: {
+        test: { label: "Probar conexi\xF3n" }
+      }
+    }
+  }
+};
+
 // src/translations/index.ts
 var settingsBuiltinTranslations = {
   en,
   "zh-CN": zhCN,
-  "ja-JP": jaJP
+  "ja-JP": jaJP,
+  "es-ES": esES
 };
 
 // src/settings-service-plugin.ts
@@ -2841,6 +3158,7 @@ function wrapEngineAsSettingsEngine(engine) {
   };
 }
 export {
+  InMemoryCryptoProvider,
   NoopCryptoAdapter,
   SETTINGS_PLUGIN_ID,
   SETTINGS_PLUGIN_VERSION,