@t4dhg/mcp-factorial 9.0.0 → 10.1.0

package/dist/attendance/planner.d.ts

@@ -0,0 +1,189 @@
+/**
+ * Backfill planner for attendance shifts (registro horario).
+ *
+ * Everything in this module is pure: no network, no clock, no configuration.
+ * The caller gathers facts from the API (worked_times, estimated_times,
+ * existing shifts, approved leaves) and the planner turns them plus the
+ * requested segments into an explicit list of writes and skips. Every rule is
+ * a unit test in src/__tests__/unit/attendance/planner.test.ts.
+ */
+/** A working segment on one day, in company local wall-clock time */
+export interface Segment {
+    clock_in: string;
+    clock_out: string;
+}
+/** One planned shift record */
+export interface PlannedWrite extends Segment {
+    date: string;
+}
+/** What is known about one calendar day for one employee */
+export interface DayFacts {
+    /** worked_times.day_type: workday | saturday | sunday | bank_holiday */
+    day_type: string;
+    /** estimated_times.expected_minutes, from the contract pattern */
+    expected_minutes: number;
+    /** worked_times.tracked_minutes */
+    tracked_minutes: number;
+}
+/** An existing shift as the API reports it; clock_out null means still open */
+export interface ExistingShift {
+    date: string;
+    clock_in: string;
+    clock_out: string | null;
+}
+/** How an approved leave covers a date */
+export type LeaveCover = 'full' | 'beggining_of_day' | 'end_of_day';
+/** The subset of a leave record the planner needs */
+export interface LeaveLike {
+    start_on: string;
+    finish_on: string;
+    half_day: string | null;
+    approved: boolean | null;
+    deleted_at: string | null;
+}
+export interface PlanFacts {
+    /** Today's date, YYYY-MM-DD, in the zone the caller considers local */
+    today: string;
+    /** Per-date facts; a date missing from the map has no contract data */
+    days: Map<string, DayFacts>;
+    /** Existing shifts for the employee within the planned dates */
+    shifts: ExistingShift[];
+    /** Approved leave cover per date, see expandLeaves */
+    leaves: Map<string, LeaveCover>;
+}
+export interface RangeRequest {
+    mode: 'range';
+    employee_id: number;
+    dates: string[];
+    segments: Segment[];
+    skip_leave: boolean;
+    /** Vary each written time by up to this many minutes, deterministically per record */
+    jitter_minutes?: number;
+}
+export interface DaysRequest {
+    mode: 'days';
+    employee_id: number;
+    days: Array<{
+        date: string;
+        segments: Segment[];
+    }>;
+    skip_leave: boolean;
+    /** Vary each written time by up to this many minutes, deterministically per record */
+    jitter_minutes?: number;
+}
+export type PlanRequest = RangeRequest | DaysRequest;
+export type SkipReason = 'future_date' | 'weekend' | 'bank_holiday' | 'not_workable' | 'on_leave' | 'half_day_leave';
+export interface SkippedDay {
+    date: string;
+    reason: SkipReason;
+    detail?: string;
+}
+export interface SkippedSegment extends Segment {
+    date: string;
+    reason: 'overlaps_existing';
+    detail: string;
+}
+export interface BackfillPlan {
+    writes: PlannedWrite[];
+    skippedDays: SkippedDay[];
+    skippedSegments: SkippedSegment[];
+    totals: {
+        days: number;
+        records: number;
+        minutes: number;
+    };
+}
+export interface Gap {
+    date: string;
+    expected_minutes: number;
+    tracked_minutes: number;
+    missing_minutes: number;
+    half_day_leave: 'beggining_of_day' | 'end_of_day' | null;
+}
+/**
+ * A day whose tracked minutes are within this distance of the expected minutes
+ * counts as complete. Real clock-ins are never exact, and jittered backfills
+ * are deliberately not, so a strict comparison would flag nearly every day.
+ */
+export declare const DEFAULT_TOLERANCE_MINUTES = 15;
+/** Parse "HH:MM" into minutes since midnight; anything else is rejected */
+export declare function parseHHMM(value: string): number;
+/** True when two [start, end) intervals share any time; touching does not count */
+export declare function intervalsOverlap(a: [number, number], b: [number, number]): boolean;
+/** Every date from start to end inclusive */
+export declare function enumerateDates(start: string, end: string): string[];
+/**
+ * Validate the segments of one day: HH:MM only, clock_in strictly before
+ * clock_out, no overnight shifts, no overlap between segments.
+ */
+export declare function validateSegments(segments: Segment[]): void;
+/**
+ * Turn leave records into a per-date cover map. Only approved, undeleted
+ * leaves count; a pending (approved: null) or rejected leave does not block
+ * anything. A later leave over the same date never downgrades a full cover.
+ */
+export declare function expandLeaves(leaves: LeaveLike[]): Map<string, LeaveCover>;
+/**
+ * Apply per-record variation to a day's segments. Nobody clocks in at exactly
+ * 09:00 every day, so a month of identical times is the one pattern a real
+ * registro never shows. The variation is derived from a hash of the employee,
+ * the date and the segment, so re-planning the same request yields the same
+ * times: the preview shows exactly what will be written, the confirmation
+ * token binds to it, and a retry after a partial failure recognises its own
+ * earlier writes. Segments never cross each other or midnight.
+ */
+export declare function jitterSegments(employeeId: number, date: string, segments: Segment[], magnitude: number): Segment[];
+/**
+ * Build the plan. Skip reasons are evaluated in the documented order and the
+ * first match wins. Explicit days skip the weekday, holiday and workability
+ * rules on purpose: migration must be able to write a Saturday someone worked.
+ */
+export declare function buildBackfillPlan(request: PlanRequest, facts: PlanFacts): BackfillPlan;
+/**
+ * Stable digest of who and what a plan writes, including the note stored on
+ * every record; the confirmation token is bound to it.
+ */
+export declare function planFingerprint(employeeId: number, writes: PlannedWrite[], observations?: string): string;
+/**
+ * Workdays up to today where the contract expects more than was tracked and no
+ * full-day leave applies. Future dates are left out, since log_range would
+ * refuse them anyway.
+ */
+export declare function computeGaps(facts: PlanFacts, toleranceMinutes?: number): Gap[];
+export type LedgerStatus = 'future' | 'weekend' | 'bank_holiday' | 'not_workable' | 'on_leave' | 'half_day_leave' | 'complete' | 'missing' | 'over';
+export interface LedgerDay {
+    date: string;
+    day_type: string | null;
+    expected_minutes: number;
+    tracked_minutes: number;
+    leave: LeaveCover | null;
+    shifts: Array<{
+        clock_in: string;
+        clock_out: string | null;
+        minutes: number | null;
+    }>;
+    status: LedgerStatus;
+    /** tracked minus expected; negative means hours are missing */
+    delta_minutes: number;
+}
+/**
+ * One row per calendar day in the range, with everything the planner knows
+ * about it, for auditing what was clocked against what the contract, the
+ * company calendar and the leave record say should have been.
+ */
+export declare function computeLedger(dates: string[], facts: PlanFacts, toleranceMinutes?: number): LedgerDay[];
+/** 720 -> "12h", 750 -> "12h30" */
+export declare function hours(minutes: number): string;
+/**
+ * Render the plan the way the confirmation step shows it. It always names the
+ * person, because the company-wide key makes writing someone else's hours the
+ * mistake worth catching.
+ */
+export declare function formatPlanPreview(plan: BackfillPlan, employee: {
+    id: number;
+    name: string;
+}, range: {
+    start: string;
+    end: string;
+}, request: PlanRequest, observations?: string): string;
+//# sourceMappingURL=planner.d.ts.map

package/dist/attendance/planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../src/attendance/planner.ts"],"names":[],"mappings":"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"}

package/dist/attendance/planner.js

@@ -0,0 +1,427 @@
+/**
+ * Backfill planner for attendance shifts (registro horario).
+ *
+ * Everything in this module is pure: no network, no clock, no configuration.
+ * The caller gathers facts from the API (worked_times, estimated_times,
+ * existing shifts, approved leaves) and the planner turns them plus the
+ * requested segments into an explicit list of writes and skips. Every rule is
+ * a unit test in src/__tests__/unit/attendance/planner.test.ts.
+ */
+import { createHash } from 'node:crypto';
+const HHMM = /^([01]\d|2[0-3]):([0-5]\d)$/;
+const DATE = /^\d{4}-\d{2}-\d{2}$/;
+const END_OF_DAY = 24 * 60;
+/**
+ * A day whose tracked minutes are within this distance of the expected minutes
+ * counts as complete. Real clock-ins are never exact, and jittered backfills
+ * are deliberately not, so a strict comparison would flag nearly every day.
+ */
+export const DEFAULT_TOLERANCE_MINUTES = 15;
+/** Parse "HH:MM" into minutes since midnight; anything else is rejected */
+export function parseHHMM(value) {
+    const match = HHMM.exec(value);
+    if (!match) {
+        throw new Error(`Time "${value}" must be HH:MM in 24-hour company local time`);
+    }
+    return Number(match[1]) * 60 + Number(match[2]);
+}
+/** True when two [start, end) intervals share any time; touching does not count */
+export function intervalsOverlap(a, b) {
+    return a[0] < b[1] && b[0] < a[1];
+}
+function assertDate(value) {
+    if (!DATE.test(value) || Number.isNaN(Date.parse(`${value}T00:00:00Z`))) {
+        throw new Error(`Date "${value}" must be YYYY-MM-DD`);
+    }
+}
+/** Every date from start to end inclusive */
+export function enumerateDates(start, end) {
+    assertDate(start);
+    assertDate(end);
+    if (start > end) {
+        throw new Error(`start_on ${start} is after end_on ${end}`);
+    }
+    const dates = [];
+    const cursor = new Date(`${start}T00:00:00Z`);
+    const last = new Date(`${end}T00:00:00Z`);
+    while (cursor <= last) {
+        dates.push(cursor.toISOString().slice(0, 10));
+        cursor.setUTCDate(cursor.getUTCDate() + 1);
+    }
+    return dates;
+}
+/**
+ * Validate the segments of one day: HH:MM only, clock_in strictly before
+ * clock_out, no overnight shifts, no overlap between segments.
+ */
+export function validateSegments(segments) {
+    if (segments.length === 0) {
+        throw new Error('segments must contain at least one {clock_in, clock_out} entry');
+    }
+    const intervals = segments.map(segment => {
+        const start = parseHHMM(segment.clock_in);
+        const end = parseHHMM(segment.clock_out);
+        if (end < start) {
+            throw new Error(`Segment ${segment.clock_in}-${segment.clock_out} ends before it starts. Overnight shifts ` +
+                'are not supported by the bulk actions; use the create action with reference_date instead.');
+        }
+        if (end === start) {
+            throw new Error(`Segment ${segment.clock_in}-${segment.clock_out}: clock_in must be before clock_out`);
+        }
+        return [start, end];
+    });
+    for (let i = 0; i < intervals.length; i++) {
+        for (let j = i + 1; j < intervals.length; j++) {
+            if (intervalsOverlap(intervals[i], intervals[j])) {
+                throw new Error(`Segments ${segments[i].clock_in}-${segments[i].clock_out} and ` +
+                    `${segments[j].clock_in}-${segments[j].clock_out} overlap each other`);
+            }
+        }
+    }
+}
+/**
+ * Turn leave records into a per-date cover map. Only approved, undeleted
+ * leaves count; a pending (approved: null) or rejected leave does not block
+ * anything. A later leave over the same date never downgrades a full cover.
+ */
+export function expandLeaves(leaves) {
+    const cover = new Map();
+    for (const leave of leaves) {
+        if (leave.approved !== true || leave.deleted_at !== null)
+            continue;
+        const kind = leave.half_day === 'beggining_of_day' || leave.half_day === 'end_of_day'
+            ? leave.half_day
+            : 'full';
+        for (const date of enumerateDates(leave.start_on, leave.finish_on)) {
+            const existing = cover.get(date);
+            if (existing === 'full')
+                continue;
+            cover.set(date, kind);
+        }
+    }
+    return cover;
+}
+function daySkipReason(date, request, facts) {
+    if (date > facts.today) {
+        return {
+            date,
+            reason: 'future_date',
+            detail: `today is ${facts.today} in the zone of the machine running the server`,
+        };
+    }
+    const day = facts.days.get(date);
+    if (request.mode === 'range') {
+        if (day?.day_type === 'saturday' || day?.day_type === 'sunday') {
+            return { date, reason: 'weekend' };
+        }
+        if (day?.day_type === 'bank_holiday') {
+            return { date, reason: 'bank_holiday' };
+        }
+        if (!day || day.expected_minutes <= 0) {
+            return {
+                date,
+                reason: 'not_workable',
+                detail: day ? 'contract expects 0 minutes' : 'no contract data for this date',
+            };
+        }
+    }
+    if (request.skip_leave) {
+        const cover = facts.leaves.get(date);
+        if (cover === 'full') {
+            return { date, reason: 'on_leave', detail: 'approved leave' };
+        }
+        if (cover && request.mode === 'range') {
+            return {
+                date,
+                reason: 'half_day_leave',
+                detail: `approved half-day leave (${cover}); write it with log_days if the other half was worked`,
+            };
+        }
+    }
+    return null;
+}
+function existingIntervals(shifts, date) {
+    return shifts
+        .filter(shift => shift.date === date)
+        .map(shift => {
+        let start;
+        let end;
+        try {
+            start = parseHHMM(shift.clock_in);
+            end = shift.clock_out === null ? END_OF_DAY : parseHHMM(shift.clock_out);
+        }
+        catch {
+            throw new Error(`An existing shift on ${date} has times the planner cannot read ` +
+                `(${shift.clock_in}-${shift.clock_out ?? 'open'}). Fix or delete that record first.`);
+        }
+        // An overnight existing shift (clock_out before clock_in) occupies to end of day.
+        if (end < start)
+            end = END_OF_DAY;
+        const label = `${shift.clock_in}-${shift.clock_out ?? 'open'}`;
+        return [start, end, label];
+    });
+}
+function formatHHMM(minutes) {
+    const clamped = Math.max(0, Math.min(END_OF_DAY - 1, minutes));
+    return `${String(Math.floor(clamped / 60)).padStart(2, '0')}:${String(clamped % 60).padStart(2, '0')}`;
+}
+/** Deterministic integer in [-magnitude, magnitude] derived from the record's identity */
+function deterministicOffset(seed, magnitude) {
+    if (magnitude <= 0)
+        return 0;
+    const digest = createHash('sha256').update(seed).digest();
+    const value = digest.readUInt32BE(0) % (2 * magnitude + 1);
+    return value - magnitude;
+}
+/**
+ * Apply per-record variation to a day's segments. Nobody clocks in at exactly
+ * 09:00 every day, so a month of identical times is the one pattern a real
+ * registro never shows. The variation is derived from a hash of the employee,
+ * the date and the segment, so re-planning the same request yields the same
+ * times: the preview shows exactly what will be written, the confirmation
+ * token binds to it, and a retry after a partial failure recognises its own
+ * earlier writes. Segments never cross each other or midnight.
+ */
+export function jitterSegments(employeeId, date, segments, magnitude) {
+    if (magnitude <= 0)
+        return segments;
+    const ordered = [...segments].sort((a, b) => parseHHMM(a.clock_in) - parseHHMM(b.clock_in));
+    const result = [];
+    let previousEnd = -Infinity;
+    ordered.forEach((segment, index) => {
+        const baseStart = parseHHMM(segment.clock_in);
+        const baseEnd = parseHHMM(segment.clock_out);
+        const nextStart = index + 1 < ordered.length ? parseHHMM(ordered[index + 1].clock_in) : Infinity;
+        let start = baseStart + deterministicOffset(`${employeeId}|${date}|${index}|in`, magnitude);
+        let end = baseEnd + deterministicOffset(`${employeeId}|${date}|${index}|out`, magnitude);
+        // Never start before the previous segment ended, never end after the next one may start.
+        start = Math.max(start, previousEnd, 0);
+        end = Math.min(end, nextStart - magnitude - 1, END_OF_DAY - 1);
+        if (end <= start) {
+            start = baseStart;
+            end = baseEnd;
+        }
+        previousEnd = end;
+        result.push({ clock_in: formatHHMM(start), clock_out: formatHHMM(end) });
+    });
+    return result;
+}
+/**
+ * Build the plan. Skip reasons are evaluated in the documented order and the
+ * first match wins. Explicit days skip the weekday, holiday and workability
+ * rules on purpose: migration must be able to write a Saturday someone worked.
+ */
+export function buildBackfillPlan(request, facts) {
+    const requested = request.mode === 'range'
+        ? request.dates.map(date => ({ date, segments: request.segments }))
+        : request.days;
+    if (request.mode === 'range') {
+        validateSegments(request.segments);
+    }
+    else {
+        const seen = new Set();
+        for (const day of request.days) {
+            assertDate(day.date);
+            if (seen.has(day.date)) {
+                throw new Error(`Date ${day.date} appears more than once in days`);
+            }
+            seen.add(day.date);
+            validateSegments(day.segments);
+        }
+    }
+    const writes = [];
+    const skippedDays = [];
+    const skippedSegments = [];
+    const writtenDates = new Set();
+    let minutes = 0;
+    for (const { date, segments } of requested) {
+        const skip = daySkipReason(date, request, facts);
+        if (skip) {
+            skippedDays.push(skip);
+            continue;
+        }
+        const existing = existingIntervals(facts.shifts, date);
+        const planned = jitterSegments(request.employee_id, date, segments, request.jitter_minutes ?? 0);
+        for (const segment of planned) {
+            const interval = [
+                parseHHMM(segment.clock_in),
+                parseHHMM(segment.clock_out),
+            ];
+            const clash = existing.find(([start, end]) => intervalsOverlap(interval, [start, end]));
+            if (clash) {
+                skippedSegments.push({
+                    date,
+                    ...segment,
+                    reason: 'overlaps_existing',
+                    detail: `overlaps existing ${clash[2]}`,
+                });
+                continue;
+            }
+            writes.push({ date, ...segment });
+            writtenDates.add(date);
+            minutes += interval[1] - interval[0];
+        }
+    }
+    return {
+        writes,
+        skippedDays,
+        skippedSegments,
+        totals: { days: writtenDates.size, records: writes.length, minutes },
+    };
+}
+/**
+ * Stable digest of who and what a plan writes, including the note stored on
+ * every record; the confirmation token is bound to it.
+ */
+export function planFingerprint(employeeId, writes, observations) {
+    const canonical = writes
+        .map(w => `${w.date} ${w.clock_in} ${w.clock_out}`)
+        .sort()
+        .join('\n');
+    return createHash('sha256')
+        .update(`${employeeId}\n${observations ?? ''}\n${canonical}`)
+        .digest('hex');
+}
+/**
+ * Workdays up to today where the contract expects more than was tracked and no
+ * full-day leave applies. Future dates are left out, since log_range would
+ * refuse them anyway.
+ */
+export function computeGaps(facts, toleranceMinutes = DEFAULT_TOLERANCE_MINUTES) {
+    const gaps = [];
+    for (const [date, day] of [...facts.days.entries()].sort(([a], [b]) => a.localeCompare(b))) {
+        if (date > facts.today)
+            continue;
+        if (day.day_type !== 'workday')
+            continue;
+        if (day.expected_minutes - day.tracked_minutes <= toleranceMinutes)
+            continue;
+        const cover = facts.leaves.get(date);
+        if (cover === 'full')
+            continue;
+        gaps.push({
+            date,
+            expected_minutes: day.expected_minutes,
+            tracked_minutes: day.tracked_minutes,
+            missing_minutes: day.expected_minutes - day.tracked_minutes,
+            half_day_leave: cover ?? null,
+        });
+    }
+    return gaps;
+}
+/**
+ * One row per calendar day in the range, with everything the planner knows
+ * about it, for auditing what was clocked against what the contract, the
+ * company calendar and the leave record say should have been.
+ */
+export function computeLedger(dates, facts, toleranceMinutes = DEFAULT_TOLERANCE_MINUTES) {
+    return dates.map(date => {
+        const day = facts.days.get(date);
+        const leave = facts.leaves.get(date) ?? null;
+        const shifts = facts.shifts
+            .filter(s => s.date === date)
+            .sort((a, b) => a.clock_in.localeCompare(b.clock_in))
+            .map(s => ({
+            clock_in: s.clock_in,
+            clock_out: s.clock_out,
+            minutes: s.clock_out === null ? null : parseHHMM(s.clock_out) - parseHHMM(s.clock_in),
+        }));
+        const expected = day?.expected_minutes ?? 0;
+        const tracked = day?.tracked_minutes ?? 0;
+        let status;
+        if (date > facts.today)
+            status = 'future';
+        else if (day?.day_type === 'saturday' || day?.day_type === 'sunday')
+            status = 'weekend';
+        else if (day?.day_type === 'bank_holiday')
+            status = 'bank_holiday';
+        else if (leave === 'full')
+            status = 'on_leave';
+        else if (leave)
+            status = 'half_day_leave';
+        else if (expected <= 0)
+            status = 'not_workable';
+        else if (expected - tracked > toleranceMinutes)
+            status = 'missing';
+        else if (tracked - expected > toleranceMinutes)
+            status = 'over';
+        else
+            status = 'complete';
+        return {
+            date,
+            day_type: day?.day_type ?? null,
+            expected_minutes: expected,
+            tracked_minutes: tracked,
+            leave,
+            shifts,
+            status,
+            delta_minutes: tracked - expected,
+        };
+    });
+}
+/** 720 -> "12h", 750 -> "12h30" */
+export function hours(minutes) {
+    const whole = Math.floor(minutes / 60);
+    const rest = minutes % 60;
+    return rest === 0 ? `${whole}h` : `${whole}h${String(rest).padStart(2, '0')}`;
+}
+function countBy(items) {
+    const counts = new Map();
+    for (const item of items)
+        counts.set(item.reason, (counts.get(item.reason) ?? 0) + 1);
+    return counts;
+}
+/**
+ * Render the plan the way the confirmation step shows it. It always names the
+ * person, because the company-wide key makes writing someone else's hours the
+ * mistake worth catching.
+ */
+export function formatPlanPreview(plan, employee, range, request, observations) {
+    const lines = [];
+    lines.push(`Plan for ${employee.name} (${employee.id})`);
+    lines.push(`${range.start} .. ${range.end}`);
+    lines.push('');
+    lines.push(`  ${plan.totals.days} days to write, ${plan.totals.records} shift records, ${hours(plan.totals.minutes)}`);
+    if (request.mode === 'range') {
+        lines.push(`  ${request.segments.map(s => `${s.clock_in}-${s.clock_out}`).join(' and ')}`);
+    }
+    if (observations) {
+        lines.push(`  Note on every record: "${observations}"`);
+    }
+    if (request.jitter_minutes && request.jitter_minutes > 0) {
+        lines.push(`  Each time varies by up to ${request.jitter_minutes} minutes from the pattern (fixed per record, shown below).`);
+    }
+    if (plan.writes.length > 0 && plan.writes.length <= 62) {
+        lines.push('');
+        lines.push('  Records to write:');
+        for (const w of plan.writes)
+            lines.push(`    ${w.date} ${w.clock_in}-${w.clock_out}`);
+    }
+    if (plan.skippedDays.length > 0) {
+        lines.push('');
+        lines.push(`  Skipping ${plan.skippedDays.length} days:`);
+        const byReason = countBy(plan.skippedDays);
+        const labels = {
+            future_date: 'in the future',
+            weekend: 'weekend',
+            bank_holiday: 'bank holiday',
+            not_workable: 'not workable under the contract',
+            on_leave: 'approved leave',
+            half_day_leave: 'half-day leave, write it with log_days if the other half was worked',
+        };
+        for (const [reason, count] of byReason) {
+            const dates = plan.skippedDays.filter(d => d.reason === reason).map(d => d.date);
+            const suffix = reason === 'weekend' ? '' : ` (${dates.join(', ')})`;
+            lines.push(`    ${count} ${labels[reason]}${suffix}`);
+        }
+    }
+    if (plan.skippedSegments.length > 0) {
+        lines.push('');
+        lines.push(`  Skipping ${plan.skippedSegments.length} segments that overlap existing shifts:`);
+        for (const segment of plan.skippedSegments) {
+            lines.push(`    ${segment.date} ${segment.clock_in}-${segment.clock_out} ${segment.detail}`);
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=planner.js.map

package/dist/attendance/planner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.js","sourceRoot":"","sources":["../../src/attendance/planner.ts"],"names":[],"mappings":"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"}

package/dist/endpoints.d.ts

@@ -17,6 +17,11 @@ export declare const ENDPOINTS: {
     readonly leaveTypes: "/timeoff/leave-types";
     readonly allowances: "/timeoff/allowances";
     readonly shifts: "/attendance/shifts";
+    readonly openShifts: "/attendance/open_shifts";
+    readonly estimatedTimes: "/attendance/estimated_times";
+    readonly workedTimes: "/attendance/worked_times";
+    readonly clockIn: "/attendance/shifts/clock_in";
+    readonly clockOut: "/attendance/shifts/clock_out";
     readonly folders: "/documents/folders";
     readonly documents: "/documents/documents";
     readonly jobRoles: "/job_catalog/roles";

package/dist/endpoints.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"endpoints.d.ts","sourceRoot":"","sources":["../src/endpoints.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmDZ,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,SAAS,CAAC;AAEjD;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvF"}
+{"version":3,"file":"endpoints.d.ts","sourceRoot":"","sources":["../src/endpoints.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwDZ,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,SAAS,CAAC;AAEjD;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvF"}