@nxgt/shared-mongo 1.0.0

package/README.md

@@ -0,0 +1,15 @@
+# @nxgt/shared-mongo
+
+To install dependencies:
+
+```bash
+bun install
+```
+
+To run:
+
+```bash
+bun run src/index.ts
+```
+
+This project was created using `bun init` in bun v1.3.9. [Bun](https://bun.com) is a fast all-in-one JavaScript runtime.

package/dist/audit/audit.model.d.ts

@@ -0,0 +1,209 @@
+import type { HydratedDocument, Model } from 'mongoose';
+import { Schema } from 'mongoose';
+export interface Audit {
+    id: string;
+    type: string;
+    globalId: string;
+    author: string;
+    state: any;
+    properties: string[];
+    changes: any[];
+    version: number;
+}
+export type AuditDocument = HydratedDocument<Audit>;
+type AuditModel = Model<AuditDocument, object, object, object>;
+export declare const AuditModel: Model<import("mongoose").Document<unknown, {}, Audit, {}, import("mongoose").DefaultSchemaOptions> & Audit & {
+    _id: import("mongoose").Types.ObjectId;
+} & {
+    __v: number;
+}, object, object, object, import("mongoose").Document<unknown, object, import("mongoose").Document<unknown, {}, Audit, {}, import("mongoose").DefaultSchemaOptions> & Audit & {
+    _id: import("mongoose").Types.ObjectId;
+} & {
+    __v: number;
+}, object, import("mongoose").DefaultSchemaOptions> & Omit<import("mongoose").Document<unknown, {}, Audit, {}, import("mongoose").DefaultSchemaOptions> & Audit & {
+    _id: import("mongoose").Types.ObjectId;
+} & {
+    __v: number;
+} & Required<{
+    _id: import("mongoose").Types.ObjectId;
+}>, never> & object, Schema<import("mongoose").Document<unknown, {}, Audit, {}, import("mongoose").DefaultSchemaOptions> & Audit & {
+    _id: import("mongoose").Types.ObjectId;
+} & {
+    __v: number;
+}, AuditModel, object, object, object, {}, import("mongoose").DefaultSchemaOptions, import("mongoose").Document<unknown, {}, Audit, {}, import("mongoose").DefaultSchemaOptions> & Audit & {
+    _id: import("mongoose").Types.ObjectId;
+} & {
+    __v: number;
+}, import("mongoose").Document<unknown, object, import("mongoose").Document<unknown, {}, Audit, {}, import("mongoose").DefaultSchemaOptions> & Audit & {
+    _id: import("mongoose").Types.ObjectId;
+} & {
+    __v: number;
+}, object, import("mongoose").DefaultSchemaOptions> & Omit<import("mongoose").Document<unknown, {}, Audit, {}, import("mongoose").DefaultSchemaOptions> & Audit & {
+    _id: import("mongoose").Types.ObjectId;
+} & {
+    __v: number;
+} & Required<{
+    _id: import("mongoose").Types.ObjectId;
+}>, never> & object, {
+    __v?: import("mongoose").SchemaDefinitionProperty<number, import("mongoose").Document<unknown, {}, Audit, {}, import("mongoose").DefaultSchemaOptions> & Audit & {
+        _id: import("mongoose").Types.ObjectId;
+    } & {
+        __v: number;
+    }, import("mongoose").Document<unknown, object, import("mongoose").Document<unknown, {}, Audit, {}, import("mongoose").DefaultSchemaOptions> & Audit & {
+        _id: import("mongoose").Types.ObjectId;
+    } & {
+        __v: number;
+    }, object, import("mongoose").DefaultSchemaOptions> & Omit<import("mongoose").Document<unknown, {}, Audit, {}, import("mongoose").DefaultSchemaOptions> & Audit & {
+        _id: import("mongoose").Types.ObjectId;
+    } & {
+        __v: number;
+    } & Required<{
+        _id: import("mongoose").Types.ObjectId;
+    }>, never> & object> | undefined;
+    _id?: import("mongoose").SchemaDefinitionProperty<import("mongoose").Types.ObjectId, import("mongoose").Document<unknown, {}, Audit, {}, import("mongoose").DefaultSchemaOptions> & Audit & {
+        _id: import("mongoose").Types.ObjectId;
+    } & {
+        __v: number;
+    }, import("mongoose").Document<unknown, object, import("mongoose").Document<unknown, {}, Audit, {}, import("mongoose").DefaultSchemaOptions> & Audit & {
+        _id: import("mongoose").Types.ObjectId;
+    } & {
+        __v: number;
+    }, object, import("mongoose").DefaultSchemaOptions> & Omit<import("mongoose").Document<unknown, {}, Audit, {}, import("mongoose").DefaultSchemaOptions> & Audit & {
+        _id: import("mongoose").Types.ObjectId;
+    } & {
+        __v: number;
+    } & Required<{
+        _id: import("mongoose").Types.ObjectId;
+    }>, never> & object> | undefined;
+    id?: import("mongoose").SchemaDefinitionProperty<string, import("mongoose").Document<unknown, {}, Audit, {}, import("mongoose").DefaultSchemaOptions> & Audit & {
+        _id: import("mongoose").Types.ObjectId;
+    } & {
+        __v: number;
+    }, import("mongoose").Document<unknown, object, import("mongoose").Document<unknown, {}, Audit, {}, import("mongoose").DefaultSchemaOptions> & Audit & {
+        _id: import("mongoose").Types.ObjectId;
+    } & {
+        __v: number;
+    }, object, import("mongoose").DefaultSchemaOptions> & Omit<import("mongoose").Document<unknown, {}, Audit, {}, import("mongoose").DefaultSchemaOptions> & Audit & {
+        _id: import("mongoose").Types.ObjectId;
+    } & {
+        __v: number;
+    } & Required<{
+        _id: import("mongoose").Types.ObjectId;
+    }>, never> & object> | undefined;
+    type?: import("mongoose").SchemaDefinitionProperty<string, import("mongoose").Document<unknown, {}, Audit, {}, import("mongoose").DefaultSchemaOptions> & Audit & {
+        _id: import("mongoose").Types.ObjectId;
+    } & {
+        __v: number;
+    }, import("mongoose").Document<unknown, object, import("mongoose").Document<unknown, {}, Audit, {}, import("mongoose").DefaultSchemaOptions> & Audit & {
+        _id: import("mongoose").Types.ObjectId;
+    } & {
+        __v: number;
+    }, object, import("mongoose").DefaultSchemaOptions> & Omit<import("mongoose").Document<unknown, {}, Audit, {}, import("mongoose").DefaultSchemaOptions> & Audit & {
+        _id: import("mongoose").Types.ObjectId;
+    } & {
+        __v: number;
+    } & Required<{
+        _id: import("mongoose").Types.ObjectId;
+    }>, never> & object> | undefined;
+    version?: import("mongoose").SchemaDefinitionProperty<number, import("mongoose").Document<unknown, {}, Audit, {}, import("mongoose").DefaultSchemaOptions> & Audit & {
+        _id: import("mongoose").Types.ObjectId;
+    } & {
+        __v: number;
+    }, import("mongoose").Document<unknown, object, import("mongoose").Document<unknown, {}, Audit, {}, import("mongoose").DefaultSchemaOptions> & Audit & {
+        _id: import("mongoose").Types.ObjectId;
+    } & {
+        __v: number;
+    }, object, import("mongoose").DefaultSchemaOptions> & Omit<import("mongoose").Document<unknown, {}, Audit, {}, import("mongoose").DefaultSchemaOptions> & Audit & {
+        _id: import("mongoose").Types.ObjectId;
+    } & {
+        __v: number;
+    } & Required<{
+        _id: import("mongoose").Types.ObjectId;
+    }>, never> & object> | undefined;
+    state?: import("mongoose").SchemaDefinitionProperty<any, import("mongoose").Document<unknown, {}, Audit, {}, import("mongoose").DefaultSchemaOptions> & Audit & {
+        _id: import("mongoose").Types.ObjectId;
+    } & {
+        __v: number;
+    }, import("mongoose").Document<unknown, object, import("mongoose").Document<unknown, {}, Audit, {}, import("mongoose").DefaultSchemaOptions> & Audit & {
+        _id: import("mongoose").Types.ObjectId;
+    } & {
+        __v: number;
+    }, object, import("mongoose").DefaultSchemaOptions> & Omit<import("mongoose").Document<unknown, {}, Audit, {}, import("mongoose").DefaultSchemaOptions> & Audit & {
+        _id: import("mongoose").Types.ObjectId;
+    } & {
+        __v: number;
+    } & Required<{
+        _id: import("mongoose").Types.ObjectId;
+    }>, never> & object> | undefined;
+    changes?: import("mongoose").SchemaDefinitionProperty<any[], import("mongoose").Document<unknown, {}, Audit, {}, import("mongoose").DefaultSchemaOptions> & Audit & {
+        _id: import("mongoose").Types.ObjectId;
+    } & {
+        __v: number;
+    }, import("mongoose").Document<unknown, object, import("mongoose").Document<unknown, {}, Audit, {}, import("mongoose").DefaultSchemaOptions> & Audit & {
+        _id: import("mongoose").Types.ObjectId;
+    } & {
+        __v: number;
+    }, object, import("mongoose").DefaultSchemaOptions> & Omit<import("mongoose").Document<unknown, {}, Audit, {}, import("mongoose").DefaultSchemaOptions> & Audit & {
+        _id: import("mongoose").Types.ObjectId;
+    } & {
+        __v: number;
+    } & Required<{
+        _id: import("mongoose").Types.ObjectId;
+    }>, never> & object> | undefined;
+    properties?: import("mongoose").SchemaDefinitionProperty<string[], import("mongoose").Document<unknown, {}, Audit, {}, import("mongoose").DefaultSchemaOptions> & Audit & {
+        _id: import("mongoose").Types.ObjectId;
+    } & {
+        __v: number;
+    }, import("mongoose").Document<unknown, object, import("mongoose").Document<unknown, {}, Audit, {}, import("mongoose").DefaultSchemaOptions> & Audit & {
+        _id: import("mongoose").Types.ObjectId;
+    } & {
+        __v: number;
+    }, object, import("mongoose").DefaultSchemaOptions> & Omit<import("mongoose").Document<unknown, {}, Audit, {}, import("mongoose").DefaultSchemaOptions> & Audit & {
+        _id: import("mongoose").Types.ObjectId;
+    } & {
+        __v: number;
+    } & Required<{
+        _id: import("mongoose").Types.ObjectId;
+    }>, never> & object> | undefined;
+    globalId?: import("mongoose").SchemaDefinitionProperty<string, import("mongoose").Document<unknown, {}, Audit, {}, import("mongoose").DefaultSchemaOptions> & Audit & {
+        _id: import("mongoose").Types.ObjectId;
+    } & {
+        __v: number;
+    }, import("mongoose").Document<unknown, object, import("mongoose").Document<unknown, {}, Audit, {}, import("mongoose").DefaultSchemaOptions> & Audit & {
+        _id: import("mongoose").Types.ObjectId;
+    } & {
+        __v: number;
+    }, object, import("mongoose").DefaultSchemaOptions> & Omit<import("mongoose").Document<unknown, {}, Audit, {}, import("mongoose").DefaultSchemaOptions> & Audit & {
+        _id: import("mongoose").Types.ObjectId;
+    } & {
+        __v: number;
+    } & Required<{
+        _id: import("mongoose").Types.ObjectId;
+    }>, never> & object> | undefined;
+    author?: import("mongoose").SchemaDefinitionProperty<string, import("mongoose").Document<unknown, {}, Audit, {}, import("mongoose").DefaultSchemaOptions> & Audit & {
+        _id: import("mongoose").Types.ObjectId;
+    } & {
+        __v: number;
+    }, import("mongoose").Document<unknown, object, import("mongoose").Document<unknown, {}, Audit, {}, import("mongoose").DefaultSchemaOptions> & Audit & {
+        _id: import("mongoose").Types.ObjectId;
+    } & {
+        __v: number;
+    }, object, import("mongoose").DefaultSchemaOptions> & Omit<import("mongoose").Document<unknown, {}, Audit, {}, import("mongoose").DefaultSchemaOptions> & Audit & {
+        _id: import("mongoose").Types.ObjectId;
+    } & {
+        __v: number;
+    } & Required<{
+        _id: import("mongoose").Types.ObjectId;
+    }>, never> & object> | undefined;
+}, import("mongoose").Document<unknown, {}, Audit, {}, import("mongoose").DefaultSchemaOptions> & Audit & {
+    _id: import("mongoose").Types.ObjectId;
+} & {
+    __v: number;
+}>, import("mongoose").Document<unknown, {}, Audit, {}, import("mongoose").DefaultSchemaOptions> & Audit & {
+    _id: import("mongoose").Types.ObjectId;
+} & {
+    __v: number;
+}>;
+export declare const AUDIT_CHANGE_STREAM: import("mongodb").ChangeStream<any, any>;
+export {};
+//# sourceMappingURL=audit.model.d.ts.map

package/dist/audit/audit.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.model.d.ts","sourceRoot":"","sources":["../../src/audit/audit.model.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,EAAS,MAAM,EAAE,MAAM,UAAU,CAAC;AAKzC,MAAM,WAAW,KAAK;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,GAAG,CAAC;IACX,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,GAAG,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,aAAa,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;AAEpD,KAAK,UAAU,GAAG,KAAK,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAyB/D,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAyB,CAAC;AAEjD,eAAO,MAAM,mBAAmB,0CAM9B,CAAC"}

package/dist/audit/audit.service.d.ts

@@ -0,0 +1,17 @@
+import type { QueryFilter } from 'mongoose';
+import type { IConnection, PaginationOptions } from '../models';
+import { type Audit, type AuditDocument } from './audit.model';
+import type { Change } from './audit.types';
+export declare class AuditService {
+    private model;
+    findChangesPaginated<T>(options: PaginationOptions): Promise<IConnection<Change<T>>>;
+    findChangesPaginatedByCollectionAndOid<T>(oid: string, collection: string, options: PaginationOptions): Promise<IConnection<Change<T>>>;
+    findChangesPaginatedByCollection<T>(collection: string, options: PaginationOptions): Promise<IConnection<Change<T>>>;
+    findChanges<T>(filter?: QueryFilter<AuditDocument>): Promise<Change<T>[]>;
+    matches(audit: Audit, filter: {
+        collection: string;
+        type?: string;
+    }): boolean;
+    extractId(audit: Audit): string | undefined;
+}
+//# sourceMappingURL=audit.service.d.ts.map

package/dist/audit/audit.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.service.d.ts","sourceRoot":"","sources":["../../src/audit/audit.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAChE,OAAO,EAAE,KAAK,KAAK,EAAE,KAAK,aAAa,EAAc,MAAM,eAAe,CAAC;AAC3E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,qBAAa,YAAY;IACxB,OAAO,CAAC,KAAK,CAAc;IAErB,oBAAoB,CAAC,CAAC,EAAE,OAAO,EAAE,iBAAiB;IAIxD,sCAAsC,CAAC,CAAC,EACvC,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,iBAAiB;IAa3B,gCAAgC,CAAC,CAAC,EACjC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,iBAAiB;IAarB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAE,WAAW,CAAC,aAAa,CAAM;IAI5D,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;IAOnE,SAAS,CAAC,KAAK,EAAE,KAAK;CAGtB"}

package/dist/audit/audit.types.d.ts

@@ -0,0 +1,29 @@
+import type { Mutex } from 'async-mutex';
+import type mongoose from 'mongoose';
+import type { Audit } from './audit.model';
+export declare enum ChangeOperationType {
+    ADD = "add",
+    REPLACE = "replace",
+    REMOVE = "remove"
+}
+export declare enum CommitType {
+    INITIAL = "INITIAL",
+    UPDATE = "UPDATE",
+    TERMINAL = "TERMINAL"
+}
+export interface Change<T> extends Omit<Audit, 'state' | 'changes' | 'properties'> {
+    state: T;
+    properties: (keyof T)[];
+    changes: {
+        op: ChangeOperationType;
+        path: [keyof T];
+        value: any;
+    }[];
+}
+export type ChangeListeningOptions = {
+    author?: string;
+    omitFields?: string[];
+    models: mongoose.Model<any>[];
+    mutex?: Mutex;
+};
+//# sourceMappingURL=audit.types.d.ts.map

package/dist/audit/audit.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.types.d.ts","sourceRoot":"","sources":["../../src/audit/audit.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAC;AACrC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAE3C,oBAAY,mBAAmB;IAC9B,GAAG,QAAQ;IACX,OAAO,YAAY;IACnB,MAAM,WAAW;CACjB;AAED,oBAAY,UAAU;IACrB,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,QAAQ,aAAa;CACrB;AAED,MAAM,WAAW,MAAM,CAAC,CAAC,CACxB,SAAQ,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,YAAY,CAAC;IACvD,KAAK,EAAE,CAAC,CAAC;IACT,UAAU,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;IACxB,OAAO,EAAE;QAAE,EAAE,EAAE,mBAAmB,CAAC;QAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;QAAC,KAAK,EAAE,GAAG,CAAA;KAAE,EAAE,CAAC;CACpE;AAED,MAAM,MAAM,sBAAsB,GAAG;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;IAC9B,KAAK,CAAC,EAAE,KAAK,CAAC;CACd,CAAC"}

package/dist/audit/audit.utils.d.ts

@@ -0,0 +1,50 @@
+import { mongoose } from '../mongoose';
+import { type Audit } from './audit.model';
+import type { ChangeListeningOptions } from './audit.types';
+/**
+ * Processes MongoDB change streams and creates audit logs based on changes.
+ * @param {mongoose.mongo.ChangeStream<any, any>} changeStream - The MongoDB change stream.
+ * @param {Object} options - Configuration options for the audit process.
+ * @param {string[]} [options.omitFields] - Fields to omit when comparing states.
+ * @param {UserPrincipal} [options.user] - The user making the changes.
+ */
+export declare function auditChanges(changeStream: mongoose.mongo.ChangeStream<any, any>, options: {
+    omitFields?: string[];
+    author?: string;
+}): void;
+/**
+ * Executes a given asynchronous block of code while listening for changes in specified MongoDB models.
+ * Automatically closes all change streams after execution.
+ *
+ * @template T
+ * @param {() => Promise<T>} bloc - An asynchronous function to execute while monitoring changes.
+ * @param {Object} options - Configuration options for the change listener.
+ * @param {string} [options.author] - The author initiating the change listener (used for auditing purposes).
+ * @param {string[]} [options.omitFields] - Fields to omit from the auditing process.
+ * @param {mongoose.Model<any>[]} options.models - The Mongoose models to watch for changes.
+ * @param {Mutex} [options.mutex] - An optional mutex to ensure exclusive access during execution.
+ *
+ * @returns {Promise<T>} - Resolves with the result of the executed block of code.
+ *
+ * @throws {Error} - Propagates any errors from the `bloc` function or other internal operations.
+ */
+export declare function runWithChangesListening<T>(bloc: () => Promise<T>, options: ChangeListeningOptions): Promise<T>;
+export declare const AUDIT_EVENT = "event:audit";
+type RegisterAuditSubscriptionOptions<T extends {
+    publish<D>(topic: string, data: D): void;
+}> = {
+    pubsub: T;
+};
+/**
+ * Registers a subscription to MongoDB audit events, allowing real-time notifications of changes in the database.
+ * @param {Object} options - Configuration options for the subscription.
+ * @param {Object} options.pubsub - An object with a `publish` method to send notifications (e.g., a PubSub instance).
+ */
+export declare function registerAuditSubscription<T extends {
+    publish(topic: string, ...data: any): void;
+}>({ pubsub }: RegisterAuditSubscriptionOptions<T>): void;
+export type AuditPayload = {
+    [AUDIT_EVENT]: [payload: Audit];
+};
+export {};
+//# sourceMappingURL=audit.utils.d.ts.map

package/dist/audit/audit.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.utils.d.ts","sourceRoot":"","sources":["../../src/audit/audit.utils.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,EAAE,KAAK,KAAK,EAAc,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAM5D;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC3B,YAAY,EAAE,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,EACnD,OAAO,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,QAoEnD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EACxC,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACtB,OAAO,EAAE,sBAAsB,GAC7B,OAAO,CAAC,CAAC,CAAC,CAsBZ;AAED,eAAO,MAAM,WAAW,gBAAgB,CAAC;AAEzC,KAAK,gCAAgC,CACpC,CAAC,SAAS;IACT,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;CACzC,IACE;IACH,MAAM,EAAE,CAAC,CAAC;CACV,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,yBAAyB,CACxC,CAAC,SAAS;IAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,GAAG,IAAI,CAAA;CAAE,EACvD,EAAE,MAAM,EAAE,EAAE,gCAAgC,CAAC,CAAC,CAAC,QAmBhD;AAED,MAAM,MAAM,YAAY,GAAG;IAC1B,CAAC,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;CAChC,CAAC"}

package/dist/audit/index.d.ts

@@ -0,0 +1,5 @@
+export * from './audit.model';
+export * from './audit.service';
+export * from './audit.types';
+export * from './audit.utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/audit/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/audit/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC"}

package/dist/filters/filter.utils.d.ts

@@ -0,0 +1,112 @@
+import type { QueryFilter } from 'mongoose';
+export type SortDirection = 'ASC' | 'DESC';
+export type SortObject = Record<string, SortDirection>;
+export type LogicalOperator = 'AND' | 'OR';
+export type NumberOperator = 'EQ' | 'NE' | 'GT' | 'GTE' | 'LT' | 'LTE' | 'IN' | 'NOT_IN';
+export type StringOperator = 'EQ' | 'NE' | 'CONTAINS' | 'STARTS_WITH' | 'ENDS_WITH' | 'REGEX' | 'IN' | 'NOT_IN';
+export type ArrayOperator = 'ALL' | 'ANY' | 'NONE' | 'EXACT';
+export type ObjectIDOperator = 'EQ' | 'NE' | 'IN' | 'NOT_IN' | 'EXISTS';
+/**
+ * Generic filter types matching GraphQL inputs
+ */
+export interface StringFilter {
+    operator: StringOperator;
+    value?: string | null;
+    values?: string[] | null;
+    caseSensitive?: boolean | null;
+}
+export interface NumberFilter {
+    operator?: NumberOperator | null;
+    value?: number | null;
+    values?: number[] | null;
+}
+export interface DateRangeFilter {
+    from?: Date | string | null;
+    to?: Date | string | null;
+    eq?: Date | string | null;
+    before?: Date | string | null;
+    after?: Date | string | null;
+}
+export interface ArrayFilter {
+    operator?: ArrayOperator | null;
+    values: string[];
+}
+export interface ObjectIDFilter {
+    eq?: string | null;
+    ne?: string | null;
+    in?: string[] | null;
+    notIn?: string[] | null;
+    exists?: boolean | null;
+}
+export interface BooleanFilter {
+    eq: boolean;
+}
+/**
+ * Build MongoDB query from StringFilter
+ */
+export declare function buildStringFilter(filter?: StringFilter | null): any;
+/**
+ * Build MongoDB query from NumberFilter
+ */
+export declare function buildNumberFilter(filter?: NumberFilter | null): any;
+/**
+ * Build MongoDB query from DateRangeFilter
+ */
+export declare function buildDateRangeFilter(filter?: DateRangeFilter | null): any;
+/**
+ * Build MongoDB query from ArrayFilter
+ */
+export declare function buildArrayFilter(filter?: ArrayFilter | null): any;
+/**
+ * Build MongoDB query from ObjectIDFilter
+ */
+export declare function buildObjectIDFilter(filter?: ObjectIDFilter | null): any;
+/**
+ * Build MongoDB query from BooleanFilter
+ */
+export declare function buildBooleanFilter(filter?: BooleanFilter | null): any;
+/**
+ * Build MongoDB sort object from typed sort input
+ * @param sort Object with field names as keys and 'ASC' or 'DESC' as values
+ * @returns MongoDB sort object
+ */
+export declare function buildSort(sort?: SortObject | null): any;
+/**
+ * Shape of the `AND`/`OR`/`NOT` combinators every generated GraphQL
+ * `<Entity>Filter` input carries.
+ */
+export type LogicalFilterInput<TFilter> = {
+    AND?: TFilter[] | TFilter | null;
+    OR?: TFilter[] | TFilter | null;
+    NOT?: TFilter[] | TFilter | null;
+};
+/**
+ * Build the `$and`/`$or`/`$not` part of a Mongo filter from the recursive
+ * `AND`/`OR`/`NOT` combinators of a generated GraphQL filter input.
+ *
+ * Every module's `build<Entity>Filter` starts with the exact same block; this
+ * factors it out without changing behaviour. Call it first, then add the
+ * module's own leaf conditions onto the returned object:
+ *
+ * ```ts
+ * function buildBedFilter(filter?: BedFilter | null): QueryFilter<BedDocument> {
+ *   const mongoFilter = buildLogicalFilter(filter, buildBedFilter);
+ *   if (!filter) return mongoFilter;
+ *   addFilterCondition(mongoFilter, 'name', buildStringFilter(filter.name));
+ *   return mongoFilter;
+ * }
+ * ```
+ *
+ * Note `NOT` maps to `$not`, matching the behaviour of the hand-written
+ * blocks this replaces.
+ */
+export declare function buildLogicalFilter<TFilter, TDoc = any>(filter: TFilter | null | undefined, build: (filter?: TFilter | null) => QueryFilter<TDoc>): QueryFilter<TDoc>;
+/**
+ * Combine multiple filters with logical operator
+ */
+export declare function combineFilters(filters: Array<QueryFilter<any> | undefined>, operator?: LogicalOperator): QueryFilter<any>;
+/**
+ * Helper to add a filter condition to a query object
+ */
+export declare function addFilterCondition(query: QueryFilter<any>, field: string, condition: any): void;
+//# sourceMappingURL=filter.utils.d.ts.map

package/dist/filters/filter.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.utils.d.ts","sourceRoot":"","sources":["../../src/filters/filter.utils.ts"],"names":[],"mappings":"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"}

package/dist/filters/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The generated-GraphQL filter DSL.
+ *
+ * A separate entry point (`@nxgt/shared-mongo/filters`) rather than part of the
+ * package root, because it and the REST filter helpers in `../utils/filter.utils.ts`
+ * share three names with incompatible meanings — most sharply
+ * `buildArrayFilter`, whose default is an exact match on one side and `$in` on
+ * the other. Merging them would silently change what a query matches. It also
+ * carries its own `SortDirection` and `buildSort`, which mean something else
+ * again from the ones in `@nxgt/shared`.
+ *
+ * Import from here when the filters come from a GraphQL input; import from the
+ * package root when they come from REST query parameters.
+ */
+export * from './filter.utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/filters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/filters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,cAAc,gBAAgB,CAAC"}