@zola_do/audit 0.2.17 → 0.2.18

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -446,3 +446,15 @@ ISC
446
446
  - [Contributing](../../CONTRIBUTING.md)
447
447
  - [Code of Conduct](../../CODE_OF_CONDUCT.md)
448
448
  - [Security Policy](../../SECURITY.md)
449
+
450
+ ## Configuration Validation
451
+
452
+ Validate RabbitMQ audit configuration before bootstrap when audit logging is required:
453
+
454
+ ```typescript
455
+ import { validateAuditEnv } from '@zola_do/audit';
456
+
457
+ validateAuditEnv();
458
+ ```
459
+
460
+ Use `validateAuditEnv({ required: false })` when audit transport is intentionally optional.
@@ -22,6 +22,7 @@ const audit_rmq_readiness_1 = require("./audit-rmq-readiness");
22
22
  function createAuditModuleConfig(options = {}) {
23
23
  const imports = [];
24
24
  const providers = [];
25
+ const logger = new common_1.Logger(AuditModule.name);
25
26
  const normalizedOptions = (0, audit_module_options_1.normalizeAuditModuleOptions)(options);
26
27
  if ((0, audit_rmq_readiness_1.isRmqAuditReady)()) {
27
28
  try {
@@ -49,14 +50,14 @@ function createAuditModuleConfig(options = {}) {
49
50
  }
50
51
  catch (error) {
51
52
  if (process.env.NODE_ENV !== 'production') {
52
- console.warn('AuditModule: Could not register RabbitMQ client. Audit features will be disabled.');
53
+ logger.warn('Could not register RabbitMQ client. Audit features will be disabled.');
53
54
  }
54
55
  }
55
56
  }
56
57
  else if (process.env.NODE_ENV !== 'production') {
57
58
  const gap = (0, audit_rmq_readiness_1.describeRmqAuditGap)();
58
59
  if (gap) {
59
- console.warn(`AuditModule: RabbitMQ audit disabled — ${gap}.`);
60
+ logger.warn(`RabbitMQ audit disabled — ${gap}.`);
60
61
  }
61
62
  }
62
63
  return { imports, providers };
@@ -1 +1 @@
1
- {"version":3,"file":"audit.module.js","sourceRoot":"","sources":["../src/audit.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,yDAAqD;AACrD,yEAAoE;AACpE,2CAAuD;AACvD,uCAA0D;AAC1D,yDAAmE;AACnE,qCAAqC;AACrC,+DAA0D;AAC1D,uDAA4E;AAC5E,2DAA2D;AAE3D,iEAAqE;AACrE,+DAG+B;AAE/B,SAAS,uBAAuB,CAAC,UAAkC,EAAE;IAInE,MAAM,OAAO,GAAU,EAAE,CAAC;IAC1B,MAAM,SAAS,GAAU,EAAE,CAAC;IAE5B,MAAM,iBAAiB,GAAG,IAAA,kDAA2B,EAAC,OAAO,CAAC,CAAC;IAE/D,IAAI,IAAA,qCAAe,GAAE,EAAE,CAAC;QACtB,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,6BAAa,CAAC,QAAQ,CAAC,CAAC,uCAAiB,CAAC,CAAC,CAAC,CAAC;YAC1D,SAAS,CAAC,IAAI,CAAC,kCAAe,CAAC,CAAC;YAChC,SAAS,CAAC,IAAI,CAAC;gBACb,OAAO,EAAE,sCAAoB;gBAC7B,QAAQ,EAAE,iBAAiB;aAC5B,CAAC,CAAC;YACH,SAAS,CAAC,IAAI,CAAC;gBACb,OAAO,EAAE,mCAAiB;gBAC1B,QAAQ,EAAE,iBAAiB,CAAC,UAAU;aACvC,CAAC,CAAC;YACH,SAAS,CAAC,IAAI,CAAC;gBACb,OAAO,EAAE,sBAAe;gBACxB,UAAU,EAAE,CACV,SAAoB,EACpB,UAAsB,EACtB,YAAyB,EACzB,UAAiB,EACjB,aAAkB,EAClB,EAAE,CACF,IAAI,iDAAsB,CACxB,SAAS,EACT,UAAU,EACV,YAAY,EACZ,UAAU,EACV,aAAa,CACd;gBACH,MAAM,EAAE;oBACN,gBAAS;oBACT,oBAAU;oBACV,wCAAoB;oBACpB,mCAAiB;oBACjB,sCAAoB;iBACrB;aACF,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;gBAC1C,OAAO,CAAC,IAAI,CACV,mFAAmF,CACpF,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;SAAM,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;QACjD,MAAM,GAAG,GAAG,IAAA,yCAAmB,GAAE,CAAC;QAClC,IAAI,GAAG,EAAE,CAAC;YACR,OAAO,CAAC,IAAI,CAAC,0CAA0C,GAAG,GAAG,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AAChC,CAAC;AAGM,IAAM,WAAW,mBAAjB,MAAM,WAAW;IACtB,MAAM,CAAC,OAAO,CAAC,UAAkC,EAAE;QACjD,MAAM,MAAM,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;QAChD,OAAO;YACL,MAAM,EAAE,aAAW;YACnB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,OAAO,EAAE,MAAM,CAAC,SAAS;SAC1B,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,UAAkC,EAAE;QACtD,OAAO,aAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;CACF,CAAA;AAdY,kCAAW;sBAAX,WAAW;IADvB,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,WAAW,CAcvB"}
1
+ {"version":3,"file":"audit.module.js","sourceRoot":"","sources":["../src/audit.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,yDAAqD;AACrD,yEAAoE;AACpE,2CAA+D;AAC/D,uCAA0D;AAC1D,yDAAmE;AACnE,qCAAqC;AACrC,+DAA0D;AAC1D,uDAA4E;AAC5E,2DAA2D;AAE3D,iEAAqE;AACrE,+DAG+B;AAE/B,SAAS,uBAAuB,CAAC,UAAkC,EAAE;IAInE,MAAM,OAAO,GAAU,EAAE,CAAC;IAC1B,MAAM,SAAS,GAAU,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,IAAI,eAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAE5C,MAAM,iBAAiB,GAAG,IAAA,kDAA2B,EAAC,OAAO,CAAC,CAAC;IAE/D,IAAI,IAAA,qCAAe,GAAE,EAAE,CAAC;QACtB,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,6BAAa,CAAC,QAAQ,CAAC,CAAC,uCAAiB,CAAC,CAAC,CAAC,CAAC;YAC1D,SAAS,CAAC,IAAI,CAAC,kCAAe,CAAC,CAAC;YAChC,SAAS,CAAC,IAAI,CAAC;gBACb,OAAO,EAAE,sCAAoB;gBAC7B,QAAQ,EAAE,iBAAiB;aAC5B,CAAC,CAAC;YACH,SAAS,CAAC,IAAI,CAAC;gBACb,OAAO,EAAE,mCAAiB;gBAC1B,QAAQ,EAAE,iBAAiB,CAAC,UAAU;aACvC,CAAC,CAAC;YACH,SAAS,CAAC,IAAI,CAAC;gBACb,OAAO,EAAE,sBAAe;gBACxB,UAAU,EAAE,CACV,SAAoB,EACpB,UAAsB,EACtB,YAAyB,EACzB,UAAiB,EACjB,aAAkB,EAClB,EAAE,CACF,IAAI,iDAAsB,CACxB,SAAS,EACT,UAAU,EACV,YAAY,EACZ,UAAU,EACV,aAAa,CACd;gBACH,MAAM,EAAE;oBACN,gBAAS;oBACT,oBAAU;oBACV,wCAAoB;oBACpB,mCAAiB;oBACjB,sCAAoB;iBACrB;aACF,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;gBAC1C,MAAM,CAAC,IAAI,CACT,sEAAsE,CACvE,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;SAAM,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;QACjD,MAAM,GAAG,GAAG,IAAA,yCAAmB,GAAE,CAAC;QAClC,IAAI,GAAG,EAAE,CAAC;YACR,MAAM,CAAC,IAAI,CAAC,6BAA6B,GAAG,GAAG,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AAChC,CAAC;AAGM,IAAM,WAAW,mBAAjB,MAAM,WAAW;IACtB,MAAM,CAAC,OAAO,CAAC,UAAkC,EAAE;QACjD,MAAM,MAAM,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;QAChD,OAAO;YACL,MAAM,EAAE,aAAW;YACnB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,OAAO,EAAE,MAAM,CAAC,SAAS;SAC1B,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,UAAkC,EAAE;QACtD,OAAO,aAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;CACF,CAAA;AAdY,kCAAW;sBAAX,WAAW;IADvB,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,WAAW,CAcvB"}
package/dist/index.d.ts CHANGED
@@ -10,3 +10,4 @@ export * from './audit.subscriber';
10
10
  export * from './event-audit.decorator';
11
11
  export * from './ignore-logger.decorator';
12
12
  export * from './request-id.interceptor';
13
+ export * from './validate-audit-env.helper';
package/dist/index.js CHANGED
@@ -26,4 +26,5 @@ __exportStar(require("./audit.subscriber"), exports);
26
26
  __exportStar(require("./event-audit.decorator"), exports);
27
27
  __exportStar(require("./ignore-logger.decorator"), exports);
28
28
  __exportStar(require("./request-id.interceptor"), exports);
29
+ __exportStar(require("./validate-audit-env.helper"), exports);
29
30
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,sDAAoC;AACpC,6DAA2C;AAC3C,sDAAoC;AACpC,8CAA4B;AAC5B,wDAAsC;AACtC,iDAA+B;AAC/B,yDAAuC;AACvC,qDAAmC;AACnC,0DAAwC;AACxC,4DAA0C;AAC1C,2DAAyC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,sDAAoC;AACpC,6DAA2C;AAC3C,sDAAoC;AACpC,8CAA4B;AAC5B,wDAAsC;AACtC,iDAA+B;AAC/B,yDAAuC;AACvC,qDAAmC;AACnC,0DAAwC;AACxC,4DAA0C;AAC1C,2DAAyC;AACzC,8DAA4C"}
@@ -0,0 +1,4 @@
1
+ export type ValidateAuditEnvOptions = {
2
+ required?: boolean;
3
+ };
4
+ export declare function validateAuditEnv(options?: ValidateAuditEnvOptions): void;
@@ -0,0 +1,13 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.validateAuditEnv = validateAuditEnv;
4
+ function validateAuditEnv(options = {}) {
5
+ const { required = true } = options;
6
+ if (!required) {
7
+ return;
8
+ }
9
+ if (!process.env.RMQ_URL) {
10
+ throw new Error('RMQ_URL is required');
11
+ }
12
+ }
13
+ //# sourceMappingURL=validate-audit-env.helper.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"validate-audit-env.helper.js","sourceRoot":"","sources":["../src/validate-audit-env.helper.ts"],"names":[],"mappings":";;AAIA,4CASC;AATD,SAAgB,gBAAgB,CAAC,UAAmC,EAAE;IACpE,MAAM,EAAE,QAAQ,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IACpC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;IACT,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACzC,CAAC;AACH,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@zola_do/audit",
3
- "version": "0.2.17",
3
+ "version": "0.2.18",
4
4
  "description": "RabbitMQ-based audit logging for NestJS",
5
5
  "author": "zolaDO",
6
6
  "license": "ISC",