evo360-types 1.3.326 → 1.3.329

package/dist/apps/evo-med/calendar/zod-schemas.js

@@ -4,6 +4,7 @@ exports.zMedCalendarSchema = void 0;
 const zod_1 = require("zod");
 const zod_schemas_1 = require("../../shared/zod-schemas");
 const zod_schemas_2 = require("../people/zod-schemas");
+const zod_schemas_3 = require("../../evo-integrations/zod-schemas");
 exports.zMedCalendarSchema = zod_schemas_1.zFireDocSchema
     .extend({
     calendarId: zod_1.z.string().min(1).max(30),
@@ -42,5 +43,6 @@ exports.zMedCalendarSchema = zod_schemas_1.zFireDocSchema
         .default([1, 2, 3, 4, 5])
         .optional(),
     available_for_hubia: zod_1.z.boolean().default(false).optional(),
+    integration: zod_schemas_3.zMedCalendarIntegrationSchema.optional(),
 })
     .passthrough();

package/dist/apps/evo-med/calendar/zod-schemas.ts

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { zFireDocSchema, zTagSchema } from "../../shared/zod-schemas";
 import { zAppointmentCountersSchema } from "../people/zod-schemas";
+import { zMedCalendarIntegrationSchema } from "../../evo-integrations/zod-schemas";
 
 export const zMedCalendarSchema = zFireDocSchema
   .extend({
@@ -40,5 +41,6 @@ export const zMedCalendarSchema = zFireDocSchema
       .default([1, 2, 3, 4, 5])
       .optional(),
     available_for_hubia: z.boolean().default(false).optional(),
+    integration: zMedCalendarIntegrationSchema.optional(),
   })
   .passthrough();

package/dist/apps/evo-tenant/zod-schemas.d.ts

@@ -13,7 +13,7 @@ export declare const zTenantSchema: z.ZodObject<{
 } & {
     name: z.ZodString;
     url_alias: z.ZodString;
-    base_tenant: z.ZodOptional<z.ZodString>;
+    base_tenant: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     hidden: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
     readonly: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
     date_format: z.ZodOptional<z.ZodString>;
@@ -32,7 +32,7 @@ export declare const zTenantSchema: z.ZodObject<{
     created_at?: Date | null | undefined;
     updated_at?: Date | null | undefined;
     deleted_at?: Date | null | undefined;
-    base_tenant?: string | undefined;
+    base_tenant?: string | null | undefined;
     hidden?: boolean | undefined;
     readonly?: boolean | undefined;
     date_format?: string | undefined;
@@ -50,7 +50,7 @@ export declare const zTenantSchema: z.ZodObject<{
     created_at?: Date | null | undefined;
     updated_at?: Date | null | undefined;
     deleted_at?: Date | null | undefined;
-    base_tenant?: string | undefined;
+    base_tenant?: string | null | undefined;
     hidden?: boolean | undefined;
     readonly?: boolean | undefined;
     date_format?: string | undefined;

package/dist/apps/evo-tenant/zod-schemas.js

@@ -14,7 +14,7 @@ exports.zTenantSchema = zod_schemas_1.zFireDocSchema // Extend from FireDocSchem
     .extend({
     name: zod_1.z.string().min(1).max(255),
     url_alias: zod_1.z.string().min(1).max(255),
-    base_tenant: zod_1.z.string().optional(),
+    base_tenant: zod_1.z.string().nullable().optional(),
     hidden: zod_1.z.boolean().default(false).optional(),
     readonly: zod_1.z.boolean().default(false).optional(),
     date_format: zod_1.z.string().optional(),

package/dist/apps/evo-tenant/zod-schemas.ts

@@ -15,7 +15,7 @@ export const zTenantSchema = zFireDocSchema // Extend from FireDocSchema
   .extend({
     name: z.string().min(1).max(255),
     url_alias: z.string().min(1).max(255),
-    base_tenant: z.string().optional(),
+    base_tenant: z.string().nullable().optional(),
     hidden: z.boolean().default(false).optional(),
     readonly: z.boolean().default(false).optional(),
     date_format: z.string().optional(),

package/dist/index.d.ts

@@ -22,6 +22,7 @@ export * from "./types/evo-finops";
 export * from "./types/evo-notif-user";
 export * from "./types/evo-notifications";
 export * from "./types/evo-task-runner";
+export * from "./types/evo-integrations";
 export * from "./types/nex-customers";
 export * from "./apps/shared/zod-schemas";
 export * from "./apps/evo-core/zod-schemas";
@@ -56,3 +57,4 @@ export * from "./apps/evo-finops/zod-schemas";
 export * from "./apps/evo-notif-user/zod-schemas";
 export * from "./apps/evo-notifications/zod-schemas";
 export * from "./apps/evo-task-runner/zod-schemas";
+export * from "./apps/evo-integrations/zod-schemas";

package/dist/index.js

@@ -39,6 +39,7 @@ __exportStar(require("./types/evo-finops"), exports);
 __exportStar(require("./types/evo-notif-user"), exports);
 __exportStar(require("./types/evo-notifications"), exports);
 __exportStar(require("./types/evo-task-runner"), exports);
+__exportStar(require("./types/evo-integrations"), exports);
 __exportStar(require("./types/nex-customers"), exports);
 // zod schemas
 __exportStar(require("./apps/shared/zod-schemas"), exports);
@@ -74,3 +75,4 @@ __exportStar(require("./apps/evo-finops/zod-schemas"), exports);
 __exportStar(require("./apps/evo-notif-user/zod-schemas"), exports);
 __exportStar(require("./apps/evo-notifications/zod-schemas"), exports);
 __exportStar(require("./apps/evo-task-runner/zod-schemas"), exports);
+__exportStar(require("./apps/evo-integrations/zod-schemas"), exports);

package/dist/index.ts

@@ -23,6 +23,7 @@ export * from "./types/evo-finops";
 export * from "./types/evo-notif-user";
 export * from "./types/evo-notifications";
 export * from "./types/evo-task-runner";
+export * from "./types/evo-integrations";
 export * from "./types/nex-customers";
 
 // zod schemas
@@ -59,3 +60,4 @@ export * from "./apps/evo-finops/zod-schemas";
 export * from "./apps/evo-notif-user/zod-schemas";
 export * from "./apps/evo-notifications/zod-schemas";
 export * from "./apps/evo-task-runner/zod-schemas";
+export * from "./apps/evo-integrations/zod-schemas";

package/dist/types/evo-integrations/fb_collections.d.ts

@@ -0,0 +1,5 @@
+export declare const PLATFORM_COLLECTION = "platform";
+export declare const EVO_INTEGRATIONS_PLATFORM_DOC = "evo-integrations";
+export declare const ADAPTERS_COLLECTION = "adapters";
+export declare const INTEGRATION_CREDENTIALS_COLLECTION = "integration-credentials";
+export declare const SYNC_STATES_COLLECTION = "sync-states";

package/dist/types/evo-integrations/fb_collections.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SYNC_STATES_COLLECTION = exports.INTEGRATION_CREDENTIALS_COLLECTION = exports.ADAPTERS_COLLECTION = exports.EVO_INTEGRATIONS_PLATFORM_DOC = exports.PLATFORM_COLLECTION = void 0;
+// Platform-level (Nexus-managed, cross-tenant) adapter catalog
+// Path: /platform/evo-integrations/adapters/{adapter_id}
+exports.PLATFORM_COLLECTION = "platform";
+exports.EVO_INTEGRATIONS_PLATFORM_DOC = "evo-integrations";
+exports.ADAPTERS_COLLECTION = "adapters";
+// Tenant-level (under apps/evo-med — integration config lives with the calendar it serves)
+// Path: /tenants/{t}/apps/evo-med/integration-credentials/{cred_id}
+exports.INTEGRATION_CREDENTIALS_COLLECTION = "integration-credentials";
+// Per-calendar sync state (1 doc per calendar).
+// Path: /tenants/{t}/apps/evo-med/sync-states/{calendar_id}
+exports.SYNC_STATES_COLLECTION = "sync-states";

package/dist/types/evo-integrations/fb_collections.ts

@@ -0,0 +1,13 @@
+// Platform-level (Nexus-managed, cross-tenant) adapter catalog
+// Path: /platform/evo-integrations/adapters/{adapter_id}
+export const PLATFORM_COLLECTION = "platform";
+export const EVO_INTEGRATIONS_PLATFORM_DOC = "evo-integrations";
+export const ADAPTERS_COLLECTION = "adapters";
+
+// Tenant-level (under apps/evo-med — integration config lives with the calendar it serves)
+// Path: /tenants/{t}/apps/evo-med/integration-credentials/{cred_id}
+export const INTEGRATION_CREDENTIALS_COLLECTION = "integration-credentials";
+
+// Per-calendar sync state (1 doc per calendar).
+// Path: /tenants/{t}/apps/evo-med/sync-states/{calendar_id}
+export const SYNC_STATES_COLLECTION = "sync-states";

package/dist/types/evo-integrations/index.d.ts

@@ -0,0 +1,133 @@
+export * from "./fb_collections";
+import type { IFireDoc } from "../shared";
+export declare const EvoIntegrationsPermissions: {
+    readonly List: "evo_integrations_read";
+    readonly Get: "evo_integrations_read";
+    readonly Create: "evo_integrations_write";
+    readonly Update: "evo_integrations_write";
+    readonly Delete: "evo_integrations_write";
+    readonly InvokeAction: "evo_integrations_action_invoke";
+};
+export type EvoIntegrationsPermissions = (typeof EvoIntegrationsPermissions)[keyof typeof EvoIntegrationsPermissions];
+export declare const SYNC_RUN_PUBSUB_TOPIC = "evo-integrations.sync_runs";
+export declare const SYNC_RUN_HANDLER = "evo-integrations.sync-run";
+export type CapabilityEntity = "appointment" | "patient" | "payment" | "sync";
+export type CapabilityName = "appointment.get" | "appointment.list" | "appointment.create" | "appointment.update" | "appointment.cancel" | "appointment.confirm" | "appointment.reschedule" | "patient.get" | "patient.list" | "patient.create" | "patient.update" | "patient.document.upload" | "payment.update" | "sync.appointments";
+/**
+ * Capabilities obrigatórias em qualquer adapter. Sem elas, o adapter
+ * não pode ser ativado. `appointment.get` é fundamental pra auto-deleção
+ * confiável via get-after-diff.
+ */
+export declare const OBLIGATORY_CAPABILITIES: readonly CapabilityName[];
+/**
+ * Capabilities internas (não expostas via action dispatcher — apenas
+ * via sync engine / task-runner).
+ */
+export declare function isInternalCapability(name: CapabilityName): boolean;
+export declare function splitCapabilityName(name: CapabilityName): {
+    entity: CapabilityEntity;
+    action: string;
+};
+export type AdapterCategory = "clinic-agenda" | "prontuario" | "misc";
+export type AdapterStatus = "active" | "disabled" | "beta";
+/**
+ * Doc Firestore global do adapter, gerenciado pela Nexus UI.
+ * Path: /platform/evo-integrations/adapters/{adapter_id}
+ */
+export interface IIntegrationsAdapterDoc extends IFireDoc {
+    name: string;
+    description?: string;
+    category: AdapterCategory;
+    status: AdapterStatus;
+    /** Semver string do código do adapter (distinto do `version` numérico do IFireDoc). */
+    adapter_version: string;
+    /**
+     * URLs default dos workflows n8n por capability.
+     * Precedência: calendar.integration.workflow_overrides → este doc → adapter code default.
+     */
+    default_workflow_urls: Partial<Record<CapabilityName, string>>;
+    supported_capabilities: readonly CapabilityName[];
+    auth_schema_version?: number;
+}
+export type IntegrationCredentialStatus = "active" | "paused" | "revoked";
+export interface IIntegrationsCredential extends IFireDoc {
+    adapter_id: string;
+    name: string;
+    /**
+     * Referência ao secret no Google Secret Manager.
+     * Formato: projects/hr-evo360/secrets/evo-integrations-{tenant}-{cred_id}
+     */
+    secret_ref: string;
+    /** Config não-secreta (api_base, external_org_id, etc.). */
+    config?: Record<string, unknown>;
+    status: IntegrationCredentialStatus;
+    last_used_at?: Date | null;
+}
+export type SyncWindowType = "hot" | "warm" | "recent_reconcile" | "cold";
+export interface ICoveredWindow {
+    start: Date;
+    end: Date;
+}
+export interface ISyncedHashes {
+    patients: Record<string, string>;
+    appointments: Record<string, string>;
+}
+export interface ISyncState extends IFireDoc {
+    calendar_id: string;
+    last_sync_at?: Date | null;
+    last_window_type?: SyncWindowType;
+    last_synced_hashes: ISyncedHashes;
+    last_coveredWindow?: ICoveredWindow | null;
+}
+export type SyncRunStatus = "success" | "partial" | "error";
+export interface ISyncRunEventError {
+    code?: string;
+    message: string;
+    details?: Record<string, unknown>;
+}
+export interface ISyncRunEvent {
+    run_id: string;
+    tenant: string;
+    calendar_id: string;
+    adapter_id: string;
+    window_type: SyncWindowType;
+    started_at: Date;
+    finished_at: Date;
+    status: SyncRunStatus;
+    patients_upserted: number;
+    appointments_upserted: number;
+    appointments_skipped: number;
+    deletions_detected: number;
+    coveredWindow_start?: Date;
+    coveredWindow_end?: Date;
+    duration_ms: number;
+    firestore_reads: number;
+    firestore_writes: number;
+    n8n_calls: number;
+    errors?: ISyncRunEventError[];
+}
+export interface ISyncWindowConfig {
+    enabled: boolean;
+    /** Cadência em minutos. Ex.: hot=60, warm=360, cold=10080 (semanal). */
+    cadence_minutes: number;
+    /** Janela absoluta em dias a partir de "hoje". */
+    window_days: {
+        past: number;
+        future: number;
+    };
+}
+export interface ISyncConfig {
+    hot?: ISyncWindowConfig;
+    warm?: ISyncWindowConfig;
+    recent_reconcile?: ISyncWindowConfig;
+    cold?: ISyncWindowConfig;
+}
+export interface IMedCalendarIntegration {
+    adapter_id: string;
+    credentials_id: string;
+    /** Prefixo opcional pra namespacing de patient_id entre adapters/calendars. Default vazio. */
+    patient_prefix?: string;
+    sync_config: ISyncConfig;
+    /** Override por capability — precedência mais alta no resolver de URL. */
+    workflow_overrides?: Partial<Record<CapabilityName, string>>;
+}

package/dist/types/evo-integrations/index.js

@@ -0,0 +1,71 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OBLIGATORY_CAPABILITIES = exports.SYNC_RUN_HANDLER = exports.SYNC_RUN_PUBSUB_TOPIC = exports.EvoIntegrationsPermissions = void 0;
+exports.isInternalCapability = isInternalCapability;
+exports.splitCapabilityName = splitCapabilityName;
+__exportStar(require("./fb_collections"), exports);
+// ======================================================
+// evo-integrations
+//
+// Padroniza integração com sistemas externos de agenda/prontuário
+// (iClinic, Feegow, MedX, ...). Feat-004.
+//
+// Arquitetura em 4 pilares:
+// 1. Adapter registry global (Nexus-managed, /platform/evo-integrations/adapters)
+// 2. Credential vault (Google Secret Manager; n8n lê via SA direto)
+// 3. Sync engine (handler do evo-task-runner; janelas hot/warm/recent_reconcile/cold)
+// 4. Action envelope (dispatcher transparente — uma URL fixa pra consumers)
+// ======================================================
+// ----- Permissions
+exports.EvoIntegrationsPermissions = {
+    List: "evo_integrations_read",
+    Get: "evo_integrations_read",
+    Create: "evo_integrations_write",
+    Update: "evo_integrations_write",
+    Delete: "evo_integrations_write",
+    InvokeAction: "evo_integrations_action_invoke",
+};
+// ----- PubSub topics
+// 1 evento por sync run, sink em BigQuery (hr-evo360.evo_log.evo_integrations_sync_runs).
+exports.SYNC_RUN_PUBSUB_TOPIC = "evo-integrations.sync_runs";
+// Handler do evo-task-runner — resolve pro tópico ${handler}.execute_requests.
+exports.SYNC_RUN_HANDLER = "evo-integrations.sync-run";
+/**
+ * Capabilities obrigatórias em qualquer adapter. Sem elas, o adapter
+ * não pode ser ativado. `appointment.get` é fundamental pra auto-deleção
+ * confiável via get-after-diff.
+ */
+exports.OBLIGATORY_CAPABILITIES = [
+    "appointment.get",
+    "appointment.create",
+    "appointment.update",
+    "appointment.cancel",
+    "appointment.confirm",
+    "patient.get",
+    "sync.appointments",
+];
+/**
+ * Capabilities internas (não expostas via action dispatcher — apenas
+ * via sync engine / task-runner).
+ */
+function isInternalCapability(name) {
+    return name === "sync.appointments";
+}
+function splitCapabilityName(name) {
+    const [entity, ...rest] = name.split(".");
+    return { entity: entity, action: rest.join(".") };
+}

package/dist/types/evo-integrations/index.ts

@@ -0,0 +1,232 @@
+export * from "./fb_collections";
+import type { IFireDoc } from "../shared";
+
+// ======================================================
+// evo-integrations
+//
+// Padroniza integração com sistemas externos de agenda/prontuário
+// (iClinic, Feegow, MedX, ...). Feat-004.
+//
+// Arquitetura em 4 pilares:
+// 1. Adapter registry global (Nexus-managed, /platform/evo-integrations/adapters)
+// 2. Credential vault (Google Secret Manager; n8n lê via SA direto)
+// 3. Sync engine (handler do evo-task-runner; janelas hot/warm/recent_reconcile/cold)
+// 4. Action envelope (dispatcher transparente — uma URL fixa pra consumers)
+// ======================================================
+
+// ----- Permissions
+export const EvoIntegrationsPermissions = {
+  List: "evo_integrations_read",
+  Get: "evo_integrations_read",
+  Create: "evo_integrations_write",
+  Update: "evo_integrations_write",
+  Delete: "evo_integrations_write",
+  InvokeAction: "evo_integrations_action_invoke",
+} as const;
+
+export type EvoIntegrationsPermissions =
+  (typeof EvoIntegrationsPermissions)[keyof typeof EvoIntegrationsPermissions];
+
+// ----- PubSub topics
+// 1 evento por sync run, sink em BigQuery (hr-evo360.evo_log.evo_integrations_sync_runs).
+export const SYNC_RUN_PUBSUB_TOPIC = "evo-integrations.sync_runs";
+
+// Handler do evo-task-runner — resolve pro tópico ${handler}.execute_requests.
+export const SYNC_RUN_HANDLER = "evo-integrations.sync-run";
+
+// ======================================================
+// Capabilities — nomenclatura {entity}.{action}
+// ======================================================
+
+export type CapabilityEntity = "appointment" | "patient" | "payment" | "sync";
+
+export type CapabilityName =
+  | "appointment.get"
+  | "appointment.list"
+  | "appointment.create"
+  | "appointment.update"
+  | "appointment.cancel"
+  | "appointment.confirm"
+  | "appointment.reschedule"
+  | "patient.get"
+  | "patient.list"
+  | "patient.create"
+  | "patient.update"
+  | "patient.document.upload"
+  | "payment.update"
+  | "sync.appointments";
+
+/**
+ * Capabilities obrigatórias em qualquer adapter. Sem elas, o adapter
+ * não pode ser ativado. `appointment.get` é fundamental pra auto-deleção
+ * confiável via get-after-diff.
+ */
+export const OBLIGATORY_CAPABILITIES: readonly CapabilityName[] = [
+  "appointment.get",
+  "appointment.create",
+  "appointment.update",
+  "appointment.cancel",
+  "appointment.confirm",
+  "patient.get",
+  "sync.appointments",
+] as const;
+
+/**
+ * Capabilities internas (não expostas via action dispatcher — apenas
+ * via sync engine / task-runner).
+ */
+export function isInternalCapability(name: CapabilityName): boolean {
+  return name === "sync.appointments";
+}
+
+export function splitCapabilityName(name: CapabilityName): {
+  entity: CapabilityEntity;
+  action: string;
+} {
+  const [entity, ...rest] = name.split(".");
+  return { entity: entity as CapabilityEntity, action: rest.join(".") };
+}
+
+// ======================================================
+// Adapter — contrato declarativo
+// Código do adapter vive em @evo/model/evo-integrations/adapters/{id}.
+// Doc correspondente em Firestore (/platform/evo-integrations/adapters/{id})
+// pode overrider URLs default sem deploy.
+// ======================================================
+
+export type AdapterCategory = "clinic-agenda" | "prontuario" | "misc";
+export type AdapterStatus = "active" | "disabled" | "beta";
+
+/**
+ * Doc Firestore global do adapter, gerenciado pela Nexus UI.
+ * Path: /platform/evo-integrations/adapters/{adapter_id}
+ */
+export interface IIntegrationsAdapterDoc extends IFireDoc {
+  name: string;
+  description?: string;
+  category: AdapterCategory;
+  status: AdapterStatus;
+  /** Semver string do código do adapter (distinto do `version` numérico do IFireDoc). */
+  adapter_version: string;
+  /**
+   * URLs default dos workflows n8n por capability.
+   * Precedência: calendar.integration.workflow_overrides → este doc → adapter code default.
+   */
+  default_workflow_urls: Partial<Record<CapabilityName, string>>;
+  supported_capabilities: readonly CapabilityName[];
+  auth_schema_version?: number;
+}
+
+// ======================================================
+// Credential — metadados. Raw creds vivem no Google Secret Manager.
+// Path: /tenants/{t}/apps/evo-med/integration-credentials/{cred_id}
+// ======================================================
+
+export type IntegrationCredentialStatus = "active" | "paused" | "revoked";
+
+export interface IIntegrationsCredential extends IFireDoc {
+  adapter_id: string;
+  name: string;
+  /**
+   * Referência ao secret no Google Secret Manager.
+   * Formato: projects/hr-evo360/secrets/evo-integrations-{tenant}-{cred_id}
+   */
+  secret_ref: string;
+  /** Config não-secreta (api_base, external_org_id, etc.). */
+  config?: Record<string, unknown>;
+  status: IntegrationCredentialStatus;
+  last_used_at?: Date | null;
+}
+
+// ======================================================
+// Sync state — 1 doc por calendar, mutável.
+// Path: /tenants/{t}/apps/evo-med/sync-states/{calendar_id}
+// ======================================================
+
+export type SyncWindowType = "hot" | "warm" | "recent_reconcile" | "cold";
+
+export interface ICoveredWindow {
+  start: Date;
+  end: Date;
+}
+
+export interface ISyncedHashes {
+  patients: Record<string, string>;
+  appointments: Record<string, string>;
+}
+
+export interface ISyncState extends IFireDoc {
+  calendar_id: string;
+  last_sync_at?: Date | null;
+  last_window_type?: SyncWindowType;
+  last_synced_hashes: ISyncedHashes;
+  last_coveredWindow?: ICoveredWindow | null;
+}
+
+// ======================================================
+// Sync run event — publicado no SYNC_RUN_PUBSUB_TOPIC ao final de cada run.
+// Schema espelha a tabela BigQuery (hr-evo360.evo_log.evo_integrations_sync_runs).
+// ======================================================
+
+export type SyncRunStatus = "success" | "partial" | "error";
+
+export interface ISyncRunEventError {
+  code?: string;
+  message: string;
+  details?: Record<string, unknown>;
+}
+
+export interface ISyncRunEvent {
+  run_id: string;
+  tenant: string;
+  calendar_id: string;
+  adapter_id: string;
+  window_type: SyncWindowType;
+  started_at: Date;
+  finished_at: Date;
+  status: SyncRunStatus;
+  patients_upserted: number;
+  appointments_upserted: number;
+  appointments_skipped: number;
+  deletions_detected: number;
+  coveredWindow_start?: Date;
+  coveredWindow_end?: Date;
+  duration_ms: number;
+  firestore_reads: number;
+  firestore_writes: number;
+  n8n_calls: number;
+  errors?: ISyncRunEventError[];
+}
+
+// ======================================================
+// Calendar integration config — vive inline no calendar doc.
+// Ver IMedCalendar em evo-types/src/types/evo-med/calendar.
+// ======================================================
+
+export interface ISyncWindowConfig {
+  enabled: boolean;
+  /** Cadência em minutos. Ex.: hot=60, warm=360, cold=10080 (semanal). */
+  cadence_minutes: number;
+  /** Janela absoluta em dias a partir de "hoje". */
+  window_days: {
+    past: number;
+    future: number;
+  };
+}
+
+export interface ISyncConfig {
+  hot?: ISyncWindowConfig;
+  warm?: ISyncWindowConfig;
+  recent_reconcile?: ISyncWindowConfig;
+  cold?: ISyncWindowConfig;
+}
+
+export interface IMedCalendarIntegration {
+  adapter_id: string;
+  credentials_id: string;
+  /** Prefixo opcional pra namespacing de patient_id entre adapters/calendars. Default vazio. */
+  patient_prefix?: string;
+  sync_config: ISyncConfig;
+  /** Override por capability — precedência mais alta no resolver de URL. */
+  workflow_overrides?: Partial<Record<CapabilityName, string>>;
+}

package/dist/types/evo-med/calendar/index.d.ts

@@ -1,6 +1,7 @@
 export * from "../../evo-people/fb_collections";
 import type { FirestoreDocumentReference, IFireDoc, ITag } from "../../shared";
 import type { IAppointmentCounters } from "../people";
+import type { IMedCalendarIntegration } from "../../evo-integrations";
 export declare const EvoMedCalendarPermissions: {
     readonly List: "evo_med_calendar_read";
     readonly Get: "evo_med_calendar_read";
@@ -35,5 +36,6 @@ export interface IMedCalendar extends IFireDoc {
     appointmentCounters?: IAppointmentCounters | null;
     available_weekdays?: number[];
     available_for_hubia?: boolean;
+    integration?: IMedCalendarIntegration;
     [key: string]: unknown;
 }

package/dist/types/evo-med/calendar/index.ts

@@ -1,6 +1,7 @@
 export * from "../../evo-people/fb_collections";
 import type { FirestoreDocumentReference, IFireDoc, ITag } from "../../shared";
 import type { IAppointmentCounters } from "../people";
+import type { IMedCalendarIntegration } from "../../evo-integrations";
 
 // Permissões para o calendário
 export const EvoMedCalendarPermissions = {
@@ -44,5 +45,7 @@ export interface IMedCalendar extends IFireDoc {
   available_weekdays?: number[];
   // Se true, a agenda é elegível para oferecer horários via HubIA
   available_for_hubia?: boolean;
+  // Config de integração (feat-004 evo-integrations). Opcional — calendars legados mantêm n8n_wf/url/ext_urls.
+  integration?: IMedCalendarIntegration;
   [key: string]: unknown; // index signature
 }

package/dist/types/evo-tenant/index.d.ts

@@ -35,7 +35,7 @@ export declare enum ITenantStatus {
 }
 export interface ITenant extends IFireDoc {
     name: string;
-    base_tenant?: string;
+    base_tenant?: string | null;
     hidden?: boolean;
     readonly?: boolean;
     url_alias: string;

package/dist/types/evo-tenant/index.ts

@@ -48,7 +48,7 @@ export enum ITenantStatus {
 
 export interface ITenant extends IFireDoc {
   name: string;
-  base_tenant?: string;
+  base_tenant?: string | null;
   hidden?: boolean;
   readonly?: boolean;
   url_alias: string;

package/package.json

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