@qcobro/common 1.11.3 → 1.11.4

package/{src/utils/outreach.ts → dist/utils/outreach.d.ts}

@@ -1,18 +1,12 @@
-import Handlebars from "handlebars";
 import type { PortfolioAccountRecord } from "../types/portfolios.js";
 import type { NumberSelector } from "../types/dispatch.js";
-
 /**
  * Renders a Handlebars template against a context. Bodies are plain text (voice
  * script / SMS), never HTML, so escaping is disabled. A missing `{{field}}`
  * renders as empty rather than throwing, so a sparse account never aborts a
  * dispatch mid-flight.
  */
-export function renderTemplate(template: string, context: Record<string, unknown>): string {
-  const compiled = Handlebars.compile(template, { noEscape: true });
-  return compiled(context);
-}
-
+export declare function renderTemplate(template: string, context: Record<string, unknown>): string;
 /**
  * Extracts the distinct simple placeholder names from a template, in first-seen order
  * (e.g. `"Hola {{firstName}}, saldo {{outstandingBalance}}"` → `["firstName",
@@ -20,16 +14,7 @@ export function renderTemplate(template: string, context: Record<string, unknown
  * turn a WhatsApp template body into Meta **named** parameters: each token becomes a
  * `{ parameter_name, text }` pair rendered against the customer context.
  */
-export function extractTemplateTokens(template: string): string[] {
-  const tokens: string[] = [];
-  const re = /\{\{\s*([A-Za-z_][\w.]*)\s*\}\}/g;
-  let match: RegExpExecArray | null;
-  while ((match = re.exec(template)) !== null) {
-    if (!tokens.includes(match[1])) tokens.push(match[1]);
-  }
-  return tokens;
-}
-
+export declare function extractTemplateTokens(template: string): string[];
 /**
  * Builds the render context exposed to outreach templates: every account field
  * plus derived `firstName` (first token of `fullName`), `currency` (the
@@ -39,19 +24,9 @@ export function extractTemplateTokens(template: string): string[] {
  * `{{#if isDue}}su pago está vencido{{else}}gracias por estar al día{{/if}}`.
  * These are the variables documented in the agent console.
  */
-export function buildOutreachContext(
-  account: PortfolioAccountRecord,
-  opts: { currency: string }
-): Record<string, unknown> {
-  const firstName = account.fullName.trim().split(/\s+/)[0] ?? "";
-  return {
-    ...account,
-    firstName,
-    currency: opts.currency,
-    isDue: account.daysPastDue > 0
-  };
-}
-
+export declare function buildOutreachContext(account: PortfolioAccountRecord, opts: {
+    currency: string;
+}): Record<string, unknown>;
 /** Default number selector: a uniform random pick from the pool. */
-export const pickRandomNumber: NumberSelector = (numbers) =>
-  numbers[Math.floor(Math.random() * numbers.length)];
+export declare const pickRandomNumber: NumberSelector;
+//# sourceMappingURL=outreach.d.ts.map

package/dist/utils/outreach.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outreach.d.ts","sourceRoot":"","sources":["../../src/utils/outreach.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAGzF;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAQhE;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,sBAAsB,EAC/B,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GACzB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzB;AAED,oEAAoE;AACpE,eAAO,MAAM,gBAAgB,EAAE,cACsB,CAAC"}

package/dist/utils/outreach.js

@@ -0,0 +1,49 @@
+import Handlebars from "handlebars";
+/**
+ * Renders a Handlebars template against a context. Bodies are plain text (voice
+ * script / SMS), never HTML, so escaping is disabled. A missing `{{field}}`
+ * renders as empty rather than throwing, so a sparse account never aborts a
+ * dispatch mid-flight.
+ */
+export function renderTemplate(template, context) {
+    const compiled = Handlebars.compile(template, { noEscape: true });
+    return compiled(context);
+}
+/**
+ * Extracts the distinct simple placeholder names from a template, in first-seen order
+ * (e.g. `"Hola {{firstName}}, saldo {{outstandingBalance}}"` → `["firstName",
+ * "outstandingBalance"]`). Block helpers like `{{#if}}`/`{{/if}}` are ignored. Used to
+ * turn a WhatsApp template body into Meta **named** parameters: each token becomes a
+ * `{ parameter_name, text }` pair rendered against the customer context.
+ */
+export function extractTemplateTokens(template) {
+    const tokens = [];
+    const re = /\{\{\s*([A-Za-z_][\w.]*)\s*\}\}/g;
+    let match;
+    while ((match = re.exec(template)) !== null) {
+        if (!tokens.includes(match[1]))
+            tokens.push(match[1]);
+    }
+    return tokens;
+}
+/**
+ * Builds the render context exposed to outreach templates: every account field
+ * plus derived `firstName` (first token of `fullName`), `currency` (the
+ * workspace's currency from WorkspaceSettings), and `isDue` (whether the account
+ * is past due, i.e. `daysPastDue > 0`). `isDue` is a boolean so templates can
+ * branch on it with Handlebars conditionals, e.g.
+ * `{{#if isDue}}su pago está vencido{{else}}gracias por estar al día{{/if}}`.
+ * These are the variables documented in the agent console.
+ */
+export function buildOutreachContext(account, opts) {
+    const firstName = account.fullName.trim().split(/\s+/)[0] ?? "";
+    return {
+        ...account,
+        firstName,
+        currency: opts.currency,
+        isDue: account.daysPastDue > 0
+    };
+}
+/** Default number selector: a uniform random pick from the pool. */
+export const pickRandomNumber = (numbers) => numbers[Math.floor(Math.random() * numbers.length)];
+//# sourceMappingURL=outreach.js.map

package/dist/utils/outreach.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outreach.js","sourceRoot":"","sources":["../../src/utils/outreach.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,YAAY,CAAC;AAIpC;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB,EAAE,OAAgC;IAC/E,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAClE,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC3B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAgB;IACpD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,EAAE,GAAG,kCAAkC,CAAC;IAC9C,IAAI,KAA6B,CAAC;IAClC,OAAO,CAAC,KAAK,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC5C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAA+B,EAC/B,IAA0B;IAE1B,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAChE,OAAO;QACL,GAAG,OAAO;QACV,SAAS;QACT,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,KAAK,EAAE,OAAO,CAAC,WAAW,GAAG,CAAC;KAC/B,CAAC;AACJ,CAAC;AAED,oEAAoE;AACpE,MAAM,CAAC,MAAM,gBAAgB,GAAmB,CAAC,OAAO,EAAE,EAAE,CAC1D,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC"}

package/dist/utils/time.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 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;
+}
+/** Decompose an instant into local date/weekday/time parts for the given timezone. */
+export declare function localParts(date: Date, timeZone: string): LocalParts;
+/** Local calendar date (`YYYY-MM-DD`) for an instant in the given timezone. */
+export declare function localDateString(date: Date, timeZone: string): string;
+/** True when two instants fall on the same local calendar day in the timezone. */
+export declare function isSameLocalDay(a: Date, b: Date, timeZone: string): boolean;
+/** ISO weekday (1=Mon … 7=Sun) for an instant in the timezone. */
+export declare function localWeekdayISO(date: Date, timeZone: string): number;
+/** Local `HH:MM` (24h) for an instant in the timezone. */
+export declare function localTimeHHMM(date: Date, timeZone: string): string;
+export {};
+//# sourceMappingURL=time.d.ts.map

package/dist/utils/time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../src/utils/time.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,UAAU,UAAU;IAClB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;CACd;AAYD,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CAmBnE;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1E;AAED,kEAAkE;AAClE,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,0DAA0D;AAC1D,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAElE"}

package/dist/utils/time.js

@@ -0,0 +1,52 @@
+/**
+ * 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.
+ */
+const WEEKDAY_TO_ISO = {
+    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, timeZone) {
+    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, timeZone) {
+    return localParts(date, timeZone).date;
+}
+/** True when two instants fall on the same local calendar day in the timezone. */
+export function isSameLocalDay(a, b, timeZone) {
+    return localDateString(a, timeZone) === localDateString(b, timeZone);
+}
+/** ISO weekday (1=Mon … 7=Sun) for an instant in the timezone. */
+export function localWeekdayISO(date, timeZone) {
+    return localParts(date, timeZone).weekday;
+}
+/** Local `HH:MM` (24h) for an instant in the timezone. */
+export function localTimeHHMM(date, timeZone) {
+    return localParts(date, timeZone).time;
+}
+//# sourceMappingURL=time.js.map

package/dist/utils/time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../../src/utils/time.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH,MAAM,cAAc,GAA2B;IAC7C,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,CAAC;CACP,CAAC;AAEF,sFAAsF;AACtF,MAAM,UAAU,UAAU,CAAC,IAAU,EAAE,QAAgB;IACrD,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;QAC3C,QAAQ;QACR,OAAO,EAAE,OAAO;QAChB,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,SAAS;QAChB,GAAG,EAAE,SAAS;QACd,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;KACd,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACxF,kFAAkF;IAClF,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;IACrD,OAAO;QACL,IAAI,EAAE,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,GAAG,EAAE;QACjD,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAC3C,IAAI,EAAE,GAAG,IAAI,IAAI,KAAK,CAAC,MAAM,EAAE;KAChC,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,eAAe,CAAC,IAAU,EAAE,QAAgB;IAC1D,OAAO,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC;AACzC,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,cAAc,CAAC,CAAO,EAAE,CAAO,EAAE,QAAgB;IAC/D,OAAO,eAAe,CAAC,CAAC,EAAE,QAAQ,CAAC,KAAK,eAAe,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;AACvE,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,eAAe,CAAC,IAAU,EAAE,QAAgB;IAC1D,OAAO,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC;AAC5C,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,aAAa,CAAC,IAAU,EAAE,QAAgB;IACxD,OAAO,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC;AACzC,CAAC"}

package/dist/utils/withErrorHandlingAndValidation.d.ts

@@ -0,0 +1,18 @@
+import { z } from "zod";
+/**
+ * Wraps an async function with Zod schema validation.
+ *
+ * The returned function validates its input against `schema` before calling
+ * `fn`. Valid input is passed through as parsed, typed data; invalid input
+ * throws a {@link ValidationError} and `fn` is never invoked.
+ *
+ * @example
+ * ```typescript
+ * const createCustomer = withErrorHandlingAndValidation(
+ *   async (params: CreateCustomerInput) => client.customer.create({ data: params }),
+ *   createCustomerSchema
+ * );
+ * ```
+ */
+export declare function withErrorHandlingAndValidation<TSchema extends z.ZodType, TResult>(fn: (params: z.infer<TSchema>) => Promise<TResult>, schema: TSchema): (params: unknown) => Promise<TResult>;
+//# sourceMappingURL=withErrorHandlingAndValidation.d.ts.map

package/dist/utils/withErrorHandlingAndValidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withErrorHandlingAndValidation.d.ts","sourceRoot":"","sources":["../../src/utils/withErrorHandlingAndValidation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,SAAS,CAAC,CAAC,OAAO,EAAE,OAAO,EAC/E,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,EAClD,MAAM,EAAE,OAAO,GACd,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAUvC"}

package/{src/utils/withErrorHandlingAndValidation.ts → dist/utils/withErrorHandlingAndValidation.js}

@@ -1,6 +1,4 @@
-import { z } from "zod";
 import { ValidationError } from "../errors/ValidationError.js";
-
 /**
  * Wraps an async function with Zod schema validation.
  *
@@ -16,17 +14,13 @@ import { ValidationError } from "../errors/ValidationError.js";
  * );
  * ```
  */
-export function withErrorHandlingAndValidation<TSchema extends z.ZodType, TResult>(
-  fn: (params: z.infer<TSchema>) => Promise<TResult>,
-  schema: TSchema
-): (params: unknown) => Promise<TResult> {
-  return async (params: unknown) => {
-    const result = schema.safeParse(params);
-
-    if (!result.success) {
-      throw new ValidationError(result.error);
-    }
-
-    return fn(result.data);
-  };
+export function withErrorHandlingAndValidation(fn, schema) {
+    return async (params) => {
+        const result = schema.safeParse(params);
+        if (!result.success) {
+            throw new ValidationError(result.error);
+        }
+        return fn(result.data);
+    };
 }
+//# sourceMappingURL=withErrorHandlingAndValidation.js.map

package/dist/utils/withErrorHandlingAndValidation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"withErrorHandlingAndValidation.js","sourceRoot":"","sources":["../../src/utils/withErrorHandlingAndValidation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,8BAA8B,CAC5C,EAAkD,EAClD,MAAe;IAEf,OAAO,KAAK,EAAE,MAAe,EAAE,EAAE;QAC/B,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAExC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1C,CAAC;QAED,OAAO,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,7 +1,10 @@
 {
   "name": "@qcobro/common",
-  "version": "1.11.3",
+  "version": "1.11.4",
   "type": "module",
+  "files": [
+    "dist"
+  ],
   "publishConfig": {
     "access": "public"
   },

package/CHANGELOG.md

@@ -1,115 +0,0 @@
-# Change Log
-
-All notable changes to this project will be documented in this file.
-See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
-
-# [1.11.0](https://github.com/fonoster/qcobro/compare/v1.10.0...v1.11.0) (2026-06-30)
-
-### Features
-
-- **whatsapp:** inbound autopilot — reply, opt-out, payment promise (§7.3, §7.4, §9.4) ([ef37a91](https://github.com/fonoster/qcobro/commit/ef37a9109909cb9e86ff3a787b5af06ed199fd78))
-- **whatsapp:** inbound event processing — opt-out suppression + quality-rating (§7.2, §9.3) ([974a9e3](https://github.com/fonoster/qcobro/commit/974a9e35d549e1baf6386ac6bcec40297c8ae703))
-- **whatsapp:** wire engine tick, webhook handshake, and unit tests (§6.2, §7.1, §9.1–9.2) ([a46bb1f](https://github.com/fonoster/qcobro/commit/a46bb1fd0f786e5856281da48d07f2f3249081e7))
-
-# [1.10.0](https://github.com/fonoster/qcobro/compare/v1.9.0...v1.10.0) (2026-06-30)
-
-### Features
-
-- **whatsapp:** add WhatsApp channel server foundation (§2–§6.1) ([51211f3](https://github.com/fonoster/qcobro/commit/51211f3b8af1cd7fb45e0b2ded40262915606548)), closes [#5](https://github.com/fonoster/qcobro/issues/5)
-
-# [1.9.0](https://github.com/fonoster/qcobro/compare/v1.8.0...v1.9.0) (2026-06-29)
-
-### Bug Fixes
-
-- **api:** stop resending Voz IA system prompt as call metadata ([0d66d18](https://github.com/fonoster/qcobro/commit/0d66d18b34d0f353f02d96599d8784f0f372a547))
-
-### Features
-
-- **common:** add isDue outreach variable and document template variables ([ed7a511](https://github.com/fonoster/qcobro/commit/ed7a51161b758d2337055028f7adf52f22f7ae56))
-
-## [1.5.4](https://github.com/fonoster/qcobro/compare/v1.5.3...v1.5.4) (2026-06-28)
-
-### Bug Fixes
-
-- **e2e:** supply fonoster voices in CI config; enable campaigns + console specs ([2ff90ab](https://github.com/fonoster/qcobro/commit/2ff90aba4da71f7e6d902aacff753ea5a9411950))
-
-# [1.5.0](https://github.com/fonoster/qcobro/compare/v1.4.1...v1.5.0) (2026-06-28)
-
-### Features
-
-- **profile-language:** per-user language preference + i18n hygiene sweep ([dbddb9c](https://github.com/fonoster/qcobro/commit/dbddb9c7915103afc339ec9d695b27c97d7634ce))
-
-# [1.4.0](https://github.com/fonoster/qcobro/compare/v1.3.2...v1.4.0) (2026-06-28)
-
-### Features
-
-- **workspace-settings:** collect currency + timezone at workspace creation ([682ae8f](https://github.com/fonoster/qcobro/commit/682ae8f5fcf2045564c0dd5ac0e8f38fa736ed4a))
-
-## [1.3.2](https://github.com/fonoster/qcobro/compare/v1.3.1...v1.3.2) (2026-06-28)
-
-**Note:** Version bump only for package @qcobro/common
-
-## [1.3.1](https://github.com/fonoster/qcobro/compare/v1.3.0...v1.3.1) (2026-06-28)
-
-### Bug Fixes
-
-- **timezone:** contact-log REST uses workspace tz; default is a constant ([1b86419](https://github.com/fonoster/qcobro/commit/1b86419fc98722d0c1174ce9f1bdf19848b35dd5))
-
-# [1.3.0](https://github.com/fonoster/qcobro/compare/v1.2.3...v1.3.0) (2026-06-28)
-
-### Features
-
-- **workspace-settings:** per-workspace currency + timezone (off Identity) ([c1516a3](https://github.com/fonoster/qcobro/commit/c1516a3d306e2b2a906d9ae476fb27f23887d5ae))
-
-# [1.2.0](https://github.com/fonoster/qcobro/compare/v1.1.4...v1.2.0) (2026-06-28)
-
-### Features
-
-- **payment-promises:** outcomes + PaymentPromise worklist, agent-based outreach ([6c620f8](https://github.com/fonoster/qcobro/commit/6c620f8a80c65a7178b0716b825a7d4ebb4077f7))
-
-# 1.1.0 (2026-06-28)
-
-### Bug Fixes
-
-- **channel-dispatch:** allow empty firstMessage for VOICE_AI; non-destructive engine test ([71e17a6](https://github.com/fonoster/qcobro/commit/71e17a6a32d8353e9d428e5763e937408df066df))
-- **channel-dispatch:** pre-recorded voice has no firstMessage either ([ebc8e90](https://github.com/fonoster/qcobro/commit/ebc8e9049b765388e8e0e7505dccef22d4dde875))
-- **email:** hydrate inbound body from received-emails api; strip quoted history ([ddcbdb1](https://github.com/fonoster/qcobro/commit/ddcbdb170953cb9428d92a0cc385d5b83eb43cfd))
-- **voice:** provision AUTOPILOT apps with required conversation settings ([c92a8aa](https://github.com/fonoster/qcobro/commit/c92a8aa52c30e2c8f3f78145dec17a99b72282cd))
-- **webapp:** drop unused fromName/fromEmail from EMAIL agent form; add Resend status badge ([625c3c8](https://github.com/fonoster/qcobro/commit/625c3c8300d275f9f1982353bdf87112a9f03fa2))
-- **workspaces:** wire invite acceptance to Identity HTTP bridge ([5b9fc40](https://github.com/fonoster/qcobro/commit/5b9fc40c57cd8d692d2711c1483bbd158e01aa54))
-
-### Features
-
-- **agent-templates:** per-channel agents, voices-from-config, Fonoster Voz IA sync ([6a8065d](https://github.com/fonoster/qcobro/commit/6a8065d27f8954aa5c5faf7ab34553dccefda5fc))
-- **ai-insights:** transcript-based AI analysis + Voz IA wiring ([4ed7d2e](https://github.com/fonoster/qcobro/commit/4ed7d2e0faf2af9d8ff7966c687c346183b05184))
-- **api-keys:** workspace API key management ([30dd25d](https://github.com/fonoster/qcobro/commit/30dd25d52e1083afb66c7bd323b10d0ac193425a))
-- **api,webapp:** delete-workspace — ownerProcedure and WorkspaceSettings UI ([2542443](https://github.com/fonoster/qcobro/commit/2542443d6cdf4c9a6b2587e3380de9ea3e9f8263))
-- **api,webapp:** profile-management — profile router and Profile page ([5850ec6](https://github.com/fonoster/qcobro/commit/5850ec6e777a987c559f6ab94a15725bc998820f))
-- **api:** add contact-verification and OAuth auth procedures ([b6b70c3](https://github.com/fonoster/qcobro/commit/b6b70c35dd8063ccbdc6e429ded21aa96154928d))
-- **api:** complete auth-and-workspaces change — password reset, resend invite, accept-invite UI ([09c557b](https://github.com/fonoster/qcobro/commit/09c557b00dfee7de725e45cfc5f6e5f61e91f44d))
-- **apiserver:** add auth router (signup, login, refresh, logout) ([9fd50e0](https://github.com/fonoster/qcobro/commit/9fd50e0a32c92ca6bcdf0c053f7050f16921b42b))
-- **apiserver:** add workspace create/list/get (Group 5 core) ([99de39c](https://github.com/fonoster/qcobro/commit/99de39c29c692fd2760053c3bb7f196e11c1a05b))
-- **campaigns-engine:** propose change + config/contracts (group 1) ([6ffd70d](https://github.com/fonoster/qcobro/commit/6ffd70df34cf0a3f33060243eadb1b7460e440eb))
-- **campaigns-engine:** wiring + cleanup (groups 7/9) ([828056d](https://github.com/fonoster/qcobro/commit/828056d091f419bafc5d675a6f0bd92e67bf9eb9))
-- **campaigns:** campaigns-core — lifecycle, days-of-week, edit modal, specs synced ([d1e75cd](https://github.com/fonoster/qcobro/commit/d1e75cd9e065a1556811ee0abf94c4e2ab569e20))
-- **campaigns:** checkpoint campaigns-core WIP before refinement ([2b3e339](https://github.com/fonoster/qcobro/commit/2b3e339913ab4de37152ed04e5aaf0d90fb247c4))
-- **channel-dispatch:** outreach trigger layer (Fonoster voice + Twilio SMS) ([56a4b9e](https://github.com/fonoster/qcobro/commit/56a4b9e4c7c9267f0bfbad42b4b37fff74b6b8fb))
-- **common:** add validated-function utilities and conventions guide ([a60bab9](https://github.com/fonoster/qcobro/commit/a60bab99affd9290602512e5921632c4a1f9f70f))
-- **console:** config-driven announcement banner; flag unimplemented data ([01d8977](https://github.com/fonoster/qcobro/commit/01d89775fa547766521c5be5c15ba429bf5a655c))
-- **console:** refinement + cleanup pass ([78dc3e5](https://github.com/fonoster/qcobro/commit/78dc3e58f2a4eaede4bf10a9d2a551b3c426d9ee))
-- **email-channel:** inbound autopilot — webhook, decision loop, reply cap ([67b6a85](https://github.com/fonoster/qcobro/commit/67b6a8515e75f8ca178293755bffa540a2a3d139))
-- **email-channel:** outbound email + engine integration (Resend) ([391d3d0](https://github.com/fonoster/qcobro/commit/391d3d0caf3440d4f41568d0c48ec37c7ec76d36))
-- **email-channel:** spec + contracts for bidirectional email (Resend autopilot) ([6c2461c](https://github.com/fonoster/qcobro/commit/6c2461ced535cc1b1eb4a7f9eb2a3dcd989dbbe5))
-- **email:** bidirectional email channel end-to-end ([b49a442](https://github.com/fonoster/qcobro/commit/b49a442104841023f3507a6c33cf85dfe689bf12))
-- **gestiones:** add voz IA channel webhook and rich detail panel ([824671f](https://github.com/fonoster/qcobro/commit/824671f0da22dcc9ec16a610618925f96e28d2c8))
-- identity now from the published fonoster identity mod ([9a6eaea](https://github.com/fonoster/qcobro/commit/9a6eaeaed20f51ea7a4846fe116735aeecdcc6e5))
-- **manual-outreach:** carteras reach-out modal + campaign-derived dispatch ([367db2d](https://github.com/fonoster/qcobro/commit/367db2d370c893317042b76239acb7d39c3e69f7))
-- **portfolios:** portfolio management, status enums, currency, and row actions ([6b6bac9](https://github.com/fonoster/qcobro/commit/6b6bac914d85f5140da0abfaa84bd682686364e3))
-- scaffold Qcobro app monorepo ([d5a7507](https://github.com/fonoster/qcobro/commit/d5a7507016d27cc2f76ece0c6aaeff33186d8da0))
-- scaffold spec-driven monorepo foundation ([1a17d89](https://github.com/fonoster/qcobro/commit/1a17d89dffe686032caafe1c09be50053286e48b))
-- **sdk:** add @qcobro/sdk with portfolios, API-key auth, and auto-refresh ([324405e](https://github.com/fonoster/qcobro/commit/324405e9922bf70ccd57088122098c6c2d8de2e7))
-- **voice:** embedded Fonoster VoiceServer for pre-recorded (external) agents ([00e581e](https://github.com/fonoster/qcobro/commit/00e581e78c503509ad7af4cade0b29b226a78a60))
-- **voice:** make pre-recorded audio permanent and spec the events-hook ([8b03fdb](https://github.com/fonoster/qcobro/commit/8b03fdbbbd84cc4233578ae94e37a9a364171584))
-- **voice:** pre-recorded via shared external app ref + Say playback ([e156292](https://github.com/fonoster/qcobro/commit/e15629223914a1141025a1804aa184222c3f244e))
-- **webapp:** implement Pencil UI — login brand panel, workspace picker, sidebar redesign ([e34ef12](https://github.com/fonoster/qcobro/commit/e34ef123b68941a007304316f3c0135f50a69cbd))
-- **workspaces:** rename + console navigation (workspace-management) ([46acf86](https://github.com/fonoster/qcobro/commit/46acf86d32a09d3cf4474818f4950e35776bef01))

package/src/config.test.ts

@@ -1,19 +0,0 @@
-import { describe, it } from "node:test";
-import assert from "node:assert/strict";
-import { ttsProductRefForVoice, type VoiceCatalogEntry } from "./config.js";
-
-const voices: VoiceCatalogEntry[] = [
-  { id: "v-eleven", name: "Sofía", language: "es", gender: "female", provider: "elevenlabs" },
-  { id: "v-google", name: "Andrés", language: "es", gender: "male", provider: "google" }
-];
-
-describe("ttsProductRefForVoice", () => {
-  it("derives the TTS product ref from the voice's provider", () => {
-    assert.equal(ttsProductRefForVoice("v-eleven", voices), "tts.elevenlabs");
-    assert.equal(ttsProductRefForVoice("v-google", voices), "tts.google");
-  });
-
-  it("falls back to tts.elevenlabs for an unknown voice", () => {
-    assert.equal(ttsProductRefForVoice("missing", voices), "tts.elevenlabs");
-  });
-});

package/src/errors/ValidationError.test.ts

@@ -1,38 +0,0 @@
-import { describe, it } from "node:test";
-import assert from "node:assert/strict";
-import { z } from "zod";
-import { ValidationError } from "./ValidationError.js";
-
-const schema = z.object({ name: z.string().min(1), age: z.number() });
-
-function zodErrorFor(input: unknown): z.ZodError {
-  const result = schema.safeParse(input);
-  assert.equal(result.success, false);
-  return (result as { success: false; error: z.ZodError }).error;
-}
-
-describe("ValidationError", () => {
-  it("exposes a stable code and field-level errors", () => {
-    const error = new ValidationError(zodErrorFor({ name: "", age: "nope" }));
-
-    assert.equal(error.code, "VALIDATION_ERROR");
-    assert.equal(error.name, "ValidationError");
-    assert.ok(error instanceof Error);
-
-    const fields = error.fieldErrors.map((f) => f.field);
-    assert.ok(fields.includes("name"));
-    assert.ok(fields.includes("age"));
-    for (const fieldError of error.fieldErrors) {
-      assert.equal(typeof fieldError.message, "string");
-      assert.equal(typeof fieldError.code, "string");
-    }
-  });
-
-  it("serializes to a JSON shape for API responses", () => {
-    const error = new ValidationError(zodErrorFor({ name: "", age: 1 }));
-    const json = error.toJSON();
-
-    assert.deepEqual(Object.keys(json).sort(), ["code", "fieldErrors", "message"]);
-    assert.equal(json.code, "VALIDATION_ERROR");
-  });
-});

package/src/errors/ValidationError.ts

@@ -1,68 +0,0 @@
-import type { z } from "zod";
-
-export interface FieldError {
-  field: string;
-  message: string;
-  code: string;
-}
-
-/**
- * Wraps a Zod validation error with structured, field-level details suitable
- * for API responses.
- */
-export class ValidationError extends Error {
-  public readonly code = "VALIDATION_ERROR";
-  public readonly fieldErrors: FieldError[];
-  public readonly zodError: z.ZodError;
-
-  constructor(zodError: z.ZodError) {
-    const fieldErrors = ValidationError.extractFieldErrors(zodError);
-    const message = ValidationError.formatMessage(fieldErrors);
-
-    super(message);
-    this.name = "ValidationError";
-    this.zodError = zodError;
-    this.fieldErrors = fieldErrors;
-
-    // Maintains proper stack trace for where the error was thrown (V8 engines).
-    if (Error.captureStackTrace) {
-      Error.captureStackTrace(this, ValidationError);
-    }
-  }
-
-  private static extractFieldErrors(zodError: z.ZodError): FieldError[] {
-    return zodError.issues.map((issue) => ({
-      field: issue.path.join(".") || "root",
-      message: issue.message,
-      code: issue.code
-    }));
-  }
-
-  private static formatMessage(fieldErrors: FieldError[]): string {
-    if (fieldErrors.length === 0) {
-      return "Validation failed";
-    }
-
-    if (fieldErrors.length === 1) {
-      const { field, message } = fieldErrors[0];
-      return field === "root" ? message : `${field}: ${message}`;
-    }
-
-    const details = fieldErrors
-      .map(({ field, message }) => (field === "root" ? message : `${field}: ${message}`))
-      .join("; ");
-
-    return `Validation failed: ${details}`;
-  }
-
-  /**
-   * Returns a JSON-serializable representation for API responses.
-   */
-  toJSON() {
-    return {
-      code: this.code,
-      message: this.message,
-      fieldErrors: this.fieldErrors
-    };
-  }
-}

package/src/schemas/agentTemplates.ts

@@ -1,100 +0,0 @@
-import { z } from "zod";
-
-export const agentTypeSchema = z.enum([
-  "SMS",
-  "VOICE_PRERECORDED",
-  "VOICE_AI",
-  "EMAIL",
-  "WHATSAPP"
-]);
-export type AgentType = z.infer<typeof agentTypeSchema>;
-
-const baseFields = {
-  name: z.string().min(1).max(120)
-};
-
-/**
- * Creating an agent template is a discriminated union on `type`: each channel
- * carries its own config fields, never mixed across types. `fonosterAppName` is
- * optional on voice types — the create function defaults it to the template name.
- */
-export const createAgentTemplateSchema = z.discriminatedUnion("type", [
-  z.object({
-    ...baseFields,
-    type: z.literal("VOICE_AI"),
-    voice: z.string().min(1),
-    systemPrompt: z.string().min(1),
-    // Optional: a VOICE_AI agent may rely on its system prompt with no scripted opening line.
-    firstMessage: z.string().optional(),
-    language: z.string().min(1),
-    fonosterAppName: z.string().min(1).optional()
-  }),
-  z.object({
-    ...baseFields,
-    type: z.literal("VOICE_PRERECORDED"),
-    voice: z.string().min(1),
-    script: z.string().min(1),
-    language: z.string().min(1),
-    fonosterAppName: z.string().min(1).optional()
-  }),
-  z.object({
-    ...baseFields,
-    type: z.literal("SMS"),
-    messageBody: z.string().min(1),
-    senderId: z.string().min(1).optional()
-  }),
-  z.object({
-    ...baseFields,
-    type: z.literal("EMAIL"),
-    subject: z.string().min(1),
-    messageBody: z.string().min(1),
-    /** Autopilot decision brain: governs reply/ignore/resolve/escalate on each inbound reply. */
-    systemPrompt: z.string().min(1),
-    /** Per-agent cap on autopilot replies per collection attempt; falls back to the
-     * `resend.maxRepliesDefault` deployment default when omitted. */
-    maxReplies: z.number().int().nonnegative().optional()
-  }),
-  z.object({
-    ...baseFields,
-    type: z.literal("WHATSAPP"),
-    /** Meta template id the operator enters; QCobro resolves + previews the template from the WABA. */
-    templateId: z.string().min(1),
-    /** Resolved from `templateId` (read-only in the UI); the approved Meta template name to send. */
-    templateName: z.string().min(1),
-    /** Fetched template body (read-only preview); its `{{vars}}` are sent as named parameters. */
-    messageBody: z.string().min(1),
-    /** Smart-agent decision brain for replies after the customer responds (mirrors EMAIL). */
-    systemPrompt: z.string().min(1),
-    /** Per-agent cap on automated replies per gestión; falls back to the deployment default when omitted. */
-    maxReplies: z.number().int().nonnegative().optional()
-  })
-]);
-export type CreateAgentTemplateInput = z.infer<typeof createAgentTemplateSchema>;
-
-/**
- * Updating an agent template: mutable base fields plus a loose `config` bag of
- * type-specific fields applied to the stored child table. `type` is immutable —
- * `.strict()` rejects any attempt to pass it (or other unknown keys).
- */
-export const updateAgentTemplateSchema = z
-  .object({
-    id: z.string().min(1),
-    name: z.string().min(1).max(120).optional(),
-    // `archived` toggles the template's archived state: true sets `archivedAt` to
-    // now, false clears it (restore). Templates have no status concept.
-    archived: z.boolean().optional(),
-    config: z.record(z.string(), z.unknown()).optional()
-  })
-  .strict();
-export type UpdateAgentTemplateInput = z.infer<typeof updateAgentTemplateSchema>;
-
-export const deleteAgentTemplateSchema = z.object({
-  id: z.string().min(1)
-});
-export type DeleteAgentTemplateInput = z.infer<typeof deleteAgentTemplateSchema>;
-
-/** Manually re-attempt the Fonoster sync for a voice template. */
-export const syncAgentTemplateSchema = z.object({
-  id: z.string().min(1)
-});
-export type SyncAgentTemplateInput = z.infer<typeof syncAgentTemplateSchema>;