@managemint-solutions/sdk 0.45.0 → 0.49.0

package/README.md

@@ -419,10 +419,10 @@ a snapshot taken when it was filed, so a holiday added later does not rewrite ap
 The calendar arithmetic is plain exported functions, shared with the api:
 
 ```ts
-import { countWorkingDays, leavePeriodFor, todayInJohannesburg } from '@managemint-solutions/sdk';
+import { countWorkingDays, cyclePeriodFor, 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 { cycle, period } = cyclePeriodFor(type, user.start_date, '2026-09-21', org.leave_calendar_start_month); // cycle_years leave years from the leave-year month; period clipped to the start date
 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();                                        // "today" for the entitlements' as-of lookup
@@ -454,16 +454,17 @@ a caller need not fetch the type. The reporting line is two deep on the user: `m
 `active` ignored.
 
 An entitlement carries `max_carry_over_days` (HR-set, default 0): on the leave-year boundary the
-api's nightly rollover creates next period's entitlement for each person and type as
-`default_days + min(unused, cap)`. What it runs on:
+api's monthly rollover creates next period's entitlement for each person and type as
+`default_days + min(unused, cap)`. An entitlement's period is computed, never typed: `update`
+takes the days, carry and notes only. What the rollover runs on:
 
 ```ts
-import { leavePeriodFor, shiftDays } from '@managemint-solutions/sdk';
+import { cyclePeriodFor, shiftDays } from '@managemint-solutions/sdk';
 
 const scope = service.forOrganization(organizationId);                  // system actor: created_by stays null
-const ended = leavePeriodFor(shiftDays(today, -1), startMonth);          // the period that closed yesterday
-const rows = await scope.leaveEntitlements.endingOn(ended.period_end);   // every entitlement ending that day, balances included, paged
-const active = new Set(await scope.users.activeIds());                   // who still gets a new period
+const rows = await scope.leaveEntitlements.endedWithoutSuccessor(today); // ended before today, no later period of that user and type yet; balances included, paged
+const employees = await scope.users.employment();                       // who still gets a new period
+const { cycle } = cyclePeriodFor(type, employee.start_date, shiftDays(row.period_end, 1), startMonth); // the next period runs from the day after to the cycle's end
 await scope.leaveEntitlements.create({ ...next, user_id, leave_type_id, days_entitled, max_carry_over_days, notes });
 ```
 

package/dist/client.d.ts

@@ -10,7 +10,7 @@ import { BillingReadsResource } from './billing';
 import { InvoicesReadsResource } from './billing/invoices';
 import { LabelsResource } from './labels';
 import { LeadsResource } from './leads';
-import { LeaveEntitlementsResource, LeaveRequestsResource, LeaveTypesResource } from './leave';
+import { LeaveAdjustmentsResource, LeaveEntitlementsResource, LeaveRequestsResource, LeaveTypesResource } from './leave';
 import { OrganizationsResource } from './organizations';
 import { PermissionsResource } from './permissions';
 import { ProjectsResource } from './projects';
@@ -66,6 +66,7 @@ export declare class SupabaseClient {
     readonly leaveTypes: LeaveTypesResource;
     readonly publicHolidays: PublicHolidaysResource;
     readonly leaveEntitlements: LeaveEntitlementsResource;
+    readonly leaveAdjustments: LeaveAdjustmentsResource;
     readonly leaveRequests: LeaveRequestsResource;
     readonly timesheets: TimesheetsResource;
     readonly timesheetEntries: TimesheetEntriesResource;

package/dist/client.js

@@ -51,6 +51,7 @@ class SupabaseClient {
     leaveTypes;
     publicHolidays;
     leaveEntitlements;
+    leaveAdjustments;
     leaveRequests;
     timesheets;
     timesheetEntries;
@@ -81,6 +82,7 @@ class SupabaseClient {
         // 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.leaveAdjustments = new leave_1.LeaveAdjustmentsResource(this.supabase, this.auth, this.audit);
         this.leaveRequests = new leave_1.LeaveRequestsResource(this.supabase, this.auth, this.audit);
         this.timesheets = new timesheets_1.TimesheetsResource(this.supabase, this.auth, this.audit);
         this.timesheetEntries = new timesheets_1.TimesheetEntriesResource(this.supabase, this.auth, this.audit);

package/dist/index.d.ts

@@ -30,7 +30,7 @@ export { CreateOrganizationDto, UpdateOrganizationDto } from './organizations';
 export { PermissionsResource } from './permissions';
 export type { PermissionFlags } from './permissions';
 export { UpdatePermissionsDto } from './permissions';
-export type { UserRow } from './users';
+export type { UserEmploymentRow, UserRow } from './users';
 export { AddUserDto, GetUsersQueryDto, UpdateMyProfileDto, UpdateUserDto, UserIdDto, } from './users';
 export type { ClaimOutcome, WebhookEventRow, WebhookEventsTable } from './webhook-events';
 export { GetSupportingFilesDto, SupportingFileIdDto } from './supporting-files';
@@ -38,10 +38,11 @@ export { ClientIdDto, CreateClientDto, GetClientsDto, UpdateClientDto } from './
 export { ConvertLeadDto, CreateLeadDto, GetLeadsDto, LeadIdDto, UpdateLeadDto } from './leads';
 export { CreateProjectDto, GetProjectsDto, ProjectIdDto, UpdateProjectDto } from './projects';
 export { AddTaskLinkDto, CreateTaskDto, GetTasksDto, TaskIdDto, TaskLinkIdDto, 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 type { CreateLeaveEntitlementInput, CreateLeaveRequestRow, ReviewLeaveRequestRow, UpdateLeaveRequestRow, } from './leave';
+export type { BalanceEntitlement, BalanceRequest, LeaveCycle } from './leave';
+export { BulkCreateLeaveEntitlementsDto, CreateLeaveAdjustmentDto, CreateLeaveEntitlementDto, CreateLeaveRequestDto, CreateLeaveTypeDto, GetLeaveCalendarDto, GetLeaveEntitlementsDto, GetLeaveRequestsDto, GetLeaveTypesDto, LeaveEntitlementIdDto, LeaveRequestIdDto, LeaveTypeIdDto, ReviewLeaveRequestDto, UpdateLeaveEntitlementDto, UpdateLeaveRequestDto, UpdateLeaveTypeDto, } from './leave';
 export { GetPublicHolidaysDto } from './public-holidays';
-export { addOneYearMinusDay, countWorkingDays, isWithinPeriod, leavePeriodFor, shiftDays, todayInJohannesburg, } from './leave';
+export { addMonths, completedMonths, countWorkingDays, cyclePeriodFor, initialUntil, isWithinPeriod, proRataDays, shiftDays, todayInJohannesburg, } from './leave';
 export type { CreateTimesheetEntryRow, CreateTimesheetRow, ReviewTimesheetRow, TimesheetCover, TimesheetReportRow, UpdateTimesheetEntryRow, } from './timesheets';
 export { CreateTimesheetEntryDto, GetTimesheetReportDto, GetTimesheetsDto, ReviewTimesheetDto, TimesheetEntryIdDto, TimesheetIdDto, UpdateTimesheetEntryDto, } from './timesheets';
 export { minutesBetween, weekStartOf } from './timesheets';

package/dist/index.js

@@ -8,8 +8,8 @@
 // to keep. The row and input types they produce and accept are exported for annotations.
 Object.defineProperty(exports, "__esModule", { value: true });
 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.UpdateLabelDto = exports.LabelIdDto = exports.GetLabelsDto = exports.AddLabelDto = 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.TimesheetEntryIdDto = exports.ReviewTimesheetDto = exports.GetTimesheetsDto = exports.GetTimesheetReportDto = exports.CreateTimesheetEntryDto = exports.todayInJohannesburg = exports.shiftDays = 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.TaskLinkIdDto = exports.TaskIdDto = exports.GetTasksDto = exports.CreateTaskDto = exports.AddTaskLinkDto = exports.UpdateProjectDto = exports.ProjectIdDto = exports.GetProjectsDto = exports.CreateProjectDto = exports.UpdateLeadDto = exports.LeadIdDto = exports.GetLeadsDto = exports.CreateLeadDto = exports.ConvertLeadDto = exports.UpdateClientDto = exports.GetClientsDto = exports.CreateClientDto = exports.ClientIdDto = exports.SupportingFileIdDto = exports.GetSupportingFilesDto = exports.UserIdDto = exports.UpdateUserDto = exports.UpdateMyProfileDto = exports.GetUsersQueryDto = void 0;
-exports.monthlyTotalMinor = exports.weekStartOf = exports.minutesBetween = exports.UpdateTimesheetEntryDto = exports.TimesheetIdDto = void 0;
+exports.shiftDays = exports.proRataDays = exports.isWithinPeriod = exports.initialUntil = exports.cyclePeriodFor = exports.countWorkingDays = exports.completedMonths = exports.addMonths = exports.GetPublicHolidaysDto = exports.UpdateLeaveTypeDto = exports.UpdateLeaveRequestDto = exports.UpdateLeaveEntitlementDto = exports.ReviewLeaveRequestDto = exports.LeaveTypeIdDto = exports.LeaveRequestIdDto = exports.LeaveEntitlementIdDto = exports.GetLeaveTypesDto = exports.GetLeaveRequestsDto = exports.GetLeaveEntitlementsDto = exports.GetLeaveCalendarDto = exports.CreateLeaveTypeDto = exports.CreateLeaveRequestDto = exports.CreateLeaveEntitlementDto = exports.CreateLeaveAdjustmentDto = exports.BulkCreateLeaveEntitlementsDto = exports.UpdateTaskDto = exports.TaskLinkIdDto = exports.TaskIdDto = exports.GetTasksDto = exports.CreateTaskDto = exports.AddTaskLinkDto = exports.UpdateProjectDto = exports.ProjectIdDto = exports.GetProjectsDto = exports.CreateProjectDto = exports.UpdateLeadDto = exports.LeadIdDto = exports.GetLeadsDto = exports.CreateLeadDto = exports.ConvertLeadDto = exports.UpdateClientDto = exports.GetClientsDto = exports.CreateClientDto = exports.ClientIdDto = exports.SupportingFileIdDto = exports.GetSupportingFilesDto = exports.UserIdDto = exports.UpdateUserDto = exports.UpdateMyProfileDto = exports.GetUsersQueryDto = void 0;
+exports.monthlyTotalMinor = exports.weekStartOf = exports.minutesBetween = exports.UpdateTimesheetEntryDto = exports.TimesheetIdDto = exports.TimesheetEntryIdDto = exports.ReviewTimesheetDto = exports.GetTimesheetsDto = exports.GetTimesheetReportDto = exports.CreateTimesheetEntryDto = exports.todayInJohannesburg = 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; } });
@@ -114,9 +114,12 @@ Object.defineProperty(exports, "TaskIdDto", { enumerable: true, get: function ()
 Object.defineProperty(exports, "TaskLinkIdDto", { enumerable: true, get: function () { return tasks_1.TaskLinkIdDto; } });
 Object.defineProperty(exports, "UpdateTaskDto", { enumerable: true, get: function () { return tasks_1.UpdateTaskDto; } });
 var leave_1 = require("./leave");
+Object.defineProperty(exports, "BulkCreateLeaveEntitlementsDto", { enumerable: true, get: function () { return leave_1.BulkCreateLeaveEntitlementsDto; } });
+Object.defineProperty(exports, "CreateLeaveAdjustmentDto", { enumerable: true, get: function () { return leave_1.CreateLeaveAdjustmentDto; } });
 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, "GetLeaveCalendarDto", { enumerable: true, get: function () { return leave_1.GetLeaveCalendarDto; } });
 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; } });
@@ -129,13 +132,16 @@ Object.defineProperty(exports, "UpdateLeaveRequestDto", { enumerable: true, get:
 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.
+// The calendar and policy arithmetic is plain functions, not a resource, so the api counts days
+// and balances 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, "addMonths", { enumerable: true, get: function () { return leave_2.addMonths; } });
+Object.defineProperty(exports, "completedMonths", { enumerable: true, get: function () { return leave_2.completedMonths; } });
 Object.defineProperty(exports, "countWorkingDays", { enumerable: true, get: function () { return leave_2.countWorkingDays; } });
+Object.defineProperty(exports, "cyclePeriodFor", { enumerable: true, get: function () { return leave_2.cyclePeriodFor; } });
+Object.defineProperty(exports, "initialUntil", { enumerable: true, get: function () { return leave_2.initialUntil; } });
 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, "proRataDays", { enumerable: true, get: function () { return leave_2.proRataDays; } });
 Object.defineProperty(exports, "shiftDays", { enumerable: true, get: function () { return leave_2.shiftDays; } });
 Object.defineProperty(exports, "todayInJohannesburg", { enumerable: true, get: function () { return leave_2.todayInJohannesburg; } });
 var timesheets_1 = require("./timesheets");

package/dist/leave/dto.d.ts

@@ -1,26 +1,34 @@
-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';
+import type { BulkCreateLeaveEntitlementsDto as BulkCreateLeaveEntitlementsDtoType, CreateLeaveAdjustmentDto as CreateLeaveAdjustmentDtoType, CreateLeaveEntitlementDto as CreateLeaveEntitlementDtoType, CreateLeaveRequestDto as CreateLeaveRequestDtoType, CreateLeaveTypeDto as CreateLeaveTypeDtoType, GetLeaveCalendarDto as GetLeaveCalendarDtoType, 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 { LeaveGrantMethod, 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;
+/** The policy half of a leave type, shared by create and update. */
+declare class LeaveTypePolicy {
     readonly default_days: number;
     readonly is_paid: boolean;
     readonly requires_approval: boolean;
-    readonly requires_document: boolean;
+    readonly document_after_days: number | null;
+    readonly cycle_years: number;
+    readonly grant_method: LeaveGrantMethod;
+    readonly max_carry_over_days: number;
+    readonly carry_over_expiry_months: number | null;
+    readonly min_service_months: number;
+    readonly min_days_per_week: number;
+    readonly initial_months: number;
+    readonly initial_days_per_month: number | null;
+    readonly paid_on_exit: boolean;
 }
-export declare class UpdateLeaveTypeDto implements UpdateLeaveTypeDtoType {
+export declare class CreateLeaveTypeDto extends LeaveTypePolicy implements CreateLeaveTypeDtoType {
+    readonly name: string;
+    readonly description: string | null;
+}
+export declare class UpdateLeaveTypeDto extends LeaveTypePolicy implements UpdateLeaveTypeDtoType {
     readonly name: string;
     readonly description: string | null;
-    readonly default_days: number;
-    readonly is_paid: boolean;
-    readonly requires_approval: boolean;
-    readonly requires_document: boolean;
     readonly active: boolean;
 }
 export declare class LeaveEntitlementIdDto implements LeaveEntitlementIdDtoType {
@@ -33,21 +41,33 @@ export declare class GetLeaveEntitlementsDto implements GetLeaveEntitlementsDtoT
     readonly leave_type_id?: string | null;
     readonly as_of?: string | null;
 }
-export declare class CreateLeaveEntitlementDto implements CreateLeaveEntitlementDtoType {
+/** The opening balance an entitlement brings in, shared by create and update. */
+declare class CarriedDays {
+    readonly days_carried: number;
+    readonly carried_expires_on: string | null;
+}
+export declare class CreateLeaveEntitlementDto extends CarriedDays implements CreateLeaveEntitlementDtoType {
     readonly user_id: string;
     readonly leave_type_id: string;
-    readonly days_entitled: number;
-    readonly max_carry_over_days: number;
+    readonly days_entitled: number | null;
+    readonly max_carry_over_days: number | null;
     readonly period_start: string | null;
     readonly period_end: string | null;
     readonly notes: string | null;
 }
-export declare class UpdateLeaveEntitlementDto implements UpdateLeaveEntitlementDtoType {
+export declare class UpdateLeaveEntitlementDto extends CarriedDays implements UpdateLeaveEntitlementDtoType {
     readonly days_entitled: number;
     readonly max_carry_over_days: number;
-    readonly period_end: string;
     readonly notes: string | null;
 }
+export declare class BulkCreateLeaveEntitlementsDto implements BulkCreateLeaveEntitlementsDtoType {
+    readonly leave_type_id: string;
+    readonly user_ids: string[] | null;
+}
+export declare class CreateLeaveAdjustmentDto implements CreateLeaveAdjustmentDtoType {
+    readonly days: number;
+    readonly reason: string;
+}
 export declare class LeaveRequestIdDto implements LeaveRequestIdDtoType {
     readonly leaveRequestId: string;
 }
@@ -61,6 +81,7 @@ export declare class GetLeaveRequestsDto implements GetLeaveRequestsDtoType {
     readonly start_date_before?: string | null;
 }
 export declare class CreateLeaveRequestDto implements CreateLeaveRequestDtoType {
+    readonly user_id: string | null;
     readonly leave_type_id: string;
     readonly start_date: string;
     readonly end_date: string;
@@ -78,3 +99,10 @@ export declare class ReviewLeaveRequestDto implements ReviewLeaveRequestDtoType
     readonly status: LeaveReviewDecision;
     readonly review_note: string | null;
 }
+export declare class GetLeaveCalendarDto implements GetLeaveCalendarDtoType {
+    readonly date_from: string;
+    readonly date_to: string;
+    readonly user_id?: string | null;
+    readonly leave_type_id?: string | null;
+}
+export {};

package/dist/leave/dto.js

@@ -9,7 +9,7 @@ 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;
+exports.GetLeaveCalendarDto = exports.ReviewLeaveRequestDto = exports.UpdateLeaveRequestDto = exports.CreateLeaveRequestDto = exports.GetLeaveRequestsDto = exports.LeaveRequestIdDto = exports.CreateLeaveAdjustmentDto = exports.BulkCreateLeaveEntitlementsDto = 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");
@@ -46,13 +46,98 @@ __decorate([
     (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;
+/** The policy half of a leave type, shared by create and update. */
+class LeaveTypePolicy {
     default_days;
     is_paid;
     requires_approval;
-    requires_document;
+    document_after_days;
+    cycle_years;
+    grant_method;
+    max_carry_over_days;
+    carry_over_expiry_months;
+    min_service_months;
+    min_days_per_week;
+    initial_months;
+    initial_days_per_month;
+    paid_on_exit;
+}
+__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)
+], LeaveTypePolicy.prototype, "default_days", void 0);
+__decorate([
+    (0, class_validator_1.IsBoolean)({ message: 'Is paid must be true or false' }),
+    __metadata("design:type", Boolean)
+], LeaveTypePolicy.prototype, "is_paid", void 0);
+__decorate([
+    (0, class_validator_1.IsBoolean)({ message: 'Requires approval must be true or false' }),
+    __metadata("design:type", Boolean)
+], LeaveTypePolicy.prototype, "requires_approval", void 0);
+__decorate([
+    (0, validators_1.IsNullable)(),
+    (0, class_validator_1.IsNumber)({ maxDecimalPlaces: 1 }, { message: 'Document after days must be a number with at most one decimal' }),
+    (0, class_validator_1.Min)(0, { message: 'Document after days cannot be negative' }),
+    (0, class_validator_1.Max)(999.9, { message: 'Document after days cannot exceed 999.9' }),
+    __metadata("design:type", Object)
+], LeaveTypePolicy.prototype, "document_after_days", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)({ message: 'Cycle years must be a whole number' }),
+    (0, class_validator_1.Min)(1, { message: 'Cycle years must be at least 1' }),
+    (0, class_validator_1.Max)(5, { message: 'Cycle years cannot exceed 5' }),
+    __metadata("design:type", Number)
+], LeaveTypePolicy.prototype, "cycle_years", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(enum_1.LeaveGrantMethod, { message: 'Grant method must be upfront or monthly' }),
+    __metadata("design:type", String)
+], LeaveTypePolicy.prototype, "grant_method", void 0);
+__decorate([
+    (0, class_validator_1.IsNumber)({ maxDecimalPlaces: 1 }, { message: 'Max carry over days must be a number with at most one decimal' }),
+    (0, class_validator_1.Min)(0, { message: 'Max carry over days cannot be negative' }),
+    (0, class_validator_1.Max)(999.9, { message: 'Max carry over days cannot exceed 999.9' }),
+    __metadata("design:type", Number)
+], LeaveTypePolicy.prototype, "max_carry_over_days", void 0);
+__decorate([
+    (0, validators_1.IsNullable)(),
+    (0, class_validator_1.IsInt)({ message: 'Carry over expiry months must be a whole number' }),
+    (0, class_validator_1.Min)(1, { message: 'Carry over expiry months must be at least 1' }),
+    (0, class_validator_1.Max)(60, { message: 'Carry over expiry months cannot exceed 60' }),
+    __metadata("design:type", Object)
+], LeaveTypePolicy.prototype, "carry_over_expiry_months", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)({ message: 'Minimum service months must be a whole number' }),
+    (0, class_validator_1.Min)(0, { message: 'Minimum service months cannot be negative' }),
+    (0, class_validator_1.Max)(120, { message: 'Minimum service months cannot exceed 120' }),
+    __metadata("design:type", Number)
+], LeaveTypePolicy.prototype, "min_service_months", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)({ message: 'Minimum days per week must be a whole number' }),
+    (0, class_validator_1.Min)(0, { message: 'Minimum days per week cannot be negative' }),
+    (0, class_validator_1.Max)(7, { message: 'Minimum days per week cannot exceed 7' }),
+    __metadata("design:type", Number)
+], LeaveTypePolicy.prototype, "min_days_per_week", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)({ message: 'Initial months must be a whole number' }),
+    (0, class_validator_1.Min)(0, { message: 'Initial months cannot be negative' }),
+    (0, class_validator_1.Max)(60, { message: 'Initial months cannot exceed 60' }),
+    __metadata("design:type", Number)
+], LeaveTypePolicy.prototype, "initial_months", void 0);
+__decorate([
+    (0, validators_1.IsNullable)(),
+    (0, class_validator_1.IsNumber)({ maxDecimalPlaces: 2 }, { message: 'Initial days per month must be a number with at most two decimals' }),
+    (0, class_validator_1.Min)(0, { message: 'Initial days per month cannot be negative' }),
+    (0, class_validator_1.Max)(99.99, { message: 'Initial days per month cannot exceed 99.99' }),
+    __metadata("design:type", Object)
+], LeaveTypePolicy.prototype, "initial_days_per_month", void 0);
+__decorate([
+    (0, class_validator_1.IsBoolean)({ message: 'Paid on exit must be true or false' }),
+    __metadata("design:type", Boolean)
+], LeaveTypePolicy.prototype, "paid_on_exit", void 0);
+class CreateLeaveTypeDto extends LeaveTypePolicy {
+    name;
+    description;
 }
 exports.CreateLeaveTypeDto = CreateLeaveTypeDto;
 __decorate([
@@ -69,31 +154,9 @@ __decorate([
     (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);
-__decorate([
-    (0, class_validator_1.IsBoolean)({ message: 'Requires document must be true or false' }),
-    __metadata("design:type", Boolean)
-], CreateLeaveTypeDto.prototype, "requires_document", void 0);
-class UpdateLeaveTypeDto {
+class UpdateLeaveTypeDto extends LeaveTypePolicy {
     name;
     description;
-    default_days;
-    is_paid;
-    requires_approval;
-    requires_document;
     active;
 }
 exports.UpdateLeaveTypeDto = UpdateLeaveTypeDto;
@@ -111,24 +174,6 @@ __decorate([
     (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: 'Requires document must be true or false' }),
-    __metadata("design:type", Boolean)
-], UpdateLeaveTypeDto.prototype, "requires_document", void 0);
 __decorate([
     (0, class_validator_1.IsBoolean)({ message: 'Active must be true or false' }),
     __metadata("design:type", Boolean)
@@ -183,7 +228,23 @@ __decorate([
     (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 {
+/** The opening balance an entitlement brings in, shared by create and update. */
+class CarriedDays {
+    days_carried;
+    carried_expires_on;
+}
+__decorate([
+    (0, class_validator_1.IsNumber)({ maxDecimalPlaces: 1 }, { message: 'Days carried must be a number with at most one decimal' }),
+    (0, class_validator_1.Min)(0, { message: 'Days carried cannot be negative' }),
+    (0, class_validator_1.Max)(999.9, { message: 'Days carried cannot exceed 999.9' }),
+    __metadata("design:type", Number)
+], CarriedDays.prototype, "days_carried", void 0);
+__decorate([
+    (0, validators_1.IsNullable)(),
+    (0, validators_1.IsCalendarDate)({ message: 'Carried expires on must be a calendar date (YYYY-MM-DD)' }),
+    __metadata("design:type", Object)
+], CarriedDays.prototype, "carried_expires_on", void 0);
+class CreateLeaveEntitlementDto extends CarriedDays {
     user_id;
     leave_type_id;
     days_entitled;
@@ -202,16 +263,18 @@ __decorate([
     __metadata("design:type", String)
 ], CreateLeaveEntitlementDto.prototype, "leave_type_id", void 0);
 __decorate([
+    (0, validators_1.IsNullable)(),
     (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)
+    __metadata("design:type", Object)
 ], CreateLeaveEntitlementDto.prototype, "days_entitled", void 0);
 __decorate([
+    (0, validators_1.IsNullable)(),
     (0, class_validator_1.IsNumber)({ maxDecimalPlaces: 1 }, { message: 'Max carry over days must be a number with at most one decimal' }),
     (0, class_validator_1.Min)(0, { message: 'Max carry over days cannot be negative' }),
     (0, class_validator_1.Max)(999.9, { message: 'Max carry over days cannot exceed 999.9' }),
-    __metadata("design:type", Number)
+    __metadata("design:type", Object)
 ], CreateLeaveEntitlementDto.prototype, "max_carry_over_days", void 0);
 __decorate([
     (0, validators_1.IsNullable)(),
@@ -230,10 +293,9 @@ __decorate([
     (0, class_validator_1.MaxLength)(2000, { message: 'Notes cannot exceed 2000 characters' }),
     __metadata("design:type", Object)
 ], CreateLeaveEntitlementDto.prototype, "notes", void 0);
-class UpdateLeaveEntitlementDto {
+class UpdateLeaveEntitlementDto extends CarriedDays {
     days_entitled;
     max_carry_over_days;
-    period_end;
     notes;
 }
 exports.UpdateLeaveEntitlementDto = UpdateLeaveEntitlementDto;
@@ -249,10 +311,6 @@ __decorate([
     (0, class_validator_1.Max)(999.9, { message: 'Max carry over days cannot exceed 999.9' }),
     __metadata("design:type", Number)
 ], UpdateLeaveEntitlementDto.prototype, "max_carry_over_days", 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)(),
@@ -260,6 +318,42 @@ __decorate([
     (0, class_validator_1.MaxLength)(2000, { message: 'Notes cannot exceed 2000 characters' }),
     __metadata("design:type", Object)
 ], UpdateLeaveEntitlementDto.prototype, "notes", void 0);
+class BulkCreateLeaveEntitlementsDto {
+    leave_type_id;
+    user_ids;
+}
+exports.BulkCreateLeaveEntitlementsDto = BulkCreateLeaveEntitlementsDto;
+__decorate([
+    (0, class_validator_1.IsUUID)('7', { message: 'Invalid leave type ID format' }),
+    __metadata("design:type", String)
+], BulkCreateLeaveEntitlementsDto.prototype, "leave_type_id", void 0);
+__decorate([
+    (0, validators_1.IsNullable)(),
+    (0, class_validator_1.IsArray)({ message: 'User IDs must be a list' }),
+    (0, class_validator_1.ArrayMinSize)(1, { message: 'Choose at least one person, or send null for everyone' }),
+    (0, class_validator_1.ArrayMaxSize)(500, { message: 'At most 500 people at once' }),
+    (0, class_validator_1.IsUUID)('4', { each: true, message: 'Invalid user ID format' }),
+    __metadata("design:type", Object)
+], BulkCreateLeaveEntitlementsDto.prototype, "user_ids", void 0);
+class CreateLeaveAdjustmentDto {
+    days;
+    reason;
+}
+exports.CreateLeaveAdjustmentDto = CreateLeaveAdjustmentDto;
+__decorate([
+    (0, class_validator_1.IsNumber)({ maxDecimalPlaces: 1 }, { message: 'Days must be a number with at most one decimal' }),
+    (0, class_validator_1.NotEquals)(0, { message: 'An adjustment cannot be zero days' }),
+    (0, class_validator_1.Min)(-999.9, { message: 'Days cannot be below -999.9' }),
+    (0, class_validator_1.Max)(999.9, { message: 'Days cannot exceed 999.9' }),
+    __metadata("design:type", Number)
+], CreateLeaveAdjustmentDto.prototype, "days", void 0);
+__decorate([
+    Trim(),
+    (0, class_validator_1.IsString)({ message: 'Invalid reason' }),
+    (0, class_validator_1.MinLength)(1, { message: 'Give a reason for the adjustment' }),
+    (0, class_validator_1.MaxLength)(500, { message: 'Reason cannot exceed 500 characters' }),
+    __metadata("design:type", String)
+], CreateLeaveAdjustmentDto.prototype, "reason", void 0);
 // ---- Leave requests ----
 class LeaveRequestIdDto {
     leaveRequestId;
@@ -324,9 +418,8 @@ __decorate([
     (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 {
+    user_id;
     leave_type_id;
     start_date;
     end_date;
@@ -334,6 +427,11 @@ class CreateLeaveRequestDto {
     reason;
 }
 exports.CreateLeaveRequestDto = CreateLeaveRequestDto;
+__decorate([
+    (0, validators_1.IsNullable)(),
+    (0, class_validator_1.IsUUID)('4', { message: 'Invalid user ID format' }),
+    __metadata("design:type", Object)
+], CreateLeaveRequestDto.prototype, "user_id", void 0);
 __decorate([
     (0, class_validator_1.IsUUID)('7', { message: 'Invalid leave type ID format' }),
     __metadata("design:type", String)
@@ -404,3 +502,31 @@ __decorate([
     (0, class_validator_1.MaxLength)(2000, { message: 'Review note cannot exceed 2000 characters' }),
     __metadata("design:type", Object)
 ], ReviewLeaveRequestDto.prototype, "review_note", void 0);
+// ---- Calendar ----
+class GetLeaveCalendarDto {
+    date_from;
+    date_to;
+    user_id;
+    leave_type_id;
+}
+exports.GetLeaveCalendarDto = GetLeaveCalendarDto;
+__decorate([
+    (0, validators_1.IsCalendarDate)({ message: 'Date from must be a calendar date (YYYY-MM-DD)' }),
+    __metadata("design:type", String)
+], GetLeaveCalendarDto.prototype, "date_from", void 0);
+__decorate([
+    (0, validators_1.IsCalendarDate)({ message: 'Date to must be a calendar date (YYYY-MM-DD)' }),
+    __metadata("design:type", String)
+], GetLeaveCalendarDto.prototype, "date_to", 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)
+], GetLeaveCalendarDto.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)
+], GetLeaveCalendarDto.prototype, "leave_type_id", void 0);

package/dist/leave/index.d.ts

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

package/dist/leave/index.js

@@ -1,7 +1,8 @@
 "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
+// with, and the calendar and policy arithmetic the api counts days and balances with. The
+// resources hang off `SupabaseClient` as `leaveTypes`, `leaveEntitlements`, `leaveAdjustments`
+// 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;
@@ -18,9 +19,12 @@ 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;
+exports.LeaveRequestsResource = exports.LeaveEntitlementsResource = exports.LeaveTypesResource = exports.LeaveAdjustmentsResource = void 0;
 __exportStar(require("./dto"), exports);
 __exportStar(require("./working-days"), exports);
+__exportStar(require("./leave-policy"), exports);
+var leave_adjustments_1 = require("./leave-adjustments");
+Object.defineProperty(exports, "LeaveAdjustmentsResource", { enumerable: true, get: function () { return leave_adjustments_1.LeaveAdjustmentsResource; } });
 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");