@managemint-solutions/sdk 0.37.0 → 0.38.0

package/README.md

@@ -427,6 +427,7 @@ 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');
@@ -435,6 +436,7 @@ const request = await supabase.leaveRequests.create({ user_id: userId, leave_typ
 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))] });
 ```
 
@@ -443,6 +445,9 @@ the request is still in the status they expect and resolve to `null` otherwise,
 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`.

package/dist/leave/dto.d.ts

@@ -51,6 +51,7 @@ 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;

package/dist/leave/dto.js

@@ -249,6 +249,7 @@ class GetLeaveRequestsDto {
     page = 1;
     page_size = 10;
     user_id;
+    leave_type_id;
     status;
     start_date_after;
     start_date_before;
@@ -275,6 +276,12 @@ __decorate([
     (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)(),

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

@@ -29,6 +29,12 @@ export declare class LeaveEntitlementsResource {
      * table's exclusion constraint), so there is at most one.
      */
     findFor(userId: string, leaveTypeId: string, date: string): Promise<LeaveEntitlementCover | null>;
+    /**
+     * Whether `userId` already has an entitlement of `leaveTypeId` touching any day of
+     * `start`..`end`. The readable half of the rule; the table's exclusion constraint is the half
+     * that survives a race. `excludeId` leaves out the entitlement being edited.
+     */
+    overlaps(userId: string, leaveTypeId: string, start: string, end: string, excludeId?: string): Promise<boolean>;
     create(input: CreateLeaveEntitlementInput): Promise<LeaveEntitlementEntity>;
     update(leaveEntitlementId: string, input: UpdateLeaveEntitlementDto): Promise<LeaveEntitlementEntity>;
     /** Hard delete: the type simply becomes untracked for that user and period. */

package/dist/leave/leave-entitlements.js

@@ -94,6 +94,28 @@ class LeaveEntitlementsResource {
         const cover = data;
         return { ...cover, days_entitled: Number(cover.days_entitled) };
     }
+    /**
+     * Whether `userId` already has an entitlement of `leaveTypeId` touching any day of
+     * `start`..`end`. The readable half of the rule; the table's exclusion constraint is the half
+     * that survives a race. `excludeId` leaves out the entitlement being edited.
+     */
+    async overlaps(userId, leaveTypeId, start, end, excludeId) {
+        let overlapQuery = this.supabase
+            .from('leave_entitlements')
+            .select('mms_id', { count: 'exact', head: true })
+            .eq('organization_id', this.auth.organization_id)
+            .eq('user_id', userId)
+            .eq('leave_type_id', leaveTypeId)
+            .lte('period_start', end)
+            .gte('period_end', start);
+        if (excludeId) {
+            overlapQuery = overlapQuery.neq('mms_id', excludeId);
+        }
+        const { count, error } = await overlapQuery;
+        if (error)
+            throw (0, errors_1.mapPostgrestError)(error);
+        return (count ?? 0) > 0;
+    }
     async create(input) {
         const row = await this.table.insert({
             user_id: input.user_id,

package/dist/leave/leave-requests.js

@@ -60,6 +60,9 @@ class LeaveRequestsResource {
         if (query.user_id) {
             requestsQuery = requestsQuery.eq('user_id', query.user_id);
         }
+        if (query.leave_type_id) {
+            requestsQuery = requestsQuery.eq('leave_type_id', query.leave_type_id);
+        }
         if (query.status) {
             requestsQuery = requestsQuery.eq('status', query.status);
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@managemint-solutions/sdk",
-  "version": "0.37.0",
+  "version": "0.38.0",
   "description": "Typed Supabase data-access SDK for ManageMint Solutions",
   "license": "UNLICENSED",
   "author": "Scott Bebington <scottbebington@gmail.com>",
@@ -51,7 +51,7 @@
     "testEnvironment": "node"
   },
   "dependencies": {
-    "@managemint-solutions/entities": "^1.21.0"
+    "@managemint-solutions/entities": "^1.22.0"
   },
   "peerDependencies": {
     "@nestjs/common": "^11.0.0",