@mj-biz-apps/tasks-entities 0.0.1 → 1.0.0

package/dist/custom/TaskDependencyEntitySubclass.d.ts

@@ -0,0 +1,28 @@
+import { BaseEntity, ValidationResult } from "@memberjunction/core";
+/**
+ * Custom entity subclass for MJ_BizApps_Tasks: Task Dependencies.
+ * Prevents circular dependencies by walking the dependency graph
+ * before allowing a save.
+ *
+ * Registered with priority 1 to override the CodeGen-generated base class.
+ */
+export declare class TaskDependencyEntity extends BaseEntity {
+    Validate(): ValidationResult;
+    /**
+     * Redundant safety check (also enforced by DB CHECK constraint).
+     */
+    private validateNoSelfReference;
+    /**
+     * Async validation: walk the dependency graph starting from DependsOnTaskID
+     * and check whether we eventually reach TaskID (which would create a cycle).
+     */
+    ValidateAsync(): Promise<ValidationResult>;
+    /**
+     * BFS/iterative walk of the dependency graph to detect cycles.
+     *
+     * Starting from `DependsOnTaskID`, follow all outgoing DependsOnTaskID edges.
+     * If we reach `TaskID`, saving this row would create a cycle → reject.
+     */
+    private validateNoCycle;
+}
+//# sourceMappingURL=TaskDependencyEntitySubclass.d.ts.map

package/dist/custom/TaskDependencyEntitySubclass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskDependencyEntitySubclass.d.ts","sourceRoot":"","sources":["../../src/custom/TaskDependencyEntitySubclass.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAqB,gBAAgB,EAA4C,MAAM,sBAAsB,CAAC;AAGjI;;;;;;GAMG;AACH,qBACa,oBAAqB,SAAQ,UAAU;IAEhC,QAAQ,IAAI,gBAAgB;IAS5C;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAa/B;;;OAGG;IACmB,aAAa,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAShE;;;;;OAKG;YACW,eAAe;CAwChC"}

package/dist/custom/TaskDependencyEntitySubclass.js

@@ -0,0 +1,87 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { BaseEntity, RunView, ValidationErrorInfo, ValidationErrorType } from "@memberjunction/core";
+import { RegisterClass } from "@memberjunction/global";
+/**
+ * Custom entity subclass for MJ_BizApps_Tasks: Task Dependencies.
+ * Prevents circular dependencies by walking the dependency graph
+ * before allowing a save.
+ *
+ * Registered with priority 1 to override the CodeGen-generated base class.
+ */
+let TaskDependencyEntity = class TaskDependencyEntity extends BaseEntity {
+    Validate() {
+        const result = super.Validate();
+        this.validateNoSelfReference(result);
+        result.Success = result.Success && result.Errors.length === 0;
+        return result;
+    }
+    /**
+     * Redundant safety check (also enforced by DB CHECK constraint).
+     */
+    validateNoSelfReference(result) {
+        const taskID = this.Get('TaskID');
+        const dependsOnTaskID = this.Get('DependsOnTaskID');
+        if (taskID && dependsOnTaskID && taskID === dependsOnTaskID) {
+            result.Errors.push(new ValidationErrorInfo('DependsOnTaskID', 'A task cannot depend on itself.', dependsOnTaskID, ValidationErrorType.Failure));
+        }
+    }
+    /**
+     * Async validation: walk the dependency graph starting from DependsOnTaskID
+     * and check whether we eventually reach TaskID (which would create a cycle).
+     */
+    async ValidateAsync() {
+        const result = await super.ValidateAsync();
+        await this.validateNoCycle(result);
+        result.Success = result.Success && result.Errors.length === 0;
+        return result;
+    }
+    /**
+     * BFS/iterative walk of the dependency graph to detect cycles.
+     *
+     * Starting from `DependsOnTaskID`, follow all outgoing DependsOnTaskID edges.
+     * If we reach `TaskID`, saving this row would create a cycle → reject.
+     */
+    async validateNoCycle(result) {
+        const taskID = this.Get('TaskID');
+        const dependsOnTaskID = this.Get('DependsOnTaskID');
+        if (!taskID || !dependsOnTaskID)
+            return;
+        const visited = new Set();
+        const queue = [dependsOnTaskID];
+        while (queue.length > 0) {
+            const current = queue.shift();
+            if (current === taskID) {
+                result.Errors.push(new ValidationErrorInfo('DependsOnTaskID', 'This dependency would create a circular reference.', dependsOnTaskID, ValidationErrorType.Failure));
+                return;
+            }
+            if (visited.has(current))
+                continue;
+            visited.add(current);
+            // Load all tasks that `current` depends on
+            const rv = new RunView();
+            const upstream = await rv.RunView({
+                EntityName: 'MJ_BizApps_Tasks: Task Dependencies',
+                ExtraFilter: `TaskID = '${current}'`,
+                ResultType: 'simple',
+            });
+            if (upstream?.Results) {
+                for (const dep of upstream.Results) {
+                    const upstreamID = dep.DependsOnTaskID;
+                    if (upstreamID && !visited.has(upstreamID)) {
+                        queue.push(upstreamID);
+                    }
+                }
+            }
+        }
+    }
+};
+TaskDependencyEntity = __decorate([
+    RegisterClass(BaseEntity, 'MJ_BizApps_Tasks: Task Dependencies', 1)
+], TaskDependencyEntity);
+export { TaskDependencyEntity };
+//# sourceMappingURL=TaskDependencyEntitySubclass.js.map

package/dist/custom/TaskDependencyEntitySubclass.js.map

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

package/dist/custom/TaskEntitySubclass.d.ts

@@ -0,0 +1,17 @@
+import { BaseEntity, ValidationResult } from "@memberjunction/core";
+/**
+ * Custom entity subclass for MJ_BizApps_Tasks: Tasks.
+ *
+ * Client-safe logic ONLY: field validation and in-record status-transition
+ * side-effects (StartedAt/CompletedAt/PercentComplete). Server-only side-effects
+ * (activity logging, sub-task rollup) live in TaskEntityServer.
+ *
+ * Registered with priority 1 to override the CodeGen-generated base class (priority 0).
+ */
+export declare class TaskEntity extends BaseEntity {
+    Validate(): ValidationResult;
+    private validatePercentComplete;
+    private validateDueAfterStart;
+    private applyStatusTransitionSideEffects;
+}
+//# sourceMappingURL=TaskEntitySubclass.d.ts.map

package/dist/custom/TaskEntitySubclass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskEntitySubclass.d.ts","sourceRoot":"","sources":["../../src/custom/TaskEntitySubclass.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAA4C,MAAM,sBAAsB,CAAC;AAG9G;;;;;;;;GAQG;AACH,qBACa,UAAW,SAAQ,UAAU;IAMtB,QAAQ,IAAI,gBAAgB;IAW5C,OAAO,CAAC,uBAAuB;IAY/B,OAAO,CAAC,qBAAqB;IAiB7B,OAAO,CAAC,gCAAgC;CA4B3C"}

package/dist/custom/TaskEntitySubclass.js

@@ -0,0 +1,70 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { BaseEntity, ValidationErrorInfo, ValidationErrorType } from "@memberjunction/core";
+import { RegisterClass } from "@memberjunction/global";
+/**
+ * Custom entity subclass for MJ_BizApps_Tasks: Tasks.
+ *
+ * Client-safe logic ONLY: field validation and in-record status-transition
+ * side-effects (StartedAt/CompletedAt/PercentComplete). Server-only side-effects
+ * (activity logging, sub-task rollup) live in TaskEntityServer.
+ *
+ * Registered with priority 1 to override the CodeGen-generated base class (priority 0).
+ */
+let TaskEntity = class TaskEntity extends BaseEntity {
+    // ---------------------------------------------------------------
+    // Validation
+    // ---------------------------------------------------------------
+    Validate() {
+        const result = super.Validate();
+        this.validatePercentComplete(result);
+        this.validateDueAfterStart(result);
+        this.applyStatusTransitionSideEffects();
+        result.Success = result.Success && result.Errors.length === 0;
+        return result;
+    }
+    validatePercentComplete(result) {
+        const pct = this.Get('PercentComplete');
+        if (pct != null && (pct < 0 || pct > 100)) {
+            result.Errors.push(new ValidationErrorInfo('PercentComplete', 'Percent complete must be between 0 and 100.', pct, ValidationErrorType.Failure));
+        }
+    }
+    validateDueAfterStart(result) {
+        const startedAt = this.Get('StartedAt');
+        const dueAt = this.Get('DueAt');
+        if (startedAt && dueAt && dueAt <= startedAt) {
+            result.Errors.push(new ValidationErrorInfo('DueAt', 'Due date must be after the start date.', dueAt, ValidationErrorType.Failure));
+        }
+    }
+    // ---------------------------------------------------------------
+    // Status transition side-effects
+    // ---------------------------------------------------------------
+    applyStatusTransitionSideEffects() {
+        const statusField = this.Fields.find(f => f.CodeName === 'Status');
+        if (!statusField || !statusField.Dirty)
+            return;
+        const oldStatus = statusField.OldValue;
+        const newStatus = statusField.Value;
+        if (newStatus === 'InProgress' && !this.Get('StartedAt')) {
+            this.Set('StartedAt', new Date());
+        }
+        if (newStatus === 'Completed') {
+            if (!this.Get('CompletedAt')) {
+                this.Set('CompletedAt', new Date());
+            }
+            this.Set('PercentComplete', 100);
+        }
+        if (oldStatus === 'Completed' && newStatus !== 'Completed' && newStatus !== 'Cancelled') {
+            this.Set('CompletedAt', null);
+        }
+    }
+};
+TaskEntity = __decorate([
+    RegisterClass(BaseEntity, 'MJ_BizApps_Tasks: Tasks', 1)
+], TaskEntity);
+export { TaskEntity };
+//# sourceMappingURL=TaskEntitySubclass.js.map

package/dist/custom/TaskEntitySubclass.js.map

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