@qcobro/common 1.11.3 → 1.12.0

package/src/types/voiceApplication.ts

@@ -1,29 +0,0 @@
-/**
- * Port for syncing VOICE_AI agent templates to an external voice-application
- * provider (Fonoster Autopilot). Kept provider-agnostic so service functions
- * depend on this interface and tests inject a stub — no live SDK in unit tests.
- */
-
-/** Domain-level inputs the engine needs to (re)build a voice application. */
-export interface VoiceApplicationInput {
-  /** Application name (maps to VoiceAiConfig.fonosterAppName). */
-  name: string;
-  /** Provider voice id (e.g. an ElevenLabs voice id). */
-  voice: string;
-  /** The AI agent's persona/instructions. */
-  systemPrompt: string;
-  /** The opening line spoken to the contact; optional — falls back to the autopilot
-   * template's default greeting when the agent has no scripted first message. */
-  firstMessage?: string;
-  /** Language code (e.g. `es`, `en`). */
-  language: string;
-}
-
-export interface VoiceApplicationClient {
-  /** Create the remote application; resolves with its provider ref. */
-  createApplication(input: VoiceApplicationInput): Promise<{ ref: string }>;
-  /** Update an existing remote application by ref. */
-  updateApplication(ref: string, input: VoiceApplicationInput): Promise<{ ref: string }>;
-  /** Delete the remote application by ref (best-effort cleanup). */
-  deleteApplication(ref: string): Promise<void>;
-}

package/src/types/whatsApp.ts

@@ -1,82 +0,0 @@
-import type { WhatsAppCapabilities } from "../schemas/whatsApp.js";
-
-/** One message in a WhatsApp conversation thread. */
-export interface WhatsAppThreadMessage {
-  direction: "outbound" | "inbound";
-  /** "agent" for outbound; the customer's E.164 number for inbound. */
-  from: string;
-  at: string;
-  body: string;
-  metaMessageId?: string;
-}
-
-/** The per-gestión WhatsApp conversation thread stored in `channelData.whatsAppThread`. */
-export interface WhatsAppThread {
-  customerPhone: string;
-  messages: WhatsAppThreadMessage[];
-  agentReplyCount: number;
-  /** ISO timestamp of the customer's last inbound message — drives the 24 h window check. */
-  lastCustomerMessageAt: string;
-}
-
-/**
- * DB record + client surfaces for the per-workspace WhatsApp integration. The
- * `accessToken` is encrypted at rest (cloak) and MUST NOT be returned to clients —
- * read procedures project to {@link WhatsAppIntegrationView}.
- */
-export interface WhatsAppIntegrationRecord {
-  id: string;
-  workspaceRef: string;
-  wabaId: string;
-  /** Tenant secret — encrypted at rest; never serialized to the client. */
-  accessToken: string;
-  verifyToken: string;
-  /** Meta template-send language for this workspace (e.g. `es_DO`). */
-  defaultLanguage: string;
-  createdAt: Date;
-  updatedAt: Date;
-}
-
-/** Client-safe projection of the integration (no secret). */
-export interface WhatsAppIntegrationView {
-  connected: boolean;
-  wabaId: string;
-  verifyToken: string;
-  defaultLanguage: string;
-}
-
-export interface WhatsAppSenderNumberRecord {
-  id: string;
-  workspaceRef: string;
-  phoneNumberId: string;
-  displayNumber: string;
-  label: string;
-  /** Cached from Meta quality callbacks: GREEN | YELLOW | RED | null (unknown). */
-  qualityRating: string | null;
-  capabilities: WhatsAppCapabilities;
-  createdAt: Date;
-  updatedAt: Date;
-}
-
-/** The DB surface the WhatsApp integration functions need (tests inject a stub). */
-export interface WhatsAppIntegrationClient {
-  whatsAppIntegration: {
-    findUnique(args: {
-      where: { workspaceRef: string };
-    }): Promise<WhatsAppIntegrationRecord | null>;
-    findFirst(args: { where: { verifyToken: string } }): Promise<WhatsAppIntegrationRecord | null>;
-    upsert(args: {
-      where: { workspaceRef: string };
-      create: Record<string, unknown>;
-      update: Record<string, unknown>;
-    }): Promise<WhatsAppIntegrationRecord>;
-  };
-  whatsAppSenderNumber: {
-    findUnique(args: {
-      where: { phoneNumberId: string };
-    }): Promise<WhatsAppSenderNumberRecord | null>;
-    findMany(args: { where: { workspaceRef: string } }): Promise<WhatsAppSenderNumberRecord[]>;
-    create(args: { data: Record<string, unknown> }): Promise<WhatsAppSenderNumberRecord>;
-    delete(args: { where: { phoneNumberId: string } }): Promise<WhatsAppSenderNumberRecord>;
-  };
-}

package/src/types/workspaceSettings.ts

@@ -1,22 +0,0 @@
-import type { Currency } from "../schemas/workspaceSettings.js";
-
-export interface WorkspaceSettingsRecord {
-  workspaceRef: string;
-  currency: Currency;
-  timezone: string;
-  createdAt: Date;
-  updatedAt: Date;
-}
-
-/** The DB surface the workspace-settings functions need (tests inject a stub). */
-export interface WorkspaceSettingsClient {
-  workspaceSettings: {
-    findUnique(args: { where: { workspaceRef: string } }): Promise<WorkspaceSettingsRecord | null>;
-
-    upsert(args: {
-      where: { workspaceRef: string };
-      create: Record<string, unknown>;
-      update: Record<string, unknown>;
-    }): Promise<WorkspaceSettingsRecord>;
-  };
-}

package/src/utils/index.ts

@@ -1,14 +0,0 @@
-export { withErrorHandlingAndValidation } from "./withErrorHandlingAndValidation.js";
-export {
-  renderTemplate,
-  extractTemplateTokens,
-  buildOutreachContext,
-  pickRandomNumber
-} from "./outreach.js";
-export {
-  localParts,
-  localDateString,
-  isSameLocalDay,
-  localWeekdayISO,
-  localTimeHHMM
-} from "./time.js";

package/src/utils/outreach.test.ts

@@ -1,83 +0,0 @@
-import { describe, it } from "node:test";
-import assert from "node:assert/strict";
-import { renderTemplate, buildOutreachContext, pickRandomNumber } from "./outreach.js";
-import type { PortfolioAccountRecord } from "../types/portfolios.js";
-
-function makeAccount(overrides: Partial<PortfolioAccountRecord> = {}): PortfolioAccountRecord {
-  return {
-    id: "acc-1",
-    portfolioId: "pf-1",
-    externalId: "EXT-1",
-    fullName: "María López",
-    phone: "+50670000000",
-    preferredLanguage: "es",
-    bestTimeToCall: null,
-    customerSegment: null,
-    principalAmount: 1000,
-    termsAmount: 0,
-    termsFrequency: null,
-    termsLength: 0,
-    outstandingBalance: 1500,
-    daysPastDue: 30,
-    missedInstallments: 2,
-    lastPaymentDate: null,
-    lastPaymentAmount: null,
-    negotiationOptions: null,
-    archivedAt: null,
-    createdAt: new Date(),
-    updatedAt: new Date(),
-    ...overrides
-  };
-}
-
-describe("renderTemplate + buildOutreachContext", () => {
-  it("personalizes a body with account data and derived fields", () => {
-    const ctx = buildOutreachContext(makeAccount(), { currency: "CRC" });
-    const out = renderTemplate(
-      "Hola {{firstName}}, su saldo es {{outstandingBalance}} {{currency}}",
-      ctx
-    );
-    assert.equal(out, "Hola María, su saldo es 1500 CRC");
-  });
-
-  it("renders a missing field as empty without throwing", () => {
-    const ctx = buildOutreachContext(makeAccount(), { currency: "CRC" });
-    const out = renderTemplate("Hola {{firstName}} {{unknownField}}!", ctx);
-    assert.equal(out, "Hola María !");
-  });
-
-  it("derives firstName from the first token of fullName", () => {
-    const ctx = buildOutreachContext(makeAccount({ fullName: "Juan Carlos Pérez" }), {
-      currency: "USD"
-    });
-    assert.equal(ctx.firstName, "Juan");
-  });
-
-  it("derives isDue from daysPastDue", () => {
-    const overdue = buildOutreachContext(makeAccount({ daysPastDue: 30 }), { currency: "CRC" });
-    const current = buildOutreachContext(makeAccount({ daysPastDue: 0 }), { currency: "CRC" });
-    assert.equal(overdue.isDue, true);
-    assert.equal(current.isDue, false);
-  });
-
-  it("branches a template on the isDue conditional", () => {
-    const tpl = "{{#if isDue}}Su pago está vencido{{else}}Gracias por estar al día{{/if}}";
-    const overdue = renderTemplate(
-      tpl,
-      buildOutreachContext(makeAccount({ daysPastDue: 5 }), { currency: "CRC" })
-    );
-    const current = renderTemplate(
-      tpl,
-      buildOutreachContext(makeAccount({ daysPastDue: 0 }), { currency: "CRC" })
-    );
-    assert.equal(overdue, "Su pago está vencido");
-    assert.equal(current, "Gracias por estar al día");
-  });
-});
-
-describe("pickRandomNumber", () => {
-  it("returns a number from the pool", () => {
-    const pool = ["+1", "+2", "+3"];
-    assert.ok(pool.includes(pickRandomNumber(pool)));
-  });
-});

package/src/utils/time.ts

@@ -1,66 +0,0 @@
-/**
- * Timezone-aware wall-clock helpers. The campaigns engine evaluates schedule
- * windows and daily caps in the deployment timezone (from `qcobro.json`), not UTC.
- * All functions take an IANA timezone string and use `Intl` so DST is handled.
- */
-
-interface LocalParts {
-  /** Local calendar date as `YYYY-MM-DD`. */
-  date: string;
-  /** ISO weekday: 1 = Monday … 7 = Sunday. */
-  weekday: number;
-  /** Local time as `HH:MM` (24h, zero-padded). */
-  time: string;
-}
-
-const WEEKDAY_TO_ISO: Record<string, number> = {
-  Mon: 1,
-  Tue: 2,
-  Wed: 3,
-  Thu: 4,
-  Fri: 5,
-  Sat: 6,
-  Sun: 7
-};
-
-/** Decompose an instant into local date/weekday/time parts for the given timezone. */
-export function localParts(date: Date, timeZone: string): LocalParts {
-  const fmt = new Intl.DateTimeFormat("en-US", {
-    timeZone,
-    weekday: "short",
-    year: "numeric",
-    month: "2-digit",
-    day: "2-digit",
-    hour: "2-digit",
-    minute: "2-digit",
-    hour12: false
-  });
-  const parts = Object.fromEntries(fmt.formatToParts(date).map((p) => [p.type, p.value]));
-  // `hour` can come back as "24" at midnight under hour12:false; normalize to "00".
-  const hour = parts.hour === "24" ? "00" : parts.hour;
-  return {
-    date: `${parts.year}-${parts.month}-${parts.day}`,
-    weekday: WEEKDAY_TO_ISO[parts.weekday] ?? 0,
-    time: `${hour}:${parts.minute}`
-  };
-}
-
-/** Local calendar date (`YYYY-MM-DD`) for an instant in the given timezone. */
-export function localDateString(date: Date, timeZone: string): string {
-  return localParts(date, timeZone).date;
-}
-
-/** True when two instants fall on the same local calendar day in the timezone. */
-export function isSameLocalDay(a: Date, b: Date, timeZone: string): boolean {
-  return localDateString(a, timeZone) === localDateString(b, timeZone);
-}
-
-/** ISO weekday (1=Mon … 7=Sun) for an instant in the timezone. */
-export function localWeekdayISO(date: Date, timeZone: string): number {
-  return localParts(date, timeZone).weekday;
-}
-
-/** Local `HH:MM` (24h) for an instant in the timezone. */
-export function localTimeHHMM(date: Date, timeZone: string): string {
-  return localParts(date, timeZone).time;
-}

package/src/utils/withErrorHandlingAndValidation.test.ts

@@ -1,33 +0,0 @@
-import { describe, it } from "node:test";
-import assert from "node:assert/strict";
-import { z } from "zod";
-import { withErrorHandlingAndValidation } from "./withErrorHandlingAndValidation.js";
-import { ValidationError } from "../errors/ValidationError.js";
-
-const schema = z.object({ name: z.string().min(1) });
-
-describe("withErrorHandlingAndValidation", () => {
-  it("passes parsed, typed input to the wrapped function and returns its result", async () => {
-    let received: { name: string } | null = null;
-    const wrapped = withErrorHandlingAndValidation(async (params: { name: string }) => {
-      received = params;
-      return `hello ${params.name}`;
-    }, schema);
-
-    const result = await wrapped({ name: "Ada" });
-
-    assert.equal(result, "hello Ada");
-    assert.deepEqual(received, { name: "Ada" });
-  });
-
-  it("throws ValidationError and never calls the inner function on invalid input", async () => {
-    let called = false;
-    const wrapped = withErrorHandlingAndValidation(async (params: { name: string }) => {
-      called = true;
-      return params.name;
-    }, schema);
-
-    await assert.rejects(() => wrapped({ name: "" }), ValidationError);
-    assert.equal(called, false);
-  });
-});

package/tsconfig.json

@@ -1,9 +0,0 @@
-{
-  "extends": "../../tsconfig.json",
-  "compilerOptions": {
-    "outDir": "dist",
-    "rootDir": "src"
-  },
-  "include": ["src"],
-  "exclude": ["src/**/*.test.ts"]
-}