@managemint-solutions/sdk 0.42.0 → 0.44.0

package/README.md

@@ -202,10 +202,13 @@ await supabase.tasks.archive(task.mms_id);
 await supabase.tasks.unarchive(task.mms_id);
 await supabase.tasks.remove(task.mms_id);   // soft delete
 await supabase.tasks.restore(task.mms_id);
+await supabase.tasks.linkTask(task.mms_id, { linked_task_id: otherId, link_type: TaskLinkType.CHILD });
+await supabase.tasks.unlinkTask(task.mms_id, otherId);
 ```
 
 A task's `task_id` (its per-organization number) is assigned by the database on insert, and each
-task carries its embedded `status`, `assigned_to`, `project` and `client`.
+task carries its embedded `status`, `assigned_to`, `project` and `client`. The detail read also carries its `parent`,
+`subtasks` and `related` tasks, read from `task_links` in both directions.
 
 The client decodes `{ mms_id, organization_id }` from the JWT itself and scopes every query
 by `organization_id`. `supabase.supabase` is the raw `@supabase/supabase-js` client

package/dist/additional-details/index.js

@@ -15,9 +15,11 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AdditionalDetailsResource = void 0;
-const enum_1 = require("@managemint-solutions/entities/audit-trail/enum");
+const enum_1 = require("@managemint-solutions/entities/additional-details/enum");
+const enum_2 = require("@managemint-solutions/entities/audit-trail/enum");
 const audit_1 = require("../audit");
 const errors_1 = require("../errors");
+const won_1 = require("../leads/won");
 const values_1 = require("./values");
 __exportStar(require("./dto"), exports);
 __exportStar(require("./values"), exports);
@@ -41,7 +43,7 @@ class AdditionalDetailsResource {
         this.auth = auth;
         this.table = (0, audit_1.auditedTable)(supabase, auth, audit, {
             table: 'additional_details',
-            entityType: enum_1.AuditTrailEntityType.ADDITIONAL_DETAILS,
+            entityType: enum_2.AuditTrailEntityType.ADDITIONAL_DETAILS,
         });
     }
     async getById(additionalDetailsId) {
@@ -68,6 +70,9 @@ class AdditionalDetailsResource {
         return data.map(withCastValue);
     }
     async create(entity, entityId, input) {
+        if (entity === enum_1.AdditionalDetailsEntityTypes.LEAD) {
+            await (0, won_1.refuseWonLead)(this.supabase, this.auth.organization_id, entityId);
+        }
         const row = await this.table.insert({
             organization_id: this.auth.organization_id,
             entity_type: entity,

package/dist/client.d.ts

@@ -9,6 +9,7 @@ import { NotificationsResource } from './notifications';
 import { BillingReadsResource } from './billing';
 import { InvoicesReadsResource } from './billing/invoices';
 import { LabelsResource } from './labels';
+import { LeadsResource } from './leads';
 import { LeaveEntitlementsResource, LeaveRequestsResource, LeaveTypesResource } from './leave';
 import { OrganizationsResource } from './organizations';
 import { PermissionsResource } from './permissions';
@@ -58,6 +59,7 @@ export declare class SupabaseClient {
     readonly permissions: PermissionsResource;
     readonly users: UsersResource;
     readonly supportingFiles: SupportingFilesResource;
+    readonly leads: LeadsResource;
     readonly clients: ClientsResource;
     readonly projects: ProjectsResource;
     readonly tasks: TasksResource;

package/dist/client.js

@@ -11,6 +11,7 @@ const notifications_1 = require("./notifications");
 const billing_1 = require("./billing");
 const invoices_1 = require("./billing/invoices");
 const labels_1 = require("./labels");
+const leads_1 = require("./leads");
 const leave_1 = require("./leave");
 const organizations_1 = require("./organizations");
 const permissions_1 = require("./permissions");
@@ -43,6 +44,7 @@ class SupabaseClient {
     permissions;
     users;
     supportingFiles;
+    leads;
     clients;
     projects;
     tasks;
@@ -71,6 +73,8 @@ class SupabaseClient {
         this.users = new users_1.UsersResource(this.supabase, this.auth, this.audit);
         this.supportingFiles = new supporting_files_1.SupportingFilesResource(this.supabase, this.auth, this.audit);
         this.clients = new clients_1.ClientsResource(this.supabase, this.auth, this.audit);
+        // After clients and additional details: a convert writes through both.
+        this.leads = new leads_1.LeadsResource(this.supabase, this.auth, this.audit, this.additionalDetails);
         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);

package/dist/clients/index.js

@@ -34,7 +34,8 @@ const CLIENT_LIST_SELECT = `
           label,
           is_complete,
           is_fail,
-          is_triage
+          is_triage,
+          is_won
         ),
         created_by:user_profiles!created_by (*)
       `;
@@ -50,7 +51,8 @@ const CLIENT_DETAIL_SELECT = `
           colour,
           is_complete,
           is_fail,
-          is_triage
+          is_triage,
+          is_won
         ),
         contract_client,
         contracted_hours,

package/dist/index.d.ts

@@ -35,8 +35,9 @@ export { AddUserDto, GetUsersQueryDto, UpdateMyProfileDto, UpdateUserDto, UserId
 export type { ClaimOutcome, WebhookEventRow, WebhookEventsTable } from './webhook-events';
 export { GetSupportingFilesDto, SupportingFileIdDto } from './supporting-files';
 export { ClientIdDto, CreateClientDto, GetClientsDto, UpdateClientDto } from './clients';
+export { ConvertLeadDto, CreateLeadDto, GetLeadsDto, LeadIdDto, UpdateLeadDto } from './leads';
 export { CreateProjectDto, GetProjectsDto, ProjectIdDto, UpdateProjectDto } from './projects';
-export { CreateTaskDto, GetTasksDto, TaskIdDto, UpdateTaskDto } from './tasks';
+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 { GetPublicHolidaysDto } from './public-holidays';

package/dist/index.js

@@ -8,7 +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.monthlyTotalMinor = exports.weekStartOf = exports.minutesBetween = exports.UpdateTimesheetEntryDto = exports.TimesheetIdDto = 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.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 = exports.UserIdDto = exports.UpdateUserDto = exports.UpdateMyProfileDto = exports.GetUsersQueryDto = 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;
 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; } });
@@ -94,15 +95,23 @@ Object.defineProperty(exports, "ClientIdDto", { enumerable: true, get: function
 Object.defineProperty(exports, "CreateClientDto", { enumerable: true, get: function () { return clients_1.CreateClientDto; } });
 Object.defineProperty(exports, "GetClientsDto", { enumerable: true, get: function () { return clients_1.GetClientsDto; } });
 Object.defineProperty(exports, "UpdateClientDto", { enumerable: true, get: function () { return clients_1.UpdateClientDto; } });
+var leads_1 = require("./leads");
+Object.defineProperty(exports, "ConvertLeadDto", { enumerable: true, get: function () { return leads_1.ConvertLeadDto; } });
+Object.defineProperty(exports, "CreateLeadDto", { enumerable: true, get: function () { return leads_1.CreateLeadDto; } });
+Object.defineProperty(exports, "GetLeadsDto", { enumerable: true, get: function () { return leads_1.GetLeadsDto; } });
+Object.defineProperty(exports, "LeadIdDto", { enumerable: true, get: function () { return leads_1.LeadIdDto; } });
+Object.defineProperty(exports, "UpdateLeadDto", { enumerable: true, get: function () { return leads_1.UpdateLeadDto; } });
 var projects_1 = require("./projects");
 Object.defineProperty(exports, "CreateProjectDto", { enumerable: true, get: function () { return projects_1.CreateProjectDto; } });
 Object.defineProperty(exports, "GetProjectsDto", { enumerable: true, get: function () { return projects_1.GetProjectsDto; } });
 Object.defineProperty(exports, "ProjectIdDto", { enumerable: true, get: function () { return projects_1.ProjectIdDto; } });
 Object.defineProperty(exports, "UpdateProjectDto", { enumerable: true, get: function () { return projects_1.UpdateProjectDto; } });
 var tasks_1 = require("./tasks");
+Object.defineProperty(exports, "AddTaskLinkDto", { enumerable: true, get: function () { return tasks_1.AddTaskLinkDto; } });
 Object.defineProperty(exports, "CreateTaskDto", { enumerable: true, get: function () { return tasks_1.CreateTaskDto; } });
 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, "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, "CreateLeaveEntitlementDto", { enumerable: true, get: function () { return leave_1.CreateLeaveEntitlementDto; } });

package/dist/leads/dto.d.ts

@@ -0,0 +1,35 @@
+import type { UUID } from 'crypto';
+import type { ConvertLeadDto as ConvertLeadDtoType, CreateLeadDto as CreateLeadDtoType, GetLeadsDto as GetLeadsDtoType, LeadIdDto as LeadIdDtoType, UpdateLeadDto as UpdateLeadDtoType } from '@managemint-solutions/entities/leads/dto';
+import { LeadSource } from '@managemint-solutions/entities/leads/enum';
+export declare class GetLeadsDto implements Omit<GetLeadsDtoType, 'status_id_in'> {
+    readonly search?: string | null;
+    readonly page: number;
+    readonly page_size: number;
+    readonly created_after?: string | null;
+    readonly created_before?: string | null;
+    readonly status_id_in?: string[] | null;
+    readonly status_id_not_in?: string[] | null;
+    readonly assigned_to_id?: string | null;
+    readonly completed?: boolean | null;
+    readonly archive: boolean;
+}
+export declare class LeadIdDto implements LeadIdDtoType {
+    readonly leadId: string;
+}
+export declare class CreateLeadDto implements CreateLeadDtoType {
+    readonly name: string;
+    readonly contact_person?: string | null;
+    readonly email?: string | null;
+    readonly phone?: string | null;
+    readonly status_id?: UUID | null;
+    readonly assigned_to_id?: string | null;
+    readonly source?: LeadSource | null;
+    readonly estimated_value_minor?: number | null;
+    readonly follow_up_date?: string | null;
+    readonly lost_reason?: string | null;
+}
+export declare class UpdateLeadDto extends CreateLeadDto implements UpdateLeadDtoType {
+}
+export declare class ConvertLeadDto implements ConvertLeadDtoType {
+    readonly client_status_id: string | null;
+}

package/dist/leads/dto.js

@@ -0,0 +1,209 @@
+"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.ConvertLeadDto = exports.UpdateLeadDto = exports.CreateLeadDto = exports.LeadIdDto = exports.GetLeadsDto = void 0;
+const class_validator_1 = require("class-validator");
+const class_transformer_1 = require("class-transformer");
+const enum_1 = require("@managemint-solutions/entities/leads/enum");
+const validators_1 = require("../validators");
+// class-validator versions of the shared DTO types from @managemint-solutions/entities, so the
+// wire contract cannot drift. `status_id` is typed as the entities' `UUID | null` for the same
+// reason; class-validator only sees the runtime string.
+// `status_id_in` is omitted from the implemented type on purpose: the entities type carries the
+// CSV wire value (`string | null`), while this class carries the `@Transform`-parsed
+// `string[] | null` the query builder feeds to `.in('status_id', ...)`. `status_id_not_in` is not
+// in the entities type at all: it is what the api resolves `completed: false` into, as for tasks.
+class GetLeadsDto {
+    search;
+    page = 1;
+    page_size = 10;
+    created_after;
+    created_before;
+    status_id_in;
+    status_id_not_in;
+    assigned_to_id;
+    // Tri-state: true = only won leads, false = only open ones, omitted = no completion filter.
+    // The api resolves it to status ids before it reaches `list`.
+    completed;
+    archive = false;
+}
+exports.GetLeadsDto = GetLeadsDto;
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, validators_1.IsNullable)(),
+    (0, class_validator_1.IsString)({ message: 'Search query must be a string' }),
+    (0, class_validator_1.MinLength)(1, { message: 'Search query cannot be empty' }),
+    (0, class_validator_1.MaxLength)(255, { message: 'Search query cannot exceed 255 characters' }),
+    __metadata("design:type", Object)
+], GetLeadsDto.prototype, "search", void 0);
+__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)
+], GetLeadsDto.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)
+], GetLeadsDto.prototype, "page_size", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, validators_1.IsNullable)(),
+    (0, class_validator_1.IsDateString)({}, { message: 'Start date must be a valid ISO 8601 date string' }),
+    __metadata("design:type", Object)
+], GetLeadsDto.prototype, "created_after", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, validators_1.IsNullable)(),
+    (0, class_validator_1.IsDateString)({}, { message: 'End date must be a valid ISO 8601 date string' }),
+    __metadata("design:type", Object)
+], GetLeadsDto.prototype, "created_before", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, validators_1.IsNullable)(),
+    (0, class_transformer_1.Transform)(({ value }) => value ? value.split(',').map((id) => id.trim()) : null, { toClassOnly: true }),
+    (0, class_validator_1.IsUUID)('7', { each: true, message: 'Each status ID must be a valid UUID v7' }),
+    __metadata("design:type", Object)
+], GetLeadsDto.prototype, "status_id_in", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, validators_1.IsNullable)(),
+    (0, class_transformer_1.Transform)(({ value }) => value ? value.split(',').map((id) => id.trim()) : null, { toClassOnly: true }),
+    (0, class_validator_1.IsUUID)('7', { each: true, message: 'Each status ID must be a valid UUID v7' }),
+    __metadata("design:type", Object)
+], GetLeadsDto.prototype, "status_id_not_in", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, validators_1.IsNullable)()
+    // v4: the owner is a `users.mms_id`, the GoTrue auth uid (see GetTasksDto).
+    ,
+    (0, class_validator_1.IsUUID)('4', { message: 'Invalid assigned to ID format' }),
+    __metadata("design:type", Object)
+], GetLeadsDto.prototype, "assigned_to_id", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, validators_1.IsNullable)(),
+    (0, class_transformer_1.Transform)(({ value }) => value === 'true' ? true : value === 'false' ? false : value, { toClassOnly: true }),
+    (0, class_validator_1.IsBoolean)({ message: 'Completed must be true or false' }),
+    __metadata("design:type", Object)
+], GetLeadsDto.prototype, "completed", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, validators_1.IsNullable)(),
+    (0, class_transformer_1.Transform)(({ value }) => value ? value === 'true' : false, { toClassOnly: true }),
+    (0, class_validator_1.IsBoolean)({ message: 'Include archived must be a boolean' }),
+    __metadata("design:type", Boolean)
+], GetLeadsDto.prototype, "archive", void 0);
+class LeadIdDto {
+    leadId;
+}
+exports.LeadIdDto = LeadIdDto;
+__decorate([
+    (0, class_validator_1.IsUUID)('7', { message: 'Invalid lead ID format' }),
+    __metadata("design:type", String)
+], LeadIdDto.prototype, "leadId", void 0);
+class CreateLeadDto {
+    name;
+    contact_person;
+    email;
+    phone;
+    status_id;
+    // Omitted defaults to the creator. v4: a `users.mms_id` is the GoTrue auth uid.
+    assigned_to_id;
+    // The only check on the value: `leads.source` is plain text.
+    source;
+    estimated_value_minor;
+    follow_up_date;
+    // Required when the status is a fail status and cleared otherwise - `LeadsResource` decides.
+    lost_reason;
+}
+exports.CreateLeadDto = CreateLeadDto;
+__decorate([
+    (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)
+], CreateLeadDto.prototype, "name", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, validators_1.IsNullable)(),
+    (0, class_validator_1.IsString)({ message: 'Invalid contact person' }),
+    (0, class_validator_1.MaxLength)(100, { message: 'Contact person cannot exceed 100 characters' }),
+    __metadata("design:type", Object)
+], CreateLeadDto.prototype, "contact_person", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, validators_1.IsNullable)(),
+    (0, class_validator_1.ValidateIf)((o) => o.email !== ''),
+    (0, class_validator_1.IsEmail)({}, { message: 'Invalid email address' }),
+    __metadata("design:type", Object)
+], CreateLeadDto.prototype, "email", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, validators_1.IsNullable)(),
+    (0, class_validator_1.IsString)({ message: 'Invalid phone number' }),
+    __metadata("design:type", Object)
+], CreateLeadDto.prototype, "phone", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, validators_1.IsNullable)(),
+    (0, class_validator_1.IsUUID)('7', { message: 'Invalid status ID format' }),
+    __metadata("design:type", Object)
+], CreateLeadDto.prototype, "status_id", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, validators_1.IsNullable)(),
+    (0, class_validator_1.IsUUID)('4', { message: 'Invalid assigned to ID format' }),
+    __metadata("design:type", Object)
+], CreateLeadDto.prototype, "assigned_to_id", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, validators_1.IsNullable)(),
+    (0, class_validator_1.IsEnum)(enum_1.LeadSource, { message: 'Invalid lead source' }),
+    __metadata("design:type", Object)
+], CreateLeadDto.prototype, "source", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, validators_1.IsNullable)(),
+    (0, class_validator_1.IsInt)({ message: 'Estimated value must be a whole number of minor units' }),
+    (0, class_validator_1.Min)(0, { message: 'Estimated value must be at least 0' }),
+    __metadata("design:type", Object)
+], CreateLeadDto.prototype, "estimated_value_minor", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, validators_1.IsNullable)(),
+    (0, validators_1.IsCalendarDate)({ message: 'Follow-up date must be a calendar date (YYYY-MM-DD)' }),
+    __metadata("design:type", Object)
+], CreateLeadDto.prototype, "follow_up_date", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, validators_1.IsNullable)(),
+    (0, class_validator_1.IsString)({ message: 'Invalid lost reason' }),
+    (0, class_validator_1.MaxLength)(500, { message: 'Lost reason cannot exceed 500 characters' }),
+    __metadata("design:type", Object)
+], CreateLeadDto.prototype, "lost_reason", void 0);
+class UpdateLeadDto extends CreateLeadDto {
+}
+exports.UpdateLeadDto = UpdateLeadDto;
+class ConvertLeadDto {
+    client_status_id;
+}
+exports.ConvertLeadDto = ConvertLeadDto;
+__decorate([
+    (0, validators_1.IsNullable)(),
+    (0, class_validator_1.IsUUID)('7', { message: 'Invalid status ID format' }),
+    __metadata("design:type", Object)
+], ConvertLeadDto.prototype, "client_status_id", void 0);

package/dist/leads/index.d.ts

@@ -0,0 +1,54 @@
+import type { ClientEntity } from '@managemint-solutions/entities/clients';
+import type { MmsList } from '@managemint-solutions/entities/common';
+import type { LeadEntity, LeadSummary } from '@managemint-solutions/entities/leads';
+import type { AuthContext } from '../auth';
+import type { AdditionalDetailsResource } from '../additional-details';
+import { type AuditResource } from '../audit';
+import type { ClientsResource } from '../clients';
+import type { TypedSupabaseClient } from '../client';
+import type { ConvertLeadDto, CreateLeadDto, GetLeadsDto, UpdateLeadDto } from './dto';
+export * from './dto';
+export declare class LeadsResource {
+    private readonly supabase;
+    private readonly auth;
+    private readonly audit;
+    private readonly additionalDetails;
+    private readonly table;
+    constructor(supabase: TypedSupabaseClient, auth: AuthContext, audit: AuditResource, additionalDetails: AdditionalDetailsResource);
+    list(query: GetLeadsDto): Promise<MmsList<LeadSummary>>;
+    getById(leadId: string): Promise<LeadEntity>;
+    create(input: CreateLeadDto): Promise<LeadEntity>;
+    update(leadId: string, input: UpdateLeadDto): Promise<LeadEntity>;
+    archive(leadId: string): Promise<LeadEntity>;
+    unarchive(leadId: string): Promise<LeadEntity>;
+    restore(leadId: string): Promise<LeadEntity>;
+    /** Soft delete - the row stays, flagged `deleted`, and `restore()` brings it back. A Won lead cannot be deleted. */
+    remove(leadId: string): Promise<void>;
+    /**
+     * Turns the lead into a client: the client is created from the lead's name, email and phone
+     * with the status the caller picked, the lead's contact person, source and estimated value
+     * become additional details on it, the lead's notes, additional details and files move to it,
+     * and the lead moves to Won with `converted_client_id` and `converted_at` set. It is not
+     * deleted - it stays as a record of the deal, and from then on it cannot be changed
+     * (`refuseWonLead`). The list hides Won leads by default.
+     *
+     * There is no transaction across these writes (PostgREST and Storage cannot share one). A
+     * failure after the client is created leaves that client and a lead that is still not
+     * converted, holding whatever had not moved yet. Running the convert again is safe: step (a)
+     * only refuses a lead that finished converting, and steps (d) and (e) only touch rows still on
+     * the lead, so nothing is moved twice - but it makes a second client, and the first one (with
+     * whatever had already moved to it) is left for someone to tidy up or delete.
+     *
+     * Converting needs only `update_leads`: `clients` is the service-role clients resource
+     * acting for the caller (`forOrganization(org, user).clientsOnBehalfOfUser()`), so the
+     * client is created, and read back, without the caller holding any clients permission.
+     */
+    convert(leadId: string, input: ConvertLeadDto, clients: ClientsResource): Promise<ClientEntity>;
+    /**
+     * The two status rules, checked before anything is written, and the lost reason the write
+     * stores. A lead reaches its Won status (`is_won`) only by converting, so choosing it is
+     * refused (a converted lead is not updated at all). A fail status needs a lost reason; any
+     * other status, or none, clears it.
+     */
+    private lostReasonFor;
+}