evo360-types 1.3.570 → 1.3.574

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

@@ -0,0 +1,361 @@
+"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.TelemedicineErrorCode = exports.EntitlementAuditActionEnum = exports.TranscriptionProviderEnum = exports.LegalTextStatusEnum = exports.WebhookEventStatusEnum = exports.TeleconsultationEventTypeEnum = exports.TeleconsultationEventSourceEnum = exports.TeleconsultationEventActorTypeEnum = exports.EndedByTypeEnum = exports.AccessSendChannelKindEnum = exports.AccessGrantStateEnum = exports.AccessGrantKindEnum = exports.ArtifactStatusEnum = exports.ArtifactTypeEnum = exports.ConsentActorTypeEnum = exports.ConsentDecisionEnum = exports.ConsentSubjectEnum = exports.TranscriptionStatusEnum = exports.RecordingStatusEnum = exports.IdentityLevelEnum = exports.PresenceStateEnum = exports.ParticipantStateEnum = exports.ParticipantRoleEnum = exports.TeleconsultationProviderEnum = exports.TeleconsultationModeEnum = exports.WaitingPolicyEnum = exports.TELECONSULTATION_TERMINAL_STATUSES = exports.TeleconsultationStatusEnum = exports.TELEMEDICINE_WINDOW_DEFAULTS = exports.TELEMEDICINE_JOIN_REMINDER_HANDLER = exports.TELEMEDICINE_JOIN_ACTION_TYPE = exports.EvoTelemedicinePermissions = void 0;
+__exportStar(require("./fb_collections"), exports);
+// ======================================================
+// evo-telemedicine (feat-160 — Telemedicina integrada)
+//
+// Contratos compartilhados entre `functions-telemedicine`, `packages/model`,
+// o web-app (painel) e o SPA `web-virtual-care`. Shapes seguem
+// `hub-medica-docs/features/feat-160-telemedicine-platform-mvp/data-model.md`.
+//
+// Regras que os tipos carregam:
+// - nada de PII do paciente (nome/telefone/e-mail/DOB), token do provider,
+//   capability `/qr`, cookie, URL assinada ou texto de transcrição nos docs;
+// - segredos de grant existem só como hash/HMAC (`secret_hash`);
+// - eventos são append-only e a `metadata` é allowlist sem PII/conteúdo médico;
+// - o acesso exige entitlement do tenant AND rollout operacional AND permissão.
+//
+// Convenção de datas: docs Firestore usam `Date` (como o resto do repo — o zod
+// converte Timestamp via `zFirestoreDateSchema`); DTOs HTTP usam ISO 8601 em
+// `string` (JSON não transporta Date).
+// ======================================================
+// ----- Permissões (spec §9.3)
+exports.EvoTelemedicinePermissions = {
+    /** Ver estado e dados operacionais básicos. */
+    Read: "evo_telemedicine_read",
+    /** Preparar, admitir, entrar como médico e encerrar. */
+    Host: "evo_telemedicine_host",
+    /** Solicitar/iniciar/parar gravação. */
+    Record: "evo_telemedicine_record",
+    /** Listar e baixar gravações/transcrições. */
+    ArtifactsRead: "evo_telemedicine_artifacts_read",
+    /** Alterar defaults permitidos do tenant; reatribuir host. */
+    Configure: "evo_telemedicine_configure",
+    /** Consultar trilha detalhada (events). */
+    AuditRead: "evo_telemedicine_audit_read",
+};
+// ----- Constantes de integração
+/** `action_type` do quick-reply `/qr` que redireciona para `/api/public/v1/enter/{cap}` (redirect puro, reexecutável). */
+exports.TELEMEDICINE_JOIN_ACTION_TYPE = "telemedicine_join";
+/** Handler do lembrete/CTA de entrada — igual a `TaskAutoHandlerEnum.TelemedicineJoinReminder`. */
+exports.TELEMEDICINE_JOIN_REMINDER_HANDLER = "telemedicine_join_reminder";
+/**
+ * Defaults de janela do MVP (spec §8.2/§8.3/D23) — configuráveis só em nível de
+ * plataforma. Em minutos, salvo indicação.
+ */
+exports.TELEMEDICINE_WINDOW_DEFAULTS = {
+    /** Médico prepara/entra desde N minutos antes do início previsto. */
+    doctor_access_before_minutes: 30,
+    /** Paciente abre o fluxo desde N minutos antes do início previsto. */
+    patient_access_before_minutes: 15,
+    /** Se nunca iniciou: expira N minutos após o fim previsto. */
+    unused_expires_after_end_minutes: 120,
+    /** Reconexão após última presença do médico. */
+    reconnect_grace_minutes: 10,
+    /** Code one-time de exchange (`launch_code`). */
+    launch_code_ttl_minutes: 5,
+    /** Access da sessão pública do browser (`browser_session`), renovável de forma rotativa. */
+    browser_session_ttl_minutes: 15,
+    /** Verificação de identidade: N falhas na janela bloqueiam o grant. */
+    identity_max_failures: 5,
+    identity_failure_window_minutes: 15,
+    identity_block_minutes: 30,
+    /** URL assinada de artefato. */
+    signed_url_max_minutes: 5,
+    /** Bits aleatórios mínimos de capability/code. */
+    secret_min_bits: 128,
+};
+// ----- Enums (espelhados à mão em apps/evo-telemedicine/zod-schemas.ts)
+/** Estado clínico da teleconsulta (spec §10). Presença é separada (`ParticipantState`). */
+exports.TeleconsultationStatusEnum = {
+    /** Vínculo criado, janela fechada. */
+    Scheduled: "scheduled",
+    /** Janela aberta, nenhum encontro ativo. */
+    Open: "open",
+    /** Ao menos uma sessão física ativa ou presença clínica em curso. */
+    Live: "live",
+    /** Consulta iniciada, médico sem presença dentro da tolerância. */
+    Reconnecting: "reconnecting",
+    /** Encerramento em andamento; novos joins proibidos. */
+    Ending: "ending",
+    Ended: "ended",
+    Cancelled: "cancelled",
+    Expired: "expired",
+};
+/** Terminais: nunca ressuscitam (webhook atrasado, reschedule, join). */
+exports.TELECONSULTATION_TERMINAL_STATUSES = [
+    "ended",
+    "cancelled",
+    "expired",
+];
+exports.WaitingPolicyEnum = {
+    /** Default. Médico admite manualmente. */
+    ManualAdmit: "manual_admit",
+    /** Entrada automática só com médico `connected` e `identity_level = strong`; nunca em sala vazia. */
+    AutoWhenDoctorPresent: "auto_when_doctor_present",
+};
+exports.TeleconsultationModeEnum = {
+    AudioVideo: "audio_video",
+    AudioOnlyAllowed: "audio_only_allowed",
+};
+exports.TeleconsultationProviderEnum = {
+    RealtimeKit: "realtimekit",
+};
+exports.ParticipantRoleEnum = {
+    Doctor: "doctor",
+    Patient: "patient",
+};
+/** Presença — separada do estado clínico da teleconsulta. */
+exports.ParticipantStateEnum = {
+    Invited: "invited",
+    Verified: "verified",
+    Waiting: "waiting",
+    Connected: "connected",
+    Disconnected: "disconnected",
+    Left: "left",
+};
+/** Subconjunto de `ParticipantState` que o cliente pode reportar em `POST /presence`. */
+exports.PresenceStateEnum = {
+    Waiting: "waiting",
+    Connected: "connected",
+    Disconnected: "disconnected",
+    Left: "left",
+};
+/**
+ * Nível de verificação da identidade do paciente (spec §8.3): `strong` = nome +
+ * DOB conferidos; `weak` = só nome (paciente sem DOB) — proíbe `auto_admit`.
+ */
+exports.IdentityLevelEnum = {
+    None: "none",
+    Weak: "weak",
+    Strong: "strong",
+};
+exports.RecordingStatusEnum = {
+    Idle: "idle",
+    ConsentPending: "consent_pending",
+    Recording: "recording",
+    Stopping: "stopping",
+    Failed: "failed",
+};
+exports.TranscriptionStatusEnum = {
+    NotRequested: "not_requested",
+    Queued: "queued",
+    Processing: "processing",
+    Ready: "ready",
+    Failed: "failed",
+    Deleted: "deleted",
+};
+exports.ConsentSubjectEnum = {
+    Terms: "terms",
+    Privacy: "privacy",
+    Recording: "recording",
+    Transcription: "transcription",
+};
+exports.ConsentDecisionEnum = {
+    Accepted: "accepted",
+    Declined: "declined",
+    Withdrawn: "withdrawn",
+};
+exports.ConsentActorTypeEnum = {
+    Patient: "patient",
+    Doctor: "doctor",
+};
+exports.ArtifactTypeEnum = {
+    RecordingAudioVideo: "recording_audio_video",
+    RecordingAudio: "recording_audio",
+    Transcript: "transcript",
+};
+exports.ArtifactStatusEnum = {
+    Pending: "pending",
+    Processing: "processing",
+    Ready: "ready",
+    Failed: "failed",
+    Deleting: "deleting",
+    Deleted: "deleted",
+};
+exports.AccessGrantKindEnum = {
+    /** Capability de 128 bits no link `/qr`; reexecutável na janela da teleconsulta. */
+    QrCapability: "qr_capability",
+    /** Code one-time de exchange (5 min) — médico (`/launch`) ou filho do `/enter`. */
+    LaunchCode: "launch_code",
+    /** Sessão do browser (cookie `__session`), 15 min, rotativa. */
+    BrowserSession: "browser_session",
+};
+exports.AccessGrantStateEnum = {
+    Active: "active",
+    Consumed: "consumed",
+    Blocked: "blocked",
+    Revoked: "revoked",
+    Expired: "expired",
+};
+/** Canal pelo qual o CTA de acesso do paciente é (re)enviado. `manual` só devolve a URL mascarada (smoke). */
+exports.AccessSendChannelKindEnum = {
+    WhatsApp: "whatsapp",
+    Email: "email",
+    Manual: "manual",
+};
+exports.EndedByTypeEnum = {
+    User: "user",
+    System: "system",
+};
+exports.TeleconsultationEventActorTypeEnum = {
+    User: "user",
+    Patient: "patient",
+    System: "system",
+    Provider: "provider",
+};
+exports.TeleconsultationEventSourceEnum = {
+    Api: "api",
+    Webhook: "webhook",
+    AppointmentReconciler: "appointment_reconciler",
+    RetentionJob: "retention_job",
+    /** `telemed_sweep`: expiração de não usadas, timeout de reconexão, outbox órfã. */
+    Sweep: "sweep",
+};
+/** Tipos de evento append-only (data-model §5 + acréscimos do plan). */
+exports.TeleconsultationEventTypeEnum = {
+    TeleconsultationCreated: "teleconsultation.created",
+    TeleconsultationRescheduled: "teleconsultation.rescheduled",
+    TeleconsultationCancelled: "teleconsultation.cancelled",
+    TeleconsultationExpired: "teleconsultation.expired",
+    /** Alteração tardia na agenda com consulta já iniciada — tratamento operacional, não apaga o encontro. */
+    TeleconsultationDiverged: "teleconsultation.diverged",
+    AccessCreated: "access.created",
+    AccessRevoked: "access.revoked",
+    AccessExchanged: "access.exchanged",
+    AccessVerificationFailed: "access.verification_failed",
+    AccessBlocked: "access.blocked",
+    HostClaimed: "host.claimed",
+    HostReassigned: "host.reassigned",
+    WaitingPolicyChanged: "waiting_policy.changed",
+    DoctorPrepared: "doctor.prepared",
+    DoctorJoined: "doctor.joined",
+    DoctorDisconnected: "doctor.disconnected",
+    DoctorRejoined: "doctor.rejoined",
+    DoctorLeft: "doctor.left",
+    PatientVerified: "patient.verified",
+    PatientWaiting: "patient.waiting",
+    PatientAdmitted: "patient.admitted",
+    PatientRejected: "patient.rejected",
+    PatientJoined: "patient.joined",
+    PatientDisconnected: "patient.disconnected",
+    PatientRejoined: "patient.rejoined",
+    PatientLeft: "patient.left",
+    RecordingConsentRequested: "recording.consent_requested",
+    RecordingConsentAccepted: "recording.consent_accepted",
+    RecordingConsentDeclined: "recording.consent_declined",
+    RecordingConsentWithdrawn: "recording.consent_withdrawn",
+    RecordingStarted: "recording.started",
+    RecordingStopped: "recording.stopped",
+    RecordingFailed: "recording.failed",
+    TranscriptionQueued: "transcription.queued",
+    TranscriptionReady: "transcription.ready",
+    TranscriptionFailed: "transcription.failed",
+    TranscriptionDeleted: "transcription.deleted",
+    ConsultationStarted: "consultation.started",
+    ConsultationReconnecting: "consultation.reconnecting",
+    ConsultationEnded: "consultation.ended",
+    ArtifactAccessed: "artifact.accessed",
+    ArtifactDeleted: "artifact.deleted",
+    EntitlementDenied: "entitlement.denied",
+    RolloutDenied: "rollout.denied",
+    PermissionDenied: "permission.denied",
+    /** Evento do provider desconhecido/ignorado — registrado, não processado. */
+    WebhookObserved: "webhook.observed",
+};
+/** Outbox durável do webhook (data-model §6): claim/lease como o task-runner. */
+exports.WebhookEventStatusEnum = {
+    Pending: "pending",
+    Claimed: "claimed",
+    Completed: "completed",
+    Failed: "failed",
+};
+exports.LegalTextStatusEnum = {
+    Draft: "draft",
+    Published: "published",
+    Retired: "retired",
+};
+exports.TranscriptionProviderEnum = {
+    None: "none",
+    RealtimeKit: "realtimekit",
+};
+// ======================================================
+// Auditoria de entitlement (`.../entitlement-audit/{id}`, data-model §8)
+// ======================================================
+exports.EntitlementAuditActionEnum = {
+    Set: "set",
+    Override: "override",
+    Revoke: "revoke",
+};
+// ======================================================
+// Códigos de erro (plan §4 — `{ ok: false, error: '<CODE>', message? }` com status estável)
+// ======================================================
+exports.TelemedicineErrorCode = {
+    /** 403 — entitlement ausente/inativo (sem bypass de super admin). */
+    TenantModuleDisabled: "TENANT_MODULE_DISABLED",
+    /** 403 — kill switch operacional (`create|join|recording|transcription`). */
+    RolloutDisabled: "ROLLOUT_DISABLED",
+    /** 403 — `emergency_kill` ligado. */
+    EmergencyKill: "EMERGENCY_KILL",
+    /** 403 — RBAC. */
+    PermissionDenied: "PERMISSION_DENIED",
+    /** 403 — capability do entitlement ausente/false (`recording`, `transcription`, `auto_admit`). */
+    CapabilityDisabled: "CAPABILITY_DISABLED",
+    /** 404 — teleconsulta/artefato/grant inexistente (ou genérico, em rota pública). */
+    NotFound: "NOT_FOUND",
+    /** 409 — fora da janela (antes de `*_access_from` ou após `unused_expires_at`). */
+    AccessWindowClosed: "ACCESS_WINDOW_CLOSED",
+    /** 409 — outro médico já fez o claim de host. */
+    HostClaimedByOther: "HOST_CLAIMED_BY_OTHER",
+    /** 409 — comando exige médico claimant presente (admit/end/recording). */
+    HostRequired: "HOST_REQUIRED",
+    /** 409 — termos/privacidade (ou gravação) não aceitos na versão vigente. */
+    ConsentRequired: "CONSENT_REQUIRED",
+    /** 409 — paciente ainda não verificou identidade. */
+    IdentityRequired: "IDENTITY_REQUIRED",
+    /** 401 — verificação de identidade falhou (erro neutro: não diz qual campo). */
+    IdentityVerificationFailed: "IDENTITY_VERIFICATION_FAILED",
+    /** 429 — grant bloqueado por excesso de falhas. */
+    GrantBlocked: "GRANT_BLOCKED",
+    /** 401 — grant/code inválido, consumido, expirado ou revogado (genérico por design). */
+    GrantInvalid: "GRANT_INVALID",
+    /** 401 — cookie `__session` ausente/inválido/expirado. */
+    SessionInvalid: "SESSION_INVALID",
+    /** 410 — estado terminal (`ended|cancelled|expired`). */
+    TeleconsultationTerminal: "TELECONSULTATION_TERMINAL",
+    /** 409 — transição de estado não permitida (spec §10). */
+    InvalidTransition: "INVALID_TRANSITION",
+    /** 409 — `expected_version` divergente. */
+    VersionConflict: "VERSION_CONFLICT",
+    /** 409 — política de espera só muda até o paciente entrar. */
+    WaitingPolicyLocked: "WAITING_POLICY_LOCKED",
+    /** 409 — já existe gravação ativa/pendente. */
+    RecordingActive: "RECORDING_ACTIVE",
+    /** 502 — provider falhou ao gravar (não derruba a consulta). */
+    RecordingFailed: "RECORDING_FAILED",
+    /** 403 — transcrição em produção sem gate aprovado (D12). */
+    TranscriptionGateClosed: "TRANSCRIPTION_GATE_CLOSED",
+    /** 409 — artefato não está `ready`. */
+    ArtifactNotReady: "ARTIFACT_NOT_READY",
+    /** 502 — erro do provider de mídia. */
+    ProviderError: "PROVIDER_ERROR",
+    /** 429 — rate limit por IP-hash/grant. */
+    RateLimited: "RATE_LIMITED",
+    /** 400 — body/params inválidos. */
+    ValidationError: "VALIDATION_ERROR",
+};