@thinkai/tai-api-contract 2.12.0 → 2.14.0

package/src/index.ts

@@ -1019,3 +1019,58 @@ export interface YourAiJourneyAiSpendDto {
     activeUsers: number;
   }[];
 }
+
+// --- HRIS (Personio, ZenHR, …) ---
+
+/** A single absence/leave record sourced from an HRIS provider. */
+export interface WorkspaceAbsenceDto {
+  /** HRIS provider that sourced this record ('personio', 'zenhr', …). */
+  source: string;
+  employeeEmail: string;
+  absenceType: string;
+  /** ISO date YYYY-MM-DD */
+  startDate: string;
+  /** ISO date YYYY-MM-DD */
+  endDate: string;
+  halfDayStart: boolean;
+  halfDayEnd: boolean;
+  status: "approved" | "pending" | "rejected";
+}
+
+/** Response body for GET /workspaces/:id/absences */
+export interface WorkspaceAbsenceListDto {
+  absences: WorkspaceAbsenceDto[];
+  /** ISO timestamp of the most recent successful sync, or null if never synced. */
+  syncedAt: string | null;
+}
+
+/** Sync status for a single HRIS provider connected to a workspace. */
+export interface HrisSyncStatusDto {
+  /** Provider identifier ('personio', 'zenhr', …). */
+  provider: string;
+  lastSyncAt: string | null;
+  status: "ok" | "error" | "never";
+  lastError?: string;
+}
+
+/** Response body for GET /workspaces/:id/hris/status */
+export interface HrisSyncStatusListDto {
+  statuses: HrisSyncStatusDto[];
+}
+
+/** Response body for POST /workspaces/:id/hris/sync (manual trigger). */
+export interface HrisTriggerSyncResultDto {
+  status: "ok" | "skipped" | "error";
+  /** Stable machine-readable code (e.g. 'no_personio_source', 'hris_sync_failed'). */
+  code?: string;
+  /** Number of employees synced (present when status = 'ok'). */
+  employeeCount?: number;
+  /** Number of absence records synced (present when status = 'ok'). */
+  absenceCount?: number;
+  /** Wall-clock duration of the sync in milliseconds (present when status = 'ok'). */
+  durationMs?: number;
+  /** Machine-readable reason for a skipped sync (e.g. 'no_personio_source'). */
+  reason?: string;
+  /** Error message when status = 'error'. */
+  error?: string;
+}