@managemint-solutions/entities 1.22.0 → 1.23.0

package/dist/audit-trail/enum/index.d.ts

@@ -18,6 +18,7 @@ export declare enum AuditTrailEntityType {
     PROJECTS = "projects",
     TASKS = "tasks",
     TIMESHEETS = "timesheets",
+    TIMESHEET_ENTRIES = "timesheet_entries",
     LEAVE_TYPES = "leave_types",
     LEAVE_ENTITLEMENTS = "leave_entitlements",
     LEAVE_REQUESTS = "leave_requests",

package/dist/audit-trail/enum/index.js

@@ -23,6 +23,7 @@ var AuditTrailEntityType;
     AuditTrailEntityType["PROJECTS"] = "projects";
     AuditTrailEntityType["TASKS"] = "tasks";
     AuditTrailEntityType["TIMESHEETS"] = "timesheets";
+    AuditTrailEntityType["TIMESHEET_ENTRIES"] = "timesheet_entries";
     AuditTrailEntityType["LEAVE_TYPES"] = "leave_types";
     AuditTrailEntityType["LEAVE_ENTITLEMENTS"] = "leave_entitlements";
     AuditTrailEntityType["LEAVE_REQUESTS"] = "leave_requests";

package/dist/billing/enum/index.d.ts

@@ -40,7 +40,7 @@ export declare enum BillingEventSource {
     SCHEDULER = "scheduler"
 }
 /**
- * Billing ledger event names — the values written to billing_events.event_type.
+ * Billing ledger event names - the values written to billing_events.event_type.
  * Distinct from BillingStatus (which is the organization's current billing state)
  * even though a couple of values coincide, e.g. cancellation_requested.
  */

package/dist/billing/enum/index.js

@@ -53,7 +53,7 @@ var BillingEventSource;
 })(BillingEventSource || (exports.BillingEventSource = BillingEventSource = {}));
 ;
 /**
- * Billing ledger event names — the values written to billing_events.event_type.
+ * Billing ledger event names - the values written to billing_events.event_type.
  * Distinct from BillingStatus (which is the organization's current billing state)
  * even though a couple of values coincide, e.g. cancellation_requested.
  */

package/dist/billing/index.d.ts

@@ -2,7 +2,7 @@ import { BillingEventSource, BillingEventType, BillingTransactionStatus, Billing
 /**
  * Day of the month every billing period is anchored on. The period containing a
  * given date runs from the most recent 25th (inclusive) to the next 25th
- * (exclusive) — the anchor day itself belongs to the new period.
+ * (exclusive) - the anchor day itself belongs to the new period.
  */
 export declare const BILLING_ANCHOR_DAY = 25;
 export type BillingPeriod = {
@@ -31,7 +31,7 @@ export type CreateTransactionInput = {
     prorationEndAt?: Date | null;
     /**
      * Defaults to INITIALIZED. Pass PAID (with paidAt) for transactions recorded
-     * after the fact, e.g. subscription renewals reported by webhook — inserting
+     * after the fact, e.g. subscription renewals reported by webhook - inserting
      * them directly as paid keeps them out of the one-open-transaction-per-
      * organization unique index.
      */

package/dist/billing/index.js

@@ -4,6 +4,6 @@ exports.BILLING_ANCHOR_DAY = void 0;
 /**
  * Day of the month every billing period is anchored on. The period containing a
  * given date runs from the most recent 25th (inclusive) to the next 25th
- * (exclusive) — the anchor day itself belongs to the new period.
+ * (exclusive) - the anchor day itself belongs to the new period.
  */
 exports.BILLING_ANCHOR_DAY = 25;

package/dist/billing/invoices/index.d.ts

@@ -1,7 +1,7 @@
 import { BillingTransactionStatus, BillingTransactionType } from "../enum";
 /** One priced line on an invoice document, frozen at issue time. */
 export type InvoiceLineItem = {
-    /** The bold line: the module, e.g. "Core — subscription". */
+    /** The bold line: the module, e.g. "Core - subscription". */
     label: string;
     /** The grey sub-line: "12 seats · 2 Sep – 25 Sep 2026 (23 of 31 days)". */
     detail?: string | null;
@@ -27,7 +27,7 @@ export type InvoiceSummary = {
 };
 /**
  * The full invoice document data. `line_items` and `billed_to` are snapshots
- * frozen when the invoice was written — the document must not change when the
+ * frozen when the invoice was written - the document must not change when the
  * organization later edits its billing address or the pricebook moves on.
  */
 export type InvoiceEntity = InvoiceSummary & {
@@ -44,7 +44,7 @@ export type InvoiceEntity = InvoiceSummary & {
         registration_number: string | null;
     };
 };
-/** Response of GET /billing/invoices/:invoiceId/html — the A4 document markup. */
+/** Response of GET /billing/invoices/:invoiceId/html - the A4 document markup. */
 export type InvoiceHtmlResponse = {
     html: string;
 };

package/dist/billing/payments/index.d.ts

@@ -1,8 +1,8 @@
 import { BillingTransactionStatus, BillingTransactionType } from "../enum";
 /**
  * One row of GET /billing/payments: a billing_transactions ledger row as the portal
- * lists it. Every charge is a payment — the initial subscription, a pro-rata seat or
- * module charge, a reinstatement and a monthly renewal alike — whether or not it
+ * lists it. Every charge is a payment - the initial subscription, a pro-rata seat or
+ * module charge, a reinstatement and a monthly renewal alike - whether or not it
  * settled. Invoices are the separate accounting documents that only renewals issue.
  */
 export type PaymentSummary = {
@@ -26,6 +26,6 @@ export type PaymentEntity = PaymentSummary & {
     proration_start_at: string | null;
     proration_end_at: string | null;
     paystack_reference: string | null;
-    /** The invoice this payment issued — renewals only; null for every other type. */
+    /** The invoice this payment issued - renewals only; null for every other type. */
     invoice_id: string | null;
 };

package/dist/configs/dto/index.d.ts

@@ -4,7 +4,7 @@ export type CreateConfigDto = {
     description?: string;
     value?: ConfigValue;
 };
-/** `value` replaces the whole object — it is not merged. `name` is the lookup key and is not editable here. */
+/** `value` replaces the whole object - it is not merged. `name` is the lookup key and is not editable here. */
 export type UpdateConfigDto = {
     description?: string;
     value?: ConfigValue;

package/dist/configs/index.d.ts

@@ -6,7 +6,7 @@ export type JsonValue = string | number | boolean | null | JsonValue[] | {
 /** The `value` column: one JSON object keyed by setting name. */
 export type ConfigValue = Record<string, JsonValue>;
 /**
- * One named config — a row of `public.configs`. Global: there is no organization on the row.
+ * One named config - a row of `public.configs`. Global: there is no organization on the row.
  * Every signed-in caller may read; only the service role writes. A feature-flag set is just a
  * row someone named in Supabase Studio, not a concept the code knows about.
  */

package/dist/feature-requests/dto/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * The body of `POST /feature-requests`. Every field the endpoint accepts is here: the api's
  * global ValidationPipe runs with `forbidNonWhitelisted`, so anything not on this contract is
- * a 400 — the honeypot included, which is why it is a declared field rather than a stray one.
+ * a 400 - the honeypot included, which is why it is a declared field rather than a stray one.
  *
  * `source` is absent on purpose: the api sets it from `FeatureRequestSource`, never from the
  * request.

package/dist/feature-requests/enum/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * Where a feature request came in from. Stored as text and set server-side by the api — the
+ * Where a feature request came in from. Stored as text and set server-side by the api - the
  * client never sends it, so a second intake (an in-portal "suggest a feature", say) adds a
  * member here rather than trusting a request field.
  */

package/dist/feature-requests/enum/index.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FeatureRequestSource = void 0;
 /**
- * Where a feature request came in from. Stored as text and set server-side by the api — the
+ * Where a feature request came in from. Stored as text and set server-side by the api - the
  * client never sends it, so a second intake (an in-portal "suggest a feature", say) adds a
  * member here rather than trusting a request field.
  */

package/dist/feature-requests/index.d.ts

@@ -6,7 +6,7 @@ export * from './enum';
  *
  * Deliberately tenant-less: the person filling the form has no account, so there is no
  * `organization_id` and no `created_by` to record. The row is read in Supabase Studio and
- * nowhere else — nothing in the portal or on the website ever renders one back.
+ * nowhere else - nothing in the portal or on the website ever renders one back.
  */
 export type FeatureRequestEntity = {
     mms_id: UUID;
@@ -14,7 +14,7 @@ export type FeatureRequestEntity = {
     name: string;
     /** Markdown, as typed. Optional on the form, so an empty submission is stored as null. */
     specification: string | null;
-    /** Whatever the requester called themselves — a person, a company, or both. */
+    /** Whatever the requester called themselves - a person, a company, or both. */
     requester_name: string;
     requester_email: string;
     source: FeatureRequestSource;

package/dist/leave/dto/index.d.ts

@@ -20,6 +20,7 @@ export type CreateLeaveTypeDto = {
     default_days: number;
     is_paid: boolean;
     requires_approval: boolean;
+    requires_document: boolean;
 };
 export type UpdateLeaveTypeDto = {
     name: string;
@@ -27,6 +28,7 @@ export type UpdateLeaveTypeDto = {
     default_days: number;
     is_paid: boolean;
     requires_approval: boolean;
+    requires_document: boolean;
     active: boolean;
 };
 export type LeaveEntitlementIdDto = {
@@ -48,11 +50,13 @@ export type CreateLeaveEntitlementDto = {
     period_start: string | null;
     /** Null = one year after `period_start`, less a day. */
     period_end: string | null;
+    max_carry_over_days: number;
     notes: string | null;
 };
 export type UpdateLeaveEntitlementDto = {
     days_entitled: number;
     period_end: string;
+    max_carry_over_days: number;
     notes: string | null;
 };
 export type LeaveRequestIdDto = {

package/dist/leave/index.d.ts

@@ -10,6 +10,8 @@ export * from './enum';
 export type LeaveTypeIdentity = {
     mms_id: string;
     name: string;
+    /** Carried on requests and entitlements so a reviewer knows without a second fetch. */
+    requires_document: boolean;
 };
 export type LeaveTypeEntity = {
     mms_id: string;
@@ -24,6 +26,8 @@ export type LeaveTypeEntity = {
     is_paid: boolean;
     /** False auto-approves a request on submission. */
     requires_approval: boolean;
+    /** Approval waits until a supporting file is attached to the request; implies `requires_approval`. */
+    requires_document: boolean;
     /** An inactive type keeps its history but cannot be chosen for new requests. */
     active: boolean;
 };
@@ -41,6 +45,8 @@ export type LeaveEntitlementEntity = LeavePeriod & {
     user: UserIdentity;
     leave_type: LeaveTypeIdentity;
     days_entitled: number;
+    /** Cap on the unused days the nightly rollover carries into the next period. */
+    max_carry_over_days: number;
     notes: string | null;
     /**
      * Computed on read, never stored: the approved and pending requests of this user and

package/dist/modules/index.d.ts

@@ -1,6 +1,6 @@
 /**
  * Module keys the API gates features on. These MUST match billing_modules.module_key
- * rows in the database — the database decides which modules exist and what they cost;
+ * rows in the database - the database decides which modules exist and what they cost;
  * this only declares which of them unlock which features.
  *
  * Module selection is never validated against this: requests carry module ids, which
@@ -30,7 +30,7 @@ export type PricedModule = {
     currency: string;
 };
 /**
- * A frozen price list version. Exactly one pricebook is active at a time — the
+ * A frozen price list version. Exactly one pricebook is active at a time - the
  * one new organizations are pinned to and the one an organization moves to when
  * it buys a module. Organizations on older pricebooks keep paying those prices
  * until they change something (grandfathering).

package/dist/modules/index.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.MODULE_KEYS = void 0;
 /**
  * Module keys the API gates features on. These MUST match billing_modules.module_key
- * rows in the database — the database decides which modules exist and what they cost;
+ * rows in the database - the database decides which modules exist and what they cost;
  * this only declares which of them unlock which features.
  *
  * Module selection is never validated against this: requests carry module ids, which

package/dist/notifications/enum/index.d.ts

@@ -16,6 +16,9 @@ export declare enum NotificationType {
     LEAVE_REQUEST_SUBMITTED = "leave_request_submitted",
     LEAVE_REQUEST_APPROVED = "leave_request_approved",
     LEAVE_REQUEST_REJECTED = "leave_request_rejected",
+    TIMESHEET_SUBMITTED = "timesheet_submitted",
+    TIMESHEET_APPROVED = "timesheet_approved",
+    TIMESHEET_REJECTED = "timesheet_rejected",
     SIGNUP_CONFIRMATION = "signup_confirmation",
     PASSWORD_RECOVERY = "password_recovery"
 }

package/dist/notifications/enum/index.js

@@ -24,6 +24,9 @@ var NotificationType;
     NotificationType["LEAVE_REQUEST_SUBMITTED"] = "leave_request_submitted";
     NotificationType["LEAVE_REQUEST_APPROVED"] = "leave_request_approved";
     NotificationType["LEAVE_REQUEST_REJECTED"] = "leave_request_rejected";
+    NotificationType["TIMESHEET_SUBMITTED"] = "timesheet_submitted";
+    NotificationType["TIMESHEET_APPROVED"] = "timesheet_approved";
+    NotificationType["TIMESHEET_REJECTED"] = "timesheet_rejected";
     NotificationType["SIGNUP_CONFIRMATION"] = "signup_confirmation";
     NotificationType["PASSWORD_RECOVERY"] = "password_recovery";
 })(NotificationType || (exports.NotificationType = NotificationType = {}));

package/dist/organization/dto/index.d.ts

@@ -21,7 +21,7 @@ export type CreateOrganizationDto = {
     org_billing_state?: string | null;
     org_billing_postal_code?: string | null;
     org_billing_country?: string | null;
-    /** Terms & conditions acceptance — the API refuses anything but `true`. */
+    /** Terms & conditions acceptance - the API refuses anything but `true`. */
     org_consent_given: true;
     org_industry?: string | null;
     org_marketting_consent_given: boolean;

package/dist/organization/enum/index.d.ts

@@ -3,7 +3,7 @@ export declare enum OrganizationTypes {
     SOLE_TRADER = "Sole-Trader"
 }
 /**
- * How often an organization is billed. Only monthly billing exists today — add
+ * How often an organization is billed. Only monthly billing exists today - add
  * members when the product supports more.
  */
 export declare enum PaymentFrequency {

package/dist/organization/enum/index.js

@@ -8,7 +8,7 @@ var OrganizationTypes;
 })(OrganizationTypes || (exports.OrganizationTypes = OrganizationTypes = {}));
 ;
 /**
- * How often an organization is billed. Only monthly billing exists today — add
+ * How often an organization is billed. Only monthly billing exists today - add
  * members when the product supports more.
  */
 var PaymentFrequency;

package/dist/organization/index.d.ts

@@ -39,7 +39,7 @@ export type OrganizationEntity = {
     leave_calendar_start_month: number;
     billing_cycle_locked: boolean;
     /**
-     * The modules the organization subscribes to, priced at ITS pricebook's rates —
+     * The modules the organization subscribes to, priced at ITS pricebook's rates -
      * i.e. what it actually pays, which may be an older pricebook than the active one.
      */
     modules: PricedModule[];

package/dist/paystack/enum/index.d.ts

@@ -13,7 +13,7 @@ export declare enum PaystackWebhookEvent {
     TRANSACTION_SUCCESSFUL = "charge.success"
 }
 /**
- * Paystack's own subscription vocabulary — an external contract we do not own, so
+ * Paystack's own subscription vocabulary - an external contract we do not own, so
  * this is not necessarily exhaustive. Provided for comparison sites only; the
  * `status` fields on the payload interfaces deliberately stay `string`.
  */
@@ -25,7 +25,7 @@ export declare enum PaystackSubscriptionStatus {
     CANCELLED = "cancelled"
 }
 /**
- * Paystack's own transaction vocabulary — an external contract we do not own, so
+ * Paystack's own transaction vocabulary - an external contract we do not own, so
  * this is not necessarily exhaustive. Provided for comparison sites only; the
  * `status` fields on the payload interfaces deliberately stay `string`.
  * Only SUCCESS means the charge completed and the money moved.

package/dist/paystack/enum/index.js

@@ -18,7 +18,7 @@ var PaystackWebhookEvent;
 })(PaystackWebhookEvent || (exports.PaystackWebhookEvent = PaystackWebhookEvent = {}));
 ;
 /**
- * Paystack's own subscription vocabulary — an external contract we do not own, so
+ * Paystack's own subscription vocabulary - an external contract we do not own, so
  * this is not necessarily exhaustive. Provided for comparison sites only; the
  * `status` fields on the payload interfaces deliberately stay `string`.
  */
@@ -32,7 +32,7 @@ var PaystackSubscriptionStatus;
 })(PaystackSubscriptionStatus || (exports.PaystackSubscriptionStatus = PaystackSubscriptionStatus = {}));
 ;
 /**
- * Paystack's own transaction vocabulary — an external contract we do not own, so
+ * Paystack's own transaction vocabulary - an external contract we do not own, so
  * this is not necessarily exhaustive. Provided for comparison sites only; the
  * `status` fields on the payload interfaces deliberately stay `string`.
  * Only SUCCESS means the charge completed and the money moved.

package/dist/paystack/index.d.ts

@@ -143,7 +143,7 @@ export type PaystackChargeAuthorizationResponse = {
     /**
      * A 2xx from Paystack only means the request was accepted. See
      * PaystackTransactionStatus; only PaystackTransactionStatus.SUCCESS means the
-     * charge completed and the money moved — the rest are failure, pending, or
+     * charge completed and the money moved - the rest are failure, pending, or
      * challenge states such as SEND_OTP when the authorization is not reusable.
      */
     status: string;

package/dist/resend/webhook/index.d.ts

@@ -28,7 +28,7 @@ export type ResendEmailEventData = {
 };
 /**
  * One inbound email as `email.received` delivers it. The payload is metadata
- * only — body text and attachment bytes are fetched from the receiving API
+ * only - body text and attachment bytes are fetched from the receiving API
  * with `email_id`.
  */
 export type ResendInboundEmailData = {

package/dist/support/dto/index.d.ts

@@ -1,11 +1,11 @@
 import type { SupportTopic } from '../enum';
 /**
  * The body of `POST /support`. Every field the endpoint accepts is here: the api's global
- * ValidationPipe runs with `forbidNonWhitelisted`, so anything not on this contract is a 400 —
+ * ValidationPipe runs with `forbidNonWhitelisted`, so anything not on this contract is a 400 -
  * the honeypot included, which is why it is a declared field rather than a stray one.
  *
- * Nothing is stored. The api turns one of these into two emails — the message to the support
- * inbox, and an acknowledgement back to `email` — and that is the whole record of it.
+ * Nothing is stored. The api turns one of these into two emails - the message to the support
+ * inbox, and an acknowledgement back to `email` - and that is the whole record of it.
  */
 export type CreateSupportRequestDto = {
     topic: SupportTopic;

package/dist/timesheets/dto/index.d.ts

@@ -0,0 +1,57 @@
+import { TimesheetReviewDecision, TimesheetStatus } from '../enum';
+/**
+ * The wire shapes of the timesheet routes. The api runs a global ValidationPipe with
+ * `forbidNonWhitelisted`, so every field a route accepts is declared here and mirrored by
+ * the sdk's class-validator DTO. Dates travel as `YYYY-MM-DD` strings, times as `HH:MM`.
+ *
+ * Body fields are required keys: a field that may be empty is sent as `null`, never left
+ * out, so a payload always says what it means. Only query-string filters are optional.
+ */
+export type TimesheetIdDto = {
+    timesheetId: string;
+};
+/** One list for everyone: `user_id` narrows it (to yourself, say); the api scopes what is visible. */
+export type GetTimesheetsDto = {
+    page: number;
+    page_size: number;
+    user_id?: string | null;
+    status?: TimesheetStatus | null;
+    /** A Monday; keeps only that week. */
+    week_start?: string | null;
+};
+export type ReviewTimesheetDto = {
+    status: TimesheetReviewDecision;
+    review_note: string | null;
+};
+/** Approved weeks only; the span may not exceed a year. */
+export type GetTimesheetReportDto = {
+    date_from: string;
+    date_to: string;
+    user_id?: string | null;
+};
+export type TimesheetEntryIdDto = {
+    timesheetEntryId: string;
+};
+/**
+ * Always the caller's own entry: there is no `user_id` to log on someone's behalf. The week
+ * is found or created from `date`; the duration is derived from the two times.
+ */
+export type CreateTimesheetEntryDto = {
+    date: string;
+    start_time: string;
+    end_time: string;
+    client_id: string | null;
+    project_id: string | null;
+    task_id: string | null;
+    description: string | null;
+};
+/** Only an entry in a draft or rejected week can be edited; a moved date checks both weeks. */
+export type UpdateTimesheetEntryDto = {
+    date: string;
+    start_time: string;
+    end_time: string;
+    client_id: string | null;
+    project_id: string | null;
+    task_id: string | null;
+    description: string | null;
+};

package/dist/timesheets/dto/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/timesheets/enum/index.d.ts

@@ -1,5 +1,17 @@
+/**
+ * The lifecycle of a timesheet week. Stored as text on `timesheets.status` and validated
+ * here, never by a Postgres enum. A week is created as `draft` by its first entry, moves to
+ * `submitted` when the employee sends it, then to `approved` (entries lock) or `rejected`
+ * (entries reopen and the week may be submitted again).
+ */
 export declare enum TimesheetStatus {
+    DRAFT = "draft",
     SUBMITTED = "submitted",
     APPROVED = "approved",
     REJECTED = "rejected"
 }
+/** The two outcomes a reviewer may give a submitted week. */
+export declare enum TimesheetReviewDecision {
+    APPROVED = "approved",
+    REJECTED = "rejected"
+}

package/dist/timesheets/enum/index.js

@@ -1,10 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TimesheetStatus = void 0;
+exports.TimesheetReviewDecision = exports.TimesheetStatus = void 0;
+/**
+ * The lifecycle of a timesheet week. Stored as text on `timesheets.status` and validated
+ * here, never by a Postgres enum. A week is created as `draft` by its first entry, moves to
+ * `submitted` when the employee sends it, then to `approved` (entries lock) or `rejected`
+ * (entries reopen and the week may be submitted again).
+ */
 var TimesheetStatus;
 (function (TimesheetStatus) {
+    TimesheetStatus["DRAFT"] = "draft";
     TimesheetStatus["SUBMITTED"] = "submitted";
     TimesheetStatus["APPROVED"] = "approved";
     TimesheetStatus["REJECTED"] = "rejected";
 })(TimesheetStatus || (exports.TimesheetStatus = TimesheetStatus = {}));
 ;
+/** The two outcomes a reviewer may give a submitted week. */
+var TimesheetReviewDecision;
+(function (TimesheetReviewDecision) {
+    TimesheetReviewDecision["APPROVED"] = "approved";
+    TimesheetReviewDecision["REJECTED"] = "rejected";
+})(TimesheetReviewDecision || (exports.TimesheetReviewDecision = TimesheetReviewDecision = {}));

package/dist/timesheets/index.d.ts

@@ -0,0 +1,83 @@
+import { TimesheetStatus } from './enum';
+import { UserIdentity } from '../users';
+import { ClientIdentity } from '../clients';
+import { ProjectIdentity } from '../projects';
+import { TaskIdentity } from '../tasks';
+export * from './enum';
+/**
+ * Timesheets, the second slice of the HR module: time entries an employee logs against a
+ * Monday-to-Sunday week, submits as one, and a manager approves or rejects with a note.
+ * Dates are calendar dates (`YYYY-MM-DD`); times are wall-clock `HH:MM` on that date, so an
+ * entry never crosses midnight - split it. The same reporting line as leave decides who sees
+ * and reviews what.
+ */
+export type TimesheetEntryEntity = {
+    mms_id: string;
+    created_at: string;
+    created_by: UserIdentity | null;
+    updated_at: string | null;
+    last_updated_by: UserIdentity | null;
+    /** The week this entry belongs to, created as a draft by the first entry dated inside it. */
+    timesheet_id: string;
+    user: UserIdentity;
+    date: string;
+    /** `HH:MM`; `24:00` is allowed as an end for a shift finishing at midnight. */
+    start_time: string;
+    end_time: string;
+    /** Stored by Postgres from the two times, never sent by the client. */
+    duration_minutes: number;
+    /** Optional attribution; each survives the deletion of what it points at as null. */
+    client: ClientIdentity | null;
+    project: ProjectIdentity | null;
+    task: TaskIdentity | null;
+    description: string | null;
+};
+/** One week as the list shows it: the totals are counted on read, never stored. */
+export type TimesheetSummary = {
+    mms_id: string;
+    created_at: string;
+    created_by: UserIdentity | null;
+    updated_at: string | null;
+    last_updated_by: UserIdentity | null;
+    user: UserIdentity;
+    /** Always a Monday; `week_end` is its Sunday. */
+    week_start: string;
+    week_end: string;
+    status: TimesheetStatus;
+    /** Null while the week is a draft; reset when a rejected week is resubmitted. */
+    submitted_at: string | null;
+    reviewed_by: UserIdentity | null;
+    reviewed_at: string | null;
+    review_note: string | null;
+    total_minutes: number;
+    entry_count: number;
+};
+export type TimesheetEntity = TimesheetSummary & {
+    entries: TimesheetEntryEntity[];
+};
+/**
+ * Hours over a date range, approved weeks only, grouped four ways from the same entries.
+ * Null `client` / `project` collects the entries logged without one.
+ */
+export type TimesheetReportEntity = {
+    date_from: string;
+    date_to: string;
+    total_minutes: number;
+    by_user: {
+        user: UserIdentity;
+        total_minutes: number;
+    }[];
+    by_client: {
+        client: ClientIdentity | null;
+        total_minutes: number;
+    }[];
+    by_project: {
+        project: ProjectIdentity | null;
+        client: ClientIdentity | null;
+        total_minutes: number;
+    }[];
+    by_day: {
+        date: string;
+        total_minutes: number;
+    }[];
+};

package/dist/timesheets/index.js

@@ -0,0 +1,17 @@
+"use strict";
+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 });
+__exportStar(require("./enum"), exports);

package/dist/users/dto/index.d.ts

@@ -31,6 +31,8 @@ export type UpdateUserDto = {
     employment_type?: EmploymentType | null;
     job_title?: string | null;
     manager_id?: string | null;
+    /** Must differ from `manager_id` and needs a manager set first; the api refuses otherwise. */
+    secondary_manager_id?: string | null;
     social_facebook?: string | null;
     social_linkedin?: string | null;
     social_twitter?: string | null;
@@ -49,7 +51,7 @@ export type UpdateUserDto = {
  * behind `update_users`. Absent here on purpose:
  *   job_title, employment_type,
  *   start_date, end_date  - HR-owned work details, not self-service
- *   manager_id            - an org structure decision
+ *   manager_id, secondary_manager_id - an org structure decision
  *   email                 - GoTrue's, changed through the auth flow
  *   profile_image         - set by POST /users/me/profile-image, never by the client
  */

package/dist/users/index.d.ts

@@ -32,6 +32,8 @@ export interface UserEntity {
     updated_at: Date | null;
     last_updated_by: UserIdentity | null;
     manager: UserIdentity | null;
+    /** Either manager may review a report's leave and timesheets; only the primary is emailed. */
+    secondary_manager: UserIdentity | null;
     birthday: Date | null;
     employment_type: EmploymentType;
     job_title: string | null;
@@ -137,6 +139,7 @@ export interface Permissions {
         projects: CrudPermission;
         project_budgets: CrudPermission;
         tasks: CrudPermission;
+        timesheets: CrudPermission;
         invoices: Omit<CrudPermission, 'create' | 'update' | 'delete'>;
         leave_types: CrudPermission;
         leave_entitlements: CrudPermission;

package/dist/users/permissions/dto/index.d.ts

@@ -11,6 +11,10 @@ export type UpdatePermissionsDto = {
     read_tasks: boolean;
     update_tasks: boolean;
     delete_tasks: boolean;
+    create_timesheets: boolean;
+    read_timesheets: boolean;
+    update_timesheets: boolean;
+    delete_timesheets: boolean;
     create_leave: boolean;
     read_leave: boolean;
     update_leave: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@managemint-solutions/entities",
-  "version": "1.22.0",
+  "version": "1.23.0",
   "description": "Entity types used by both the api and portal",
   "homepage": "https://github.com/ManageMint-Solutions/managemint-solutions-entities#readme",
   "bugs": {