evo360-types 1.3.369 → 1.3.371

package/dist/apps/evo-hub-ia/v1/zod-schemas.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.zAiBindingSchema = exports.zHubiaRuleSchema = exports.zHubiaRulesModeSchema = exports.zHubiaRuleActionSchema = exports.zHubiaRuleScopeSchema = exports.zHubiaConditionGroupSchema = exports.zHubiaConditionSchema = exports.zHubiaConditionOpSchema = exports.zHubiaRuleAppliesToSchema = exports.zHubiaRuleOutcomeSchema = exports.zHubiaRuleTriggerSchema = exports.zHubiaRulePhaseSchema = exports.zHubiaConversationModeSchema = exports.zHubiaConversationMessageSchema = exports.zHubiaV1ChannelConfigSchema = exports.zHubiaAttendanceModeSchema = void 0;
+exports.zAiBindingSchema = exports.zHubiaRuleSchema = exports.zHubiaRulesModeSchema = exports.zHubiaRuleActionSchema = exports.zHubiaRuleScopeSchema = exports.zHubiaConditionGroupSchema = exports.zHubiaConditionSchema = exports.zHubiaScheduleSchema = exports.zHubiaScheduleWindowSchema = exports.zHubiaConditionOpSchema = exports.zHubiaRuleAppliesToSchema = exports.zHubiaRuleOutcomeSchema = exports.zHubiaRuleTriggerSchema = exports.zHubiaRulePhaseSchema = exports.zHubiaConversationModeSchema = exports.zHubiaConversationMessageSchema = exports.zHubiaV1ChannelConfigSchema = exports.zHubiaAttendanceModeSchema = void 0;
 const zod_1 = require("zod");
 const zod_schemas_1 = require("../../shared/zod-schemas");
 // ───────── Attendance Mode (how AI operates on this channel) ─────────
@@ -103,14 +103,62 @@ exports.zHubiaConditionOpSchema = zod_1.z.enum([
     "contains", "not_contains",
     "matches",
     "gt", "gte", "lt", "lte",
+    "in_schedule", "not_in_schedule",
 ]);
+// ───────── Schedule (janela de horário por dia da semana) ─────────
+//
+// Usado como `value` das condições com operadores `in_schedule` /
+// `not_in_schedule`. Modelagem POSITIVA: o usuário define a agenda natural
+// (ex: horário comercial Seg-Sex 8h-18h) e escolhe o operador in/not_in
+// conforme quiser disparar dentro ou fora dessa janela.
+//
+// Semântica de boundary: `start <= time_hhmm < end` (start incluso, end
+// excluso — permite janelas adjacentes do mesmo dia sem overlap).
+//
+// Overnight: split por meia-noite — `[{day:1,start:'22:00',end:'23:59'},
+// {day:2,start:'00:00',end:'06:00'}]`. NÃO suportamos `end < start` numa
+// mesma window (regra explícita: 1 window = mesmo dia).
+/** Uma janela individual: dia da semana (0=dom..6=sáb) + intervalo HH:MM. */
+exports.zHubiaScheduleWindowSchema = zod_1.z.object({
+    day: zod_1.z.number().int().min(0).max(6),
+    start: zod_1.z.string().regex(/^([01]\d|2[0-3]):[0-5]\d$/, "formato HH:MM (00-23 : 00-59)"),
+    end: zod_1.z.string().regex(/^([01]\d|2[0-3]):[0-5]\d$/, "formato HH:MM (00-23 : 00-59)"),
+}).refine((w) => w.start < w.end, {
+    message: "start deve ser estritamente menor que end (split por meia-noite para overnight)",
+    path: ["end"],
+});
+/** Agenda semanal — lista de janelas + timezone opcional.
+ *  Quando `timezone` ausente, runtime usa a do tenant (`/tenants/{tenant}.timezone`,
+ *  fallback `'America/Sao_Paulo'`). */
+exports.zHubiaScheduleSchema = zod_1.z.object({
+    windows: zod_1.z.array(exports.zHubiaScheduleWindowSchema).min(1),
+    timezone: zod_1.z.string().optional(),
+});
 /** Uma condição: avalia `op(fact, value)` contra o facts provider do runtime.
- *  `value` é ausente para `exists`/`not_exists`. */
+ *
+ *  Política do `value`:
+ *  - Ausente para `exists`/`not_exists`/`is_empty`/`is_not_empty`.
+ *  - Primitive (string/number/boolean) ou array para os operadores clássicos
+ *    (`eq`, `in`, `contains`, etc.) — formato livre, casado dinamicamente.
+ *  - Objeto `IHubiaSchedule` para `in_schedule`/`not_in_schedule` (validado
+ *    pelo `superRefine` abaixo). */
 exports.zHubiaConditionSchema = zod_1.z.object({
-    /** Dot-path no namespace de facts (ex: "lead.tag_names", "contact.has_lead"). */
+    /** Dot-path no namespace de facts (ex: "lead.tag_names", "contact.has_lead",
+     *  "now.iso" — este último para operadores de schedule). */
     fact: zod_1.z.string().min(1),
     op: exports.zHubiaConditionOpSchema,
     value: zod_1.z.unknown().optional(),
+}).superRefine((c, ctx) => {
+    if (c.op === "in_schedule" || c.op === "not_in_schedule") {
+        const parsed = exports.zHubiaScheduleSchema.safeParse(c.value);
+        if (!parsed.success) {
+            ctx.addIssue({
+                code: zod_1.z.ZodIssueCode.custom,
+                path: ["value"],
+                message: `value de '${c.op}' precisa ser um IHubiaSchedule válido (${parsed.error.issues.map((i) => i.message).join("; ")})`,
+            });
+        }
+    }
 });
 /** Grupo de condições. Nível 2: um nível de AND/OR, sem aninhamento profundo
  *  (Nível 3 fica para depois). Pelo menos uma das listas precisa ter ≥1 condição. */

package/dist/apps/evo-hub-ia/v1/zod-schemas.ts

@@ -122,15 +122,66 @@ export const zHubiaConditionOpSchema = z.enum([
   "contains", "not_contains",
   "matches",
   "gt", "gte", "lt", "lte",
+  "in_schedule", "not_in_schedule",
 ]);
 
+// ───────── Schedule (janela de horário por dia da semana) ─────────
+//
+// Usado como `value` das condições com operadores `in_schedule` /
+// `not_in_schedule`. Modelagem POSITIVA: o usuário define a agenda natural
+// (ex: horário comercial Seg-Sex 8h-18h) e escolhe o operador in/not_in
+// conforme quiser disparar dentro ou fora dessa janela.
+//
+// Semântica de boundary: `start <= time_hhmm < end` (start incluso, end
+// excluso — permite janelas adjacentes do mesmo dia sem overlap).
+//
+// Overnight: split por meia-noite — `[{day:1,start:'22:00',end:'23:59'},
+// {day:2,start:'00:00',end:'06:00'}]`. NÃO suportamos `end < start` numa
+// mesma window (regra explícita: 1 window = mesmo dia).
+
+/** Uma janela individual: dia da semana (0=dom..6=sáb) + intervalo HH:MM. */
+export const zHubiaScheduleWindowSchema = z.object({
+  day: z.number().int().min(0).max(6),
+  start: z.string().regex(/^([01]\d|2[0-3]):[0-5]\d$/, "formato HH:MM (00-23 : 00-59)"),
+  end: z.string().regex(/^([01]\d|2[0-3]):[0-5]\d$/, "formato HH:MM (00-23 : 00-59)"),
+}).refine((w) => w.start < w.end, {
+  message: "start deve ser estritamente menor que end (split por meia-noite para overnight)",
+  path: ["end"],
+});
+
+/** Agenda semanal — lista de janelas + timezone opcional.
+ *  Quando `timezone` ausente, runtime usa a do tenant (`/tenants/{tenant}.timezone`,
+ *  fallback `'America/Sao_Paulo'`). */
+export const zHubiaScheduleSchema = z.object({
+  windows: z.array(zHubiaScheduleWindowSchema).min(1),
+  timezone: z.string().optional(),
+});
+
 /** Uma condição: avalia `op(fact, value)` contra o facts provider do runtime.
- *  `value` é ausente para `exists`/`not_exists`. */
+ *
+ *  Política do `value`:
+ *  - Ausente para `exists`/`not_exists`/`is_empty`/`is_not_empty`.
+ *  - Primitive (string/number/boolean) ou array para os operadores clássicos
+ *    (`eq`, `in`, `contains`, etc.) — formato livre, casado dinamicamente.
+ *  - Objeto `IHubiaSchedule` para `in_schedule`/`not_in_schedule` (validado
+ *    pelo `superRefine` abaixo). */
 export const zHubiaConditionSchema = z.object({
-  /** Dot-path no namespace de facts (ex: "lead.tag_names", "contact.has_lead"). */
+  /** Dot-path no namespace de facts (ex: "lead.tag_names", "contact.has_lead",
+   *  "now.iso" — este último para operadores de schedule). */
   fact: z.string().min(1),
   op: zHubiaConditionOpSchema,
   value: z.unknown().optional(),
+}).superRefine((c, ctx) => {
+  if (c.op === "in_schedule" || c.op === "not_in_schedule") {
+    const parsed = zHubiaScheduleSchema.safeParse(c.value);
+    if (!parsed.success) {
+      ctx.addIssue({
+        code: z.ZodIssueCode.custom,
+        path: ["value"],
+        message: `value de '${c.op}' precisa ser um IHubiaSchedule válido (${parsed.error.issues.map((i) => i.message).join("; ")})`,
+      });
+    }
+  }
 });
 
 /** Grupo de condições. Nível 2: um nível de AND/OR, sem aninhamento profundo

package/dist/types/evo-hub-ia/v1/index.d.ts

@@ -14,15 +14,48 @@ export type IHubiaRuleOutcome = "stop" | "to_llm" | "to_llm_with_context";
 /** Tipo de batch ao qual a regra se aplica. `real_message` (default) ignora
  *  a mensagem de kickoff do sistema — proteção contra loop de transferência. */
 export type IHubiaRuleAppliesTo = "real_message" | "kickoff" | "any";
-/** Operadores suportados pelas condições. */
-export type IHubiaConditionOp = "exists" | "not_exists" | "is_empty" | "is_not_empty" | "eq" | "neq" | "in" | "not_in" | "contains" | "not_contains" | "matches" | "gt" | "gte" | "lt" | "lte";
+/** Operadores suportados pelas condições.
+ *
+ *  `in_schedule` / `not_in_schedule` esperam `value: IHubiaSchedule` e
+ *  avaliam contra o fact `now.*` (timezone-aware, ver IHubiaSchedule). */
+export type IHubiaConditionOp = "exists" | "not_exists" | "is_empty" | "is_not_empty" | "eq" | "neq" | "in" | "not_in" | "contains" | "not_contains" | "matches" | "gt" | "gte" | "lt" | "lte" | "in_schedule" | "not_in_schedule";
+/** Uma janela de horário num dia da semana.
+ *
+ *  - `day`: 0=dom, 1=seg, …, 6=sáb.
+ *  - `start`/`end`: formato `HH:MM` (00-23 : 00-59).
+ *  - Semântica de boundary: `start <= now < end` (end excluso — permite
+ *    janelas adjacentes sem overlap).
+ *  - NÃO suporta `end < start`: para overnight, fazer split por meia-noite
+ *    em duas janelas (`{day:1,end:'23:59'}` + `{day:2,start:'00:00'}`). */
+export interface IHubiaScheduleWindow {
+    day: number;
+    start: string;
+    end: string;
+}
+/** Agenda semanal usada como `value` para `in_schedule`/`not_in_schedule`.
+ *
+ *  Modelagem POSITIVA: descreva a agenda natural (ex: horário comercial)
+ *  e escolha o operador (`in_` ou `not_in_`) conforme quiser disparar
+ *  dentro ou fora da janela.
+ *
+ *  `timezone`: IANA tz name (ex: `'America/Sao_Paulo'`). Quando ausente,
+ *  runtime usa `/tenants/{tenant}.timezone` (fallback `'America/Sao_Paulo'`). */
+export interface IHubiaSchedule {
+    windows: IHubiaScheduleWindow[];
+    timezone?: string;
+}
 /** Master switch do binding. `dry_run` força TODAS as regras do binding a
  *  modo seco (kill switch). Default runtime quando ausente: `live`. */
 export type IHubiaRulesMode = "live" | "dry_run";
 /** Uma condição: avalia `op(fact, value)` contra o facts provider do runtime.
- *  `value` é ausente para `exists`/`not_exists`. */
+ *
+ *  Política do `value`:
+ *  - Ausente para `exists`/`not_exists`/`is_empty`/`is_not_empty`.
+ *  - Primitive (string/number/boolean) ou array para `eq`/`in`/`contains`/etc.
+ *  - `IHubiaSchedule` para `in_schedule`/`not_in_schedule`. */
 export interface IHubiaCondition {
-    /** Dot-path no namespace de facts (ex: "lead.tag_names", "contact.has_lead"). */
+    /** Dot-path no namespace de facts (ex: "lead.tag_names", "contact.has_lead",
+     *  "now.iso" para operadores de schedule). */
     fact: string;
     op: IHubiaConditionOp;
     value?: unknown;

package/dist/types/evo-hub-ia/v1/index.ts

@@ -27,7 +27,10 @@ export type IHubiaRuleOutcome = "stop" | "to_llm" | "to_llm_with_context";
  *  a mensagem de kickoff do sistema — proteção contra loop de transferência. */
 export type IHubiaRuleAppliesTo = "real_message" | "kickoff" | "any";
 
-/** Operadores suportados pelas condições. */
+/** Operadores suportados pelas condições.
+ *
+ *  `in_schedule` / `not_in_schedule` esperam `value: IHubiaSchedule` e
+ *  avaliam contra o fact `now.*` (timezone-aware, ver IHubiaSchedule). */
 export type IHubiaConditionOp =
   | "exists"
   | "not_exists"
@@ -43,7 +46,36 @@ export type IHubiaConditionOp =
   | "gt"
   | "gte"
   | "lt"
-  | "lte";
+  | "lte"
+  | "in_schedule"
+  | "not_in_schedule";
+
+/** Uma janela de horário num dia da semana.
+ *
+ *  - `day`: 0=dom, 1=seg, …, 6=sáb.
+ *  - `start`/`end`: formato `HH:MM` (00-23 : 00-59).
+ *  - Semântica de boundary: `start <= now < end` (end excluso — permite
+ *    janelas adjacentes sem overlap).
+ *  - NÃO suporta `end < start`: para overnight, fazer split por meia-noite
+ *    em duas janelas (`{day:1,end:'23:59'}` + `{day:2,start:'00:00'}`). */
+export interface IHubiaScheduleWindow {
+  day: number;
+  start: string;
+  end: string;
+}
+
+/** Agenda semanal usada como `value` para `in_schedule`/`not_in_schedule`.
+ *
+ *  Modelagem POSITIVA: descreva a agenda natural (ex: horário comercial)
+ *  e escolha o operador (`in_` ou `not_in_`) conforme quiser disparar
+ *  dentro ou fora da janela.
+ *
+ *  `timezone`: IANA tz name (ex: `'America/Sao_Paulo'`). Quando ausente,
+ *  runtime usa `/tenants/{tenant}.timezone` (fallback `'America/Sao_Paulo'`). */
+export interface IHubiaSchedule {
+  windows: IHubiaScheduleWindow[];
+  timezone?: string;
+}
 
 /** Master switch do binding. `dry_run` força TODAS as regras do binding a
  *  modo seco (kill switch). Default runtime quando ausente: `live`. */
@@ -52,9 +84,14 @@ export type IHubiaRulesMode = "live" | "dry_run";
 // ── Sub-interfaces ──
 
 /** Uma condição: avalia `op(fact, value)` contra o facts provider do runtime.
- *  `value` é ausente para `exists`/`not_exists`. */
+ *
+ *  Política do `value`:
+ *  - Ausente para `exists`/`not_exists`/`is_empty`/`is_not_empty`.
+ *  - Primitive (string/number/boolean) ou array para `eq`/`in`/`contains`/etc.
+ *  - `IHubiaSchedule` para `in_schedule`/`not_in_schedule`. */
 export interface IHubiaCondition {
-  /** Dot-path no namespace de facts (ex: "lead.tag_names", "contact.has_lead"). */
+  /** Dot-path no namespace de facts (ex: "lead.tag_names", "contact.has_lead",
+   *  "now.iso" para operadores de schedule). */
   fact: string;
   op: IHubiaConditionOp;
   value?: unknown;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "evo360-types",
-  "version": "1.3.369",
+  "version": "1.3.371",
   "description": "HREVO360 Shared Types",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",