@bwi-mentorspaces/application-utils-npm 0.0.142 → 0.0.143

package/match-guidance/index.d.ts

@@ -3,3 +3,4 @@ export * from "./next-step";
 export * from "./session-facts";
 export * from "./message-facts";
 export * from "./invitation-history";
+export * from "./reporting-eligibility";

package/match-guidance/index.js

@@ -15,4 +15,5 @@ __exportStar(require("./next-step"), exports);
 __exportStar(require("./session-facts"), exports);
 __exportStar(require("./message-facts"), exports);
 __exportStar(require("./invitation-history"), exports);
+__exportStar(require("./reporting-eligibility"), exports);
 //# sourceMappingURL=index.js.map

package/match-guidance/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../match-guidance/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,0CAAwB;AACxB,8CAA4B;AAC5B,kDAAgC;AAChC,kDAAgC;AAChC,uDAAqC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../match-guidance/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,0CAAwB;AACxB,8CAA4B;AAC5B,kDAAgC;AAChC,kDAAgC;AAChC,uDAAqC;AACrC,0DAAwC"}

package/match-guidance/reporting-eligibility.d.ts

@@ -0,0 +1,15 @@
+import { IGuidanceSql } from "./model";
+/** Trusted aliases for already-joined match eligibility records. */
+export interface IProgramMatchEligibilityAliases<TSql> {
+    match: TSql;
+    mentor: TSql;
+    mentee: TSql;
+    mentorMember: TSql;
+    menteeMember: TSql;
+}
+/** Bind the existing program reporting eligibility rules to the caller's SQL implementation. */
+export declare function createReportingEligibility<TSql>(adapter: IGuidanceSql<TSql>): {
+    buildAdminProgramMemberEligibilityCondition: (programMemberAlias: TSql, userAlias: TSql) => TSql;
+    programMatchEligibilityConditionSql: (programRef: string, evaluatedAt: Date, aliases: IProgramMatchEligibilityAliases<TSql>) => TSql;
+    eligibleProgramMatchesSql: (programRef: string, evaluatedAt: Date) => TSql;
+};

package/match-guidance/reporting-eligibility.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createReportingEligibility = void 0;
+/** Bind the existing program reporting eligibility rules to the caller's SQL implementation. */
+function createReportingEligibility(adapter) {
+    /**
+     * Build participant eligibility for admin program data and recommendations.
+     * Callers provide static SQL aliases and retain their own program scoping.
+     *
+     * @param {TSql} programMemberAlias Trusted program-member SQL alias
+     * @param {TSql} userAlias Trusted user SQL alias
+     * @returns {TSql} Parameterized participant eligibility predicate
+     */
+    function buildAdminProgramMemberEligibilityCondition(programMemberAlias, userAlias) {
+        return adapter.sql `(
+        ${programMemberAlias}.Status = ${"active"}
+        AND ${programMemberAlias}.IsOnboarded = TRUE
+        AND ${userAlias}.Role <> ${"MSA"}
+    )`;
+    }
+    /**
+     * Evaluate reporting eligibility against existing joins without fetching them again.
+     *
+     * @param {string} programRef Owning program
+     * @param {Date} evaluatedAt Single request timestamp
+     * @param {IProgramMatchEligibilityAliases} aliases Trusted SQL aliases
+     * @returns {TSql} Shared reporting eligibility predicate
+     */
+    function programMatchEligibilityConditionSql(programRef, evaluatedAt, aliases) {
+        const { match, mentor, mentee, mentorMember, menteeMember } = aliases;
+        return adapter.sql `(${match}.ProgramRef = ${programRef} AND ${match}.Status = ${"active"}
+        AND ${match}.PublishedOn IS NOT NULL AND ${match}.PublishedOn <= ${evaluatedAt}
+        AND ${mentor}.Status = ${"active"} AND ${mentee}.Status = ${"active"}
+        AND ${mentor}.IsOnboarded = TRUE AND ${mentee}.IsOnboarded = TRUE
+        AND ${mentorMember}.Role = 'Mentor' AND ${menteeMember}.Role = 'Mentee'
+        AND ${buildAdminProgramMemberEligibilityCondition(mentorMember, mentor)}
+        AND ${buildAdminProgramMemberEligibilityCondition(menteeMember, mentee)})`;
+    }
+    /**
+     * Shared joins and eligibility predicates for match count and page retrieval.
+     *
+     * @param {string} programRef Owning program
+     * @param {Date} evaluatedAt Single request timestamp
+     * @returns {TSql} Parameterized FROM and WHERE fragment
+     */
+    function eligibleProgramMatchesSql(programRef, evaluatedAt) {
+        return adapter.sql `
+        FROM \`match\` m
+        INNER JOIN user mentor ON mentor.Id = m.MentorUserId
+        INNER JOIN user mentee ON mentee.Id = m.MenteeUserId
+        INNER JOIN programmember mentorMember ON mentorMember.ProgramRef = m.ProgramRef AND mentorMember.UserRef = mentor.Ref
+        INNER JOIN programmember menteeMember ON menteeMember.ProgramRef = m.ProgramRef AND menteeMember.UserRef = mentee.Ref
+        WHERE ${programMatchEligibilityConditionSql(programRef, evaluatedAt, {
+            match: adapter.sql `m`,
+            mentor: adapter.sql `mentor`,
+            mentee: adapter.sql `mentee`,
+            mentorMember: adapter.sql `mentorMember`,
+            menteeMember: adapter.sql `menteeMember`
+        })}
+    `;
+    }
+    return {
+        buildAdminProgramMemberEligibilityCondition,
+        programMatchEligibilityConditionSql,
+        eligibleProgramMatchesSql
+    };
+}
+exports.createReportingEligibility = createReportingEligibility;
+//# sourceMappingURL=reporting-eligibility.js.map

package/match-guidance/reporting-eligibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporting-eligibility.js","sourceRoot":"","sources":["../../match-guidance/reporting-eligibility.ts"],"names":[],"mappings":";;;AAWA,gGAAgG;AAChG,SAAgB,0BAA0B,CAAO,OAA2B;IACxE;;;;;;;OAOG;IACH,SAAS,2CAA2C,CAAC,kBAAwB,EAAE,SAAe;QAC1F,OAAO,OAAO,CAAC,GAAG,CAAA;UAChB,kBAAkB,aAAa,QAAQ;cACnC,kBAAkB;cAClB,SAAS,YAAY,KAAK;MAClC,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACH,SAAS,mCAAmC,CACxC,UAAkB,EAClB,WAAiB,EACjB,OAA8C;QAE9C,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,GAA0C,OAAO,CAAC;QAC7G,OAAO,OAAO,CAAC,GAAG,CAAA,IAAI,KAAK,iBAAiB,UAAU,QAAQ,KAAK,aAAa,QAAQ;cAClF,KAAK,gCAAgC,KAAK,mBAAmB,WAAW;cACxE,MAAM,aAAa,QAAQ,QAAQ,MAAM,aAAa,QAAQ;cAC9D,MAAM,2BAA2B,MAAM;cACvC,YAAY,wBAAwB,YAAY;cAChD,2CAA2C,CAAC,YAAY,EAAE,MAAM,CAAC;cACjE,2CAA2C,CAAC,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC;IAC/E,CAAC;IAED;;;;;;OAMG;IACH,SAAS,yBAAyB,CAAC,UAAkB,EAAE,WAAiB;QACpE,OAAO,OAAO,CAAC,GAAG,CAAA;;;;;;gBAMV,mCAAmC,CAAC,UAAU,EAAE,WAAW,EAAE;YACjE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAA,GAAG;YACrB,MAAM,EAAE,OAAO,CAAC,GAAG,CAAA,QAAQ;YAC3B,MAAM,EAAE,OAAO,CAAC,GAAG,CAAA,QAAQ;YAC3B,YAAY,EAAE,OAAO,CAAC,GAAG,CAAA,cAAc;YACvC,YAAY,EAAE,OAAO,CAAC,GAAG,CAAA,cAAc;SAC1C,CAAC;KACL,CAAC;IACF,CAAC;IAED,OAAO;QACH,2CAA2C;QAC3C,mCAAmC;QACnC,yBAAyB;KAC5B,CAAC;AACN,CAAC;AArED,gEAqEC"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@bwi-mentorspaces/application-utils-npm",
-    "version": "0.0.142",
+    "version": "0.0.143",
     "description": "Mentor Spaces npm packages for reusable models, utils, and abstracted, commonly used processes for DB Repo, Logging, etc.",
     "author": {
         "name": "Mentor Spaces",