@digitaldefiance/node-express-suite 3.7.4 → 3.7.6

package/src/models/user-role.js

@@ -1,9 +1,25 @@
 "use strict";
+/**
+ * @fileoverview User-role relationship model factory for MongoDB.
+ * Creates Mongoose model for many-to-many user-role associations.
+ * @module models/user-role
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = UserRoleModel;
 const enumerations_1 = require("../enumerations");
 const schema_collection_1 = require("../enumerations/schema-collection");
 const user_role_1 = require("../schemas/user-role");
+/**
+ * Creates a Mongoose model for user-role relationship documents.
+ * @template TModelName - Model name type (defaults to BaseModelName)
+ * @template TCollection - Collection name type (defaults to SchemaCollection)
+ * @template TID - Platform ID type (defaults to Buffer)
+ * @param {Connection} connection - Mongoose connection instance
+ * @param {TModelName} modelName - Model name (defaults to 'UserRole')
+ * @param {TCollection} collection - Collection name (defaults to 'userRoles')
+ * @param {Schema} schema - Mongoose schema (defaults to UserRoleSchema)
+ * @returns {Model<IUserRoleDocument<TID>>} Configured Mongoose model
+ */
 function UserRoleModel(connection, modelName = enumerations_1.BaseModelName.UserRole, collection = schema_collection_1.SchemaCollection.UserRole, schema = user_role_1.UserRoleSchema) {
     return connection.model(modelName, schema, collection);
 }

package/src/models/user-role.js.map

@@ -1 +1 @@
-{"version":3,"file":"user-role.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/models/user-role.ts"],"names":[],"mappings":";;AAOA,gCAWC;AAhBD,kDAAgD;AAChD,yEAAqE;AACrE,oDAAsD;AAGtD,SAAwB,aAAa,CAKnC,UAAsB,EACtB,YAAwB,4BAAa,CAAC,QAAsB,EAC5D,aAA0B,oCAAgB,CAAC,QAAuB,EAClE,SAAiB,0BAAc;IAE/B,OAAO,UAAU,CAAC,KAAK,CAAuB,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;AAC/E,CAAC"}
+{"version":3,"file":"user-role.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/models/user-role.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAoBH,gCAeC;AA/BD,kDAAgD;AAChD,yEAAqE;AACrE,oDAAsD;AAGtD;;;;;;;;;;GAUG;AACH,SAAwB,aAAa,CAKnC,UAAsB,EACtB,YAAwB,4BAAa,CAAC,QAAsB,EAC5D,aAA0B,oCAAgB,CAAC,QAAuB,EAClE,SAAiB,0BAAc;IAE/B,OAAO,UAAU,CAAC,KAAK,CACrB,SAAS,EACT,MAAM,EACN,UAAU,CACX,CAAC;AACJ,CAAC"}

package/src/models/user.d.ts

@@ -1,8 +1,24 @@
+/**
+ * @fileoverview User model factory for MongoDB.
+ * Creates Mongoose model for user management with authentication.
+ * @module models/user
+ */
 import { Connection, Model, Schema } from '@digitaldefiance/mongoose-types';
 import { IUserDocument } from '../documents/user';
 import { BaseModelName } from '../enumerations';
 import { SchemaCollection } from '../enumerations/schema-collection';
 import type { PlatformID } from '@digitaldefiance/node-ecies-lib';
-export declare function UserModel<TModelName extends string = BaseModelName, TCollection extends string = SchemaCollection, I extends PlatformID = Buffer>(connection: Connection, modelName?: TModelName, collection?: TCollection, schema?: Schema): Model<IUserDocument<string, I>>;
+/**
+ * Creates a Mongoose model for user documents.
+ * @template TModelName - Model name type (defaults to BaseModelName)
+ * @template TCollection - Collection name type (defaults to SchemaCollection)
+ * @template TID - Platform ID type (defaults to Buffer)
+ * @param {Connection} connection - Mongoose connection instance
+ * @param {TModelName} modelName - Model name (defaults to 'User')
+ * @param {TCollection} collection - Collection name (defaults to 'users')
+ * @param {Schema} schema - Mongoose schema (defaults to UserSchema)
+ * @returns {Model<IUserDocument<string, TID>>} Configured Mongoose model
+ */
+export declare function UserModel<TModelName extends string = BaseModelName, TCollection extends string = SchemaCollection, TID extends PlatformID = Buffer>(connection: Connection, modelName?: TModelName, collection?: TCollection, schema?: Schema): Model<IUserDocument<string, TID>>;
 export default UserModel;
 //# sourceMappingURL=user.d.ts.map

package/src/models/user.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/models/user.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAErE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAElE,wBAAgB,SAAS,CACvB,UAAU,SAAS,MAAM,GAAG,aAAa,EACzC,WAAW,SAAS,MAAM,GAAG,gBAAgB,EAC7C,CAAC,SAAS,UAAU,GAAG,MAAM,EAE7B,UAAU,EAAE,UAAU,EACtB,SAAS,GAAE,UAA6C,EACxD,UAAU,GAAE,WAAkD,EAC9D,MAAM,GAAE,MAAmB,GAC1B,KAAK,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAMjC;AAED,eAAe,SAAS,CAAC"}
+{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/models/user.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAErE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAElE;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CACvB,UAAU,SAAS,MAAM,GAAG,aAAa,EACzC,WAAW,SAAS,MAAM,GAAG,gBAAgB,EAC7C,GAAG,SAAS,UAAU,GAAG,MAAM,EAE/B,UAAU,EAAE,UAAU,EACtB,SAAS,GAAE,UAA6C,EACxD,UAAU,GAAE,WAAkD,EAC9D,MAAM,GAAE,MAAmB,GAC1B,KAAK,CAAC,aAAa,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAMnC;AAED,eAAe,SAAS,CAAC"}

package/src/models/user.js

@@ -1,9 +1,25 @@
 "use strict";
+/**
+ * @fileoverview User model factory for MongoDB.
+ * Creates Mongoose model for user management with authentication.
+ * @module models/user
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UserModel = UserModel;
 const enumerations_1 = require("../enumerations");
 const schema_collection_1 = require("../enumerations/schema-collection");
 const user_1 = require("../schemas/user");
+/**
+ * Creates a Mongoose model for user documents.
+ * @template TModelName - Model name type (defaults to BaseModelName)
+ * @template TCollection - Collection name type (defaults to SchemaCollection)
+ * @template TID - Platform ID type (defaults to Buffer)
+ * @param {Connection} connection - Mongoose connection instance
+ * @param {TModelName} modelName - Model name (defaults to 'User')
+ * @param {TCollection} collection - Collection name (defaults to 'users')
+ * @param {Schema} schema - Mongoose schema (defaults to UserSchema)
+ * @returns {Model<IUserDocument<string, TID>>} Configured Mongoose model
+ */
 function UserModel(connection, modelName = enumerations_1.BaseModelName.User, collection = schema_collection_1.SchemaCollection.User, schema = user_1.UserSchema) {
     return connection.model(modelName, schema, collection);
 }

package/src/models/user.js.map

@@ -1 +1 @@
-{"version":3,"file":"user.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/models/user.ts"],"names":[],"mappings":";;AAOA,8BAeC;AApBD,kDAAgD;AAChD,yEAAqE;AACrE,0CAA6C;AAG7C,SAAgB,SAAS,CAKvB,UAAsB,EACtB,YAAwB,4BAAa,CAAC,IAAkB,EACxD,aAA0B,oCAAgB,CAAC,IAAmB,EAC9D,SAAiB,iBAAU;IAE3B,OAAO,UAAU,CAAC,KAAK,CACrB,SAAS,EACT,MAAM,EACN,UAAU,CACX,CAAC;AACJ,CAAC;AAED,kBAAe,SAAS,CAAC"}
+{"version":3,"file":"user.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/models/user.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAoBH,8BAeC;AA/BD,kDAAgD;AAChD,yEAAqE;AACrE,0CAA6C;AAG7C;;;;;;;;;;GAUG;AACH,SAAgB,SAAS,CAKvB,UAAsB,EACtB,YAAwB,4BAAa,CAAC,IAAkB,EACxD,aAA0B,oCAAgB,CAAC,IAAmB,EAC9D,SAAiB,iBAAU;IAE3B,OAAO,UAAU,CAAC,KAAK,CACrB,SAAS,EACT,MAAM,EACN,UAAU,CACX,CAAC;AACJ,CAAC;AAED,kBAAe,SAAS,CAAC"}

package/src/pipeline/pipeline-builder.d.ts

@@ -1,4 +1,12 @@
+/**
+ * @fileoverview Pipeline builder for Express middleware chains.
+ * Provides fluent API for building middleware pipelines.
+ * @module pipeline/pipeline-builder
+ */
 import { RequestHandler } from 'express';
+/**
+ * Builder for creating Express middleware pipelines.
+ */
 export declare class Pipeline {
     private middleware;
     static create(): Pipeline;

package/src/pipeline/pipeline-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline-builder.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/pipeline/pipeline-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC,qBAAa,QAAQ;IACnB,OAAO,CAAC,UAAU,CAAwB;IAE1C,MAAM,CAAC,MAAM,IAAI,QAAQ;IAIzB,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAKlC,KAAK,IAAI,cAAc,EAAE;CAG1B"}
+{"version":3,"file":"pipeline-builder.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/pipeline/pipeline-builder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC;;GAEG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,UAAU,CAAwB;IAE1C,MAAM,CAAC,MAAM,IAAI,QAAQ;IAIzB,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAKlC,KAAK,IAAI,cAAc,EAAE;CAG1B"}

package/src/pipeline/pipeline-builder.js

@@ -1,6 +1,14 @@
 "use strict";
+/**
+ * @fileoverview Pipeline builder for Express middleware chains.
+ * Provides fluent API for building middleware pipelines.
+ * @module pipeline/pipeline-builder
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Pipeline = void 0;
+/**
+ * Builder for creating Express middleware pipelines.
+ */
 class Pipeline {
     middleware = [];
     static create() {

package/src/pipeline/pipeline-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline-builder.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/pipeline/pipeline-builder.ts"],"names":[],"mappings":";;;AAEA,MAAa,QAAQ;IACX,UAAU,GAAqB,EAAE,CAAC;IAE1C,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,QAAQ,EAAE,CAAC;IACxB,CAAC;IAED,GAAG,CAAC,OAAuB;QACzB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK;QACH,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;CACF;AAfD,4BAeC"}
+{"version":3,"file":"pipeline-builder.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/pipeline/pipeline-builder.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAIH;;GAEG;AACH,MAAa,QAAQ;IACX,UAAU,GAAqB,EAAE,CAAC;IAE1C,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,QAAQ,EAAE,CAAC;IACxB,CAAC;IAED,GAAG,CAAC,OAAuB;QACzB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK;QACH,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;CACF;AAfD,4BAeC"}

package/src/plugins/plugin-interface.d.ts

@@ -1,5 +1,14 @@
+/**
+ * @fileoverview Application plugin interface.
+ * Defines contract for application plugins.
+ * @module plugins/plugin-interface
+ */
 import type { PlatformID } from '@digitaldefiance/node-ecies-lib';
 import { IApplication } from '../interfaces/application';
+/**
+ * Interface for application plugins.
+ * @template TID - Platform ID type (defaults to Buffer)
+ */
 export interface IApplicationPlugin<TID extends PlatformID = Buffer> {
     readonly name: string;
     readonly version?: string;

package/src/plugins/plugin-interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-interface.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/plugins/plugin-interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,MAAM,WAAW,kBAAkB,CAAC,GAAG,SAAS,UAAU,GAAG,MAAM;IACjE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB"}
+{"version":3,"file":"plugin-interface.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/plugins/plugin-interface.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD;;;GAGG;AACH,MAAM,WAAW,kBAAkB,CAAC,GAAG,SAAS,UAAU,GAAG,MAAM;IACjE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB"}

package/src/plugins/plugin-interface.js

@@ -1,3 +1,8 @@
 "use strict";
+/**
+ * @fileoverview Application plugin interface.
+ * Defines contract for application plugins.
+ * @module plugins/plugin-interface
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=plugin-interface.js.map

package/src/plugins/plugin-interface.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-interface.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/plugins/plugin-interface.ts"],"names":[],"mappings":""}
+{"version":3,"file":"plugin-interface.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/plugins/plugin-interface.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/src/plugins/plugin-manager.d.ts

@@ -1,6 +1,15 @@
+/**
+ * @fileoverview Plugin manager for application plugins.
+ * Manages registration and lifecycle of application plugins.
+ * @module plugins/plugin-manager
+ */
 import type { PlatformID } from '@digitaldefiance/node-ecies-lib';
 import { IApplication } from '../interfaces/application';
 import { IApplicationPlugin } from './plugin-interface';
+/**
+ * Manager for application plugins.
+ * @template TID - Platform ID type (defaults to Buffer)
+ */
 export declare class PluginManager<TID extends PlatformID = Buffer> {
     private plugins;
     private initialized;

package/src/plugins/plugin-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-manager.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/plugins/plugin-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,qBAAa,aAAa,CAAC,GAAG,SAAS,UAAU,GAAG,MAAM;IACxD,OAAO,CAAC,OAAO,CAA8C;IAC7D,OAAO,CAAC,WAAW,CAAS;IAE5B,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,CAAC,GAAG,IAAI;IAYzC,OAAO,CAAC,GAAG,EAAE,YAAY,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAAC,GAAG,CAAC,GAAG,SAAS;IAItD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAG3B"}
+{"version":3,"file":"plugin-manager.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/plugins/plugin-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD;;;GAGG;AACH,qBAAa,aAAa,CAAC,GAAG,SAAS,UAAU,GAAG,MAAM;IACxD,OAAO,CAAC,OAAO,CAA8C;IAC7D,OAAO,CAAC,WAAW,CAAS;IAE5B,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,CAAC,GAAG,IAAI;IAYzC,OAAO,CAAC,GAAG,EAAE,YAAY,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAAC,GAAG,CAAC,GAAG,SAAS;IAItD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAG3B"}

package/src/plugins/plugin-manager.js

@@ -1,6 +1,15 @@
 "use strict";
+/**
+ * @fileoverview Plugin manager for application plugins.
+ * Manages registration and lifecycle of application plugins.
+ * @module plugins/plugin-manager
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PluginManager = void 0;
+/**
+ * Manager for application plugins.
+ * @template TID - Platform ID type (defaults to Buffer)
+ */
 class PluginManager {
     plugins = new Map();
     initialized = false;

package/src/plugins/plugin-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-manager.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/plugins/plugin-manager.ts"],"names":[],"mappings":";;;AAIA,MAAa,aAAa;IAChB,OAAO,GAAG,IAAI,GAAG,EAAmC,CAAC;IACrD,WAAW,GAAG,KAAK,CAAC;IAE5B,QAAQ,CAAC,MAA+B;QACtC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CACb,0BAA0B,MAAM,CAAC,IAAI,uBAAuB,CAC7D,CAAC;QACJ,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,UAAU,MAAM,CAAC,IAAI,qBAAqB,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,GAAsB;QAClC,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3C,MAAM,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,OAAO;QACX,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3C,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;gBAChB,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YACtB,CAAC;QACH,CAAC;IACH,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;CACF;AAtCD,sCAsCC"}
+{"version":3,"file":"plugin-manager.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/plugins/plugin-manager.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAMH;;;GAGG;AACH,MAAa,aAAa;IAChB,OAAO,GAAG,IAAI,GAAG,EAAmC,CAAC;IACrD,WAAW,GAAG,KAAK,CAAC;IAE5B,QAAQ,CAAC,MAA+B;QACtC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CACb,0BAA0B,MAAM,CAAC,IAAI,uBAAuB,CAC7D,CAAC;QACJ,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,UAAU,MAAM,CAAC,IAAI,qBAAqB,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,GAAsB;QAClC,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3C,MAAM,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,OAAO;QACX,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3C,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;gBAChB,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YACtB,CAAC;QACH,CAAC;IACH,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;CACF;AAtCD,sCAsCC"}

package/src/registry/email-service-registry.d.ts

@@ -1,27 +1,49 @@
+/**
+ * @fileoverview Email service registry singleton.
+ * Manages email service registration and retrieval.
+ * @module registry/email-service-registry
+ */
 import { IEmailService } from '../interfaces/email-service';
+/**
+ * Singleton registry for email service.
+ */
 declare class EmailServiceRegistry {
     private service?;
+    /**
+     * Registers an email service.
+     * @param {IEmailService} service - Email service implementation
+     */
     setService(service: IEmailService): void;
+    /**
+     * Retrieves the registered email service.
+     * @returns {IEmailService} Email service instance
+     * @throws {TranslatableSuiteError} If no service is registered
+     */
     getService(): IEmailService;
     /**
-     * Check if any email service is registered
+     * Check if any email service is registered.
+     * @returns {boolean} True if service is registered
      */
     hasService(): boolean;
     /**
-     * Check if the registered service is an instance of a specific class
-     * @param serviceClass The class/constructor to check against
-     * @returns true if the registered service is an instance of the given class
+     * Check if the registered service is an instance of a specific class.
+     * @template T - Email service type
+     * @param {Function} serviceClass - The class/constructor to check against
+     * @returns {boolean} True if the registered service is an instance of the given class
      * @example
      * emailServiceRegistry.isServiceType(EmailService) // true if EmailService is registered
      * emailServiceRegistry.isServiceType(DummyEmailService) // true if DummyEmailService is registered
      */
     isServiceType<T extends IEmailService>(serviceClass: new (...args: any[]) => T): boolean;
     /**
-     * Get the constructor name of the registered service
-     * @returns The name of the service class, or undefined if no service is registered
+     * Get the constructor name of the registered service.
+     * @returns {string | undefined} The name of the service class, or undefined if no service is registered
      */
     getServiceTypeName(): string | undefined;
 }
+/**
+ * Singleton instance of EmailServiceRegistry.
+ */
 export declare const emailServiceRegistry: EmailServiceRegistry;
 export {};
 //# sourceMappingURL=email-service-registry.d.ts.map

package/src/registry/email-service-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"email-service-registry.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/registry/email-service-registry.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D,cAAM,oBAAoB;IACxB,OAAO,CAAC,OAAO,CAAC,CAAgB;IAEhC,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAIxC,UAAU,IAAI,aAAa;IAS3B;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;;;;;;OAOG;IACH,aAAa,CAAC,CAAC,SAAS,aAAa,EACnC,YAAY,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GACtC,OAAO;IAIV;;;OAGG;IACH,kBAAkB,IAAI,MAAM,GAAG,SAAS;CAGzC;AAED,eAAO,MAAM,oBAAoB,sBAA6B,CAAC"}
+{"version":3,"file":"email-service-registry.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/registry/email-service-registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D;;GAEG;AACH,cAAM,oBAAoB;IACxB,OAAO,CAAC,OAAO,CAAC,CAAgB;IAEhC;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAIxC;;;;OAIG;IACH,UAAU,IAAI,aAAa;IAS3B;;;OAGG;IACH,UAAU,IAAI,OAAO;IAIrB;;;;;;;;OAQG;IACH,aAAa,CAAC,CAAC,SAAS,aAAa,EACnC,YAAY,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GACtC,OAAO;IAIV;;;OAGG;IACH,kBAAkB,IAAI,MAAM,GAAG,SAAS;CAGzC;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,sBAA6B,CAAC"}

package/src/registry/email-service-registry.js

@@ -1,12 +1,29 @@
 "use strict";
+/**
+ * @fileoverview Email service registry singleton.
+ * Manages email service registration and retrieval.
+ * @module registry/email-service-registry
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.emailServiceRegistry = void 0;
 const suite_core_lib_1 = require("@digitaldefiance/suite-core-lib");
+/**
+ * Singleton registry for email service.
+ */
 class EmailServiceRegistry {
     service;
+    /**
+     * Registers an email service.
+     * @param {IEmailService} service - Email service implementation
+     */
     setService(service) {
         this.service = service;
     }
+    /**
+     * Retrieves the registered email service.
+     * @returns {IEmailService} Email service instance
+     * @throws {TranslatableSuiteError} If no service is registered
+     */
     getService() {
         if (!this.service) {
             throw new suite_core_lib_1.TranslatableSuiteError(suite_core_lib_1.SuiteCoreStringKey.Error_EmailService_NotConfigured);
@@ -14,15 +31,17 @@ class EmailServiceRegistry {
         return this.service;
     }
     /**
-     * Check if any email service is registered
+     * Check if any email service is registered.
+     * @returns {boolean} True if service is registered
      */
     hasService() {
         return this.service !== undefined;
     }
     /**
-     * Check if the registered service is an instance of a specific class
-     * @param serviceClass The class/constructor to check against
-     * @returns true if the registered service is an instance of the given class
+     * Check if the registered service is an instance of a specific class.
+     * @template T - Email service type
+     * @param {Function} serviceClass - The class/constructor to check against
+     * @returns {boolean} True if the registered service is an instance of the given class
      * @example
      * emailServiceRegistry.isServiceType(EmailService) // true if EmailService is registered
      * emailServiceRegistry.isServiceType(DummyEmailService) // true if DummyEmailService is registered
@@ -31,12 +50,15 @@ class EmailServiceRegistry {
         return this.service !== undefined && this.service instanceof serviceClass;
     }
     /**
-     * Get the constructor name of the registered service
-     * @returns The name of the service class, or undefined if no service is registered
+     * Get the constructor name of the registered service.
+     * @returns {string | undefined} The name of the service class, or undefined if no service is registered
      */
     getServiceTypeName() {
         return this.service?.constructor.name;
     }
 }
+/**
+ * Singleton instance of EmailServiceRegistry.
+ */
 exports.emailServiceRegistry = new EmailServiceRegistry();
 //# sourceMappingURL=email-service-registry.js.map

package/src/registry/email-service-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"email-service-registry.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/registry/email-service-registry.ts"],"names":[],"mappings":";;;AAAA,oEAGyC;AAGzC,MAAM,oBAAoB;IAChB,OAAO,CAAiB;IAEhC,UAAU,CAAC,OAAsB;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,UAAU;QACR,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,uCAAsB,CAC9B,mCAAkB,CAAC,gCAAgC,CACpD,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC;IACpC,CAAC;IAED;;;;;;;OAOG;IACH,aAAa,CACX,YAAuC;QAEvC,OAAO,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,YAAY,YAAY,CAAC;IAC5E,CAAC;IAED;;;OAGG;IACH,kBAAkB;QAChB,OAAO,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC;IACxC,CAAC;CACF;AAEY,QAAA,oBAAoB,GAAG,IAAI,oBAAoB,EAAE,CAAC"}
+{"version":3,"file":"email-service-registry.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/registry/email-service-registry.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,oEAGyC;AAGzC;;GAEG;AACH,MAAM,oBAAoB;IAChB,OAAO,CAAiB;IAEhC;;;OAGG;IACH,UAAU,CAAC,OAAsB;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACH,UAAU;QACR,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,uCAAsB,CAC9B,mCAAkB,CAAC,gCAAgC,CACpD,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;;OAGG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC;IACpC,CAAC;IAED;;;;;;;;OAQG;IACH,aAAa,CACX,YAAuC;QAEvC,OAAO,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,YAAY,YAAY,CAAC;IAC5E,CAAC;IAED;;;OAGG;IACH,kBAAkB;QAChB,OAAO,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC;IACxC,CAAC;CACF;AAED;;GAEG;AACU,QAAA,oBAAoB,GAAG,IAAI,oBAAoB,EAAE,CAAC"}

package/src/responses/response-builder.d.ts

@@ -1,23 +1,102 @@
+/**
+ * @fileoverview Response builder for API responses.
+ * Provides fluent API for building HTTP responses with status codes.
+ * @module responses/response-builder
+ */
 import { SuiteCoreStringKey } from '@digitaldefiance/suite-core-lib';
 import { IStatusCodeResponse } from '../interfaces';
 import { ApiResponse } from '../types';
+/**
+ * Builder for constructing API responses with fluent interface.
+ * @template T - Response type extending ApiResponse
+ */
 export declare class ResponseBuilder<T extends ApiResponse = ApiResponse> {
     private statusCode;
     private responseData;
     private responseHeaders?;
+    /**
+     * Creates a 200 OK response builder.
+     * @template T - Response type
+     * @returns {ResponseBuilder<T>} Response builder instance
+     */
     static ok<T extends ApiResponse = ApiResponse>(): ResponseBuilder<T>;
+    /**
+     * Creates a 201 Created response builder.
+     * @template T - Response type
+     * @returns {ResponseBuilder<T>} Response builder instance
+     */
     static created<T extends ApiResponse = ApiResponse>(): ResponseBuilder<T>;
+    /**
+     * Creates a 202 Accepted response builder.
+     * @template T - Response type
+     * @returns {ResponseBuilder<T>} Response builder instance
+     */
     static accepted<T extends ApiResponse = ApiResponse>(): ResponseBuilder<T>;
+    /**
+     * Creates a 204 No Content response builder.
+     * @returns {ResponseBuilder<ApiResponse>} Response builder instance
+     */
     static noContent(): ResponseBuilder<ApiResponse>;
+    /**
+     * Creates a 400 Bad Request response builder.
+     * @template T - Response type
+     * @returns {ResponseBuilder<T>} Response builder instance
+     */
     static badRequest<T extends ApiResponse = ApiResponse>(): ResponseBuilder<T>;
+    /**
+     * Creates a 401 Unauthorized response builder.
+     * @template T - Response type
+     * @returns {ResponseBuilder<T>} Response builder instance
+     */
     static unauthorized<T extends ApiResponse = ApiResponse>(): ResponseBuilder<T>;
+    /**
+     * Creates a 403 Forbidden response builder.
+     * @template T - Response type
+     * @returns {ResponseBuilder<T>} Response builder instance
+     */
     static forbidden<T extends ApiResponse = ApiResponse>(): ResponseBuilder<T>;
+    /**
+     * Creates a 404 Not Found response builder.
+     * @template T - Response type
+     * @returns {ResponseBuilder<T>} Response builder instance
+     */
     static notFound<T extends ApiResponse = ApiResponse>(): ResponseBuilder<T>;
+    /**
+     * Creates a 500 Internal Server Error response builder.
+     * @template T - Response type
+     * @returns {ResponseBuilder<T>} Response builder instance
+     */
     static error<T extends ApiResponse = ApiResponse>(): ResponseBuilder<T>;
+    /**
+     * Sets the HTTP status code.
+     * @param {number} code - HTTP status code
+     * @returns {this} This builder instance for chaining
+     */
     status(code: number): this;
+    /**
+     * Sets a translatable message on the response.
+     * @param {SuiteCoreStringKey} key - Translation key
+     * @param {Record<string, string>} [params] - Translation parameters
+     * @param {string} [language] - Target language
+     * @returns {this} This builder instance for chaining
+     */
     message(key: SuiteCoreStringKey, params?: Record<string, string>, language?: string): this;
+    /**
+     * Sets response data.
+     * @param {Partial<T>} data - Response data to merge
+     * @returns {this} This builder instance for chaining
+     */
     data(data: Partial<T>): this;
+    /**
+     * Sets response headers.
+     * @param {Record<string, string>} headers - HTTP headers
+     * @returns {this} This builder instance for chaining
+     */
     headers(headers: Record<string, string>): this;
+    /**
+     * Builds the final response object.
+     * @returns {IStatusCodeResponse<T>} Complete response with status code and headers
+     */
     build(): IStatusCodeResponse<T>;
 }
 export declare const Response: typeof ResponseBuilder;

package/src/responses/response-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"response-builder.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/responses/response-builder.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,kBAAkB,EACnB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,qBAAa,eAAe,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW;IAC9D,OAAO,CAAC,UAAU,CAAe;IACjC,OAAO,CAAC,YAAY,CAAkB;IACtC,OAAO,CAAC,eAAe,CAAC,CAAyB;IAEjD,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,KAAK,eAAe,CAAC,CAAC,CAAC;IAIpE,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,KAAK,eAAe,CAAC,CAAC,CAAC;IAIzE,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,KAAK,eAAe,CAAC,CAAC,CAAC;IAI1E,MAAM,CAAC,SAAS,IAAI,eAAe,CAAC,WAAW,CAAC;IAIhD,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,KAAK,eAAe,CAAC,CAAC,CAAC;IAI5E,MAAM,CAAC,YAAY,CACjB,CAAC,SAAS,WAAW,GAAG,WAAW,KAChC,eAAe,CAAC,CAAC,CAAC;IAIvB,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,KAAK,eAAe,CAAC,CAAC,CAAC;IAI3E,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,KAAK,eAAe,CAAC,CAAC,CAAC;IAI1E,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,KAAK,eAAe,CAAC,CAAC,CAAC;IAIvE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK1B,OAAO,CACL,GAAG,EAAE,kBAAkB,EACvB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,QAAQ,CAAC,EAAE,MAAM,GAChB,IAAI;IAMP,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAK5B,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAK9C,KAAK,IAAI,mBAAmB,CAAC,CAAC,CAAC;CAOhC;AAED,eAAO,MAAM,QAAQ,wBAAkB,CAAC"}
+{"version":3,"file":"response-builder.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/responses/response-builder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAEL,kBAAkB,EACnB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC;;;GAGG;AACH,qBAAa,eAAe,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW;IAC9D,OAAO,CAAC,UAAU,CAAe;IACjC,OAAO,CAAC,YAAY,CAAkB;IACtC,OAAO,CAAC,eAAe,CAAC,CAAyB;IAEjD;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,KAAK,eAAe,CAAC,CAAC,CAAC;IAIpE;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,KAAK,eAAe,CAAC,CAAC,CAAC;IAIzE;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,KAAK,eAAe,CAAC,CAAC,CAAC;IAI1E;;;OAGG;IACH,MAAM,CAAC,SAAS,IAAI,eAAe,CAAC,WAAW,CAAC;IAIhD;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,KAAK,eAAe,CAAC,CAAC,CAAC;IAI5E;;;;OAIG;IACH,MAAM,CAAC,YAAY,CACjB,CAAC,SAAS,WAAW,GAAG,WAAW,KAChC,eAAe,CAAC,CAAC,CAAC;IAIvB;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,KAAK,eAAe,CAAC,CAAC,CAAC;IAI3E;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,KAAK,eAAe,CAAC,CAAC,CAAC;IAI1E;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,KAAK,eAAe,CAAC,CAAC,CAAC;IAIvE;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK1B;;;;;;OAMG;IACH,OAAO,CACL,GAAG,EAAE,kBAAkB,EACvB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,QAAQ,CAAC,EAAE,MAAM,GAChB,IAAI;IAMP;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAK5B;;;;OAIG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAK9C;;;OAGG;IACH,KAAK,IAAI,mBAAmB,CAAC,CAAC,CAAC;CAOhC;AAED,eAAO,MAAM,QAAQ,wBAAkB,CAAC"}

package/src/responses/response-builder.js

@@ -1,55 +1,134 @@
 "use strict";
+/**
+ * @fileoverview Response builder for API responses.
+ * Provides fluent API for building HTTP responses with status codes.
+ * @module responses/response-builder
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Response = exports.ResponseBuilder = void 0;
 const suite_core_lib_1 = require("@digitaldefiance/suite-core-lib");
+/**
+ * Builder for constructing API responses with fluent interface.
+ * @template T - Response type extending ApiResponse
+ */
 class ResponseBuilder {
     statusCode = 200;
     responseData = {};
     responseHeaders;
+    /**
+     * Creates a 200 OK response builder.
+     * @template T - Response type
+     * @returns {ResponseBuilder<T>} Response builder instance
+     */
     static ok() {
         return new ResponseBuilder().status(200);
     }
+    /**
+     * Creates a 201 Created response builder.
+     * @template T - Response type
+     * @returns {ResponseBuilder<T>} Response builder instance
+     */
     static created() {
         return new ResponseBuilder().status(201);
     }
+    /**
+     * Creates a 202 Accepted response builder.
+     * @template T - Response type
+     * @returns {ResponseBuilder<T>} Response builder instance
+     */
     static accepted() {
         return new ResponseBuilder().status(202);
     }
+    /**
+     * Creates a 204 No Content response builder.
+     * @returns {ResponseBuilder<ApiResponse>} Response builder instance
+     */
     static noContent() {
         return new ResponseBuilder().status(204);
     }
+    /**
+     * Creates a 400 Bad Request response builder.
+     * @template T - Response type
+     * @returns {ResponseBuilder<T>} Response builder instance
+     */
     static badRequest() {
         return new ResponseBuilder().status(400);
     }
+    /**
+     * Creates a 401 Unauthorized response builder.
+     * @template T - Response type
+     * @returns {ResponseBuilder<T>} Response builder instance
+     */
     static unauthorized() {
         return new ResponseBuilder().status(401);
     }
+    /**
+     * Creates a 403 Forbidden response builder.
+     * @template T - Response type
+     * @returns {ResponseBuilder<T>} Response builder instance
+     */
     static forbidden() {
         return new ResponseBuilder().status(403);
     }
+    /**
+     * Creates a 404 Not Found response builder.
+     * @template T - Response type
+     * @returns {ResponseBuilder<T>} Response builder instance
+     */
     static notFound() {
         return new ResponseBuilder().status(404);
     }
+    /**
+     * Creates a 500 Internal Server Error response builder.
+     * @template T - Response type
+     * @returns {ResponseBuilder<T>} Response builder instance
+     */
     static error() {
         return new ResponseBuilder().status(500);
     }
+    /**
+     * Sets the HTTP status code.
+     * @param {number} code - HTTP status code
+     * @returns {this} This builder instance for chaining
+     */
     status(code) {
         this.statusCode = code;
         return this;
     }
+    /**
+     * Sets a translatable message on the response.
+     * @param {SuiteCoreStringKey} key - Translation key
+     * @param {Record<string, string>} [params] - Translation parameters
+     * @param {string} [language] - Target language
+     * @returns {this} This builder instance for chaining
+     */
     message(key, params, language) {
         this.responseData.message =
             (0, suite_core_lib_1.getSuiteCoreTranslation)(key, params, language);
         return this;
     }
+    /**
+     * Sets response data.
+     * @param {Partial<T>} data - Response data to merge
+     * @returns {this} This builder instance for chaining
+     */
     data(data) {
         this.responseData = { ...this.responseData, ...data };
         return this;
     }
+    /**
+     * Sets response headers.
+     * @param {Record<string, string>} headers - HTTP headers
+     * @returns {this} This builder instance for chaining
+     */
     headers(headers) {
         this.responseHeaders = headers;
         return this;
     }
+    /**
+     * Builds the final response object.
+     * @returns {IStatusCodeResponse<T>} Complete response with status code and headers
+     */
     build() {
         return {
             statusCode: this.statusCode,

package/src/responses/response-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"response-builder.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/responses/response-builder.ts"],"names":[],"mappings":";;;AACA,oEAGyC;AAIzC,MAAa,eAAe;IAClB,UAAU,GAAW,GAAG,CAAC;IACzB,YAAY,GAAe,EAAE,CAAC;IAC9B,eAAe,CAA0B;IAEjD,MAAM,CAAC,EAAE;QACP,OAAO,IAAI,eAAe,EAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,CAAC,OAAO;QACZ,OAAO,IAAI,eAAe,EAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,CAAC,QAAQ;QACb,OAAO,IAAI,eAAe,EAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,CAAC,SAAS;QACd,OAAO,IAAI,eAAe,EAAe,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,CAAC,UAAU;QACf,OAAO,IAAI,eAAe,EAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,CAAC,YAAY;QAGjB,OAAO,IAAI,eAAe,EAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,CAAC,SAAS;QACd,OAAO,IAAI,eAAe,EAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,CAAC,QAAQ;QACb,OAAO,IAAI,eAAe,EAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,CAAC,KAAK;QACV,OAAO,IAAI,eAAe,EAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,CAAC,IAAY;QACjB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CACL,GAAuB,EACvB,MAA+B,EAC/B,QAAiB;QAEhB,IAAI,CAAC,YAAyC,CAAC,OAAO;YACrD,IAAA,wCAAuB,EAAC,GAAG,EAAE,MAAM,EAAE,QAA4B,CAAC,CAAC;QACrE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,IAAgB;QACnB,IAAI,CAAC,YAAY,GAAG,EAAE,GAAG,IAAI,CAAC,YAAY,EAAE,GAAG,IAAI,EAAE,CAAC;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CAAC,OAA+B;QACrC,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK;QACH,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,QAAQ,EAAE,IAAI,CAAC,YAAiB;YAChC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACnE,CAAC;IACJ,CAAC;CACF;AA3ED,0CA2EC;AAEY,QAAA,QAAQ,GAAG,eAAe,CAAC"}
+{"version":3,"file":"response-builder.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/responses/response-builder.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAGH,oEAGyC;AAIzC;;;GAGG;AACH,MAAa,eAAe;IAClB,UAAU,GAAW,GAAG,CAAC;IACzB,YAAY,GAAe,EAAE,CAAC;IAC9B,eAAe,CAA0B;IAEjD;;;;OAIG;IACH,MAAM,CAAC,EAAE;QACP,OAAO,IAAI,eAAe,EAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,OAAO;QACZ,OAAO,IAAI,eAAe,EAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,QAAQ;QACb,OAAO,IAAI,eAAe,EAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,SAAS;QACd,OAAO,IAAI,eAAe,EAAe,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACxD,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,UAAU;QACf,OAAO,IAAI,eAAe,EAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,YAAY;QAGjB,OAAO,IAAI,eAAe,EAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,SAAS;QACd,OAAO,IAAI,eAAe,EAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,QAAQ;QACb,OAAO,IAAI,eAAe,EAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,KAAK;QACV,OAAO,IAAI,eAAe,EAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,IAAY;QACjB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;OAMG;IACH,OAAO,CACL,GAAuB,EACvB,MAA+B,EAC/B,QAAiB;QAEhB,IAAI,CAAC,YAAyC,CAAC,OAAO;YACrD,IAAA,wCAAuB,EAAC,GAAG,EAAE,MAAM,EAAE,QAA4B,CAAC,CAAC;QACrE,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,IAAI,CAAC,IAAgB;QACnB,IAAI,CAAC,YAAY,GAAG,EAAE,GAAG,IAAI,CAAC,YAAY,EAAE,GAAG,IAAI,EAAE,CAAC;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,OAA+B;QACrC,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,KAAK;QACH,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,QAAQ,EAAE,IAAI,CAAC,YAAiB;YAChC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACnE,CAAC;IACJ,CAAC;CACF;AAjJD,0CAiJC;AAEY,QAAA,QAAQ,GAAG,eAAe,CAAC"}