@managemint-solutions/sdk 0.36.0 → 0.38.0

package/README.md

@@ -400,6 +400,67 @@ await service.configs.update('feature_flags', { value: { ...flags.value, timeshe
 await service.configs.remove('maintenance');   // hard delete, service role only
 ```
 
+## Leave
+
+The first slice of the HR module: `leave_types`, `leave_entitlements` and `leave_requests`, one
+org-scoped audited resource each on the caller's client. Every date is a calendar date
+(`YYYY-MM-DD`, the columns are `date`), and the DTOs refuse anything else; body fields are
+required keys, with `null` for an empty one. Balances are never stored — an entitlement's
+`days_used` / `days_pending` / `days_remaining` are computed on read from the approved and pending
+requests of that user and type whose start date falls in its period — and a request's `days` is
+a snapshot taken when it was filed, so a holiday added later does not rewrite approved history.
+
+The calendar arithmetic is plain exported functions, shared with the api:
+
+```ts
+import { countWorkingDays, leavePeriodFor, todayInJohannesburg } from '@managemint-solutions/sdk';
+
+const org = await supabase.organizations.get();
+const period = leavePeriodFor('2026-09-21', org.leave_calendar_start_month); // { period_start, period_end }
+const holidays = await supabase.publicHolidays.datesBetween('2026-09-21', '2026-09-25'); // see Public holidays
+const days = countWorkingDays('2026-09-21', '2026-09-25', holidays);        // Mon–Fri less holidays; 0.5 for a half day
+const today = todayInJohannesburg();                                        // the cancel rule's "today"
+```
+
+```ts
+const types = await supabase.leaveTypes.list({ active: true });
+const annual = await supabase.leaveTypes.create({ name: 'Annual', description: null, default_days: 15, is_paid: true, requires_approval: true });
+await supabase.leaveTypes.remove(annual.mms_id);        // hard delete; 409 once a request or entitlement references it
+
+const taken = await supabase.leaveEntitlements.overlaps(userId, annual.mms_id, '2026-01-01', '2026-12-31'); // an entitlement of that type already covers part of the period
+const cover = await supabase.leaveEntitlements.findFor(userId, annual.mms_id, '2026-09-21'); // period + cap, or null = untracked
+const committed = await supabase.leaveRequests.sumDays(userId, annual.mms_id, cover, [LeaveRequestStatus.APPROVED, LeaveRequestStatus.PENDING]);
+const clash = await supabase.leaveRequests.overlaps(userId, '2026-09-21', '2026-09-25');
+
+const request = await supabase.leaveRequests.create({ user_id: userId, leave_type_id: annual.mms_id, start_date: '2026-09-21', end_date: '2026-09-25', is_half_day: false, days, reason: null, status: LeaveRequestStatus.PENDING });
+const reviewed = await supabase.leaveRequests.review(request.mms_id, { status: LeaveReviewDecision.APPROVED, reviewed_by: managerId, review_note: null }); // null = no longer pending
+const cancelled = await supabase.leaveRequests.cancel(request.mms_id, userId);                // null = already closed
+const mine = await supabase.leaveRequests.list({ ...query, user_id: me });                   // one list; user_id narrows it
+const annualOnly = await supabase.leaveRequests.list({ ...query, leave_type_id: annual.mms_id }); // leave_type_id narrows it too
+const reports = await supabase.leaveRequests.list(query, { userIds: [me, ...(await supabase.users.idsManagedBy(me))] });
+```
+
+`review`, `cancel` and `update` are compare-and-set writes (`updateWhere`): they land only while
+the request is still in the status they expect and resolve to `null` otherwise, so two reviewers
+cannot both decide the same request. The `leave_requests` table also carries an exclusion
+constraint so two overlapping live requests of one user cannot both be inserted in a race.
+
+Notes, additional details and supporting files may attach to leave as well: their `entity`
+accepts `leave_requests` and `leave_entitlements` alongside the CRM entity types.
+
+## Public holidays
+
+The public-holiday calendar, `public_holidays`, on the caller's client as `supabase.publicHolidays`.
+Global like configs: there is no organization on a row, every signed-in caller reads the same
+list, and only the service role may write — Scott maintains it in Supabase Studio, so the SDK is
+read-only here. Several holidays may share a date; only the ones with `religion` null count as a
+day off for everyone.
+
+```ts
+const year = await supabase.publicHolidays.list({ year: 2026 });
+const off = await supabase.publicHolidays.datesBetween('2026-09-21', '2026-09-25'); // Set of religion-neutral dates
+```
+
 ## Errors
 
 Every error the SDK throws is a `SupabaseClientError` carrying the HTTP `status` to respond

package/dist/client.d.ts

@@ -8,9 +8,11 @@ import { NotesResource } from './notes';
 import { NotificationsResource } from './notifications';
 import { BillingReadsResource } from './billing';
 import { InvoicesReadsResource } from './billing/invoices';
+import { LeaveEntitlementsResource, LeaveRequestsResource, LeaveTypesResource } from './leave';
 import { OrganizationsResource } from './organizations';
 import { PermissionsResource } from './permissions';
 import { ProjectsResource } from './projects';
+import { PublicHolidaysResource } from './public-holidays';
 import { StatusesResource } from './statuses';
 import { SupportingFilesResource } from './supporting-files';
 import { TasksResource } from './tasks';
@@ -56,6 +58,10 @@ export declare class SupabaseClient {
     readonly clients: ClientsResource;
     readonly projects: ProjectsResource;
     readonly tasks: TasksResource;
+    readonly leaveTypes: LeaveTypesResource;
+    readonly publicHolidays: PublicHolidaysResource;
+    readonly leaveEntitlements: LeaveEntitlementsResource;
+    readonly leaveRequests: LeaveRequestsResource;
     constructor(config: SupabaseClientConfig);
 }
 export declare const createSupabaseClient: (config: SupabaseClientConfig) => SupabaseClient;

package/dist/client.js

@@ -10,9 +10,11 @@ const notes_1 = require("./notes");
 const notifications_1 = require("./notifications");
 const billing_1 = require("./billing");
 const invoices_1 = require("./billing/invoices");
+const leave_1 = require("./leave");
 const organizations_1 = require("./organizations");
 const permissions_1 = require("./permissions");
 const projects_1 = require("./projects");
+const public_holidays_1 = require("./public-holidays");
 const statuses_1 = require("./statuses");
 const supporting_files_1 = require("./supporting-files");
 const tasks_1 = require("./tasks");
@@ -41,6 +43,10 @@ class SupabaseClient {
     clients;
     projects;
     tasks;
+    leaveTypes;
+    publicHolidays;
+    leaveEntitlements;
+    leaveRequests;
     constructor(config) {
         this.auth = config.auth;
         this.supabase =
@@ -61,6 +67,11 @@ class SupabaseClient {
         this.clients = new clients_1.ClientsResource(this.supabase, this.auth, this.audit);
         this.projects = new projects_1.ProjectsResource(this.supabase, this.auth, this.audit);
         this.tasks = new tasks_1.TasksResource(this.supabase, this.auth, this.audit);
+        this.leaveTypes = new leave_1.LeaveTypesResource(this.supabase, this.auth, this.audit);
+        // Global like configs: every signed-in caller reads the same calendar, nobody writes it here.
+        this.publicHolidays = new public_holidays_1.PublicHolidaysResource(this.supabase);
+        this.leaveEntitlements = new leave_1.LeaveEntitlementsResource(this.supabase, this.auth, this.audit);
+        this.leaveRequests = new leave_1.LeaveRequestsResource(this.supabase, this.auth, this.audit);
     }
 }
 exports.SupabaseClient = SupabaseClient;

package/dist/index.d.ts

@@ -36,4 +36,8 @@ export { GetSupportingFilesDto, SupportingFileIdDto } from './supporting-files';
 export { ClientIdDto, CreateClientDto, GetClientsDto, UpdateClientDto } from './clients';
 export { CreateProjectDto, GetProjectsDto, ProjectIdDto, UpdateProjectDto } from './projects';
 export { CreateTaskDto, GetTasksDto, TaskIdDto, UpdateTaskDto } from './tasks';
+export type { CreateLeaveEntitlementInput, CreateLeaveRequestRow, LeaveEntitlementCover, ReviewLeaveRequestRow, UpdateLeaveRequestRow, } from './leave';
+export { CreateLeaveEntitlementDto, CreateLeaveRequestDto, CreateLeaveTypeDto, GetLeaveEntitlementsDto, GetLeaveRequestsDto, GetLeaveTypesDto, LeaveEntitlementIdDto, LeaveRequestIdDto, LeaveTypeIdDto, ReviewLeaveRequestDto, UpdateLeaveEntitlementDto, UpdateLeaveRequestDto, UpdateLeaveTypeDto, } from './leave';
+export { GetPublicHolidaysDto } from './public-holidays';
+export { addOneYearMinusDay, countWorkingDays, isWithinPeriod, leavePeriodFor, todayInJohannesburg, } from './leave';
 export { monthlyTotalMinor } from './pricebooks';

package/dist/index.js

@@ -8,7 +8,7 @@
 // to keep. The row and input types they produce and accept are exported for annotations.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UserIdDto = exports.UpdateUserDto = exports.UpdateMyProfileDto = exports.GetUsersQueryDto = exports.AddUserDto = exports.UpdatePermissionsDto = exports.PermissionsResource = exports.UpdateOrganizationDto = exports.CreateOrganizationDto = exports.NotificationIdDto = exports.GetNotificationsDto = exports.NoteIdDto = exports.GetNotesDto = exports.AddNoteDto = exports.UpdateAdditionalDetailsDto = exports.IsAdditionalDetailsValueByType = exports.GetAdditionalDetailsDto = exports.AdditionalDetailsIdDto = exports.AddAdditionalDetailsDto = exports.UpdateStatusDto = exports.StatusIdDto = exports.GetStatusesDto = exports.AddStatusDto = exports.CreateSupportRequestDto = exports.UpdateConfigDto = exports.CreateConfigDto = exports.CreateFeatureRequestDto = exports.InvoiceIdDto = exports.GetInvoicesQueryDto = exports.ReinstateSubscriptionDto = exports.PurchaseModuleDto = exports.PaymentIdDto = exports.InitialPaymentDto = exports.GetPaymentsQueryDto = exports.CancelSubscriptionDto = exports.GetAuditTrailDto = exports.IsNullable = exports.EmptyToNull = exports.SupabaseClientError = exports.createSupabaseServiceClient = exports.SupabaseServiceClient = exports.SignInDto = exports.SendPasswordResetEmailDto = exports.ResetPasswordDto = exports.ExchangeTokenHashDto = exports.ExchangeRefreshTokenDto = exports.createSupabaseAuthClient = exports.SupabaseAuthClient = exports.createSupabaseClient = exports.SupabaseClient = void 0;
-exports.monthlyTotalMinor = exports.UpdateTaskDto = exports.TaskIdDto = exports.GetTasksDto = exports.CreateTaskDto = exports.UpdateProjectDto = exports.ProjectIdDto = exports.GetProjectsDto = exports.CreateProjectDto = exports.UpdateClientDto = exports.GetClientsDto = exports.CreateClientDto = exports.ClientIdDto = exports.SupportingFileIdDto = exports.GetSupportingFilesDto = void 0;
+exports.monthlyTotalMinor = exports.todayInJohannesburg = exports.leavePeriodFor = exports.isWithinPeriod = exports.countWorkingDays = exports.addOneYearMinusDay = exports.GetPublicHolidaysDto = exports.UpdateLeaveTypeDto = exports.UpdateLeaveRequestDto = exports.UpdateLeaveEntitlementDto = exports.ReviewLeaveRequestDto = exports.LeaveTypeIdDto = exports.LeaveRequestIdDto = exports.LeaveEntitlementIdDto = exports.GetLeaveTypesDto = exports.GetLeaveRequestsDto = exports.GetLeaveEntitlementsDto = exports.CreateLeaveTypeDto = exports.CreateLeaveRequestDto = exports.CreateLeaveEntitlementDto = exports.UpdateTaskDto = exports.TaskIdDto = exports.GetTasksDto = exports.CreateTaskDto = exports.UpdateProjectDto = exports.ProjectIdDto = exports.GetProjectsDto = exports.CreateProjectDto = exports.UpdateClientDto = exports.GetClientsDto = exports.CreateClientDto = exports.ClientIdDto = exports.SupportingFileIdDto = exports.GetSupportingFilesDto = void 0;
 var client_1 = require("./client");
 Object.defineProperty(exports, "SupabaseClient", { enumerable: true, get: function () { return client_1.SupabaseClient; } });
 Object.defineProperty(exports, "createSupabaseClient", { enumerable: true, get: function () { return client_1.createSupabaseClient; } });
@@ -99,5 +99,29 @@ Object.defineProperty(exports, "CreateTaskDto", { enumerable: true, get: functio
 Object.defineProperty(exports, "GetTasksDto", { enumerable: true, get: function () { return tasks_1.GetTasksDto; } });
 Object.defineProperty(exports, "TaskIdDto", { enumerable: true, get: function () { return tasks_1.TaskIdDto; } });
 Object.defineProperty(exports, "UpdateTaskDto", { enumerable: true, get: function () { return tasks_1.UpdateTaskDto; } });
+var leave_1 = require("./leave");
+Object.defineProperty(exports, "CreateLeaveEntitlementDto", { enumerable: true, get: function () { return leave_1.CreateLeaveEntitlementDto; } });
+Object.defineProperty(exports, "CreateLeaveRequestDto", { enumerable: true, get: function () { return leave_1.CreateLeaveRequestDto; } });
+Object.defineProperty(exports, "CreateLeaveTypeDto", { enumerable: true, get: function () { return leave_1.CreateLeaveTypeDto; } });
+Object.defineProperty(exports, "GetLeaveEntitlementsDto", { enumerable: true, get: function () { return leave_1.GetLeaveEntitlementsDto; } });
+Object.defineProperty(exports, "GetLeaveRequestsDto", { enumerable: true, get: function () { return leave_1.GetLeaveRequestsDto; } });
+Object.defineProperty(exports, "GetLeaveTypesDto", { enumerable: true, get: function () { return leave_1.GetLeaveTypesDto; } });
+Object.defineProperty(exports, "LeaveEntitlementIdDto", { enumerable: true, get: function () { return leave_1.LeaveEntitlementIdDto; } });
+Object.defineProperty(exports, "LeaveRequestIdDto", { enumerable: true, get: function () { return leave_1.LeaveRequestIdDto; } });
+Object.defineProperty(exports, "LeaveTypeIdDto", { enumerable: true, get: function () { return leave_1.LeaveTypeIdDto; } });
+Object.defineProperty(exports, "ReviewLeaveRequestDto", { enumerable: true, get: function () { return leave_1.ReviewLeaveRequestDto; } });
+Object.defineProperty(exports, "UpdateLeaveEntitlementDto", { enumerable: true, get: function () { return leave_1.UpdateLeaveEntitlementDto; } });
+Object.defineProperty(exports, "UpdateLeaveRequestDto", { enumerable: true, get: function () { return leave_1.UpdateLeaveRequestDto; } });
+Object.defineProperty(exports, "UpdateLeaveTypeDto", { enumerable: true, get: function () { return leave_1.UpdateLeaveTypeDto; } });
+var public_holidays_1 = require("./public-holidays");
+Object.defineProperty(exports, "GetPublicHolidaysDto", { enumerable: true, get: function () { return public_holidays_1.GetPublicHolidaysDto; } });
+// The calendar arithmetic is plain functions, not a resource, so the api counts days with the
+// same code the SDK's tests pin down.
+var leave_2 = require("./leave");
+Object.defineProperty(exports, "addOneYearMinusDay", { enumerable: true, get: function () { return leave_2.addOneYearMinusDay; } });
+Object.defineProperty(exports, "countWorkingDays", { enumerable: true, get: function () { return leave_2.countWorkingDays; } });
+Object.defineProperty(exports, "isWithinPeriod", { enumerable: true, get: function () { return leave_2.isWithinPeriod; } });
+Object.defineProperty(exports, "leavePeriodFor", { enumerable: true, get: function () { return leave_2.leavePeriodFor; } });
+Object.defineProperty(exports, "todayInJohannesburg", { enumerable: true, get: function () { return leave_2.todayInJohannesburg; } });
 var pricebooks_1 = require("./pricebooks");
 Object.defineProperty(exports, "monthlyTotalMinor", { enumerable: true, get: function () { return pricebooks_1.monthlyTotalMinor; } });

package/dist/leave/dto.d.ts

@@ -0,0 +1,76 @@
+import type { CreateLeaveEntitlementDto as CreateLeaveEntitlementDtoType, CreateLeaveRequestDto as CreateLeaveRequestDtoType, CreateLeaveTypeDto as CreateLeaveTypeDtoType, GetLeaveEntitlementsDto as GetLeaveEntitlementsDtoType, GetLeaveRequestsDto as GetLeaveRequestsDtoType, GetLeaveTypesDto as GetLeaveTypesDtoType, LeaveEntitlementIdDto as LeaveEntitlementIdDtoType, LeaveRequestIdDto as LeaveRequestIdDtoType, LeaveTypeIdDto as LeaveTypeIdDtoType, ReviewLeaveRequestDto as ReviewLeaveRequestDtoType, UpdateLeaveEntitlementDto as UpdateLeaveEntitlementDtoType, UpdateLeaveRequestDto as UpdateLeaveRequestDtoType, UpdateLeaveTypeDto as UpdateLeaveTypeDtoType } from '@managemint-solutions/entities/leave/dto';
+import { LeaveRequestStatus, LeaveReviewDecision } from '@managemint-solutions/entities/leave/enum';
+export declare class LeaveTypeIdDto implements LeaveTypeIdDtoType {
+    readonly leaveTypeId: string;
+}
+export declare class GetLeaveTypesDto implements GetLeaveTypesDtoType {
+    readonly active?: boolean | null;
+}
+export declare class CreateLeaveTypeDto implements CreateLeaveTypeDtoType {
+    readonly name: string;
+    readonly description: string | null;
+    readonly default_days: number;
+    readonly is_paid: boolean;
+    readonly requires_approval: boolean;
+}
+export declare class UpdateLeaveTypeDto implements UpdateLeaveTypeDtoType {
+    readonly name: string;
+    readonly description: string | null;
+    readonly default_days: number;
+    readonly is_paid: boolean;
+    readonly requires_approval: boolean;
+    readonly active: boolean;
+}
+export declare class LeaveEntitlementIdDto implements LeaveEntitlementIdDtoType {
+    readonly leaveEntitlementId: string;
+}
+export declare class GetLeaveEntitlementsDto implements GetLeaveEntitlementsDtoType {
+    readonly page: number;
+    readonly page_size: number;
+    readonly user_id?: string | null;
+    readonly leave_type_id?: string | null;
+    readonly as_of?: string | null;
+}
+export declare class CreateLeaveEntitlementDto implements CreateLeaveEntitlementDtoType {
+    readonly user_id: string;
+    readonly leave_type_id: string;
+    readonly days_entitled: number;
+    readonly period_start: string | null;
+    readonly period_end: string | null;
+    readonly notes: string | null;
+}
+export declare class UpdateLeaveEntitlementDto implements UpdateLeaveEntitlementDtoType {
+    readonly days_entitled: number;
+    readonly period_end: string;
+    readonly notes: string | null;
+}
+export declare class LeaveRequestIdDto implements LeaveRequestIdDtoType {
+    readonly leaveRequestId: string;
+}
+export declare class GetLeaveRequestsDto implements GetLeaveRequestsDtoType {
+    readonly page: number;
+    readonly page_size: number;
+    readonly user_id?: string | null;
+    readonly leave_type_id?: string | null;
+    readonly status?: LeaveRequestStatus | null;
+    readonly start_date_after?: string | null;
+    readonly start_date_before?: string | null;
+}
+export declare class CreateLeaveRequestDto implements CreateLeaveRequestDtoType {
+    readonly leave_type_id: string;
+    readonly start_date: string;
+    readonly end_date: string;
+    readonly is_half_day: boolean;
+    readonly reason: string | null;
+}
+export declare class UpdateLeaveRequestDto implements UpdateLeaveRequestDtoType {
+    readonly leave_type_id: string;
+    readonly start_date: string;
+    readonly end_date: string;
+    readonly is_half_day: boolean;
+    readonly reason: string | null;
+}
+export declare class ReviewLeaveRequestDto implements ReviewLeaveRequestDtoType {
+    readonly status: LeaveReviewDecision;
+    readonly review_note: string | null;
+}

package/dist/leave/dto.js

@@ -0,0 +1,382 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReviewLeaveRequestDto = exports.UpdateLeaveRequestDto = exports.CreateLeaveRequestDto = exports.GetLeaveRequestsDto = exports.LeaveRequestIdDto = exports.UpdateLeaveEntitlementDto = exports.CreateLeaveEntitlementDto = exports.GetLeaveEntitlementsDto = exports.LeaveEntitlementIdDto = exports.UpdateLeaveTypeDto = exports.CreateLeaveTypeDto = exports.GetLeaveTypesDto = exports.LeaveTypeIdDto = void 0;
+const class_validator_1 = require("class-validator");
+const class_transformer_1 = require("class-transformer");
+const enum_1 = require("@managemint-solutions/entities/leave/enum");
+const validators_1 = require("../validators");
+// class-validator versions of the shared DTO types from @managemint-solutions/entities.
+// Each class `implements` its entities type so the wire contract cannot drift.
+//
+// Body fields are required: a nullable one carries `@IsNullable()` without `@IsOptional()`,
+// so `null` passes and a missing key fails. Only the query-string filters are optional.
+const Trim = () => (0, class_transformer_1.Transform)(({ value }) => (typeof value === 'string' ? value.trim() : value), { toClassOnly: true });
+/** A query-string tri-state: `'true'`/`'false'` become booleans, anything else is left to fail. */
+const QueryBoolean = () => (0, class_transformer_1.Transform)(({ value }) => (value === 'true' ? true : value === 'false' ? false : value), {
+    toClassOnly: true,
+});
+// The users columns (`user_id`) are v4: they carry the GoTrue auth uid the signup trigger copies
+// out of `auth.users.id`, so the table's uuidv7 default never fires. Every other id is v7.
+// ---- Leave types ----
+class LeaveTypeIdDto {
+    leaveTypeId;
+}
+exports.LeaveTypeIdDto = LeaveTypeIdDto;
+__decorate([
+    (0, class_validator_1.IsUUID)('7', { message: 'Invalid leave type ID format' }),
+    __metadata("design:type", String)
+], LeaveTypeIdDto.prototype, "leaveTypeId", void 0);
+class GetLeaveTypesDto {
+    active;
+}
+exports.GetLeaveTypesDto = GetLeaveTypesDto;
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, validators_1.IsNullable)(),
+    QueryBoolean(),
+    (0, class_validator_1.IsBoolean)({ message: 'Active must be true or false' }),
+    __metadata("design:type", Object)
+], GetLeaveTypesDto.prototype, "active", void 0);
+class CreateLeaveTypeDto {
+    name;
+    description;
+    default_days;
+    is_paid;
+    requires_approval;
+}
+exports.CreateLeaveTypeDto = CreateLeaveTypeDto;
+__decorate([
+    Trim(),
+    (0, class_validator_1.IsString)({ message: 'Invalid name' }),
+    (0, class_validator_1.MinLength)(1, { message: 'Name cannot be empty' }),
+    (0, class_validator_1.MaxLength)(100, { message: 'Name cannot exceed 100 characters' }),
+    __metadata("design:type", String)
+], CreateLeaveTypeDto.prototype, "name", void 0);
+__decorate([
+    (0, validators_1.EmptyToNull)(),
+    (0, validators_1.IsNullable)(),
+    (0, class_validator_1.IsString)({ message: 'Invalid description' }),
+    (0, class_validator_1.MaxLength)(2000, { message: 'Description cannot exceed 2000 characters' }),
+    __metadata("design:type", Object)
+], CreateLeaveTypeDto.prototype, "description", void 0);
+__decorate([
+    (0, class_validator_1.IsNumber)({ maxDecimalPlaces: 1 }, { message: 'Default days must be a number with at most one decimal' }),
+    (0, class_validator_1.Min)(0, { message: 'Default days cannot be negative' }),
+    (0, class_validator_1.Max)(999.9, { message: 'Default days cannot exceed 999.9' }),
+    __metadata("design:type", Number)
+], CreateLeaveTypeDto.prototype, "default_days", void 0);
+__decorate([
+    (0, class_validator_1.IsBoolean)({ message: 'Is paid must be true or false' }),
+    __metadata("design:type", Boolean)
+], CreateLeaveTypeDto.prototype, "is_paid", void 0);
+__decorate([
+    (0, class_validator_1.IsBoolean)({ message: 'Requires approval must be true or false' }),
+    __metadata("design:type", Boolean)
+], CreateLeaveTypeDto.prototype, "requires_approval", void 0);
+class UpdateLeaveTypeDto {
+    name;
+    description;
+    default_days;
+    is_paid;
+    requires_approval;
+    active;
+}
+exports.UpdateLeaveTypeDto = UpdateLeaveTypeDto;
+__decorate([
+    Trim(),
+    (0, class_validator_1.IsString)({ message: 'Invalid name' }),
+    (0, class_validator_1.MinLength)(1, { message: 'Name cannot be empty' }),
+    (0, class_validator_1.MaxLength)(100, { message: 'Name cannot exceed 100 characters' }),
+    __metadata("design:type", String)
+], UpdateLeaveTypeDto.prototype, "name", void 0);
+__decorate([
+    (0, validators_1.EmptyToNull)(),
+    (0, validators_1.IsNullable)(),
+    (0, class_validator_1.IsString)({ message: 'Invalid description' }),
+    (0, class_validator_1.MaxLength)(2000, { message: 'Description cannot exceed 2000 characters' }),
+    __metadata("design:type", Object)
+], UpdateLeaveTypeDto.prototype, "description", void 0);
+__decorate([
+    (0, class_validator_1.IsNumber)({ maxDecimalPlaces: 1 }, { message: 'Default days must be a number with at most one decimal' }),
+    (0, class_validator_1.Min)(0, { message: 'Default days cannot be negative' }),
+    (0, class_validator_1.Max)(999.9, { message: 'Default days cannot exceed 999.9' }),
+    __metadata("design:type", Number)
+], UpdateLeaveTypeDto.prototype, "default_days", void 0);
+__decorate([
+    (0, class_validator_1.IsBoolean)({ message: 'Is paid must be true or false' }),
+    __metadata("design:type", Boolean)
+], UpdateLeaveTypeDto.prototype, "is_paid", void 0);
+__decorate([
+    (0, class_validator_1.IsBoolean)({ message: 'Requires approval must be true or false' }),
+    __metadata("design:type", Boolean)
+], UpdateLeaveTypeDto.prototype, "requires_approval", void 0);
+__decorate([
+    (0, class_validator_1.IsBoolean)({ message: 'Active must be true or false' }),
+    __metadata("design:type", Boolean)
+], UpdateLeaveTypeDto.prototype, "active", void 0);
+// ---- Leave entitlements ----
+class LeaveEntitlementIdDto {
+    leaveEntitlementId;
+}
+exports.LeaveEntitlementIdDto = LeaveEntitlementIdDto;
+__decorate([
+    (0, class_validator_1.IsUUID)('7', { message: 'Invalid leave entitlement ID format' }),
+    __metadata("design:type", String)
+], LeaveEntitlementIdDto.prototype, "leaveEntitlementId", void 0);
+class GetLeaveEntitlementsDto {
+    page = 1;
+    page_size = 10;
+    user_id;
+    leave_type_id;
+    as_of;
+}
+exports.GetLeaveEntitlementsDto = GetLeaveEntitlementsDto;
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Transform)(({ value }) => value ? Number(value) : 1, { toClassOnly: true }),
+    (0, class_validator_1.IsNumber)({}, { message: 'Page must be a number' }),
+    (0, class_validator_1.Min)(1, { message: 'Page must be at least 1' }),
+    __metadata("design:type", Number)
+], GetLeaveEntitlementsDto.prototype, "page", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Transform)(({ value }) => value ? Number(value) : 10, { toClassOnly: true }),
+    (0, class_validator_1.IsNumber)({}, { message: 'Page size must be a number' }),
+    (0, class_validator_1.Min)(1, { message: 'Page size must be at least 1' }),
+    (0, class_validator_1.Max)(100, { message: 'Page size cannot exceed 100' }),
+    __metadata("design:type", Number)
+], GetLeaveEntitlementsDto.prototype, "page_size", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, validators_1.IsNullable)(),
+    (0, class_validator_1.IsUUID)('4', { message: 'Invalid user ID format' }),
+    __metadata("design:type", Object)
+], GetLeaveEntitlementsDto.prototype, "user_id", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, validators_1.IsNullable)(),
+    (0, class_validator_1.IsUUID)('7', { message: 'Invalid leave type ID format' }),
+    __metadata("design:type", Object)
+], GetLeaveEntitlementsDto.prototype, "leave_type_id", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, validators_1.IsNullable)(),
+    (0, validators_1.IsCalendarDate)({ message: 'As of must be a calendar date (YYYY-MM-DD)' }),
+    __metadata("design:type", Object)
+], GetLeaveEntitlementsDto.prototype, "as_of", void 0);
+class CreateLeaveEntitlementDto {
+    user_id;
+    leave_type_id;
+    days_entitled;
+    period_start;
+    period_end;
+    notes;
+}
+exports.CreateLeaveEntitlementDto = CreateLeaveEntitlementDto;
+__decorate([
+    (0, class_validator_1.IsUUID)('4', { message: 'Invalid user ID format' }),
+    __metadata("design:type", String)
+], CreateLeaveEntitlementDto.prototype, "user_id", void 0);
+__decorate([
+    (0, class_validator_1.IsUUID)('7', { message: 'Invalid leave type ID format' }),
+    __metadata("design:type", String)
+], CreateLeaveEntitlementDto.prototype, "leave_type_id", void 0);
+__decorate([
+    (0, class_validator_1.IsNumber)({ maxDecimalPlaces: 1 }, { message: 'Days entitled must be a number with at most one decimal' }),
+    (0, class_validator_1.Min)(0, { message: 'Days entitled cannot be negative' }),
+    (0, class_validator_1.Max)(999.9, { message: 'Days entitled cannot exceed 999.9' }),
+    __metadata("design:type", Number)
+], CreateLeaveEntitlementDto.prototype, "days_entitled", void 0);
+__decorate([
+    (0, validators_1.IsNullable)(),
+    (0, validators_1.IsCalendarDate)({ message: 'Period start must be a calendar date (YYYY-MM-DD)' }),
+    __metadata("design:type", Object)
+], CreateLeaveEntitlementDto.prototype, "period_start", void 0);
+__decorate([
+    (0, validators_1.IsNullable)(),
+    (0, validators_1.IsCalendarDate)({ message: 'Period end must be a calendar date (YYYY-MM-DD)' }),
+    __metadata("design:type", Object)
+], CreateLeaveEntitlementDto.prototype, "period_end", void 0);
+__decorate([
+    (0, validators_1.EmptyToNull)(),
+    (0, validators_1.IsNullable)(),
+    (0, class_validator_1.IsString)({ message: 'Invalid notes' }),
+    (0, class_validator_1.MaxLength)(2000, { message: 'Notes cannot exceed 2000 characters' }),
+    __metadata("design:type", Object)
+], CreateLeaveEntitlementDto.prototype, "notes", void 0);
+class UpdateLeaveEntitlementDto {
+    days_entitled;
+    period_end;
+    notes;
+}
+exports.UpdateLeaveEntitlementDto = UpdateLeaveEntitlementDto;
+__decorate([
+    (0, class_validator_1.IsNumber)({ maxDecimalPlaces: 1 }, { message: 'Days entitled must be a number with at most one decimal' }),
+    (0, class_validator_1.Min)(0, { message: 'Days entitled cannot be negative' }),
+    (0, class_validator_1.Max)(999.9, { message: 'Days entitled cannot exceed 999.9' }),
+    __metadata("design:type", Number)
+], UpdateLeaveEntitlementDto.prototype, "days_entitled", void 0);
+__decorate([
+    (0, validators_1.IsCalendarDate)({ message: 'Period end must be a calendar date (YYYY-MM-DD)' }),
+    __metadata("design:type", String)
+], UpdateLeaveEntitlementDto.prototype, "period_end", void 0);
+__decorate([
+    (0, validators_1.EmptyToNull)(),
+    (0, validators_1.IsNullable)(),
+    (0, class_validator_1.IsString)({ message: 'Invalid notes' }),
+    (0, class_validator_1.MaxLength)(2000, { message: 'Notes cannot exceed 2000 characters' }),
+    __metadata("design:type", Object)
+], UpdateLeaveEntitlementDto.prototype, "notes", void 0);
+// ---- Leave requests ----
+class LeaveRequestIdDto {
+    leaveRequestId;
+}
+exports.LeaveRequestIdDto = LeaveRequestIdDto;
+__decorate([
+    (0, class_validator_1.IsUUID)('7', { message: 'Invalid leave request ID format' }),
+    __metadata("design:type", String)
+], LeaveRequestIdDto.prototype, "leaveRequestId", void 0);
+class GetLeaveRequestsDto {
+    page = 1;
+    page_size = 10;
+    user_id;
+    leave_type_id;
+    status;
+    start_date_after;
+    start_date_before;
+}
+exports.GetLeaveRequestsDto = GetLeaveRequestsDto;
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Transform)(({ value }) => value ? Number(value) : 1, { toClassOnly: true }),
+    (0, class_validator_1.IsNumber)({}, { message: 'Page must be a number' }),
+    (0, class_validator_1.Min)(1, { message: 'Page must be at least 1' }),
+    __metadata("design:type", Number)
+], GetLeaveRequestsDto.prototype, "page", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Transform)(({ value }) => value ? Number(value) : 10, { toClassOnly: true }),
+    (0, class_validator_1.IsNumber)({}, { message: 'Page size must be a number' }),
+    (0, class_validator_1.Min)(1, { message: 'Page size must be at least 1' }),
+    (0, class_validator_1.Max)(100, { message: 'Page size cannot exceed 100' }),
+    __metadata("design:type", Number)
+], GetLeaveRequestsDto.prototype, "page_size", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, validators_1.IsNullable)(),
+    (0, class_validator_1.IsUUID)('4', { message: 'Invalid user ID format' }),
+    __metadata("design:type", Object)
+], GetLeaveRequestsDto.prototype, "user_id", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, validators_1.IsNullable)(),
+    (0, class_validator_1.IsUUID)('7', { message: 'Invalid leave type ID format' }),
+    __metadata("design:type", Object)
+], GetLeaveRequestsDto.prototype, "leave_type_id", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, validators_1.IsNullable)(),
+    (0, class_validator_1.IsEnum)(enum_1.LeaveRequestStatus, { message: 'Invalid status' }),
+    __metadata("design:type", Object)
+], GetLeaveRequestsDto.prototype, "status", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, validators_1.IsNullable)(),
+    (0, validators_1.IsCalendarDate)({ message: 'Start date after must be a calendar date (YYYY-MM-DD)' }),
+    __metadata("design:type", Object)
+], GetLeaveRequestsDto.prototype, "start_date_after", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, validators_1.IsNullable)(),
+    (0, validators_1.IsCalendarDate)({ message: 'Start date before must be a calendar date (YYYY-MM-DD)' }),
+    __metadata("design:type", Object)
+], GetLeaveRequestsDto.prototype, "start_date_before", void 0);
+// No `user_id`: a request is always the caller's own. Filing on someone's behalf is a later
+// feature, and leaving the field out is what keeps a forged one from validating.
+class CreateLeaveRequestDto {
+    leave_type_id;
+    start_date;
+    end_date;
+    is_half_day;
+    reason;
+}
+exports.CreateLeaveRequestDto = CreateLeaveRequestDto;
+__decorate([
+    (0, class_validator_1.IsUUID)('7', { message: 'Invalid leave type ID format' }),
+    __metadata("design:type", String)
+], CreateLeaveRequestDto.prototype, "leave_type_id", void 0);
+__decorate([
+    (0, validators_1.IsCalendarDate)({ message: 'Start date must be a calendar date (YYYY-MM-DD)' }),
+    __metadata("design:type", String)
+], CreateLeaveRequestDto.prototype, "start_date", void 0);
+__decorate([
+    (0, validators_1.IsCalendarDate)({ message: 'End date must be a calendar date (YYYY-MM-DD)' }),
+    __metadata("design:type", String)
+], CreateLeaveRequestDto.prototype, "end_date", void 0);
+__decorate([
+    (0, class_validator_1.IsBoolean)({ message: 'Is half day must be true or false' }),
+    __metadata("design:type", Boolean)
+], CreateLeaveRequestDto.prototype, "is_half_day", void 0);
+__decorate([
+    (0, validators_1.EmptyToNull)(),
+    (0, validators_1.IsNullable)(),
+    (0, class_validator_1.IsString)({ message: 'Invalid reason' }),
+    (0, class_validator_1.MaxLength)(2000, { message: 'Reason cannot exceed 2000 characters' }),
+    __metadata("design:type", Object)
+], CreateLeaveRequestDto.prototype, "reason", void 0);
+class UpdateLeaveRequestDto {
+    leave_type_id;
+    start_date;
+    end_date;
+    is_half_day;
+    reason;
+}
+exports.UpdateLeaveRequestDto = UpdateLeaveRequestDto;
+__decorate([
+    (0, class_validator_1.IsUUID)('7', { message: 'Invalid leave type ID format' }),
+    __metadata("design:type", String)
+], UpdateLeaveRequestDto.prototype, "leave_type_id", void 0);
+__decorate([
+    (0, validators_1.IsCalendarDate)({ message: 'Start date must be a calendar date (YYYY-MM-DD)' }),
+    __metadata("design:type", String)
+], UpdateLeaveRequestDto.prototype, "start_date", void 0);
+__decorate([
+    (0, validators_1.IsCalendarDate)({ message: 'End date must be a calendar date (YYYY-MM-DD)' }),
+    __metadata("design:type", String)
+], UpdateLeaveRequestDto.prototype, "end_date", void 0);
+__decorate([
+    (0, class_validator_1.IsBoolean)({ message: 'Is half day must be true or false' }),
+    __metadata("design:type", Boolean)
+], UpdateLeaveRequestDto.prototype, "is_half_day", void 0);
+__decorate([
+    (0, validators_1.EmptyToNull)(),
+    (0, validators_1.IsNullable)(),
+    (0, class_validator_1.IsString)({ message: 'Invalid reason' }),
+    (0, class_validator_1.MaxLength)(2000, { message: 'Reason cannot exceed 2000 characters' }),
+    __metadata("design:type", Object)
+], UpdateLeaveRequestDto.prototype, "reason", void 0);
+class ReviewLeaveRequestDto {
+    status;
+    review_note;
+}
+exports.ReviewLeaveRequestDto = ReviewLeaveRequestDto;
+__decorate([
+    (0, class_validator_1.IsEnum)(enum_1.LeaveReviewDecision, { message: 'Status must be approved or rejected' }),
+    __metadata("design:type", String)
+], ReviewLeaveRequestDto.prototype, "status", void 0);
+__decorate([
+    (0, validators_1.EmptyToNull)(),
+    (0, validators_1.IsNullable)(),
+    (0, class_validator_1.IsString)({ message: 'Invalid review note' }),
+    (0, class_validator_1.MaxLength)(2000, { message: 'Review note cannot exceed 2000 characters' }),
+    __metadata("design:type", Object)
+], ReviewLeaveRequestDto.prototype, "review_note", void 0);

package/dist/leave/index.d.ts

@@ -0,0 +1,5 @@
+export * from './dto';
+export * from './working-days';
+export { LeaveTypesResource } from './leave-types';
+export { LeaveEntitlementsResource, type CreateLeaveEntitlementInput, type LeaveEntitlementCover, } from './leave-entitlements';
+export { LeaveRequestsResource, type CreateLeaveRequestRow, type ReviewLeaveRequestRow, type UpdateLeaveRequestRow, } from './leave-requests';