@managemint-solutions/sdk 0.64.0 → 0.66.0

package/dist/configs/dto.js

@@ -11,17 +11,9 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UpdateConfigDto = exports.CreateConfigDto = void 0;
 const class_validator_1 = require("class-validator");
-const class_transformer_1 = require("class-transformer");
+const validators_1 = require("../validators");
 // class-validator version of the shared DTO type from @managemint-solutions/entities, so the
 // wire contract cannot drift.
-/**
- * Whitespace on either side of a pasted value is not part of the answer. Trimming here rather
- * than in the api means the length rules below measure what will actually be stored - a name of
- * three spaces is empty, not three characters long.
- */
-const Trim = () => (0, class_transformer_1.Transform)(({ value }) => (typeof value === 'string' ? value.trim() : value), {
-    toClassOnly: true,
-});
 class CreateConfigDto {
     name;
     description;
@@ -34,7 +26,7 @@ class CreateConfigDto {
 }
 exports.CreateConfigDto = CreateConfigDto;
 __decorate([
-    Trim(),
+    (0, validators_1.Trim)(),
     (0, class_validator_1.IsString)({ message: 'Invalid name' }),
     (0, class_validator_1.MinLength)(1, { message: 'Name cannot be empty' }),
     (0, class_validator_1.MaxLength)(100, { message: 'Name cannot exceed 100 characters' }),
@@ -42,7 +34,7 @@ __decorate([
 ], CreateConfigDto.prototype, "name", void 0);
 __decorate([
     (0, class_validator_1.IsOptional)(),
-    Trim(),
+    (0, validators_1.Trim)(),
     (0, class_validator_1.IsString)({ message: 'Invalid description' }),
     (0, class_validator_1.MaxLength)(1000, { message: 'Description cannot exceed 1000 characters' }),
     __metadata("design:type", String)
@@ -61,7 +53,7 @@ class UpdateConfigDto {
 exports.UpdateConfigDto = UpdateConfigDto;
 __decorate([
     (0, class_validator_1.IsOptional)(),
-    Trim(),
+    (0, validators_1.Trim)(),
     (0, class_validator_1.IsString)({ message: 'Invalid description' }),
     (0, class_validator_1.MaxLength)(1000, { message: 'Description cannot exceed 1000 characters' }),
     __metadata("design:type", String)

package/dist/documents/document-templates.js

@@ -15,6 +15,7 @@ const TEMPLATE_LIST_SELECT = `
         name,
         category,
         number_prefix,
+        due_days,
         archived,
         visibility
       `;
@@ -27,6 +28,7 @@ const TEMPLATE_DETAIL_SELECT = `
         name,
         category,
         number_prefix,
+        due_days,
         variables,
         blocks,
         blocks_version,
@@ -43,6 +45,7 @@ const templateRow = (input) => ({
     name: input.name,
     category: input.category ?? '',
     number_prefix: input.number_prefix ?? '',
+    due_days: input.due_days ?? null,
     variables: input.variables,
     blocks: input.blocks,
 });

package/dist/documents/documents.d.ts

@@ -41,6 +41,9 @@ type DocumentRow = {
     repeat_from: string | null;
     issue_at: string | null;
     email: DocumentEmail | null;
+    /** When it falls due: days after issue on a draft, the date itself (YYYY-MM-DD) once picked or issued. */
+    due_days: number | null;
+    due_at: string | null;
 };
 /**
  * A document as the sdk reads it. `my_role` (what the caller may do with it), `payments` (read
@@ -58,7 +61,7 @@ export type DocumentSendEvent = Pick<DocumentSend, 'recipients' | 'cc' | 'subjec
  * the cron's, for the drafts it makes.
  */
 export type CreateDocumentRow = Omit<DocumentRow, 'status' | 'number_sequence' | 'number' | 'issued_at' | 'issued_by' | 'voided_at' | 'voided_by' | 'void_reason' | keyof DocumentScheduleRow> & Partial<DocumentScheduleRow>;
-type DocumentScheduleRow = Pick<DocumentRow, 'repeat' | 'repeat_next_at' | 'repeat_until' | 'repeat_paused' | 'repeat_from' | 'issue_at' | 'email'>;
+type DocumentScheduleRow = Pick<DocumentRow, 'repeat' | 'repeat_next_at' | 'repeat_until' | 'repeat_paused' | 'repeat_from' | 'issue_at' | 'email' | 'due_days' | 'due_at'>;
 /**
  * A draft save, an issue or a void: whichever columns it changes - never the visibility, which
  * members hold no grant on after create (the visibility route changes it on the service role).
@@ -82,8 +85,9 @@ export declare class DocumentsResource {
      * Newest first; `search` matches the title and the number. Recurring parents are a list of
      * their own: `recurring` lists them alone, and every other list leaves them out. `ids` keeps
      * the list to (`in`) or away from (`not_in`) the documents named - the api's payment filter
-     * passes the paid ones - and `payable` to issued documents with a total above zero. The
-     * DTO's `payment` itself is the api's to turn into those two; the list ignores it.
+     * passes the paid ones - and `payable` to issued documents with a total above zero;
+     * `due_before` to documents due on or before that date. The DTO's `payment` and `overdue`
+     * are the api's to turn into those; the list ignores them.
      */
     list(query: GetDocumentsDto & {
         organization_id?: string | null;

package/dist/documents/documents.js

@@ -31,6 +31,8 @@ const DOCUMENT_LIST_SELECT = `
         repeat_paused,
         repeat_from,
         issue_at,
+        due_days,
+        due_at,
         visibility
       `;
 const DOCUMENT_DETAIL_SELECT = `
@@ -67,6 +69,8 @@ const DOCUMENT_DETAIL_SELECT = `
         repeat_from,
         issue_at,
         email,
+        due_days,
+        due_at,
         visibility
       `;
 /** How long a signed image URL in rendered HTML stays valid - long enough to keep a preview open. */
@@ -102,8 +106,9 @@ class DocumentsResource {
      * Newest first; `search` matches the title and the number. Recurring parents are a list of
      * their own: `recurring` lists them alone, and every other list leaves them out. `ids` keeps
      * the list to (`in`) or away from (`not_in`) the documents named - the api's payment filter
-     * passes the paid ones - and `payable` to issued documents with a total above zero. The
-     * DTO's `payment` itself is the api's to turn into those two; the list ignores it.
+     * passes the paid ones - and `payable` to issued documents with a total above zero;
+     * `due_before` to documents due on or before that date. The DTO's `payment` and `overdue`
+     * are the api's to turn into those; the list ignores them.
      */
     async list(query) {
         const page = query.page;
@@ -146,6 +151,9 @@ class DocumentsResource {
         if (query.payable) {
             documentsQuery = documentsQuery.eq('status', enum_1.DocumentStatus.ISSUED).gt('total_minor', 0);
         }
+        if (query.due_before) {
+            documentsQuery = documentsQuery.lte('due_at', query.due_before);
+        }
         if (trimmedSearch) {
             documentsQuery = documentsQuery.or((0, transforms_1.orIlike)(['title', 'number'], trimmedSearch));
         }

package/dist/documents/dto.d.ts

@@ -1,5 +1,5 @@
 import type { DocumentBlock, DocumentEmail, DocumentVariable, DocumentVariableValues } from '@managemint-solutions/entities/documents';
-import type { CreateDocumentDto as CreateDocumentDtoType, CreateDocumentTemplateDto as CreateDocumentTemplateDtoType, DocumentIdDto as DocumentIdDtoType, DocumentImageNameDto as DocumentImageNameDtoType, DocumentImageUrlsDto as DocumentImageUrlsDtoType, DocumentPayQueryDto as DocumentPayQueryDtoType, DocumentPayTokenDto as DocumentPayTokenDtoType, DocumentPaymentIdDto as DocumentPaymentIdDtoType, DocumentTemplateIdDto as DocumentTemplateIdDtoType, GetDocumentsDto as GetDocumentsDtoType, GetDocumentTemplatesDto as GetDocumentTemplatesDtoType, PayDocumentDto as PayDocumentDtoType, RecordDocumentPaymentDto as RecordDocumentPaymentDtoType, ReassignPrivateDocumentsDto as ReassignPrivateDocumentsDtoType, SendDocumentDto as SendDocumentDtoType, UpdateDocumentDto as UpdateDocumentDtoType, UpdateDocumentTemplateDto as UpdateDocumentTemplateDtoType, VoidDocumentDto as VoidDocumentDtoType } from '@managemint-solutions/entities/documents/dto';
+import type { CatalogueTemplateSlugDto as CatalogueTemplateSlugDtoType, CopyCatalogueTemplateDto as CopyCatalogueTemplateDtoType, CreateDocumentDto as CreateDocumentDtoType, CreateDocumentTemplateDto as CreateDocumentTemplateDtoType, DocumentIdDto as DocumentIdDtoType, DocumentImageNameDto as DocumentImageNameDtoType, DocumentImageUrlsDto as DocumentImageUrlsDtoType, DocumentPayQueryDto as DocumentPayQueryDtoType, DocumentPayTokenDto as DocumentPayTokenDtoType, DocumentPaymentIdDto as DocumentPaymentIdDtoType, DocumentTemplateIdDto as DocumentTemplateIdDtoType, GetCatalogueTemplatesDto as GetCatalogueTemplatesDtoType, GetDocumentsDto as GetDocumentsDtoType, GetDocumentTemplatesDto as GetDocumentTemplatesDtoType, PayDocumentDto as PayDocumentDtoType, RecordDocumentPaymentDto as RecordDocumentPaymentDtoType, ReassignPrivateDocumentsDto as ReassignPrivateDocumentsDtoType, SendDocumentDto as SendDocumentDtoType, UpdateDocumentDto as UpdateDocumentDtoType, UpdateDocumentTemplateDto as UpdateDocumentTemplateDtoType, VoidDocumentDto as VoidDocumentDtoType } from '@managemint-solutions/entities/documents/dto';
 import { DocumentPaymentFilter, DocumentRepeat, DocumentStatus, DocumentVisibility } from '@managemint-solutions/entities/documents/enum';
 export declare class GetDocumentTemplatesDto implements GetDocumentTemplatesDtoType {
     readonly search?: string | null;
@@ -16,6 +16,7 @@ export declare class UpdateDocumentTemplateDto implements UpdateDocumentTemplate
     readonly name: string;
     readonly category?: string;
     readonly number_prefix?: string;
+    readonly due_days?: number | null;
     readonly variables: DocumentVariable[];
     readonly blocks: DocumentBlock[];
 }
@@ -32,6 +33,8 @@ export declare class GetDocumentsDto implements GetDocumentsDtoType {
     readonly recurring?: boolean;
     readonly repeat_from?: string | null;
     readonly payment?: DocumentPaymentFilter | null;
+    readonly due_before?: string | null;
+    readonly overdue?: boolean;
     readonly page: number;
     readonly page_size: number;
 }
@@ -50,6 +53,8 @@ declare class DocumentScheduleDto {
     readonly repeat_paused?: boolean;
     readonly issue_at?: string | null;
     readonly email?: DocumentEmail | null;
+    readonly due_days?: number | null;
+    readonly due_at?: string | null;
 }
 /**
  * A new draft. Its values cannot be checked here - with a template, the variables they fill are
@@ -122,4 +127,17 @@ export declare class DocumentPaymentIdDto implements DocumentPaymentIdDtoType {
     readonly documentId: string;
     readonly paymentId: string;
 }
+export declare class GetCatalogueTemplatesDto implements GetCatalogueTemplatesDtoType {
+    readonly search?: string | null;
+    readonly category?: string | null;
+}
+export declare class CatalogueTemplateSlugDto implements CatalogueTemplateSlugDtoType {
+    readonly slug: string;
+}
+/** The copy's own name and prefix are optional and held to a template save's rules when given. */
+export declare class CopyCatalogueTemplateDto implements CopyCatalogueTemplateDtoType {
+    readonly slug: string;
+    readonly name?: string;
+    readonly number_prefix?: string;
+}
 export {};

package/dist/documents/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.DocumentPaymentIdDto = exports.RecordDocumentPaymentDto = exports.PayDocumentDto = exports.DocumentPayQueryDto = exports.DocumentPayTokenDto = exports.SendDocumentDto = exports.ReassignPrivateDocumentsDto = exports.DocumentImageUrlsDto = exports.DocumentImageNameDto = exports.VoidDocumentDto = exports.UpdateDocumentDto = exports.CreateDocumentDto = exports.DocumentIdDto = exports.GetDocumentsDto = exports.CreateDocumentTemplateDto = exports.UpdateDocumentTemplateDto = exports.DocumentTemplateIdDto = exports.GetDocumentTemplatesDto = void 0;
+exports.CopyCatalogueTemplateDto = exports.CatalogueTemplateSlugDto = exports.GetCatalogueTemplatesDto = exports.DocumentPaymentIdDto = exports.RecordDocumentPaymentDto = exports.PayDocumentDto = exports.DocumentPayQueryDto = exports.DocumentPayTokenDto = exports.SendDocumentDto = exports.ReassignPrivateDocumentsDto = exports.DocumentImageUrlsDto = exports.DocumentImageNameDto = exports.VoidDocumentDto = exports.UpdateDocumentDto = exports.CreateDocumentDto = exports.DocumentIdDto = exports.GetDocumentsDto = exports.CreateDocumentTemplateDto = exports.UpdateDocumentTemplateDto = exports.DocumentTemplateIdDto = exports.GetDocumentTemplatesDto = void 0;
 const class_validator_1 = require("class-validator");
 const class_transformer_1 = require("class-transformer");
 const enum_1 = require("@managemint-solutions/entities/documents/enum");
@@ -79,16 +79,22 @@ __decorate([
     (0, class_validator_1.IsUUID)('7', { message: 'Invalid template ID format' }),
     __metadata("design:type", String)
 ], DocumentTemplateIdDto.prototype, "templateId", void 0);
+/** Days after issue a document falls due: a whole number from 0 to 365. */
+const IsDueDays = (0, validators_1.fromProblem)('isDueDays', (value) => Number.isInteger(value) && value >= 0 && value <= 365
+    ? null
+    : 'Due days must be a whole number from 0 to 365');
 /** Saving replaces the whole template. Its visibility changes only through the visibility route. */
 class UpdateDocumentTemplateDto {
     name;
     category;
     number_prefix;
+    due_days;
     variables;
     blocks;
 }
 exports.UpdateDocumentTemplateDto = UpdateDocumentTemplateDto;
 __decorate([
+    (0, validators_1.Trim)(),
     (0, class_validator_1.MaxLength)(100, { message: 'Name cannot exceed 100 characters' }),
     (0, class_validator_1.MinLength)(1, { message: 'Name cannot be empty' }),
     (0, class_validator_1.IsString)({ message: 'Name must be text' }),
@@ -101,9 +107,16 @@ __decorate([
 ], UpdateDocumentTemplateDto.prototype, "category", void 0);
 __decorate([
     (0, class_validator_1.IsOptional)(),
+    (0, validators_1.Trim)(),
     (0, content_1.IsDocumentNumberPrefix)(),
     __metadata("design:type", String)
 ], UpdateDocumentTemplateDto.prototype, "number_prefix", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, validators_1.IsNullable)(),
+    IsDueDays(),
+    __metadata("design:type", Object)
+], UpdateDocumentTemplateDto.prototype, "due_days", void 0);
 __decorate([
     (0, content_1.IsDocumentVariables)(),
     __metadata("design:type", Array)
@@ -136,6 +149,9 @@ class GetDocumentsDto {
     recurring;
     repeat_from;
     payment;
+    due_before;
+    // Issued, due before today, nothing settled - resolved by the api; the sdk list ignores it.
+    overdue;
     page = 1;
     page_size = 10;
 }
@@ -191,6 +207,18 @@ __decorate([
     (0, class_validator_1.IsEnum)(enum_1.DocumentPaymentFilter, { message: `Payment must be one of: ${Object.values(enum_1.DocumentPaymentFilter).join(', ')}` }),
     __metadata("design:type", Object)
 ], GetDocumentsDto.prototype, "payment", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, validators_1.IsNullable)(),
+    (0, validators_1.IsCalendarDate)({ message: 'Due before must be a calendar date (YYYY-MM-DD)' }),
+    __metadata("design:type", Object)
+], GetDocumentsDto.prototype, "due_before", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Transform)(({ value }) => value === true || value === 'true', { toClassOnly: true }),
+    (0, class_validator_1.IsBoolean)({ message: 'Overdue must be a boolean' }),
+    __metadata("design:type", Boolean)
+], GetDocumentsDto.prototype, "overdue", void 0);
 __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_transformer_1.Transform)(({ value }) => value ? Number(value) : 1, { toClassOnly: true }),
@@ -240,6 +268,8 @@ class DocumentScheduleDto {
     repeat_paused;
     issue_at;
     email;
+    due_days;
+    due_at;
 }
 __decorate([
     (0, class_validator_1.IsOptional)(),
@@ -276,6 +306,18 @@ __decorate([
     IsDocumentEmail(),
     __metadata("design:type", Object)
 ], DocumentScheduleDto.prototype, "email", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, validators_1.IsNullable)(),
+    IsDueDays(),
+    __metadata("design:type", Object)
+], DocumentScheduleDto.prototype, "due_days", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, validators_1.IsNullable)(),
+    (0, validators_1.IsCalendarDate)({ message: 'Due date must be a calendar date (YYYY-MM-DD)' }),
+    __metadata("design:type", Object)
+], DocumentScheduleDto.prototype, "due_at", void 0);
 /**
  * A new draft. Its values cannot be checked here - with a template, the variables they fill are
  * the template's - so the api checks the draft it composes with `documentProblem`.
@@ -350,6 +392,7 @@ __decorate([
     __metadata("design:type", String)
 ], UpdateDocumentDto.prototype, "category", void 0);
 __decorate([
+    (0, validators_1.Trim)(),
     (0, content_1.IsDocumentNumberPrefix)(),
     __metadata("design:type", String)
 ], UpdateDocumentDto.prototype, "number_prefix", void 0);
@@ -528,3 +571,64 @@ __decorate([
     (0, class_validator_1.IsUUID)('7', { message: 'Invalid payment ID format' }),
     __metadata("design:type", String)
 ], DocumentPaymentIdDto.prototype, "paymentId", void 0);
+// ------------------------------------------------------------
+// Template catalogue
+// ------------------------------------------------------------
+/** A catalogue slug: lower-case letters and digits in hyphen-joined words, e.g. `residential-lease-za`. */
+const CATALOGUE_SLUG = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+class GetCatalogueTemplatesDto {
+    search;
+    category;
+}
+exports.GetCatalogueTemplatesDto = GetCatalogueTemplatesDto;
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, validators_1.IsNullable)(),
+    (0, class_validator_1.MaxLength)(100, { message: 'Search query cannot exceed 100 characters' }),
+    (0, class_validator_1.MinLength)(1, { message: 'Search query cannot be empty' }),
+    (0, class_validator_1.IsString)({ message: 'Search query must be a string' }),
+    __metadata("design:type", Object)
+], GetCatalogueTemplatesDto.prototype, "search", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, validators_1.IsNullable)(),
+    (0, content_1.IsDocumentCategory)(),
+    __metadata("design:type", Object)
+], GetCatalogueTemplatesDto.prototype, "category", void 0);
+class CatalogueTemplateSlugDto {
+    slug;
+}
+exports.CatalogueTemplateSlugDto = CatalogueTemplateSlugDto;
+__decorate([
+    (0, class_validator_1.MaxLength)(80, { message: 'Unknown template' }),
+    (0, class_validator_1.Matches)(CATALOGUE_SLUG, { message: 'Unknown template' }),
+    (0, class_validator_1.IsString)({ message: 'Unknown template' }),
+    __metadata("design:type", String)
+], CatalogueTemplateSlugDto.prototype, "slug", void 0);
+/** The copy's own name and prefix are optional and held to a template save's rules when given. */
+class CopyCatalogueTemplateDto {
+    slug;
+    name;
+    number_prefix;
+}
+exports.CopyCatalogueTemplateDto = CopyCatalogueTemplateDto;
+__decorate([
+    (0, class_validator_1.MaxLength)(80, { message: 'Unknown template' }),
+    (0, class_validator_1.Matches)(CATALOGUE_SLUG, { message: 'Unknown template' }),
+    (0, class_validator_1.IsString)({ message: 'Give the template to copy' }),
+    __metadata("design:type", String)
+], CopyCatalogueTemplateDto.prototype, "slug", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, validators_1.Trim)(),
+    (0, class_validator_1.MaxLength)(100, { message: 'Name cannot exceed 100 characters' }),
+    (0, class_validator_1.MinLength)(1, { message: 'Name cannot be empty' }),
+    (0, class_validator_1.IsString)({ message: 'Name must be text' }),
+    __metadata("design:type", String)
+], CopyCatalogueTemplateDto.prototype, "name", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, validators_1.Trim)(),
+    (0, content_1.IsDocumentNumberPrefix)(),
+    __metadata("design:type", String)
+], CopyCatalogueTemplateDto.prototype, "number_prefix", void 0);

package/dist/documents/render/html.js

@@ -51,18 +51,32 @@ const filledText = (text, ctx) => text.replace(values_1.DOCUMENT_VARIABLE_PATTER
  * Plain text with each `{{key}}` replaced by its value; everything else escaped, and every line
  * break a `<br>`. A break left as a newline would hang on `white-space: pre-wrap`, and between two
  * placeholders it is a text node of whitespace alone, which the portal's paged preview drops -
- * the two lines then print as one.
+ * the two lines then print as one. On an issued document a line whose variables are all empty
+ * is left out - "VAT no. {{client_vat_number}}" for a client with no VAT number, or
+ * `{{client_address}}` with no address - rather than printing its words with nothing after them;
+ * a line with one value filled, or with no variable at all (a blank line included), stays.
  */
 const plainHtml = (text, ctx) => {
     if (typeof text !== 'string')
         return '';
-    let html = '';
-    let last = 0;
-    for (const match of text.matchAll(values_1.DOCUMENT_VARIABLE_PATTERN)) {
-        html += (0, values_1.escapeHtml)(text.slice(last, match.index)) + valueHtml(match[1], ctx);
-        last = match.index + match[0].length;
-    }
-    return (html + (0, values_1.escapeHtml)(text.slice(last))).replace(/\r?\n/g, '<br>');
+    return text
+        .split(/\r?\n/)
+        .flatMap((line) => {
+        let html = '';
+        let last = 0;
+        let variables = 0;
+        let filled = 0;
+        for (const match of line.matchAll(values_1.DOCUMENT_VARIABLE_PATTERN)) {
+            variables += 1;
+            if (PAGE_COUNTERS[match[1]] || valueText(match[1], ctx) !== null)
+                filled += 1;
+            html += (0, values_1.escapeHtml)(line.slice(last, match.index)) + valueHtml(match[1], ctx);
+            last = match.index + match[0].length;
+        }
+        html += (0, values_1.escapeHtml)(line.slice(last));
+        return !ctx.placeholders && variables > 0 && filled === 0 ? [] : [html];
+    })
+        .join('<br>');
 };
 /** Bold, italic, underline and links around `html`; any other mark is ignored. */
 const withMarks = (html, marks) => (Array.isArray(marks) ? marks : []).reduce((inner, mark) => {
@@ -151,14 +165,14 @@ const blockHtml = (block, ctx, imageUrls) => {
             return `<div class="block text">${richTextHtml(block.content, ctx)}</div>`;
         case enum_1.DocumentBlockType.FIELDS: {
             // A blank side shows where it prints on a template or draft; an issued document leaves out a
-            // row with nothing on either side, and the block with no rows left.
+            // row with no value - its label alone says nothing - and the block with no rows left.
             const rows = block.fields.flatMap((field) => {
                 const label = plainHtml(field.label, ctx);
                 const value = plainHtml(field.value, ctx);
                 if (ctx.placeholders) {
                     return [`<tr><th>${label.trim() || placeholder('Label')}</th><td>${value.trim() || placeholder('Value')}</td></tr>`];
                 }
-                return label.trim() || value.trim() ? [`<tr><th>${label}</th><td>${value}</td></tr>`] : [];
+                return value.trim() ? [`<tr><th>${label}</th><td>${value}</td></tr>`] : [];
             });
             return rows.length > 0 ? `<div class="block"><table class="fields"><tbody>${rows.join('')}</tbody></table></div>` : '';
         }

package/dist/documents/render/index.d.ts

@@ -1,2 +1,2 @@
 export { DOCUMENT_PAGE_MARGINS, fillText, renderBand, renderDocument, type DocumentBand, type PrintableDocument, type RenderedDocument, } from './html';
-export { documentTotals, escapeHtml, formatDocumentDate, johannesburgDate, money, MONO_FONT, printsMoney, startingValues, SYSTEM_VARIABLES, systemValues, type DocumentTotals, type SystemValueInputs, } from './values';
+export { documentTotals, dueDateFrom, escapeHtml, formatDocumentDate, johannesburgDate, money, MONO_FONT, printsMoney, startingValues, SYSTEM_VARIABLES, systemValues, type DocumentTotals, type SystemValueInputs, } from './values';

package/dist/documents/render/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.systemValues = exports.SYSTEM_VARIABLES = exports.startingValues = exports.printsMoney = exports.MONO_FONT = exports.money = exports.johannesburgDate = exports.formatDocumentDate = exports.escapeHtml = exports.documentTotals = exports.renderDocument = exports.renderBand = exports.fillText = exports.DOCUMENT_PAGE_MARGINS = void 0;
+exports.systemValues = exports.SYSTEM_VARIABLES = exports.startingValues = exports.printsMoney = exports.MONO_FONT = exports.money = exports.johannesburgDate = exports.formatDocumentDate = exports.escapeHtml = exports.dueDateFrom = exports.documentTotals = exports.renderDocument = exports.renderBand = exports.fillText = exports.DOCUMENT_PAGE_MARGINS = void 0;
 // `@managemint-solutions/sdk/documents`: the document renderer and the values it prints, as pure
 // functions with no dependency beyond the shared entities - no Node, no Nest, no supabase-js, no
 // DOM - so the api's PDF and the portal's in-browser preview are one renderer. The caller loads
@@ -12,6 +12,7 @@ Object.defineProperty(exports, "renderBand", { enumerable: true, get: function (
 Object.defineProperty(exports, "renderDocument", { enumerable: true, get: function () { return html_1.renderDocument; } });
 var values_1 = require("./values");
 Object.defineProperty(exports, "documentTotals", { enumerable: true, get: function () { return values_1.documentTotals; } });
+Object.defineProperty(exports, "dueDateFrom", { enumerable: true, get: function () { return values_1.dueDateFrom; } });
 Object.defineProperty(exports, "escapeHtml", { enumerable: true, get: function () { return values_1.escapeHtml; } });
 Object.defineProperty(exports, "formatDocumentDate", { enumerable: true, get: function () { return values_1.formatDocumentDate; } });
 Object.defineProperty(exports, "johannesburgDate", { enumerable: true, get: function () { return values_1.johannesburgDate; } });

package/dist/documents/render/values.d.ts

@@ -75,12 +75,16 @@ export type SystemValueInputs = {
     number: string | null;
     /** `YYYY-MM-DD`: today on a draft (`johannesburgDate(new Date())`), the issue date once issued. */
     issueDate: string;
+    /** `YYYY-MM-DD`: when the document falls due; left out (prints as missing) without one. */
+    dueDate?: string | null;
 };
+/** `issueDate` plus `days`, as a calendar date: the due date of a document issued that day. */
+export declare const dueDateFrom: (issueDate: string, days: number) => string;
 /**
  * The values filled in for the system variables: the organization's name (its trading name
  * first), address, registration and VAT numbers, email and phone; the client's name, email, phone,
- * address, registration and VAT numbers; the document number; and the issue date with its month
- * name and year. A value that is empty is left out, so it prints as missing. The
- * page number and count are not values: they are counted page by page as the PDF prints.
+ * address, registration and VAT numbers; the document number; the issue date with its month
+ * name and year; and the due date. A value that is empty is left out, so it prints as missing.
+ * The page number and count are not values: they are counted page by page as the PDF prints.
  */
-export declare const systemValues: ({ organization, client, number, issueDate }: SystemValueInputs) => DocumentVariableValues;
+export declare const systemValues: ({ organization, client, number, issueDate, dueDate }: SystemValueInputs) => DocumentVariableValues;

package/dist/documents/render/values.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.systemValues = exports.johannesburgDate = exports.startingValues = exports.printsMoney = exports.documentTotals = exports.lineAmounts = exports.MONO_FONT = exports.formatDocumentDate = exports.money = exports.escapeHtml = exports.safeHref = exports.isObject = exports.SYSTEM_VARIABLES = exports.DOCUMENT_VARIABLE_PATTERN = void 0;
+exports.systemValues = exports.dueDateFrom = exports.johannesburgDate = exports.startingValues = exports.printsMoney = exports.documentTotals = exports.lineAmounts = exports.MONO_FONT = exports.formatDocumentDate = exports.money = exports.escapeHtml = exports.safeHref = exports.isObject = exports.SYSTEM_VARIABLES = exports.DOCUMENT_VARIABLE_PATTERN = void 0;
 const enum_1 = require("@managemint-solutions/entities/documents/enum");
 // The values a document prints that nobody types in: one line's amounts, the totals of every line
 // items block, the system values, and how a value is escaped and formatted. Pure functions with
@@ -33,6 +33,7 @@ exports.SYSTEM_VARIABLES = {
     [enum_1.DocumentSystemVariable.CLIENT_ADDRESS]: { label: 'Client address', type: enum_1.DocumentVariableType.TEXT },
     [enum_1.DocumentSystemVariable.CLIENT_REGISTRATION_NUMBER]: { label: 'Client registration number', type: enum_1.DocumentVariableType.TEXT },
     [enum_1.DocumentSystemVariable.CLIENT_VAT_NUMBER]: { label: 'Client VAT number', type: enum_1.DocumentVariableType.TEXT },
+    [enum_1.DocumentSystemVariable.DUE_DATE]: { label: 'Due date', type: enum_1.DocumentVariableType.DATE },
 };
 const isObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
 exports.isObject = isObject;
@@ -108,14 +109,20 @@ exports.startingValues = startingValues;
 /** The calendar date (`YYYY-MM-DD`) `now` falls on in Africa/Johannesburg - a draft's issue date. */
 const johannesburgDate = (now) => new Intl.DateTimeFormat('en-CA', { timeZone: 'Africa/Johannesburg' }).format(now);
 exports.johannesburgDate = johannesburgDate;
+/** `issueDate` plus `days`, as a calendar date: the due date of a document issued that day. */
+const dueDateFrom = (issueDate, days) => {
+    const [year, month, day] = issueDate.split('-').map(Number);
+    return new Date(Date.UTC(year, month - 1, day + days)).toISOString().slice(0, 10);
+};
+exports.dueDateFrom = dueDateFrom;
 /**
  * The values filled in for the system variables: the organization's name (its trading name
  * first), address, registration and VAT numbers, email and phone; the client's name, email, phone,
- * address, registration and VAT numbers; the document number; and the issue date with its month
- * name and year. A value that is empty is left out, so it prints as missing. The
- * page number and count are not values: they are counted page by page as the PDF prints.
+ * address, registration and VAT numbers; the document number; the issue date with its month
+ * name and year; and the due date. A value that is empty is left out, so it prints as missing.
+ * The page number and count are not values: they are counted page by page as the PDF prints.
  */
-const systemValues = ({ organization, client, number, issueDate }) => {
+const systemValues = ({ organization, client, number, issueDate, dueDate }) => {
     const text = (value) => (typeof value === 'string' ? value.trim() : '');
     const address = (parts) => (parts ?? []).map(text).filter(Boolean).join(', ');
     const [year, month] = issueDate.split('-');
@@ -136,6 +143,7 @@ const systemValues = ({ organization, client, number, issueDate }) => {
         [enum_1.DocumentSystemVariable.ISSUE_DATE]: issueDate,
         [enum_1.DocumentSystemVariable.MONTH]: new Intl.DateTimeFormat('en-ZA', { month: 'long', timeZone: 'UTC' }).format(new Date(Date.UTC(Number(year), Number(month) - 1, 1))),
         [enum_1.DocumentSystemVariable.YEAR]: year,
+        [enum_1.DocumentSystemVariable.DUE_DATE]: dueDate ?? '',
     };
     return Object.fromEntries(Object.entries(values).filter(([, value]) => value !== ''));
 };

package/dist/feature-requests/dto.js

@@ -11,18 +11,9 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CreateFeatureRequestDto = void 0;
 const class_validator_1 = require("class-validator");
-const class_transformer_1 = require("class-transformer");
 const validators_1 = require("../validators");
 // class-validator version of the shared DTO type from @managemint-solutions/entities, so the
 // wire contract cannot drift.
-/**
- * Whitespace on either side of a pasted value is not part of the answer. Trimming here rather
- * than in the api means the length rules below measure what will actually be stored - a name of
- * three spaces is empty, not three characters long.
- */
-const Trim = () => (0, class_transformer_1.Transform)(({ value }) => (typeof value === 'string' ? value.trim() : value), {
-    toClassOnly: true,
-});
 class CreateFeatureRequestDto {
     name;
     // Markdown, and optional: a one-line request is a perfectly good request. `@Trim` sits above
@@ -44,7 +35,7 @@ class CreateFeatureRequestDto {
 }
 exports.CreateFeatureRequestDto = CreateFeatureRequestDto;
 __decorate([
-    Trim(),
+    (0, validators_1.Trim)(),
     (0, class_validator_1.IsString)({ message: 'Invalid name' }),
     (0, class_validator_1.MinLength)(1, { message: 'Name cannot be empty' }),
     (0, class_validator_1.MaxLength)(200, { message: 'Name cannot exceed 200 characters' }),
@@ -52,7 +43,7 @@ __decorate([
 ], CreateFeatureRequestDto.prototype, "name", void 0);
 __decorate([
     (0, class_validator_1.IsOptional)(),
-    Trim(),
+    (0, validators_1.Trim)(),
     (0, validators_1.EmptyToNull)(),
     (0, validators_1.IsNullable)(),
     (0, class_validator_1.ValidateIf)((o) => o.specification !== null && o.specification !== undefined),
@@ -61,14 +52,14 @@ __decorate([
     __metadata("design:type", Object)
 ], CreateFeatureRequestDto.prototype, "specification", void 0);
 __decorate([
-    Trim(),
+    (0, validators_1.Trim)(),
     (0, class_validator_1.IsString)({ message: 'Invalid requester name' }),
     (0, class_validator_1.MinLength)(1, { message: 'Requester name cannot be empty' }),
     (0, class_validator_1.MaxLength)(200, { message: 'Requester name cannot exceed 200 characters' }),
     __metadata("design:type", String)
 ], CreateFeatureRequestDto.prototype, "requester_name", void 0);
 __decorate([
-    Trim(),
+    (0, validators_1.Trim)(),
     (0, class_validator_1.IsEmail)({}, { message: 'Invalid email address' }),
     (0, class_validator_1.MaxLength)(320, { message: 'Email address cannot exceed 320 characters' }),
     __metadata("design:type", String)

package/dist/index.d.ts

@@ -43,7 +43,7 @@ export { ClientIdDto, CreateClientDto, GetClientsDto, StaffGetClientsDto, Update
 export { ConvertLeadDto, CreateLeadDto, GetLeadsDto, LeadIdDto, StaffGetLeadsDto, UpdateLeadDto } from './leads';
 export type { CreateDocumentRow, DocumentListRecord, DocumentSendEvent, UpdateDocumentRow } from './documents';
 export type { CreatePaymentRow, OpenPaymentRecord, PaymentRecord, SettlePaymentRow } from './payments';
-export { CreateDocumentDto, CreateDocumentTemplateDto, DocumentIdDto, DocumentImageNameDto, DocumentImageUrlsDto, DocumentPayQueryDto, DocumentPayTokenDto, DocumentPaymentIdDto, DocumentTemplateIdDto, documentProblem, GetDocumentsDto, GetDocumentTemplatesDto, PayDocumentDto, RecordDocumentPaymentDto, SendDocumentDto, UpdateDocumentDto, UpdateDocumentTemplateDto, VoidDocumentDto, ReassignPrivateDocumentsDto, } from './documents';
+export { CatalogueTemplateSlugDto, CopyCatalogueTemplateDto, CreateDocumentDto, CreateDocumentTemplateDto, DocumentIdDto, DocumentImageNameDto, DocumentImageUrlsDto, DocumentPayQueryDto, DocumentPayTokenDto, DocumentPaymentIdDto, DocumentTemplateIdDto, documentProblem, GetCatalogueTemplatesDto, GetDocumentsDto, GetDocumentTemplatesDto, PayDocumentDto, RecordDocumentPaymentDto, SendDocumentDto, UpdateDocumentDto, UpdateDocumentTemplateDto, VoidDocumentDto, ReassignPrivateDocumentsDto, } from './documents';
 export type { DocumentRecord, DocumentTemplateRecord } from './documents';
 export type { VisibilityRecord, VisibilityShareInput } from './visibility';
 export { UpdateVisibilityDto } from './visibility';

package/dist/index.js

@@ -8,8 +8,9 @@
 // to keep. The row and input types they produce and accept are exported for annotations.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UpdateOrganizationPayoutsDto = 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.ReorderStatusesDto = 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.withAuditBatch = 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.createSupabaseStaffClient = exports.SupabaseStaffClient = exports.createSupabaseClient = exports.SupabaseClient = void 0;
-exports.VoidDocumentDto = exports.UpdateDocumentTemplateDto = exports.UpdateDocumentDto = exports.SendDocumentDto = exports.RecordDocumentPaymentDto = exports.PayDocumentDto = exports.GetDocumentTemplatesDto = exports.GetDocumentsDto = exports.documentProblem = exports.DocumentTemplateIdDto = exports.DocumentPaymentIdDto = exports.DocumentPayTokenDto = exports.DocumentPayQueryDto = exports.DocumentImageUrlsDto = exports.DocumentImageNameDto = exports.DocumentIdDto = exports.CreateDocumentTemplateDto = exports.CreateDocumentDto = exports.UpdateLeadDto = exports.StaffGetLeadsDto = exports.LeadIdDto = exports.GetLeadsDto = exports.CreateLeadDto = exports.ConvertLeadDto = exports.UpdateClientDto = exports.StaffGetClientsDto = exports.GetClientsDto = exports.CreateClientDto = exports.ClientIdDto = exports.SupportingFileNamesDto = exports.SupportingFileIdDto = exports.GetSupportingFilesDto = exports.UserIdDto = exports.UpdateUserDto = exports.UpdateMyProfileDto = exports.StaffGetUsersDto = exports.GetUsersQueryDto = exports.AddUserDto = exports.UserApiCredentialIdDto = exports.MintEmulationTokenDto = exports.CreateUserApiCredentialDto = exports.UpdateStaffPermissionsDto = exports.StaffIdDto = exports.CreateStaffDto = exports.UpdatePermissionsDto = exports.PermissionsResource = exports.UpdateOrganizationDto = exports.OrganizationIdDto = exports.GetOrganizationsDto = exports.CreateOrganizationDto = 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.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.StaffGetTasksDto = exports.GetTasksDto = exports.CreateTaskDto = exports.AddTaskLinkDto = exports.UpdateProjectDto = exports.StaffGetProjectsDto = exports.ProjectIdDto = exports.GetProjectsDto = exports.CreateProjectDto = exports.UpdateVisibilityDto = exports.ReassignPrivateDocumentsDto = void 0;
+exports.SendDocumentDto = exports.RecordDocumentPaymentDto = exports.PayDocumentDto = exports.GetDocumentTemplatesDto = exports.GetDocumentsDto = exports.GetCatalogueTemplatesDto = exports.documentProblem = exports.DocumentTemplateIdDto = exports.DocumentPaymentIdDto = exports.DocumentPayTokenDto = exports.DocumentPayQueryDto = exports.DocumentImageUrlsDto = exports.DocumentImageNameDto = exports.DocumentIdDto = exports.CreateDocumentTemplateDto = exports.CreateDocumentDto = exports.CopyCatalogueTemplateDto = exports.CatalogueTemplateSlugDto = exports.UpdateLeadDto = exports.StaffGetLeadsDto = exports.LeadIdDto = exports.GetLeadsDto = exports.CreateLeadDto = exports.ConvertLeadDto = exports.UpdateClientDto = exports.StaffGetClientsDto = exports.GetClientsDto = exports.CreateClientDto = exports.ClientIdDto = exports.SupportingFileNamesDto = exports.SupportingFileIdDto = exports.GetSupportingFilesDto = exports.UserIdDto = exports.UpdateUserDto = exports.UpdateMyProfileDto = exports.StaffGetUsersDto = exports.GetUsersQueryDto = exports.AddUserDto = exports.UserApiCredentialIdDto = exports.MintEmulationTokenDto = exports.CreateUserApiCredentialDto = exports.UpdateStaffPermissionsDto = exports.StaffIdDto = exports.CreateStaffDto = exports.UpdatePermissionsDto = exports.PermissionsResource = exports.UpdateOrganizationDto = exports.OrganizationIdDto = exports.GetOrganizationsDto = exports.CreateOrganizationDto = void 0;
+exports.UpdateTimesheetEntryDto = exports.TimesheetIdDto = exports.TimesheetEntryIdDto = exports.ReviewTimesheetDto = exports.GetTimesheetsDto = exports.GetTimesheetReportDto = exports.CreateTimesheetEntryDto = exports.todayInJohannesburg = 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.StaffGetTasksDto = exports.GetTasksDto = exports.CreateTaskDto = exports.AddTaskLinkDto = exports.UpdateProjectDto = exports.StaffGetProjectsDto = exports.ProjectIdDto = exports.GetProjectsDto = exports.CreateProjectDto = exports.UpdateVisibilityDto = exports.ReassignPrivateDocumentsDto = exports.VoidDocumentDto = exports.UpdateDocumentTemplateDto = exports.UpdateDocumentDto = void 0;
+exports.monthlyTotalMinor = exports.weekStartOf = exports.minutesBetween = 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; } });
@@ -123,6 +124,8 @@ Object.defineProperty(exports, "LeadIdDto", { enumerable: true, get: function ()
 Object.defineProperty(exports, "StaffGetLeadsDto", { enumerable: true, get: function () { return leads_1.StaffGetLeadsDto; } });
 Object.defineProperty(exports, "UpdateLeadDto", { enumerable: true, get: function () { return leads_1.UpdateLeadDto; } });
 var documents_1 = require("./documents");
+Object.defineProperty(exports, "CatalogueTemplateSlugDto", { enumerable: true, get: function () { return documents_1.CatalogueTemplateSlugDto; } });
+Object.defineProperty(exports, "CopyCatalogueTemplateDto", { enumerable: true, get: function () { return documents_1.CopyCatalogueTemplateDto; } });
 Object.defineProperty(exports, "CreateDocumentDto", { enumerable: true, get: function () { return documents_1.CreateDocumentDto; } });
 Object.defineProperty(exports, "CreateDocumentTemplateDto", { enumerable: true, get: function () { return documents_1.CreateDocumentTemplateDto; } });
 Object.defineProperty(exports, "DocumentIdDto", { enumerable: true, get: function () { return documents_1.DocumentIdDto; } });
@@ -133,6 +136,7 @@ Object.defineProperty(exports, "DocumentPayTokenDto", { enumerable: true, get: f
 Object.defineProperty(exports, "DocumentPaymentIdDto", { enumerable: true, get: function () { return documents_1.DocumentPaymentIdDto; } });
 Object.defineProperty(exports, "DocumentTemplateIdDto", { enumerable: true, get: function () { return documents_1.DocumentTemplateIdDto; } });
 Object.defineProperty(exports, "documentProblem", { enumerable: true, get: function () { return documents_1.documentProblem; } });
+Object.defineProperty(exports, "GetCatalogueTemplatesDto", { enumerable: true, get: function () { return documents_1.GetCatalogueTemplatesDto; } });
 Object.defineProperty(exports, "GetDocumentsDto", { enumerable: true, get: function () { return documents_1.GetDocumentsDto; } });
 Object.defineProperty(exports, "GetDocumentTemplatesDto", { enumerable: true, get: function () { return documents_1.GetDocumentTemplatesDto; } });
 Object.defineProperty(exports, "PayDocumentDto", { enumerable: true, get: function () { return documents_1.PayDocumentDto; } });

package/dist/service-client/index.d.ts

@@ -64,6 +64,18 @@ export declare class SupabaseOrganizationScope {
      * subscriptions and both webhook handler services.
      */
     table(options: AuditedTableOptions): AuditedTable;
+    /**
+     * The organization's templates whose `column` starts with `start` (literally, any case),
+     * private and archived ones included. Service role because both columns are unique across the
+     * whole organization (`uq_document_templates_organization_name`,
+     * `uq_document_templates_organization_prefix`) while a caller reads only the templates shared
+     * with them.
+     */
+    templatesStartingWith(column: 'name' | 'number_prefix', start: string): Promise<{
+        mms_id: string;
+        name: string;
+        number_prefix: string;
+    }[]>;
     /**
      * Gives `userId` a new leave calendar feed token (stored as its SHA-256), which also retires
      * any address they subscribed with before. Service role only: the token is a credential.

package/dist/service-client/index.js

@@ -84,6 +84,23 @@ class SupabaseOrganizationScope {
     table(options) {
         return (0, audit_1.auditedTable)(this.supabase, this.actor, this.audit, options);
     }
+    /**
+     * The organization's templates whose `column` starts with `start` (literally, any case),
+     * private and archived ones included. Service role because both columns are unique across the
+     * whole organization (`uq_document_templates_organization_name`,
+     * `uq_document_templates_organization_prefix`) while a caller reads only the templates shared
+     * with them.
+     */
+    async templatesStartingWith(column, start) {
+        const { data, error } = await this.supabase
+            .from('document_templates')
+            .select('mms_id, name, number_prefix')
+            .eq('organization_id', this.actor.organization_id)
+            .ilike(column, `${start.replace(/[\\%_]/g, '\\$&')}%`);
+        if (error)
+            throw (0, errors_1.mapPostgrestError)(error);
+        return (data ?? []);
+    }
     /**
      * Gives `userId` a new leave calendar feed token (stored as its SHA-256), which also retires
      * any address they subscribed with before. Service role only: the token is a credential.

package/dist/validators.d.ts

@@ -26,6 +26,12 @@ export declare function IsNullable(validationOptions?: ValidationOptions): Prope
  * blank submission tripping it. Goes above `IsNullable()`, which then skips the rules.
  */
 export declare function EmptyToNull(): PropertyDecorator;
+/**
+ * Whitespace on either side of a pasted value is not part of the answer. Trimming here rather
+ * than in the api means the rules measure what will actually be stored - a name of three spaces
+ * is empty, not three characters long. Goes above `EmptyToNull()`, so a blank box becomes null.
+ */
+export declare function Trim(): PropertyDecorator;
 /**
  * A class-validator decorator from a check that returns the first problem it finds, or null. The
  * problem is the message, so a 400 always says exactly what is wrong and where. `object` is the

package/dist/validators.js

@@ -9,6 +9,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.fromProblem = exports.MatchesPasswordRules = exports.IsClockTime = exports.isClockTime = exports.IsCalendarDate = exports.isCalendarDate = void 0;
 exports.IsNullable = IsNullable;
 exports.EmptyToNull = EmptyToNull;
+exports.Trim = Trim;
 const class_validator_1 = require("class-validator");
 const class_transformer_1 = require("class-transformer");
 const CALENDAR_DATE = /^\d{4}-\d{2}-\d{2}$/;
@@ -72,6 +73,14 @@ function IsNullable(validationOptions) {
 function EmptyToNull() {
     return (0, class_transformer_1.Transform)(({ value }) => (value === '' ? null : value), { toClassOnly: true });
 }
+/**
+ * Whitespace on either side of a pasted value is not part of the answer. Trimming here rather
+ * than in the api means the rules measure what will actually be stored - a name of three spaces
+ * is empty, not three characters long. Goes above `EmptyToNull()`, so a blank box becomes null.
+ */
+function Trim() {
+    return (0, class_transformer_1.Transform)(({ value }) => (typeof value === 'string' ? value.trim() : value), { toClassOnly: true });
+}
 /**
  * A class-validator decorator from a check that returns the first problem it finds, or null. The
  * problem is the message, so a 400 always says exactly what is wrong and where. `object` is the

package/package.json

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