@managemint-solutions/sdk 0.35.0 → 0.37.0

package/dist/leave/dto.js

@@ -0,0 +1,375 @@
+"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;
+    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.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';

package/dist/leave/index.js

@@ -0,0 +1,29 @@
+"use strict";
+// Leave, the first slice of the HR module: one resource per table, the DTOs the api validates
+// with, and the calendar arithmetic the api counts days with. The resources hang off
+// `SupabaseClient` as `leaveTypes`, `leaveEntitlements` and `leaveRequests`; the holiday
+// calendar the day count reads is its own resource, `publicHolidays` (src/public-holidays).
+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.LeaveRequestsResource = exports.LeaveEntitlementsResource = exports.LeaveTypesResource = void 0;
+__exportStar(require("./dto"), exports);
+__exportStar(require("./working-days"), exports);
+var leave_types_1 = require("./leave-types");
+Object.defineProperty(exports, "LeaveTypesResource", { enumerable: true, get: function () { return leave_types_1.LeaveTypesResource; } });
+var leave_entitlements_1 = require("./leave-entitlements");
+Object.defineProperty(exports, "LeaveEntitlementsResource", { enumerable: true, get: function () { return leave_entitlements_1.LeaveEntitlementsResource; } });
+var leave_requests_1 = require("./leave-requests");
+Object.defineProperty(exports, "LeaveRequestsResource", { enumerable: true, get: function () { return leave_requests_1.LeaveRequestsResource; } });

package/dist/leave/leave-entitlements.d.ts

@@ -0,0 +1,42 @@
+import type { MmsList } from '@managemint-solutions/entities/common';
+import type { LeaveEntitlementEntity, LeavePeriod } from '@managemint-solutions/entities/leave';
+import type { AuthContext } from '../auth';
+import { type AuditResource } from '../audit';
+import type { TypedSupabaseClient } from '../client';
+import type { GetLeaveEntitlementsDto, UpdateLeaveEntitlementDto } from './dto';
+/** What the request path needs of the entitlement covering a date: the period and the cap. */
+export type LeaveEntitlementCover = LeavePeriod & {
+    mms_id: string;
+    days_entitled: number;
+};
+/** The create input after the api has resolved the period defaults. */
+export type CreateLeaveEntitlementInput = LeavePeriod & {
+    user_id: string;
+    leave_type_id: string;
+    days_entitled: number;
+    notes?: string | null;
+};
+export declare class LeaveEntitlementsResource {
+    private readonly supabase;
+    private readonly auth;
+    private readonly table;
+    constructor(supabase: TypedSupabaseClient, auth: AuthContext, audit: AuditResource);
+    list(query: GetLeaveEntitlementsDto): Promise<MmsList<LeaveEntitlementEntity>>;
+    getById(leaveEntitlementId: string): Promise<LeaveEntitlementEntity>;
+    /**
+     * The entitlement of `userId` for `leaveTypeId` whose period contains `date`, or null when the
+     * type is not tracked for them then. The periods of one user and type cannot overlap (the
+     * table's exclusion constraint), so there is at most one.
+     */
+    findFor(userId: string, leaveTypeId: string, date: string): Promise<LeaveEntitlementCover | null>;
+    create(input: CreateLeaveEntitlementInput): Promise<LeaveEntitlementEntity>;
+    update(leaveEntitlementId: string, input: UpdateLeaveEntitlementDto): Promise<LeaveEntitlementEntity>;
+    /** Hard delete: the type simply becomes untracked for that user and period. */
+    remove(leaveEntitlementId: string): Promise<void>;
+    /**
+     * Adds the computed balance to each row from one query over the requests that could count
+     * against any of them - the approved and pending ones of these users and types, starting in
+     * the span the periods cover. Nothing is stored: a balance is always what the requests say.
+     */
+    private withBalances;
+}

package/dist/leave/leave-entitlements.js

@@ -0,0 +1,170 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LeaveEntitlementsResource = void 0;
+const enum_1 = require("@managemint-solutions/entities/audit-trail/enum");
+const enum_2 = require("@managemint-solutions/entities/leave/enum");
+const audit_1 = require("../audit");
+const errors_1 = require("../errors");
+const transforms_1 = require("../transforms");
+const LEAVE_ENTITLEMENT_SELECT = `
+        mms_id,
+        created_at,
+        created_by:user_profiles!created_by (*),
+        updated_at,
+        last_updated_by:user_profiles!last_updated_by (*),
+        user:user_profiles!user_id (*),
+        leave_type:leave_types!leave_type_id (
+          mms_id,
+          name
+        ),
+        period_start,
+        period_end,
+        days_entitled,
+        notes
+      `;
+class LeaveEntitlementsResource {
+    supabase;
+    auth;
+    table;
+    constructor(supabase, auth, audit) {
+        this.supabase = supabase;
+        this.auth = auth;
+        this.table = (0, audit_1.auditedTable)(supabase, auth, audit, {
+            table: 'leave_entitlements',
+            entityType: enum_1.AuditTrailEntityType.LEAVE_ENTITLEMENTS,
+        });
+    }
+    async list(query) {
+        const page = query.page;
+        const pageSize = query.page_size;
+        const offset = (page - 1) * pageSize;
+        let entitlementsQuery = this.supabase
+            .from('leave_entitlements')
+            .select(LEAVE_ENTITLEMENT_SELECT, { count: 'estimated' })
+            .eq('organization_id', this.auth.organization_id)
+            .order('period_start', { ascending: false })
+            .order('created_at', { ascending: false })
+            .range(offset, offset + pageSize - 1);
+        if (query.user_id) {
+            entitlementsQuery = entitlementsQuery.eq('user_id', query.user_id);
+        }
+        if (query.leave_type_id) {
+            entitlementsQuery = entitlementsQuery.eq('leave_type_id', query.leave_type_id);
+        }
+        if (query.as_of) {
+            entitlementsQuery = entitlementsQuery.lte('period_start', query.as_of).gte('period_end', query.as_of);
+        }
+        const { data, error, count } = await entitlementsQuery;
+        if (error)
+            throw (0, errors_1.mapPostgrestError)(error);
+        const rows = await this.withBalances((data ?? []));
+        return (0, transforms_1.toMmsList)(rows, page, pageSize, count);
+    }
+    async getById(leaveEntitlementId) {
+        const { data, error } = await this.supabase
+            .from('leave_entitlements')
+            .select(LEAVE_ENTITLEMENT_SELECT)
+            .eq('mms_id', leaveEntitlementId)
+            .eq('organization_id', this.auth.organization_id)
+            .single();
+        if (error)
+            throw (0, errors_1.mapPostgrestError)(error);
+        const [row] = await this.withBalances([data]);
+        return row;
+    }
+    /**
+     * The entitlement of `userId` for `leaveTypeId` whose period contains `date`, or null when the
+     * type is not tracked for them then. The periods of one user and type cannot overlap (the
+     * table's exclusion constraint), so there is at most one.
+     */
+    async findFor(userId, leaveTypeId, date) {
+        const { data, error } = await this.supabase
+            .from('leave_entitlements')
+            .select('mms_id, period_start, period_end, days_entitled')
+            .eq('organization_id', this.auth.organization_id)
+            .eq('user_id', userId)
+            .eq('leave_type_id', leaveTypeId)
+            .lte('period_start', date)
+            .gte('period_end', date)
+            .maybeSingle();
+        if (error)
+            throw (0, errors_1.mapPostgrestError)(error);
+        if (!data)
+            return null;
+        const cover = data;
+        return { ...cover, days_entitled: Number(cover.days_entitled) };
+    }
+    async create(input) {
+        const row = await this.table.insert({
+            user_id: input.user_id,
+            leave_type_id: input.leave_type_id,
+            period_start: input.period_start,
+            period_end: input.period_end,
+            days_entitled: input.days_entitled,
+            notes: input.notes ?? null,
+            organization_id: this.auth.organization_id,
+            created_by: this.auth.mms_id,
+            created_at: new Date().toISOString(),
+        });
+        return this.getById(row.mms_id);
+    }
+    async update(leaveEntitlementId, input) {
+        await this.table.update(leaveEntitlementId, {
+            days_entitled: input.days_entitled,
+            period_end: input.period_end,
+            notes: input.notes,
+            last_updated_by: this.auth.mms_id,
+            updated_at: new Date().toISOString(),
+        });
+        return this.getById(leaveEntitlementId);
+    }
+    /** Hard delete: the type simply becomes untracked for that user and period. */
+    async remove(leaveEntitlementId) {
+        await this.table.remove(leaveEntitlementId);
+    }
+    /**
+     * Adds the computed balance to each row from one query over the requests that could count
+     * against any of them - the approved and pending ones of these users and types, starting in
+     * the span the periods cover. Nothing is stored: a balance is always what the requests say.
+     */
+    async withBalances(rows) {
+        if (rows.length === 0)
+            return [];
+        const userIds = [...new Set(rows.map((row) => row.user.mms_id))];
+        const typeIds = [...new Set(rows.map((row) => row.leave_type.mms_id))];
+        const earliest = rows.map((row) => row.period_start).sort()[0];
+        const latest = rows.map((row) => row.period_end).sort().reverse()[0];
+        const { data, error } = await this.supabase
+            .from('leave_requests')
+            .select('user_id, leave_type_id, start_date, days, status')
+            .eq('organization_id', this.auth.organization_id)
+            .in('user_id', userIds)
+            .in('leave_type_id', typeIds)
+            .in('status', [enum_2.LeaveRequestStatus.APPROVED, enum_2.LeaveRequestStatus.PENDING])
+            .gte('start_date', earliest)
+            .lte('start_date', latest);
+        if (error)
+            throw (0, errors_1.mapPostgrestError)(error);
+        const requests = (data ?? []);
+        return rows.map((row) => {
+            const mine = requests.filter((request) => request.user_id === row.user.mms_id &&
+                request.leave_type_id === row.leave_type.mms_id &&
+                request.start_date >= row.period_start &&
+                request.start_date <= row.period_end);
+            const sum = (status) => mine
+                .filter((request) => request.status === status)
+                .reduce((total, request) => total + Number(request.days), 0);
+            const daysEntitled = Number(row.days_entitled);
+            const daysUsed = sum(enum_2.LeaveRequestStatus.APPROVED);
+            const daysPending = sum(enum_2.LeaveRequestStatus.PENDING);
+            return {
+                ...row,
+                days_entitled: daysEntitled,
+                days_used: daysUsed,
+                days_pending: daysPending,
+                days_remaining: daysEntitled - daysUsed - daysPending,
+            };
+        });
+    }
+}
+exports.LeaveEntitlementsResource = LeaveEntitlementsResource;