@qcobro/common 1.11.3 → 1.11.4

package/dist/config.d.ts

@@ -0,0 +1,307 @@
+import { z } from "zod";
+/**
+ * QCobro service configuration — the shape of `qcobro.json`.
+ *
+ * This module exports the schema/type only (no filesystem access) so it stays
+ * safe to import from the browser. Server packages load the file and call
+ * `qcobroConfigSchema.parse(...)`.
+ *
+ * Identity runs as an external Fonoster Identity service; QCobro only needs the
+ * endpoint to reach it. All Identity service configuration (database, keys,
+ * issuer, SMTP, …) lives with that service, not here.
+ */
+export declare const identityConfigSchema: z.ZodObject<{
+    endpoint: z.ZodDefault<z.ZodString>;
+    httpBridgeUrl: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * A selectable voice in the deployment's catalog. Voice agent templates pick a
+ * voice by `id` (the provider's voice identifier, e.g. an ElevenLabs voice id);
+ * the console renders the picker from this catalog rather than free text.
+ */
+export declare const voiceCatalogEntrySchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    language: z.ZodString;
+    gender: z.ZodEnum<{
+        female: "female";
+        male: "male";
+    }>;
+    provider: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export type VoiceCatalogEntry = z.infer<typeof voiceCatalogEntrySchema>;
+/**
+ * Fonoster connection + Autopilot defaults. VOICE_AI agent templates are synced to
+ * Fonoster as AUTOPILOT applications; the apiserver authenticates with a workspace
+ * access key + API key/secret. Optional — when absent, voice templates save locally
+ * and stay unsynced (the console offers a manual re-sync).
+ */
+export declare const fonosterConfigSchema: z.ZodOptional<z.ZodObject<{
+    accessKeyId: z.ZodString;
+    apiKey: z.ZodString;
+    apiSecret: z.ZodString;
+    endpoint: z.ZodOptional<z.ZodString>;
+    autopilot: z.ZodDefault<z.ZodObject<{
+        sttProductRef: z.ZodDefault<z.ZodString>;
+        sttModel: z.ZodDefault<z.ZodString>;
+        llmProductRef: z.ZodDefault<z.ZodString>;
+        llmProvider: z.ZodDefault<z.ZodString>;
+        llmModel: z.ZodDefault<z.ZodString>;
+        maxTokens: z.ZodDefault<z.ZodNumber>;
+        temperature: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    voices: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        language: z.ZodString;
+        gender: z.ZodEnum<{
+            female: "female";
+            male: "male";
+        }>;
+        provider: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>>>;
+    numbers: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    prerecordedAppRef: z.ZodOptional<z.ZodString>;
+    webhookBaseUrl: z.ZodOptional<z.ZodString>;
+    maxCallsPerMinute: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>>;
+export type FonosterConfig = z.infer<typeof fonosterConfigSchema>;
+/**
+ * Derives the TTS product ref for a voice from its provider (e.g. an `elevenlabs`
+ * voice → `tts.elevenlabs`). Used by both Voz IA (Autopilot) and pre-recorded
+ * voice. Falls back to `tts.elevenlabs` when the voice isn't in the catalog.
+ */
+export declare function ttsProductRefForVoice(voiceId: string, voices: VoiceCatalogEntry[]): string;
+/**
+ * Twilio connection for SMS dispatch. Optional — when absent, SMS dispatch fails
+ * with a clear error. `fromNumbers` (E.164) are rotated through per message.
+ */
+export declare const twilioConfigSchema: z.ZodOptional<z.ZodObject<{
+    accountSid: z.ZodString;
+    authToken: z.ZodString;
+    fromNumbers: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    maxSmsPerMinute: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>>;
+export type TwilioConfig = z.infer<typeof twilioConfigSchema>;
+/**
+ * Resend connection for the bidirectional EMAIL channel. Optional — when absent, EMAIL
+ * dispatch is inert (the engine reports EMAIL campaigns as not-configured) and the inbound
+ * webhook rejects everything. Outbound uses `apiKey` + `fromEmail`/`fromName`; inbound
+ * replies arrive at `reply+<token>@<inboundDomain>` and are verified with
+ * `inboundSigningSecret`. The per-attempt reply cap defaults to `maxRepliesDefault`.
+ */
+export declare const resendConfigSchema: z.ZodOptional<z.ZodObject<{
+    apiKey: z.ZodString;
+    fromEmail: z.ZodString;
+    fromName: z.ZodOptional<z.ZodString>;
+    inboundDomain: z.ZodString;
+    inboundSigningSecret: z.ZodOptional<z.ZodString>;
+    maxEmailsPerMinute: z.ZodDefault<z.ZodNumber>;
+    maxRepliesDefault: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>>;
+export type ResendConfig = z.infer<typeof resendConfigSchema>;
+/**
+ * AI-insight generation. Produces a gestión's structured analysis from its
+ * conversation transcript. Optional — when absent or `enabled:false`, no LLM is
+ * called and gestiones keep their unanalyzed / generic-insight state.
+ *
+ * Providers mirror the Fonoster autopilot / Mikro vendor set, reached over each
+ * vendor's REST API (no SDK dependency). `mock` is an offline provider that
+ * synthesizes a deterministic analysis from the transcript — for local dev,
+ * demos, and tests, with no key and no network/cost.
+ */
+export declare const aiProviderSchema: z.ZodEnum<{
+    google: "google";
+    mock: "mock";
+    openai: "openai";
+    anthropic: "anthropic";
+}>;
+export type AiProvider = z.infer<typeof aiProviderSchema>;
+/** Valid models per provider; used to reject misconfiguration at load. */
+export declare const AI_MODELS: Record<AiProvider, string[]>;
+export declare const aiConfigSchema: z.ZodOptional<z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    provider: z.ZodDefault<z.ZodEnum<{
+        google: "google";
+        mock: "mock";
+        openai: "openai";
+        anthropic: "anthropic";
+    }>>;
+    apiKey: z.ZodOptional<z.ZodString>;
+    model: z.ZodDefault<z.ZodString>;
+    temperature: z.ZodDefault<z.ZodNumber>;
+    maxTokens: z.ZodDefault<z.ZodNumber>;
+    generation: z.ZodDefault<z.ZodEnum<{
+        onDemand: "onDemand";
+        onIngestion: "onIngestion";
+    }>>;
+}, z.core.$strip>>;
+export type AiConfig = z.infer<typeof aiConfigSchema>;
+/**
+ * Text-to-speech for previewing pre-recorded agent scripts in the console (the
+ * Pre-grabada gestión detail plays the script as audio). Optional — when absent, the
+ * apiKey falls back to `ELEVENLABS_API_KEY`, and if no key resolves the player is simply
+ * unavailable. Voices come from `fonoster.voices`.
+ */
+export declare const ttsConfigSchema: z.ZodOptional<z.ZodObject<{
+    provider: z.ZodDefault<z.ZodLiteral<"elevenlabs">>;
+    apiKey: z.ZodOptional<z.ZodString>;
+    model: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>>;
+export type TtsConfig = z.infer<typeof ttsConfigSchema>;
+/**
+ * A piece of user-facing copy that may be localized. Either a single string
+ * (same text for every language) or a map of language code → string
+ * (e.g. `{ "en": "Early access", "es": "Acceso temprano" }`). The console
+ * resolves it against the active UI language, falling back to any available value.
+ */
+export declare const localizedStringSchema: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
+export type LocalizedString = z.infer<typeof localizedStringSchema>;
+/**
+ * A deployment-wide announcement rendered as a dismissible banner across the
+ * console (and the workspace picker). Optional — when absent, no banner shows.
+ *
+ * `variant` selects the color scheme and `icon` the leading glyph, so a
+ * deployment can style it as a neutral announcement, an amber alert, etc.
+ * `title` and `message` are localizable (see {@link localizedStringSchema}).
+ */
+export declare const announcementConfigSchema: z.ZodOptional<z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    variant: z.ZodDefault<z.ZodEnum<{
+        success: "success";
+        announcement: "announcement";
+        alert: "alert";
+        danger: "danger";
+    }>>;
+    icon: z.ZodDefault<z.ZodEnum<{
+        megaphone: "megaphone";
+        info: "info";
+        "alert-triangle": "alert-triangle";
+        sparkles: "sparkles";
+        rocket: "rocket";
+        bell: "bell";
+    }>>;
+    dismissible: z.ZodDefault<z.ZodBoolean>;
+    title: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
+    message: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
+}, z.core.$strip>>;
+export type AnnouncementConfig = z.infer<typeof announcementConfigSchema>;
+export declare const qcobroConfigSchema: z.ZodObject<{
+    database: z.ZodObject<{
+        url: z.ZodString;
+    }, z.core.$strip>;
+    identity: z.ZodObject<{
+        endpoint: z.ZodDefault<z.ZodString>;
+        httpBridgeUrl: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>;
+    apiserver: z.ZodDefault<z.ZodObject<{
+        port: z.ZodDefault<z.ZodNumber>;
+        voicePort: z.ZodDefault<z.ZodNumber>;
+        contactLogAuth: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    fonoster: z.ZodOptional<z.ZodObject<{
+        accessKeyId: z.ZodString;
+        apiKey: z.ZodString;
+        apiSecret: z.ZodString;
+        endpoint: z.ZodOptional<z.ZodString>;
+        autopilot: z.ZodDefault<z.ZodObject<{
+            sttProductRef: z.ZodDefault<z.ZodString>;
+            sttModel: z.ZodDefault<z.ZodString>;
+            llmProductRef: z.ZodDefault<z.ZodString>;
+            llmProvider: z.ZodDefault<z.ZodString>;
+            llmModel: z.ZodDefault<z.ZodString>;
+            maxTokens: z.ZodDefault<z.ZodNumber>;
+            temperature: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+        voices: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            language: z.ZodString;
+            gender: z.ZodEnum<{
+                female: "female";
+                male: "male";
+            }>;
+            provider: z.ZodDefault<z.ZodString>;
+        }, z.core.$strip>>>;
+        numbers: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        prerecordedAppRef: z.ZodOptional<z.ZodString>;
+        webhookBaseUrl: z.ZodOptional<z.ZodString>;
+        maxCallsPerMinute: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    twilio: z.ZodOptional<z.ZodObject<{
+        accountSid: z.ZodString;
+        authToken: z.ZodString;
+        fromNumbers: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        maxSmsPerMinute: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    resend: z.ZodOptional<z.ZodObject<{
+        apiKey: z.ZodString;
+        fromEmail: z.ZodString;
+        fromName: z.ZodOptional<z.ZodString>;
+        inboundDomain: z.ZodString;
+        inboundSigningSecret: z.ZodOptional<z.ZodString>;
+        maxEmailsPerMinute: z.ZodDefault<z.ZodNumber>;
+        maxRepliesDefault: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    ai: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        provider: z.ZodDefault<z.ZodEnum<{
+            google: "google";
+            mock: "mock";
+            openai: "openai";
+            anthropic: "anthropic";
+        }>>;
+        apiKey: z.ZodOptional<z.ZodString>;
+        model: z.ZodDefault<z.ZodString>;
+        temperature: z.ZodDefault<z.ZodNumber>;
+        maxTokens: z.ZodDefault<z.ZodNumber>;
+        generation: z.ZodDefault<z.ZodEnum<{
+            onDemand: "onDemand";
+            onIngestion: "onIngestion";
+        }>>;
+    }, z.core.$strip>>;
+    tts: z.ZodOptional<z.ZodObject<{
+        provider: z.ZodDefault<z.ZodLiteral<"elevenlabs">>;
+        apiKey: z.ZodOptional<z.ZodString>;
+        model: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>>;
+    announcement: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        variant: z.ZodDefault<z.ZodEnum<{
+            success: "success";
+            announcement: "announcement";
+            alert: "alert";
+            danger: "danger";
+        }>>;
+        icon: z.ZodDefault<z.ZodEnum<{
+            megaphone: "megaphone";
+            info: "info";
+            "alert-triangle": "alert-triangle";
+            sparkles: "sparkles";
+            rocket: "rocket";
+            bell: "bell";
+        }>>;
+        dismissible: z.ZodDefault<z.ZodBoolean>;
+        title: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
+        message: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
+    }, z.core.$strip>>;
+    security: z.ZodOptional<z.ZodObject<{
+        cloakEncryptionKey: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    whatsapp: z.ZodDefault<z.ZodObject<{
+        apiBaseUrl: z.ZodDefault<z.ZodString>;
+        apiVersion: z.ZodDefault<z.ZodString>;
+        maxMessagesPerMinute: z.ZodDefault<z.ZodNumber>;
+        appSecret: z.ZodOptional<z.ZodString>;
+        maxRepliesDefault: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    engine: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        tickSeconds: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type IdentityConfig = z.infer<typeof identityConfigSchema>;
+export type QCobroConfig = z.infer<typeof qcobroConfigSchema>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB;;;iBAK/B,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;iBAMlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAkEpB,CAAC;AAEd,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAG1F;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;kBAYlB,CAAC;AAEd,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;kBAqBlB,CAAC;AAEd,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB;;;;;EAAoD,CAAC;AAClF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,0EAA0E;AAC1E,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,CAKlD,CAAC;AAEF,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;kBAwBd,CAAC;AAEd,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,eAAe;;;;kBAMf,CAAC;AAEd,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,2EAGhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;kBAcxB,CAAC;AAEd,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8E7B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}