easywork-common-lib 1.0.997 → 1.0.999

package/dist/common/@types/enums/permission.enum.d.ts

@@ -1,3 +1,4 @@
+import { User } from "../../../entities/user.entity";
 export declare enum Roles {
     ADMIN = "ADMIN",
     USER = "USER",
@@ -39,11 +40,29 @@ export declare enum PermissionCondition {
     TIME_BASED = "timeBased",
     STATUS_BASED = "statusBased"
 }
+export interface FilterCondition {
+    field: string;
+    operator: "equals" | "in" | "contains" | "not_in" | "is_null" | "is_not_null" | "like" | "gt" | "gte" | "lt" | "lte";
+    value?: any;
+    values?: any[];
+}
+export interface FilterCriteria {
+    fields?: FilterCondition[];
+    includeOwn?: boolean;
+    includeAssigned?: boolean;
+    includeObserved?: boolean;
+    includeTeam?: boolean;
+    includeGroup?: boolean;
+    includeSupervised?: boolean;
+    orConditions?: FilterCriteria[];
+    andConditions?: FilterCriteria[];
+}
 export interface PermissionRule {
     action: PermissionAction;
     scope: PermissionScope;
     conditions?: PermissionCondition[];
     roleLevel?: number;
+    filterCriteria?: FilterCriteria;
     customConditions?: Record<string, any>;
     timeRestrictions?: {
         createdWithin?: number;
@@ -55,3 +74,20 @@ export interface ResourcePermission {
     resource: string;
     rules: PermissionRule[];
 }
+export interface PermissionContextType {
+    user: User;
+    resource: string;
+    action: PermissionAction;
+    targetEntity?: any;
+    additionalContext?: Record<string, any>;
+}
+export interface PermissionResult {
+    allowed: boolean;
+    scope?: PermissionScope;
+    filters?: Record<string, any>;
+    reason?: string;
+}
+export declare enum PermissionGroupScope {
+    GLOBAL = "global",
+    GROUP_SPECIFIC = "group_specific"
+}

package/dist/common/@types/enums/permission.enum.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PermissionCondition = exports.PermissionScope = exports.PermissionAction = exports.Roles = void 0;
+exports.PermissionGroupScope = exports.PermissionCondition = exports.PermissionScope = exports.PermissionAction = exports.Roles = void 0;
 var Roles;
 (function (Roles) {
     Roles["ADMIN"] = "ADMIN";
@@ -46,4 +46,9 @@ var PermissionCondition;
     PermissionCondition["TIME_BASED"] = "timeBased";
     PermissionCondition["STATUS_BASED"] = "statusBased";
 })(PermissionCondition || (exports.PermissionCondition = PermissionCondition = {}));
+var PermissionGroupScope;
+(function (PermissionGroupScope) {
+    PermissionGroupScope["GLOBAL"] = "global";
+    PermissionGroupScope["GROUP_SPECIFIC"] = "group_specific";
+})(PermissionGroupScope || (exports.PermissionGroupScope = PermissionGroupScope = {}));
 //# sourceMappingURL=permission.enum.js.map

package/dist/common/@types/enums/permission.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"permission.enum.js","sourceRoot":"","sources":["../../../../src/common/@types/enums/permission.enum.ts"],"names":[],"mappings":";;;AAAA,IAAY,KAKX;AALD,WAAY,KAAK;IACf,wBAAe,CAAA;IACf,sBAAa,CAAA;IACb,kCAAyB,CAAA;IACzB,0BAAiB,CAAA;AACnB,CAAC,EALW,KAAK,qBAAL,KAAK,QAKhB;AAED,IAAY,gBAeX;AAfD,WAAY,gBAAgB;IAC1B,qCAAiB,CAAA;IACjB,iCAAa,CAAA;IACb,qCAAiB,CAAA;IACjB,qCAAiB,CAAA;IACjB,qCAAiB,CAAA;IACjB,qCAAiB,CAAA;IACjB,qCAAiB,CAAA;IACjB,qCAAiB,CAAA;IACjB,uCAAmB,CAAA;IACnB,qCAAiB,CAAA;IACjB,qCAAiB,CAAA;IACjB,uCAAmB,CAAA;IACnB,mCAAe,CAAA;IACf,uCAAmB,CAAA;AACrB,CAAC,EAfW,gBAAgB,gCAAhB,gBAAgB,QAe3B;AAED,IAAY,eAOX;AAPD,WAAY,eAAe;IACzB,8BAAW,CAAA;IACX,gCAAa,CAAA;IACb,kCAAe,CAAA;IACf,8BAAW,CAAA;IACX,wCAAqB,CAAA;IACrB,4CAAyB,CAAA;AAC3B,CAAC,EAPW,eAAe,+BAAf,eAAe,QAO1B;AAED,IAAY,mBAUX;AAVD,WAAY,mBAAmB;IAC7B,wCAAiB,CAAA;IACjB,sCAAe,CAAA;IACf,iDAA0B,CAAA;IAC1B,4CAAqB,CAAA;IACrB,+CAAwB,CAAA;IACxB,6CAAsB,CAAA;IACtB,+CAAwB,CAAA;IACxB,+CAAwB,CAAA;IACxB,mDAA4B,CAAA;AAC9B,CAAC,EAVW,mBAAmB,mCAAnB,mBAAmB,QAU9B"}
+{"version":3,"file":"permission.enum.js","sourceRoot":"","sources":["../../../../src/common/@types/enums/permission.enum.ts"],"names":[],"mappings":";;;AAEA,IAAY,KAKX;AALD,WAAY,KAAK;IACf,wBAAe,CAAA;IACf,sBAAa,CAAA;IACb,kCAAyB,CAAA;IACzB,0BAAiB,CAAA;AACnB,CAAC,EALW,KAAK,qBAAL,KAAK,QAKhB;AAED,IAAY,gBAeX;AAfD,WAAY,gBAAgB;IAC1B,qCAAiB,CAAA;IACjB,iCAAa,CAAA;IACb,qCAAiB,CAAA;IACjB,qCAAiB,CAAA;IACjB,qCAAiB,CAAA;IACjB,qCAAiB,CAAA;IACjB,qCAAiB,CAAA;IACjB,qCAAiB,CAAA;IACjB,uCAAmB,CAAA;IACnB,qCAAiB,CAAA;IACjB,qCAAiB,CAAA;IACjB,uCAAmB,CAAA;IACnB,mCAAe,CAAA;IACf,uCAAmB,CAAA;AACrB,CAAC,EAfW,gBAAgB,gCAAhB,gBAAgB,QAe3B;AAED,IAAY,eAOX;AAPD,WAAY,eAAe;IACzB,8BAAW,CAAA;IACX,gCAAa,CAAA;IACb,kCAAe,CAAA;IACf,8BAAW,CAAA;IACX,wCAAqB,CAAA;IACrB,4CAAyB,CAAA;AAC3B,CAAC,EAPW,eAAe,+BAAf,eAAe,QAO1B;AAED,IAAY,mBAUX;AAVD,WAAY,mBAAmB;IAC7B,wCAAiB,CAAA;IACjB,sCAAe,CAAA;IACf,iDAA0B,CAAA;IAC1B,4CAAqB,CAAA;IACrB,+CAAwB,CAAA;IACxB,6CAAsB,CAAA;IACtB,+CAAwB,CAAA;IACxB,+CAAwB,CAAA;IACxB,mDAA4B,CAAA;AAC9B,CAAC,EAVW,mBAAmB,mCAAnB,mBAAmB,QAU9B;AA6ED,IAAY,oBAGX;AAHD,WAAY,oBAAoB;IAC9B,yCAAiB,CAAA;IACjB,yDAAiC,CAAA;AACnC,CAAC,EAHW,oBAAoB,oCAApB,oBAAoB,QAG/B"}

package/dist/entities/permission.entity.d.ts

@@ -1,6 +1,7 @@
 import { EntityBase } from "../common/database/base.entity";
 import { Role } from "./role.entity";
-import { PermissionRule } from "../common";
+import { PermissionGroupScope, PermissionRule } from "../common";
+import { Group } from "./group.entity";
 export declare class Permission extends EntityBase {
     resource: string;
     rules: PermissionRule[];
@@ -8,4 +9,9 @@ export declare class Permission extends EntityBase {
     minRoleLevel?: number;
     maxRoleLevel?: number;
     useRoleLevel: boolean;
+    groupScope: PermissionGroupScope;
+    groups?: Group[];
+    description?: string;
+    priority?: number;
+    tags?: string[];
 }

package/dist/entities/permission.entity.js

@@ -14,6 +14,8 @@ const base_entity_1 = require("../common/database/base.entity");
 const typeorm_1 = require("typeorm");
 const role_entity_1 = require("./role.entity");
 const swagger_1 = require("@nestjs/swagger");
+const common_1 = require("../common");
+const group_entity_1 = require("./group.entity");
 let Permission = class Permission extends base_entity_1.EntityBase {
     resource;
     rules;
@@ -21,15 +23,37 @@ let Permission = class Permission extends base_entity_1.EntityBase {
     minRoleLevel;
     maxRoleLevel;
     useRoleLevel;
+    groupScope;
+    groups;
+    description;
+    priority;
+    tags;
 };
 exports.Permission = Permission;
 __decorate([
-    (0, swagger_1.ApiProperty)({ type: String, description: "Resource for the permission" }),
+    (0, swagger_1.ApiProperty)({
+        type: String,
+        description: "Resource for the permission (e.g., 'contact', 'lead', 'policy')",
+    }),
     (0, typeorm_1.Column)(),
     __metadata("design:type", String)
 ], Permission.prototype, "resource", void 0);
 __decorate([
-    (0, swagger_1.ApiProperty)({ type: String, description: "Rules for the permission" }),
+    (0, swagger_1.ApiProperty)({
+        type: "array",
+        description: "Dynamic permission rules with FilterCriteria for data-driven filtering",
+        example: [
+            {
+                action: "read",
+                scope: "assigned",
+                filterCriteria: {
+                    includeOwn: true,
+                    includeAssigned: true,
+                    includeObserved: true,
+                },
+            },
+        ],
+    }),
     (0, typeorm_1.Column)({ type: "jsonb", nullable: true }),
     __metadata("design:type", Array)
 ], Permission.prototype, "rules", void 0);
@@ -63,6 +87,67 @@ __decorate([
     (0, typeorm_1.Column)({ type: "boolean", default: false }),
     __metadata("design:type", Boolean)
 ], Permission.prototype, "useRoleLevel", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        type: String,
+        enum: common_1.PermissionGroupScope,
+        description: "Scope of permission application: 'global' for all groups, 'group_specific' for specific groups",
+        example: "group_specific",
+    }),
+    (0, typeorm_1.Column)({
+        type: "enum",
+        enum: common_1.PermissionGroupScope,
+        default: common_1.PermissionGroupScope.GROUP_SPECIFIC,
+    }),
+    __metadata("design:type", String)
+], Permission.prototype, "groupScope", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        type: () => [group_entity_1.Group],
+        description: "Specific groups this permission applies to (when groupScope='group_specific'). Empty = applies to all groups",
+        required: false,
+    }),
+    (0, typeorm_1.ManyToMany)(() => group_entity_1.Group, {
+        onDelete: "CASCADE",
+        onUpdate: "CASCADE",
+    }),
+    (0, typeorm_1.JoinTable)({
+        name: "permission_groups",
+        joinColumn: { name: "permission_id", referencedColumnName: "id" },
+        inverseJoinColumn: { name: "group_id", referencedColumnName: "id" },
+    }),
+    __metadata("design:type", Array)
+], Permission.prototype, "groups", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        type: String,
+        description: "Human-readable description of what this permission allows",
+        required: false,
+        example: "Allows team leads to read contacts they own, are assigned to, or observe",
+    }),
+    (0, typeorm_1.Column)({ type: "text", nullable: true }),
+    __metadata("design:type", String)
+], Permission.prototype, "description", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        type: Number,
+        description: "Priority order when multiple permissions apply (lower = higher priority)",
+        required: false,
+        example: 1,
+    }),
+    (0, typeorm_1.Column)({ type: "int", nullable: true, default: 100 }),
+    __metadata("design:type", Number)
+], Permission.prototype, "priority", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        type: String,
+        description: "Optional tags for permission categorization and filtering",
+        required: false,
+        example: ["sales", "crm", "basic"],
+    }),
+    (0, typeorm_1.Column)({ type: "jsonb", nullable: true }),
+    __metadata("design:type", Array)
+], Permission.prototype, "tags", void 0);
 exports.Permission = Permission = __decorate([
     (0, typeorm_1.Entity)()
 ], Permission);

package/dist/entities/permission.entity.js.map

@@ -1 +1 @@
-{"version":3,"file":"permission.entity.js","sourceRoot":"","sources":["../../src/entities/permission.entity.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,gEAA4D;AAC5D,qCAAgE;AAChE,+CAAqC;AACrC,6CAA8C;AAIvC,IAAM,UAAU,GAAhB,MAAM,UAAW,SAAQ,wBAAU;IAGxC,QAAQ,CAAS;IAIjB,KAAK,CAAmB;IAWxB,KAAK,CAAU;IAIf,YAAY,CAAU;IAItB,YAAY,CAAU;IAOtB,YAAY,CAAU;CACvB,CAAA;AAlCY,gCAAU;AAGrB;IAFC,IAAA,qBAAW,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,6BAA6B,EAAE,CAAC;IACzE,IAAA,gBAAM,GAAE;;4CACQ;AAIjB;IAFC,IAAA,qBAAW,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,0BAA0B,EAAE,CAAC;IACtE,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;yCAClB;AAWxB;IATC,IAAA,qBAAW,EAAC;QACX,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,kBAAI,CAAC;QAClB,WAAW,EAAE,sCAAsC;KACpD,CAAC;IACD,IAAA,oBAAU,EAAC,GAAG,EAAE,CAAC,kBAAI,EAAE;QACtB,QAAQ,EAAE,SAAS;QACnB,QAAQ,EAAE,SAAS;KACpB,CAAC;IACD,IAAA,mBAAS,GAAE;;yCACG;AAIf;IAFC,IAAA,qBAAW,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,6BAA6B,EAAE,CAAC;IACzE,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;gDAClB;AAItB;IAFC,IAAA,qBAAW,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,4BAA4B,EAAE,CAAC;IACxE,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;gDAClB;AAOtB;IALC,IAAA,qBAAW,EAAC;QACX,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,6CAA6C;KAC3D,CAAC;IACD,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;;gDACtB;qBAjCX,UAAU;IADtB,IAAA,gBAAM,GAAE;GACI,UAAU,CAkCtB"}
+{"version":3,"file":"permission.entity.js","sourceRoot":"","sources":["../../src/entities/permission.entity.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,gEAA4D;AAC5D,qCAAgE;AAChE,+CAAqC;AACrC,6CAA8C;AAC9C,sCAAiE;AACjE,iDAAuC;AAGhC,IAAM,UAAU,GAAhB,MAAM,UAAW,SAAQ,wBAAU;IAOxC,QAAQ,CAAS;IAmBjB,KAAK,CAAmB;IAWxB,KAAK,CAAU;IAIf,YAAY,CAAU;IAItB,YAAY,CAAU;IAOtB,YAAY,CAAU;IAgBtB,UAAU,CAAuB;IAiBjC,MAAM,CAAW;IAUjB,WAAW,CAAU;IAUrB,QAAQ,CAAU;IASlB,IAAI,CAAY;CACjB,CAAA;AAnHY,gCAAU;AAOrB;IANC,IAAA,qBAAW,EAAC;QACX,IAAI,EAAE,MAAM;QACZ,WAAW,EACT,iEAAiE;KACpE,CAAC;IACD,IAAA,gBAAM,GAAE;;4CACQ;AAmBjB;IAjBC,IAAA,qBAAW,EAAC;QACX,IAAI,EAAE,OAAO;QACb,WAAW,EACT,wEAAwE;QAC1E,OAAO,EAAE;YACP;gBACE,MAAM,EAAE,MAAM;gBACd,KAAK,EAAE,UAAU;gBACjB,cAAc,EAAE;oBACd,UAAU,EAAE,IAAI;oBAChB,eAAe,EAAE,IAAI;oBACrB,eAAe,EAAE,IAAI;iBACtB;aACF;SACF;KACF,CAAC;IACD,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;yCAClB;AAWxB;IATC,IAAA,qBAAW,EAAC;QACX,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,kBAAI,CAAC;QAClB,WAAW,EAAE,sCAAsC;KACpD,CAAC;IACD,IAAA,oBAAU,EAAC,GAAG,EAAE,CAAC,kBAAI,EAAE;QACtB,QAAQ,EAAE,SAAS;QACnB,QAAQ,EAAE,SAAS;KACpB,CAAC;IACD,IAAA,mBAAS,GAAE;;yCACG;AAIf;IAFC,IAAA,qBAAW,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,6BAA6B,EAAE,CAAC;IACzE,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;gDAClB;AAItB;IAFC,IAAA,qBAAW,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,4BAA4B,EAAE,CAAC;IACxE,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;gDAClB;AAOtB;IALC,IAAA,qBAAW,EAAC;QACX,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,6CAA6C;KAC3D,CAAC;IACD,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;;gDACtB;AAgBtB;IAZC,IAAA,qBAAW,EAAC;QACX,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,6BAAoB;QAC1B,WAAW,EACT,gGAAgG;QAClG,OAAO,EAAE,gBAAgB;KAC1B,CAAC;IACD,IAAA,gBAAM,EAAC;QACN,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,6BAAoB;QAC1B,OAAO,EAAE,6BAAoB,CAAC,cAAc;KAC7C,CAAC;;8CAC+B;AAiBjC;IAfC,IAAA,qBAAW,EAAC;QACX,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,oBAAK,CAAC;QACnB,WAAW,EACT,8GAA8G;QAChH,QAAQ,EAAE,KAAK;KAChB,CAAC;IACD,IAAA,oBAAU,EAAC,GAAG,EAAE,CAAC,oBAAK,EAAE;QACvB,QAAQ,EAAE,SAAS;QACnB,QAAQ,EAAE,SAAS;KACpB,CAAC;IACD,IAAA,mBAAS,EAAC;QACT,IAAI,EAAE,mBAAmB;QACzB,UAAU,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,oBAAoB,EAAE,IAAI,EAAE;QACjE,iBAAiB,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,oBAAoB,EAAE,IAAI,EAAE;KACpE,CAAC;;0CACe;AAUjB;IARC,IAAA,qBAAW,EAAC;QACX,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,2DAA2D;QACxE,QAAQ,EAAE,KAAK;QACf,OAAO,EACL,0EAA0E;KAC7E,CAAC;IACD,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;+CACpB;AAUrB;IARC,IAAA,qBAAW,EAAC;QACX,IAAI,EAAE,MAAM;QACZ,WAAW,EACT,0EAA0E;QAC5E,QAAQ,EAAE,KAAK;QACf,OAAO,EAAE,CAAC;KACX,CAAC;IACD,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;;4CACpC;AASlB;IAPC,IAAA,qBAAW,EAAC;QACX,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,2DAA2D;QACxE,QAAQ,EAAE,KAAK;QACf,OAAO,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC;KACnC,CAAC;IACD,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;wCAC1B;qBAlHL,UAAU;IADtB,IAAA,gBAAM,GAAE;GACI,UAAU,CAmHtB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "easywork-common-lib",
-  "version": "1.0.997",
+  "version": "1.0.999",
   "description": "Librería común de Easywork",
   "main": "dist/index.js",
   "scripts": {