@managemint-solutions/sdk 0.67.0 → 0.69.0

package/dist/supporting-files/dto.js

@@ -9,9 +9,11 @@ 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.SupportingFileNamesDto = exports.GetSupportingFilesDto = exports.SupportingFileIdDto = exports.MAX_FILES_PER_UPLOAD = void 0;
+exports.GetAllSupportingFilesDto = exports.SupportingFileNamesDto = exports.GetSupportingFilesDto = exports.SupportingFileIdDto = exports.MAX_FILES_PER_UPLOAD = void 0;
 const class_validator_1 = require("class-validator");
+const class_transformer_1 = require("class-transformer");
 const enum_1 = require("@managemint-solutions/entities/supporting-files/enum");
+const validators_1 = require("../validators");
 // class-validator versions of the shared DTO types from @managemint-solutions/entities.
 // Each class `implements` its entities type so the wire contract cannot drift.
 /** Files accepted in one upload. */
@@ -51,3 +53,46 @@ __decorate([
     (0, class_validator_1.IsNotEmpty)({ each: true, message: 'A file name cannot be empty' }),
     __metadata("design:type", Array)
 ], SupportingFileNamesDto.prototype, "names", void 0);
+/** The admin api's GET /supporting-files: every organization's supporting files, a page at a time. */
+class GetAllSupportingFilesDto {
+    page = 1;
+    page_size = 25;
+    organization_id;
+    entity_type;
+    search;
+}
+exports.GetAllSupportingFilesDto = GetAllSupportingFilesDto;
+__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)
+], GetAllSupportingFilesDto.prototype, "page", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Transform)(({ value }) => (value ? Number(value) : 25), { 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)
+], GetAllSupportingFilesDto.prototype, "page_size", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, validators_1.IsNullable)(),
+    (0, class_validator_1.IsUUID)('7', { message: 'Invalid organization ID format' }),
+    __metadata("design:type", Object)
+], GetAllSupportingFilesDto.prototype, "organization_id", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, validators_1.IsNullable)(),
+    (0, class_validator_1.IsEnum)(enum_1.SupportingFilesEntityTypes, { message: 'Invalid record type' }),
+    __metadata("design:type", Object)
+], GetAllSupportingFilesDto.prototype, "entity_type", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, validators_1.IsNullable)(),
+    (0, class_validator_1.IsString)({ message: 'Invalid search' }),
+    (0, class_validator_1.MaxLength)(200, { message: 'Search cannot exceed 200 characters' }),
+    __metadata("design:type", Object)
+], GetAllSupportingFilesDto.prototype, "search", void 0);

package/dist/supporting-files/index.d.ts

@@ -1,8 +1,11 @@
 import type { SupportingFileEntity, SupportingFilePresignedUrl, SupportingFileUploadTarget } from '@managemint-solutions/entities/supporting-files';
+import type { StaffSupportingFileRow } from '@managemint-solutions/entities/supporting-files';
+import type { MmsList } from '@managemint-solutions/entities/common';
 import { SupportingFilesEntityTypes } from '@managemint-solutions/entities/supporting-files/enum';
 import { type AuditResource, type ResourceActor } from '../audit';
 import type { TypedSupabaseClient } from '../client';
 export * from './dto';
+import type { GetAllSupportingFilesDto } from './dto';
 export * from './paths';
 export declare class SupportingFilesResource {
     private readonly supabase;
@@ -25,6 +28,8 @@ export declare class SupportingFilesResource {
         organization_id: string;
     }>;
     list(entity: SupportingFilesEntityTypes, entityId: string): Promise<SupportingFileEntity[]>;
+    /** The admin portal's Supporting Files list: every file on a record type in `entityTypes`, newest first. */
+    listAll(query: GetAllSupportingFilesDto, entityTypes: string[]): Promise<MmsList<StaffSupportingFileRow>>;
     /**
      * Where the caller puts each file: one signed upload URL per name, in request order, valid
      * for two hours, into the organization's prefix. Storage checks the bucket's INSERT policy

package/dist/supporting-files/index.js

@@ -21,9 +21,11 @@ const audit_1 = require("../audit");
 const errors_1 = require("../errors");
 const won_1 = require("../leads/won");
 const tenancy_1 = require("../tenancy");
+const transforms_1 = require("../transforms");
 const paths_1 = require("./paths");
 __exportStar(require("./dto"), exports);
 __exportStar(require("./paths"), exports);
+const SUPPORTING_FILE_LIST_SELECT = 'mms_id, created_at, name, extension, entity_type, entity_id, created_by:user_profiles!created_by(*), organization:organizations!organization_id(mms_id, name)';
 /** How long a presigned download URL stays valid. */
 const SIGNED_URL_TTL_SECONDS = 300;
 /** Storage calls per file (minting an upload URL, checking an object) run concurrently in batches of this size. */
@@ -98,6 +100,13 @@ class SupportingFilesResource {
             throw (0, errors_1.mapPostgrestError)(error);
         return data;
     }
+    /** The admin portal's Supporting Files list: every file on a record type in `entityTypes`, newest first. */
+    async listAll(query, entityTypes) {
+        const { data, error, count } = await (0, tenancy_1.filterStaffList)(this.supabase.from('supporting_files').select(SUPPORTING_FILE_LIST_SELECT, { count: 'exact' }), query, ['name'], entityTypes).order('created_at', { ascending: false });
+        if (error)
+            throw (0, errors_1.mapPostgrestError)(error);
+        return (0, transforms_1.toMmsList)(data, query.page, query.page_size, count);
+    }
     /**
      * Where the caller puts each file: one signed upload URL per name, in request order, valid
      * for two hours, into the organization's prefix. Storage checks the bucket's INSERT policy

package/dist/tenancy.d.ts

@@ -11,3 +11,15 @@ export declare const requireOrganization: (actor: {
 export declare const withOrganization: (select: string, actor: {
     organization_id: string | null;
 }) => string;
+/**
+ * A staff list's page with its filters applied: the organization, the record type, a text search
+ * over `searchColumns`, and when given, the record types a row may belong to (those the caller
+ * may read). The read spans every organization the caller's policies let it see.
+ */
+export declare const filterStaffList: <Q extends PostgrestFilterBuilder<any, any, any, any, any, any, any>>(query: Q, filters: {
+    page: number;
+    page_size: number;
+    organization_id?: string | null;
+    entity_type?: string | null;
+    search?: string | null;
+}, searchColumns: readonly string[], entityTypes?: string[]) => Q;

package/dist/tenancy.js

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.withOrganization = exports.requireOrganization = exports.scopeToOrganization = void 0;
+exports.filterStaffList = exports.withOrganization = exports.requireOrganization = exports.scopeToOrganization = void 0;
 const errors_1 = require("./errors");
+const transforms_1 = require("./transforms");
 // How a resource scopes itself to the caller's organization. A tenant (`AuthContext`) reads and
 // writes inside their own; staff (`StaffContext`, `organization_id: null`) read across every
 // organization, as their role's policies allow, and write nothing.
@@ -23,3 +24,23 @@ exports.requireOrganization = requireOrganization;
 /** A select, plus the row's organization on a staff read so the row says whose it is. */
 const withOrganization = (select, actor) => actor.organization_id === null ? `${select}, organization:organizations!organization_id(mms_id, name)` : select;
 exports.withOrganization = withOrganization;
+/**
+ * A staff list's page with its filters applied: the organization, the record type, a text search
+ * over `searchColumns`, and when given, the record types a row may belong to (those the caller
+ * may read). The read spans every organization the caller's policies let it see.
+ */
+const filterStaffList = (query, filters, searchColumns, entityTypes) => {
+    const from = (filters.page - 1) * filters.page_size;
+    let builder = query.range(from, from + filters.page_size - 1);
+    if (filters.organization_id)
+        builder = builder.eq('organization_id', filters.organization_id);
+    if (filters.entity_type)
+        builder = builder.eq('entity_type', filters.entity_type);
+    if (entityTypes)
+        builder = builder.in('entity_type', entityTypes);
+    const search = filters.search?.trim();
+    if (search)
+        builder = builder.or((0, transforms_1.orIlike)(searchColumns, search));
+    return builder;
+};
+exports.filterStaffList = filterStaffList;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@managemint-solutions/sdk",
-  "version": "0.67.0",
+  "version": "0.69.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.49.0"
+    "@managemint-solutions/entities": "^1.51.0"
   },
   "peerDependencies": {
     "@nestjs/common": "^11.0.0",