@tstdl/base 0.93.97 → 0.93.99

package/audit/auditor.d.ts

@@ -43,7 +43,7 @@ type AuditEvents = Record<string, UndefinableJsonObject>;
  *
  * @template Events A record mapping event action names to their specific `details` payload types.
  */
-export declare class Auditor<Events extends AuditEvents = Record<never, never>> implements Resolvable<AuditorArgument> {
+export declare class Auditor<Events extends AuditEvents = AuditEvents> implements Resolvable<AuditorArgument> {
     #private;
     /**
      * The module path for this auditor instance.

package/context/context.d.ts

@@ -3,7 +3,7 @@ import type { Function, SimplifyObject } from '../types/index.js';
  * Creates a new context provider
  * @param name name of of the context used for function names
  */
-export declare function createContextProvider<Context, const Name extends string>(name: Name): SimplifyObject<Record<`getCurrent${Name}Context`, {
+export declare function createContextProvider<Context, const Name extends string>(name: Name): SimplifyObject<Record<`tryGetCurrent${Name}Context`, () => Context | null> & Record<`getCurrent${Name}Context`, {
     (required: true, debugFn: Function): Context;
     (required?: false, debugFn?: Function): Context | null;
     (required: boolean, debugFn: Function): Context | null;

package/context/context.js

@@ -5,6 +5,9 @@ import { isNotNull, isString } from '../utils/type-guards.js';
  */
 export function createContextProvider(name) {
     let currentContext = null;
+    function tryGetCurrentContext() {
+        return currentContext;
+    }
     function getCurrentContext(required = false, debugFn) {
         if (required) {
             assertInContext(debugFn);
@@ -57,6 +60,7 @@ export function createContextProvider(name) {
         }
     }
     return {
+        [`tryGetCurrent${name}Context`](...args) { return tryGetCurrentContext(...args); },
         [`getCurrent${name}Context`](...args) { return getCurrentContext(...args); },
         [`setCurrent${name}Context`](...args) { return setCurrentContext(...args); },
         [`runIn${name}Context`](...args) { return runInContext(...args); },

package/cookie/cookie.js

@@ -56,10 +56,14 @@ export function parseCookieString(cookieString) {
         .split(';')
         .map((cookiePartString) => {
         const splitIndex = cookiePartString.indexOf('=');
+        if (splitIndex == -1) {
+            return [cookiePartString.trim(), ''];
+        }
         const name = cookiePartString.slice(0, splitIndex).trim();
         const rawValue = trim(cookiePartString.slice(splitIndex + 1).trim(), '"');
         const value = decodeURIComponent(rawValue);
         return [name, value];
-    });
+    })
+        .filter(([name]) => name.length > 0);
     return new Map(cookieEntries);
 }

package/css/css-variables.d.ts

@@ -1,14 +1,52 @@
+/**
+ * Utility for programmatically managing CSS variables using Constructable Stylesheets.
+ */
 export declare class CssVariables implements Disposable {
     #private;
     readonly selector: string;
     readonly prefix: string;
+    /**
+     * Creates an instance of CssVariables.
+     * @param selector The CSS selector where variables should be applied. Defaults to `:root`.
+     * @param prefix Optional prefix for variable names.
+     */
     constructor(selector: string | null, prefix?: string);
+    /**
+     * Disposes the stylesheet by removing it from `document.adoptedStyleSheets`.
+     */
     [Symbol.dispose](): void;
+    /**
+     * Sets a CSS variable.
+     * @param name The name of the variable.
+     * @param value The value of the variable.
+     */
     set(name: string, value: string): void;
+    /**
+     * Sets multiple CSS variables at once.
+     * @param variables A record of variable names and values, or an array of entries.
+     */
     setMany(variables: Record<string, string> | readonly (readonly [string, string])[]): void;
+    /**
+     * Gets the value of a CSS variable.
+     * @param name The name of the variable.
+     * @returns The value of the variable, or `null` if not set.
+     */
     get(name: string): string | null;
+    /**
+     * Deletes a CSS variable.
+     * @param name The name of the variable to delete.
+     */
     delete(name: string): void;
+    /**
+     * Clears all CSS variables managed by this instance.
+     */
     clear(): void;
     private _prefix;
 }
+/**
+ * Creates a new {@link CssVariables} instance.
+ * @param selector The CSS selector where variables should be applied. Defaults to `:root`.
+ * @param prefix Optional prefix for variable names.
+ * @returns A new CssVariables instance.
+ */
 export declare function cssVariables(selector?: string | null, prefix?: string): CssVariables;

package/css/css-variables.js

@@ -1,32 +1,57 @@
 import { objectEntries } from '../utils/object/object.js';
 import { isArray } from '../utils/type-guards.js';
+/**
+ * Utility for programmatically managing CSS variables using Constructable Stylesheets.
+ */
 export class CssVariables {
     #styleSheet = new CSSStyleSheet();
     #cssRule;
     selector;
     prefix;
+    /**
+     * Creates an instance of CssVariables.
+     * @param selector The CSS selector where variables should be applied. Defaults to `:root`.
+     * @param prefix Optional prefix for variable names.
+     */
     constructor(selector, prefix = '') {
         this.selector = selector ?? ':root';
         this.prefix = prefix;
         document.adoptedStyleSheets.push(this.#styleSheet);
         this.#cssRule = createCssRule(this.#styleSheet, `${this.selector} {}`);
     }
+    /**
+     * Disposes the stylesheet by removing it from `document.adoptedStyleSheets`.
+     */
     [Symbol.dispose]() {
         const index = document.adoptedStyleSheets.indexOf(this.#styleSheet);
         if (index != -1) {
             document.adoptedStyleSheets.splice(index, 1);
         }
     }
+    /**
+     * Sets a CSS variable.
+     * @param name The name of the variable.
+     * @param value The value of the variable.
+     */
     set(name, value) {
         const prefixed = this._prefix(name);
         this.#cssRule.style.setProperty(prefixed, value);
     }
+    /**
+     * Sets multiple CSS variables at once.
+     * @param variables A record of variable names and values, or an array of entries.
+     */
     setMany(variables) {
         const entries = isArray(variables) ? variables : objectEntries(variables);
         for (const [name, value] of entries) {
             this.set(name, value);
         }
     }
+    /**
+     * Gets the value of a CSS variable.
+     * @param name The name of the variable.
+     * @returns The value of the variable, or `null` if not set.
+     */
     get(name) {
         const prefixed = this._prefix(name);
         const rawValue = this.#cssRule.style.getPropertyValue(prefixed);
@@ -35,10 +60,17 @@ export class CssVariables {
         }
         return rawValue;
     }
+    /**
+     * Deletes a CSS variable.
+     * @param name The name of the variable to delete.
+     */
     delete(name) {
         const prefixed = this._prefix(name);
         this.#cssRule.style.removeProperty(prefixed);
     }
+    /**
+     * Clears all CSS variables managed by this instance.
+     */
     clear() {
         this.#cssRule.style.cssText = '';
     }
@@ -47,6 +79,12 @@ export class CssVariables {
         return prefixed.startsWith('--') ? prefixed : `--${prefixed}`;
     }
 }
+/**
+ * Creates a new {@link CssVariables} instance.
+ * @param selector The CSS selector where variables should be applied. Defaults to `:root`.
+ * @param prefix Optional prefix for variable names.
+ * @returns A new CssVariables instance.
+ */
 export function cssVariables(selector = null, prefix = '') {
     return new CssVariables(selector, prefix);
 }

package/document-management/api/document-management.api.d.ts

@@ -1,6 +1,6 @@
 import { DataStream } from '../../sse/index.js';
 import { Document, DocumentCategory, DocumentRequest, DocumentRequestsTemplate, DocumentRequestTemplate, DocumentType } from '../models/index.js';
-import { CategoriesAndTypesData, DocumentCategoryView, DocumentManagementData, DocumentRequestsTemplateData } from '../service-models/index.js';
+import { CategoriesAndTypesData, DocumentCategoryView, DocumentManagementData, DocumentRequestsTemplateData, DocumentStatistics, GetDocumentStatisticsOptions } from '../service-models/index.js';
 export type DocumentManagementApiDefinition = typeof documentManagementApiDefinition;
 export declare const documentManagementApiDefinition: {
     resource: string;
@@ -14,6 +14,13 @@ export declare const documentManagementApiDefinition: {
             result: typeof DocumentManagementData;
             credentials: true;
         };
+        getStatistics: {
+            resource: string;
+            method: "POST";
+            parameters: typeof GetDocumentStatisticsOptions;
+            result: typeof DocumentStatistics;
+            credentials: true;
+        };
         getCategoriesAndTypes: {
             resource: string;
             method: "GET";
@@ -362,7 +369,7 @@ export declare const documentManagementApiDefinition: {
             method: "POST";
             parameters: import("../../schema/index.js").ObjectSchema<{
                 id: string;
-                state: "error" | "pending" | "running" | "completed" | "review" | "failed";
+                state: "error" | "pending" | "running" | "completed" | "failed" | "review";
             }>;
             result: import("../../schema/index.js").LiteralSchema<"ok">;
             credentials: true;
@@ -423,6 +430,13 @@ declare const _DocumentManagementApi: import("../../api/client/index.js").ApiCli
             result: typeof DocumentManagementData;
             credentials: true;
         };
+        getStatistics: {
+            resource: string;
+            method: "POST";
+            parameters: typeof GetDocumentStatisticsOptions;
+            result: typeof DocumentStatistics;
+            credentials: true;
+        };
         getCategoriesAndTypes: {
             resource: string;
             method: "GET";
@@ -771,7 +785,7 @@ declare const _DocumentManagementApi: import("../../api/client/index.js").ApiCli
             method: "POST";
             parameters: import("../../schema/index.js").ObjectSchema<{
                 id: string;
-                state: "error" | "pending" | "running" | "completed" | "review" | "failed";
+                state: "error" | "pending" | "running" | "completed" | "failed" | "review";
             }>;
             result: import("../../schema/index.js").LiteralSchema<"ok">;
             credentials: true;

package/document-management/api/document-management.api.js

@@ -13,7 +13,7 @@ import { array, boolean, literal, number, object, optional, string } from '../..
 import { DataStream } from '../../sse/index.js';
 import { policy } from '../authorization/index.js';
 import { Document, DocumentCategory, DocumentRequest, DocumentRequestsTemplate, DocumentRequestTemplate, DocumentType } from '../models/index.js';
-import { addOrArchiveDocumentToOrFromCollectionParametersSchema, applyDocumentRequestsTemplateParametersSchema, CategoriesAndTypesData, createDocumentCategoryParametersSchema, createDocumentParametersSchema, createDocumentRequestParametersSchema, createDocumentRequestsTemplateParametersSchema, createDocumentRequestTemplateParametersSchema, createDocumentTypeParametersSchema, deleteDocumentRequestParametersSchema, deleteDocumentRequestsTemplateParametersSchema, deleteDocumentRequestTemplateParametersSchema, DocumentCategoryView, DocumentManagementData, DocumentRequestsTemplateData, loadDataParametersSchema, proceedDocumentWorkflowParametersSchema, updateDocumentParametersSchema, updateDocumentRequestParametersSchema, updateDocumentRequestsTemplateParametersSchema, updateDocumentRequestTemplateParametersSchema } from '../service-models/index.js';
+import { addOrArchiveDocumentToOrFromCollectionParametersSchema, applyDocumentRequestsTemplateParametersSchema, CategoriesAndTypesData, createDocumentCategoryParametersSchema, createDocumentParametersSchema, createDocumentRequestParametersSchema, createDocumentRequestsTemplateParametersSchema, createDocumentRequestTemplateParametersSchema, createDocumentTypeParametersSchema, deleteDocumentRequestParametersSchema, deleteDocumentRequestsTemplateParametersSchema, deleteDocumentRequestTemplateParametersSchema, DocumentCategoryView, DocumentManagementData, DocumentRequestsTemplateData, DocumentStatistics, GetDocumentStatisticsOptions, loadDataParametersSchema, proceedDocumentWorkflowParametersSchema, updateDocumentParametersSchema, updateDocumentRequestParametersSchema, updateDocumentRequestsTemplateParametersSchema, updateDocumentRequestTemplateParametersSchema } from '../service-models/index.js';
 export const documentManagementApiDefinition = defineApi({
     resource: 'document-management',
     endpoints: {
@@ -24,6 +24,13 @@ export const documentManagementApiDefinition = defineApi({
             result: DocumentManagementData,
             credentials: true,
         },
+        getStatistics: {
+            resource: 'stats',
+            method: 'POST',
+            parameters: GetDocumentStatisticsOptions,
+            result: DocumentStatistics,
+            credentials: true,
+        },
         getCategoriesAndTypes: {
             resource: 'categories-and-types',
             method: 'GET',

package/document-management/models/document-category.model.js

@@ -23,7 +23,6 @@ __decorate([
 ], DocumentCategory.prototype, "parentId", void 0);
 __decorate([
     StringProperty(),
-    Unique(),
     __metadata("design:type", String)
 ], DocumentCategory.prototype, "label", void 0);
 __decorate([

package/document-management/models/document-property.model.js

@@ -26,7 +26,6 @@ let DocumentProperty = class DocumentProperty extends TenantEntity {
 };
 __decorate([
     StringProperty(),
-    Unique(),
     __metadata("design:type", String)
 ], DocumentProperty.prototype, "label", void 0);
 __decorate([

package/document-management/server/api/document-management.api.d.ts

@@ -3,6 +3,7 @@ import { type DocumentManagementApiDefinition } from '../../api/index.js';
 export declare class DocumentManagementApiController implements ApiController<DocumentManagementApiDefinition> {
     #private;
     loadData(context: ApiRequestContext<DocumentManagementApiDefinition, 'loadData'>): Promise<ApiServerResult<DocumentManagementApiDefinition, 'loadData'>>;
+    getStatistics(context: ApiRequestContext<DocumentManagementApiDefinition, 'getStatistics'>): Promise<ApiServerResult<DocumentManagementApiDefinition, 'getStatistics'>>;
     loadDataStream(context: ApiRequestContext<DocumentManagementApiDefinition, 'loadDataStream'>): ApiServerResult<DocumentManagementApiDefinition, 'loadDataStream'>;
     loadDocumentRequestsTemplateData(context: ApiRequestContext<DocumentManagementApiDefinition, 'loadDocumentRequestsTemplateData'>): Promise<ApiServerResult<DocumentManagementApiDefinition, 'loadDocumentRequestsTemplateData'>>;
     getCategoriesAndTypes(context: ApiRequestContext<DocumentManagementApiDefinition, 'getCategoriesAndTypes'>): Promise<ApiServerResult<DocumentManagementApiDefinition, 'getCategoriesAndTypes'>>;

package/document-management/server/api/document-management.api.js

@@ -15,9 +15,10 @@ import { toArray } from '../../../utils/array/index.js';
 import { documentManagementApiDefinition } from '../../api/index.js';
 import { DocumentManagementAuthorizationService } from '../../authorization/index.js';
 import { DocumentRequestCollectionAssignment } from '../../models/document-request-collection-assignment.model.js';
-import { DocumentCategoryTypeService, DocumentFileService, DocumentManagementService, DocumentRequestService, DocumentService, DocumentWorkflowService } from '../services/index.js';
+import { DocumentCategoryTypeService, DocumentFileService, DocumentManagementService, DocumentRequestService, DocumentService, DocumentStatisticsService, DocumentWorkflowService } from '../services/index.js';
 let DocumentManagementApiController = class DocumentManagementApiController {
     #documentManagementService = inject(DocumentManagementService);
+    #documentStatisticsService = inject(DocumentStatisticsService);
     #authorizationService = inject(DocumentManagementAuthorizationService);
     #documentCategoryTypeService = inject(DocumentCategoryTypeService);
     #documentFileService = inject(DocumentFileService);
@@ -38,6 +39,17 @@ let DocumentManagementApiController = class DocumentManagementApiController {
         }
         return await this.#documentManagementService.loadData(tenantId, collectionIdArray);
     }
+    async getStatistics(context) {
+        const token = await context.getToken();
+        const tenantId = await this.#authorizationService.getTenantId(token);
+        for (const collectionId of context.parameters.collectionIds) {
+            const allowed = await this.#authorizationService.canReadCollection(collectionId, token);
+            if (!allowed) {
+                throw new ForbiddenError(`You are not allowed to read collection ${collectionId}`);
+            }
+        }
+        return await this.#documentStatisticsService.getStatistics(tenantId, context.parameters);
+    }
     async *loadDataStream(context) {
         const token = await context.getToken();
         const tenantId = await this.#authorizationService.getTenantId(token);

package/document-management/server/drizzle/{0000_needy_steel_serpent.sql → 0000_silly_chimera.sql}

@@ -72,7 +72,6 @@ CREATE TABLE "document_management"."category" (
 	"delete_timestamp" timestamp with time zone,
 	"attributes" jsonb DEFAULT '{}'::jsonb NOT NULL,
 	CONSTRAINT "category_tenant_id_id_pk" PRIMARY KEY("tenant_id","id"),
-	CONSTRAINT "category_label_unique" UNIQUE("label"),
 	CONSTRAINT "category_tenant_id_key_unique" UNIQUE("tenant_id","key"),
 	CONSTRAINT "category_tenant_id_parent_id_label_unique" UNIQUE("tenant_id","parent_id","label")
 );
@@ -117,7 +116,6 @@ CREATE TABLE "document_management"."property" (
 	"delete_timestamp" timestamp with time zone,
 	"attributes" jsonb DEFAULT '{}'::jsonb NOT NULL,
 	CONSTRAINT "property_tenant_id_id_pk" PRIMARY KEY("tenant_id","id"),
-	CONSTRAINT "property_label_unique" UNIQUE("label"),
 	CONSTRAINT "property_tenant_id_key_unique" UNIQUE("tenant_id","key"),
 	CONSTRAINT "property_tenant_id_label_unique" UNIQUE("tenant_id","label")
 );

package/document-management/server/drizzle/meta/0000_snapshot.json

@@ -1,5 +1,5 @@
 {
-  "id": "bc835c07-b4ae-40f1-9d65-cfca1dcca765",
+  "id": "fee5df5b-e30c-483a-a4f2-fff78256e1c2",
   "prevId": "00000000-0000-0000-0000-000000000000",
   "version": "7",
   "dialect": "postgresql",
@@ -542,13 +542,6 @@
         }
       },
       "uniqueConstraints": {
-        "category_label_unique": {
-          "name": "category_label_unique",
-          "nullsNotDistinct": false,
-          "columns": [
-            "label"
-          ]
-        },
         "category_tenant_id_key_unique": {
           "name": "category_tenant_id_key_unique",
           "nullsNotDistinct": false,
@@ -922,13 +915,6 @@
         }
       },
       "uniqueConstraints": {
-        "property_label_unique": {
-          "name": "property_label_unique",
-          "nullsNotDistinct": false,
-          "columns": [
-            "label"
-          ]
-        },
         "property_tenant_id_key_unique": {
           "name": "property_tenant_id_key_unique",
           "nullsNotDistinct": false,

package/document-management/server/drizzle/meta/_journal.json

@@ -5,8 +5,8 @@
     {
       "idx": 0,
       "version": "7",
-      "when": 1769181101684,
-      "tag": "0000_needy_steel_serpent",
+      "when": 1769464843006,
+      "tag": "0000_silly_chimera",
       "breakpoints": true
     }
   ]

package/document-management/server/services/document-statistics.service.d.ts

@@ -0,0 +1,6 @@
+import { Transactional } from '../../../orm/server/index.js';
+import { DocumentStatistics, GetDocumentStatisticsOptions } from '../../service-models/index.js';
+export declare class DocumentStatisticsService extends Transactional {
+    #private;
+    getStatistics(tenantId: string, options: GetDocumentStatisticsOptions): Promise<DocumentStatistics>;
+}

package/document-management/server/services/document-statistics.service.js

@@ -0,0 +1,167 @@
+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;
+};
+import { Transactional } from '../../../orm/server/index.js';
+import { isDefined } from '../../../utils/type-guards.js';
+import { and, count, countDistinct, eq, inArray, isNotNull, sql, sum } from 'drizzle-orm';
+import { DocumentValidationResultStatus } from '../../models/document-validation-execution.model.js';
+import { DocumentApproval } from '../../models/document.model.js';
+import { DocumentStatistics, GetDocumentStatisticsOptions } from '../../service-models/index.js';
+import { document, documentCollectionAssignment, documentTagAssignment, documentType, documentValidationExecution, documentWorkflow } from '../schemas.js';
+import { DocumentManagementSingleton } from './singleton.js';
+let DocumentStatisticsService = class DocumentStatisticsService extends Transactional {
+    async getStatistics(tenantId, options) {
+        const stats = {};
+        const conditions = [eq(document.tenantId, tenantId)];
+        const joinCollection = isDefined(options.collectionIds);
+        const joinType = isDefined(options.categoryIds);
+        if (isDefined(options.collectionIds)) {
+            conditions.push(inArray(documentCollectionAssignment.collectionId, options.collectionIds));
+        }
+        if (isDefined(options.categoryIds)) {
+            conditions.push(inArray(documentType.categoryId, options.categoryIds));
+        }
+        await Promise.all([
+            this.#calculateBasicStats(stats, options, conditions, joinCollection, joinType),
+            this.#calculateTypeBreakdown(stats, options, conditions, joinCollection, joinType),
+            this.#calculateMimeTypeDistribution(stats, options, conditions, joinCollection, joinType),
+            this.#calculateTagUsage(stats, options, conditions, joinCollection, joinType),
+            this.#calculateValidationFailures(stats, options, conditions, joinCollection, joinType),
+        ]);
+        return stats;
+    }
+    async #calculateBasicStats(stats, options, conditions, joinCollection, joinType) {
+        const select = {};
+        if (options.includeTotalCount == true) {
+            select['totalCount'] = count(document.id);
+        }
+        if (options.includeApprovalBreakdown == true) {
+            select['approvalPending'] = count(sql `CASE WHEN ${eq(document.approval, DocumentApproval.Pending)} THEN 1 END`);
+            select['approvalApproved'] = count(sql `CASE WHEN ${eq(document.approval, DocumentApproval.Approved)} THEN 1 END`);
+            select['approvalRejected'] = count(sql `CASE WHEN ${eq(document.approval, DocumentApproval.Rejected)} THEN 1 END`);
+        }
+        if (options.includeStorageUsage == true) {
+            select['storageUsage'] = sum(document.size);
+        }
+        if (options.includeTotalPages == true) {
+            select['totalPages'] = sum(document.pages);
+        }
+        if (options.includeDataQuality == true) {
+            select['missingType'] = count(sql `CASE WHEN ${document.typeId} IS NULL THEN 1 END`);
+            select['missingDate'] = count(sql `CASE WHEN ${document.date} IS NULL THEN 1 END`);
+            select['missingTitle'] = count(sql `CASE WHEN ${document.title} IS NULL THEN 1 END`);
+        }
+        if (options.includeCreatedLast30Days == true) {
+            const thirtyDaysAgo = Date.now() - (30 * 24 * 60 * 60 * 1000);
+            select['createdLast30Days'] = count(sql `CASE WHEN ${document.createTimestamp} > ${new Date(thirtyDaysAgo).toISOString()} THEN 1 END`);
+        }
+        if (Object.keys(select).length == 0) {
+            return;
+        }
+        let query = this.session.select(select).from(document).where(and(...conditions)).$dynamic();
+        query = this.#applyJoins(query, joinCollection, joinType);
+        const [result] = await query;
+        if (isDefined(result)) {
+            if (options.includeTotalCount == true) {
+                stats.totalCount = Number(result.totalCount);
+            }
+            if (options.includeApprovalBreakdown == true) {
+                stats.approvalBreakdown = {
+                    [DocumentApproval.Pending]: Number(result.approvalPending),
+                    [DocumentApproval.Approved]: Number(result.approvalApproved),
+                    [DocumentApproval.Rejected]: Number(result.approvalRejected),
+                };
+            }
+            if (options.includeStorageUsage == true) {
+                stats.storageUsage = Number(result.storageUsage ?? 0);
+            }
+            if (options.includeTotalPages == true) {
+                stats.totalPages = Number(result.totalPages ?? 0);
+            }
+            if (options.includeDataQuality == true) {
+                stats.dataQuality = {
+                    missingType: Number(result.missingType),
+                    missingDate: Number(result.missingDate),
+                    missingTitle: Number(result.missingTitle),
+                };
+            }
+            if (options.includeCreatedLast30Days == true) {
+                stats.createdLast30Days = Number(result.createdLast30Days);
+            }
+        }
+    }
+    async #calculateTypeBreakdown(stats, options, conditions, joinCollection, joinType) {
+        if (options.includeTypeBreakdown != true) {
+            return;
+        }
+        let query = this.session
+            .select({ typeId: document.typeId, count: count(document.id) })
+            .from(document)
+            .where(and(...conditions, isNotNull(document.typeId)))
+            .groupBy(document.typeId)
+            .$dynamic();
+        query = this.#applyJoins(query, joinCollection, joinType);
+        const results = await query;
+        stats.typeBreakdown = Object.fromEntries(results.map((r) => [r.typeId, r.count]));
+    }
+    async #calculateMimeTypeDistribution(stats, options, conditions, joinCollection, joinType) {
+        if (options.includeMimeTypeDistribution != true) {
+            return;
+        }
+        let query = this.session
+            .select({ mimeType: document.mimeType, count: count(document.id) })
+            .from(document)
+            .where(and(...conditions))
+            .groupBy(document.mimeType)
+            .$dynamic();
+        query = this.#applyJoins(query, joinCollection, joinType);
+        const results = await query;
+        stats.mimeTypeDistribution = Object.fromEntries(results.map((r) => [r.mimeType, r.count]));
+    }
+    async #calculateTagUsage(stats, options, conditions, joinCollection, joinType) {
+        if (options.includeTagUsage != true) {
+            return;
+        }
+        let query = this.session
+            .select({ tagId: documentTagAssignment.tagId, count: count(document.id) })
+            .from(document)
+            .innerJoin(documentTagAssignment, eq(documentTagAssignment.documentId, document.id))
+            .where(and(...conditions))
+            .groupBy(documentTagAssignment.tagId)
+            .$dynamic();
+        query = this.#applyJoins(query, joinCollection, joinType);
+        const results = await query;
+        stats.tagUsage = Object.fromEntries(results.map((r) => [r.tagId, r.count]));
+    }
+    async #calculateValidationFailures(stats, options, conditions, joinCollection, joinType) {
+        if (options.includeValidationFailures != true) {
+            return;
+        }
+        let query = this.session
+            .select({ count: countDistinct(document.id) })
+            .from(document)
+            .innerJoin(documentWorkflow, eq(documentWorkflow.documentId, document.id))
+            .innerJoin(documentValidationExecution, eq(documentValidationExecution.workflowId, documentWorkflow.id))
+            .where(and(...conditions, eq(documentValidationExecution.resultStatus, DocumentValidationResultStatus.Failed)))
+            .$dynamic();
+        query = this.#applyJoins(query, joinCollection, joinType);
+        const [result] = await query;
+        stats.validationFailures = (result?.count ?? 0);
+    }
+    #applyJoins(query, joinCollection, joinType) {
+        if (joinCollection) {
+            query = query.innerJoin(documentCollectionAssignment, eq(documentCollectionAssignment.documentId, document.id));
+        }
+        if (joinType) {
+            query = query.leftJoin(documentType, eq(documentType.id, document.typeId));
+        }
+        return query;
+    }
+};
+DocumentStatisticsService = __decorate([
+    DocumentManagementSingleton()
+], DocumentStatisticsService);
+export { DocumentStatisticsService };

package/document-management/server/services/index.d.ts

@@ -7,6 +7,7 @@ export * from './document-management-observation.service.js';
 export * from './document-management.service.js';
 export * from './document-property.service.js';
 export * from './document-request.service.js';
+export * from './document-statistics.service.js';
 export * from './document-tag.service.js';
 export * from './document-validation.service.js';
 export * from './document-workflow.service.js';

package/document-management/server/services/index.js

@@ -7,6 +7,7 @@ export * from './document-management-observation.service.js';
 export * from './document-management.service.js';
 export * from './document-property.service.js';
 export * from './document-request.service.js';
+export * from './document-statistics.service.js';
 export * from './document-tag.service.js';
 export * from './document-validation.service.js';
 export * from './document-workflow.service.js';

package/document-management/service-models/document-statistics.view-model.d.ts

@@ -0,0 +1,38 @@
+import type { Record } from '../../types/index.js';
+import { DocumentApproval } from '../models/document.model.js';
+export declare class DocumentApprovalBreakdown {
+    [DocumentApproval.Pending]: number;
+    [DocumentApproval.Approved]: number;
+    [DocumentApproval.Rejected]: number;
+}
+export declare class DocumentDataQualityMetrics {
+    missingType: number;
+    missingDate: number;
+    missingTitle: number;
+}
+export declare class DocumentStatistics {
+    totalCount?: number;
+    approvalBreakdown?: DocumentApprovalBreakdown;
+    typeBreakdown?: Record<string, number>;
+    storageUsage?: number;
+    mimeTypeDistribution?: Record<string, number>;
+    dataQuality?: DocumentDataQualityMetrics;
+    createdLast30Days?: number;
+    tagUsage?: Record<string, number>;
+    totalPages?: number;
+    validationFailures?: number;
+}
+export declare class GetDocumentStatisticsOptions {
+    includeTotalCount?: boolean;
+    includeApprovalBreakdown?: boolean;
+    includeTypeBreakdown?: boolean;
+    includeStorageUsage?: boolean;
+    includeMimeTypeDistribution?: boolean;
+    includeDataQuality?: boolean;
+    includeCreatedLast30Days?: boolean;
+    includeTagUsage?: boolean;
+    includeTotalPages?: boolean;
+    includeValidationFailures?: boolean;
+    collectionIds: string[];
+    categoryIds?: string[];
+}