permissions-contractx 1.0.0

package/dist/test-document-compliance.js

@@ -0,0 +1,118 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Test script to validate permissions-contractx package compliance with PermisosRoles.odt document
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.testDocumentCompliance = main;
+const contractx_document_compliance_service_1 = require("./services/contractx-document-compliance.service");
+const common_1 = require("@nestjs/common");
+// Mock Logger for standalone script
+const mockLogger = {
+    log: console.log,
+    error: console.error,
+    warn: console.warn,
+    debug: console.debug,
+    verbose: console.log
+};
+// Override NestJS Logger
+Object.setPrototypeOf(common_1.Logger.prototype, mockLogger);
+async function main() {
+    console.log('🔍 ContractX Package Document Compliance Validation');
+    console.log('===================================================\n');
+    const complianceService = new contractx_document_compliance_service_1.ContractXDocumentComplianceService();
+    try {
+        console.log('📋 Validating package compliance with PermisosRoles.odt document...\n');
+        const validationResult = await complianceService.validateDocumentCompliance();
+        // Generate and display report
+        const report = complianceService.generateComplianceReport(validationResult);
+        console.log(report);
+        // Summary
+        console.log('\n🎯 COMPLIANCE SUMMARY:');
+        console.log('=======================');
+        console.log(`Overall Compliance: ${validationResult.isCompliant ? '✅ PASSED' : '❌ FAILED'}`);
+        console.log(`Compliant Roles: ${validationResult.summary.compliantRoles.length}/${validationResult.summary.totalRoles}`);
+        console.log(`Validated Permissions: ${validationResult.summary.validatedPermissions}`);
+        console.log(`Warnings: ${validationResult.warnings.length}`);
+        console.log(`Errors: ${validationResult.errors.length}`);
+        if (!validationResult.isCompliant) {
+            console.log('\n❌ NON-COMPLIANT ROLES:');
+            validationResult.summary.nonCompliantRoles.forEach(role => {
+                const analysis = validationResult.roleAnalysis.find(a => a.role === role);
+                if (analysis) {
+                    console.log(`  • ${role}:`);
+                    if (analysis.missingPermissions.length > 0) {
+                        console.log(`    Missing: ${analysis.missingPermissions.length} permissions`);
+                    }
+                    if (analysis.extraPermissions.length > 0) {
+                        console.log(`    Extra: ${analysis.extraPermissions.length} permissions`);
+                    }
+                }
+            });
+        }
+        // Detailed analysis for key roles
+        console.log('\n🔍 KEY ROLE ANALYSIS:');
+        console.log('=====================');
+        const keyRoles = [
+            'superadmin',
+            'support',
+            'client_contract_admin',
+            'provider_contract_admin',
+            'client_reports_manager',
+            'provider_finance_manager'
+        ];
+        keyRoles.forEach(role => {
+            const analysis = validationResult.roleAnalysis.find(a => a.role === role);
+            if (analysis) {
+                const status = analysis.isCompliant ? '✅' : '❌';
+                console.log(`${status} ${role}: ${analysis.expectedPermissions.length} expected, ${analysis.actualPermissions.length} actual`);
+                if (!analysis.isCompliant) {
+                    if (analysis.missingPermissions.length > 0) {
+                        console.log(`    Missing (${analysis.missingPermissions.length}): ${analysis.missingPermissions.slice(0, 3).join(', ')}${analysis.missingPermissions.length > 3 ? '...' : ''}`);
+                    }
+                    if (analysis.extraPermissions.length > 0) {
+                        console.log(`    Extra (${analysis.extraPermissions.length}): ${analysis.extraPermissions.slice(0, 3).join(', ')}${analysis.extraPermissions.length > 3 ? '...' : ''}`);
+                    }
+                }
+            }
+        });
+        // Module coverage analysis
+        console.log('\n📊 MODULE COVERAGE:');
+        console.log('===================');
+        const coverageStats = {
+            covered: validationResult.modulesCoverage.filter(m => m.covered).length,
+            total: validationResult.modulesCoverage.length
+        };
+        console.log(`Modules covered: ${coverageStats.covered}/${coverageStats.total}`);
+        // Show uncovered modules if any
+        const uncoveredModules = validationResult.modulesCoverage.filter(m => !m.covered);
+        if (uncoveredModules.length > 0) {
+            console.log('Uncovered modules:');
+            uncoveredModules.forEach(module => {
+                console.log(`  ❌ ${module.module}`);
+            });
+        }
+        // Final assessment
+        console.log('\n🎯 FINAL ASSESSMENT:');
+        console.log('====================');
+        if (validationResult.isCompliant) {
+            console.log('✅ The permissions-contractx package is FULLY COMPLIANT with the PermisosRoles.odt document.');
+            console.log('✅ All role permissions match the documented requirements.');
+            console.log('✅ The package can be confidently used for JWT token validation.');
+        }
+        else {
+            console.log('❌ The permissions-contractx package has COMPLIANCE ISSUES with the PermisosRoles.odt document.');
+            console.log('❌ Some role permissions do not match the documented requirements.');
+            console.log('⚠️  Review and fix the non-compliant roles before using for JWT validation.');
+        }
+        process.exit(validationResult.isCompliant ? 0 : 1);
+    }
+    catch (error) {
+        console.error('❌ Error during compliance validation:', error);
+        process.exit(1);
+    }
+}
+// Run the validation
+if (require.main === module) {
+    main().catch(console.error);
+}

package/package.json

@@ -0,0 +1,405 @@
+{
+  "name": "permissions-contractx",
+  "version": "1.0.0",
+  "description": "Enterprise-grade authentication and authorization package for NestJS microservices with role-based and permission-based access control",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc -w",
+    "clean": "rimraf dist",
+    "prepublishOnly": "npm run clean && npm run build",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint src/**/*.ts",
+    "lint:fix": "eslint src/**/*.ts --fix"
+  },
+  "keywords": [
+    "nestjs",
+    "authentication",
+    "authorization",
+    "rbac",
+    "jwt",
+    "permissions",
+    "roles",
+    "security",
+    "microservices",
+    "middleware",
+    "guard",
+    "decorator"
+  ],
+  "author": "ContractX Development Team",
+  "license": "MIT",
+  "homepage": "https://github.com/your-org/permissions-contractx#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/your-org/permissions-contractx.git"
+  },
+  "bugs": {
+    "url": "https://github.com/your-org/permissions-contractx/issues"
+  },
+  "peerDependencies": {
+    "@nestjs/common": "^11.1.6",
+    "@nestjs/config": "^4.0.2",
+    "@nestjs/core": "^11.1.6",
+    "@nestjs/jwt": "^11.0.0",
+    "jsonwebtoken": "^9.0.0",
+    "reflect-metadata": "^0.1.13",
+    "rxjs": "^7.0.0"
+  },
+  "devDependencies": {
+    "@nestjs/testing": "^11.1.6",
+    "@types/express": "^5.0.3",
+    "@types/jest": "^29.5.0",
+    "@types/jsonwebtoken": "^9.0.0",
+    "@types/node": "^20.0.0",
+    "@types/supertest": "^2.0.12",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "eslint": "^8.40.0",
+    "jest": "^29.5.0",
+    "rimraf": "^5.0.0",
+    "supertest": "^6.3.0",
+    "ts-jest": "^29.1.0",
+    "ts-node": "^10.9.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=16.0.0",
+    "npm": ">=7.0.0"
+  },
+  "directories": {
+    "example": "examples",
+    "test": "test"
+  },
+  "dependencies": {
+    "acorn": "^8.15.0",
+    "acorn-jsx": "^5.3.2",
+    "acorn-walk": "^8.3.4",
+    "ajv": "^6.12.6",
+    "ansi-escapes": "^4.3.2",
+    "ansi-regex": "^5.0.1",
+    "ansi-styles": "^4.3.0",
+    "anymatch": "^3.1.3",
+    "arg": "^4.1.3",
+    "argparse": "^2.0.1",
+    "array-union": "^2.1.0",
+    "asap": "^2.0.6",
+    "asynckit": "^0.4.0",
+    "babel-jest": "^29.7.0",
+    "babel-plugin-istanbul": "^6.1.1",
+    "babel-plugin-jest-hoist": "^29.6.3",
+    "babel-preset-current-node-syntax": "^1.2.0",
+    "babel-preset-jest": "^29.6.3",
+    "balanced-match": "^1.0.2",
+    "brace-expansion": "^2.0.2",
+    "braces": "^3.0.3",
+    "browserslist": "^4.25.2",
+    "bs-logger": "^0.2.6",
+    "bser": "^2.1.1",
+    "buffer-equal-constant-time": "^1.0.1",
+    "buffer-from": "^1.1.2",
+    "call-bind-apply-helpers": "^1.0.2",
+    "call-bound": "^1.0.4",
+    "callsites": "^3.1.0",
+    "camelcase": "^5.3.1",
+    "caniuse-lite": "^1.0.30001733",
+    "chalk": "^4.1.2",
+    "char-regex": "^1.0.2",
+    "ci-info": "^3.9.0",
+    "cjs-module-lexer": "^1.4.3",
+    "cliui": "^8.0.1",
+    "co": "^4.6.0",
+    "collect-v8-coverage": "^1.0.2",
+    "color-convert": "^2.0.1",
+    "color-name": "^1.1.4",
+    "combined-stream": "^1.0.8",
+    "component-emitter": "^1.3.1",
+    "concat-map": "^0.0.1",
+    "consola": "^3.4.2",
+    "convert-source-map": "^2.0.0",
+    "cookiejar": "^2.1.4",
+    "create-jest": "^29.7.0",
+    "create-require": "^1.1.1",
+    "cross-spawn": "^7.0.6",
+    "debug": "^4.4.1",
+    "dedent": "^1.6.0",
+    "deep-is": "^0.1.4",
+    "deepmerge": "^4.3.1",
+    "delayed-stream": "^1.0.0",
+    "detect-newline": "^3.1.0",
+    "dezalgo": "^1.0.4",
+    "diff": "^4.0.2",
+    "diff-sequences": "^29.6.3",
+    "dir-glob": "^3.0.1",
+    "doctrine": "^3.0.0",
+    "dotenv": "^16.4.7",
+    "dotenv-expand": "^12.0.1",
+    "dunder-proto": "^1.0.1",
+    "eastasianwidth": "^0.2.0",
+    "ecdsa-sig-formatter": "^1.0.11",
+    "electron-to-chromium": "^1.5.199",
+    "emittery": "^0.13.1",
+    "emoji-regex": "^8.0.0",
+    "error-ex": "^1.3.2",
+    "es-define-property": "^1.0.1",
+    "es-errors": "^1.3.0",
+    "es-object-atoms": "^1.1.1",
+    "es-set-tostringtag": "^2.1.0",
+    "escalade": "^3.2.0",
+    "escape-string-regexp": "^4.0.0",
+    "eslint-scope": "^7.2.2",
+    "eslint-visitor-keys": "^3.4.3",
+    "espree": "^9.6.1",
+    "esprima": "^4.0.1",
+    "esquery": "^1.6.0",
+    "esrecurse": "^4.3.0",
+    "estraverse": "^5.3.0",
+    "esutils": "^2.0.3",
+    "execa": "^5.1.1",
+    "exit": "^0.1.2",
+    "expect": "^29.7.0",
+    "fast-deep-equal": "^3.1.3",
+    "fast-glob": "^3.3.3",
+    "fast-json-stable-stringify": "^2.1.0",
+    "fast-levenshtein": "^2.0.6",
+    "fast-safe-stringify": "^2.1.1",
+    "fastq": "^1.19.1",
+    "fb-watchman": "^2.0.2",
+    "fflate": "^0.8.2",
+    "file-entry-cache": "^6.0.1",
+    "file-type": "^21.0.0",
+    "fill-range": "^7.1.1",
+    "find-up": "^5.0.0",
+    "flat-cache": "^3.2.0",
+    "flatted": "^3.3.3",
+    "foreground-child": "^3.3.1",
+    "form-data": "^4.0.4",
+    "formidable": "^2.1.5",
+    "fs.realpath": "^1.0.0",
+    "function-bind": "^1.1.2",
+    "gensync": "^1.0.0-beta.2",
+    "get-caller-file": "^2.0.5",
+    "get-intrinsic": "^1.3.0",
+    "get-package-type": "^0.1.0",
+    "get-proto": "^1.0.1",
+    "get-stream": "^6.0.1",
+    "glob": "^7.2.3",
+    "glob-parent": "^6.0.2",
+    "globals": "^13.24.0",
+    "globby": "^11.1.0",
+    "gopd": "^1.2.0",
+    "graceful-fs": "^4.2.11",
+    "graphemer": "^1.4.0",
+    "handlebars": "^4.7.8",
+    "has-flag": "^4.0.0",
+    "has-symbols": "^1.1.0",
+    "has-tostringtag": "^1.0.2",
+    "hasown": "^2.0.2",
+    "html-escaper": "^2.0.2",
+    "human-signals": "^2.1.0",
+    "ieee754": "^1.2.1",
+    "ignore": "^5.3.2",
+    "import-fresh": "^3.3.1",
+    "import-local": "^3.2.0",
+    "imurmurhash": "^0.1.4",
+    "inflight": "^1.0.6",
+    "inherits": "^2.0.4",
+    "is-arrayish": "^0.2.1",
+    "is-core-module": "^2.16.1",
+    "is-extglob": "^2.1.1",
+    "is-fullwidth-code-point": "^3.0.0",
+    "is-generator-fn": "^2.1.0",
+    "is-glob": "^4.0.3",
+    "is-number": "^7.0.0",
+    "is-path-inside": "^3.0.3",
+    "is-stream": "^2.0.1",
+    "isexe": "^2.0.0",
+    "istanbul-lib-coverage": "^3.2.2",
+    "istanbul-lib-instrument": "^6.0.3",
+    "istanbul-lib-report": "^3.0.1",
+    "istanbul-lib-source-maps": "^4.0.1",
+    "istanbul-reports": "^3.1.7",
+    "iterare": "^1.2.1",
+    "jackspeak": "^3.4.3",
+    "jest-changed-files": "^29.7.0",
+    "jest-circus": "^29.7.0",
+    "jest-cli": "^29.7.0",
+    "jest-config": "^29.7.0",
+    "jest-diff": "^29.7.0",
+    "jest-docblock": "^29.7.0",
+    "jest-each": "^29.7.0",
+    "jest-environment-node": "^29.7.0",
+    "jest-get-type": "^29.6.3",
+    "jest-haste-map": "^29.7.0",
+    "jest-leak-detector": "^29.7.0",
+    "jest-matcher-utils": "^29.7.0",
+    "jest-message-util": "^29.7.0",
+    "jest-mock": "^29.7.0",
+    "jest-pnp-resolver": "^1.2.3",
+    "jest-regex-util": "^29.6.3",
+    "jest-resolve": "^29.7.0",
+    "jest-resolve-dependencies": "^29.7.0",
+    "jest-runner": "^29.7.0",
+    "jest-runtime": "^29.7.0",
+    "jest-snapshot": "^29.7.0",
+    "jest-util": "^29.7.0",
+    "jest-validate": "^29.7.0",
+    "jest-watcher": "^29.7.0",
+    "jest-worker": "^29.7.0",
+    "js-tokens": "^4.0.0",
+    "js-yaml": "^4.1.0",
+    "jsesc": "^3.1.0",
+    "json-buffer": "^3.0.1",
+    "json-parse-even-better-errors": "^2.3.1",
+    "json-schema-traverse": "^0.4.1",
+    "json-stable-stringify-without-jsonify": "^1.0.1",
+    "json5": "^2.2.3",
+    "jsonwebtoken": "^9.0.2",
+    "jwa": "^1.4.2",
+    "jws": "^3.2.2",
+    "keyv": "^4.5.4",
+    "kleur": "^3.0.3",
+    "leven": "^3.1.0",
+    "levn": "^0.4.1",
+    "lines-and-columns": "^1.2.4",
+    "load-esm": "^1.0.2",
+    "locate-path": "^6.0.0",
+    "lodash": "^4.17.21",
+    "lodash.includes": "^4.3.0",
+    "lodash.isboolean": "^3.0.3",
+    "lodash.isinteger": "^4.0.4",
+    "lodash.isnumber": "^3.0.3",
+    "lodash.isplainobject": "^4.0.6",
+    "lodash.isstring": "^4.0.1",
+    "lodash.memoize": "^4.1.2",
+    "lodash.merge": "^4.6.2",
+    "lodash.once": "^4.1.1",
+    "lru-cache": "^5.1.1",
+    "make-dir": "^4.0.0",
+    "make-error": "^1.3.6",
+    "makeerror": "^1.0.12",
+    "math-intrinsics": "^1.1.0",
+    "merge-stream": "^2.0.0",
+    "merge2": "^1.4.1",
+    "methods": "^1.1.2",
+    "micromatch": "^4.0.8",
+    "mime": "^2.6.0",
+    "mime-db": "^1.52.0",
+    "mime-types": "^2.1.35",
+    "mimic-fn": "^2.1.0",
+    "minimatch": "^9.0.3",
+    "minimist": "^1.2.8",
+    "minipass": "^7.1.2",
+    "ms": "^2.1.3",
+    "natural-compare": "^1.4.0",
+    "neo-async": "^2.6.2",
+    "node-int64": "^0.4.0",
+    "node-releases": "^2.0.19",
+    "normalize-path": "^3.0.0",
+    "npm-run-path": "^4.0.1",
+    "object-inspect": "^1.13.4",
+    "once": "^1.4.0",
+    "onetime": "^5.1.2",
+    "optionator": "^0.9.4",
+    "p-limit": "^3.1.0",
+    "p-locate": "^5.0.0",
+    "p-try": "^2.2.0",
+    "package-json-from-dist": "^1.0.1",
+    "parent-module": "^1.0.1",
+    "parse-json": "^5.2.0",
+    "path-exists": "^4.0.0",
+    "path-is-absolute": "^1.0.1",
+    "path-key": "^3.1.1",
+    "path-parse": "^1.0.7",
+    "path-scurry": "^1.11.1",
+    "path-to-regexp": "^8.2.0",
+    "path-type": "^4.0.0",
+    "picocolors": "^1.1.1",
+    "picomatch": "^2.3.1",
+    "pirates": "^4.0.7",
+    "pkg-dir": "^4.2.0",
+    "prelude-ls": "^1.2.1",
+    "pretty-format": "^29.7.0",
+    "prompts": "^2.4.2",
+    "punycode": "^2.3.1",
+    "pure-rand": "^6.1.0",
+    "qs": "^6.14.0",
+    "queue-microtask": "^1.2.3",
+    "react-is": "^18.3.1",
+    "reflect-metadata": "^0.1.14",
+    "require-directory": "^2.1.1",
+    "resolve": "^1.22.10",
+    "resolve-cwd": "^3.0.0",
+    "resolve-from": "^4.0.0",
+    "resolve.exports": "^2.0.3",
+    "reusify": "^1.1.0",
+    "run-parallel": "^1.2.0",
+    "rxjs": "^7.8.2",
+    "safe-buffer": "^5.2.1",
+    "semver": "^7.7.2",
+    "shebang-command": "^2.0.0",
+    "shebang-regex": "^3.0.0",
+    "side-channel": "^1.1.0",
+    "side-channel-list": "^1.0.0",
+    "side-channel-map": "^1.0.1",
+    "side-channel-weakmap": "^1.0.2",
+    "signal-exit": "^3.0.7",
+    "sisteransi": "^1.0.5",
+    "slash": "^3.0.0",
+    "source-map": "^0.6.1",
+    "source-map-support": "^0.5.13",
+    "sprintf-js": "^1.0.3",
+    "stack-utils": "^2.0.6",
+    "string-length": "^4.0.2",
+    "string-width": "^4.2.3",
+    "string-width-cjs": "^4.2.3",
+    "strip-ansi": "^6.0.1",
+    "strip-ansi-cjs": "^6.0.1",
+    "strip-bom": "^4.0.0",
+    "strip-final-newline": "^2.0.0",
+    "strip-json-comments": "^3.1.1",
+    "strtok3": "^10.3.4",
+    "superagent": "^8.1.2",
+    "supports-color": "^7.2.0",
+    "supports-preserve-symlinks-flag": "^1.0.0",
+    "test-exclude": "^6.0.0",
+    "text-table": "^0.2.0",
+    "tmpl": "^1.0.5",
+    "to-regex-range": "^5.0.1",
+    "token-types": "^6.0.4",
+    "ts-api-utils": "^1.4.3",
+    "tslib": "^2.8.1",
+    "type-check": "^0.4.0",
+    "type-detect": "^4.0.8",
+    "type-fest": "^0.20.2",
+    "uglify-js": "^3.19.3",
+    "uid": "^2.0.2",
+    "uint8array-extras": "^1.4.0",
+    "undici-types": "^6.21.0",
+    "update-browserslist-db": "^1.1.3",
+    "uri-js": "^4.4.1",
+    "v8-compile-cache-lib": "^3.0.1",
+    "v8-to-istanbul": "^9.3.0",
+    "walker": "^1.0.8",
+    "which": "^2.0.2",
+    "word-wrap": "^1.2.5",
+    "wordwrap": "^1.0.0",
+    "wrap-ansi": "^7.0.0",
+    "wrap-ansi-cjs": "^7.0.0",
+    "wrappy": "^1.0.2",
+    "write-file-atomic": "^4.0.2",
+    "y18n": "^5.0.8",
+    "yallist": "^3.1.1",
+    "yargs": "^17.7.2",
+    "yargs-parser": "^21.1.1",
+    "yn": "^3.1.1",
+    "yocto-queue": "^0.1.0"
+  }
+}