@bwi-mentorspaces/application-utils-npm 0.0.137 → 0.0.139

package/chat/stream/enum/index.d.ts

@@ -44,6 +44,8 @@ export declare enum CustomEventType {
     MatchCreated = "match_created",
     AdminMatchCreated = "admin_match_created",
     AdminMatchRemoved = "admin_match_removed",
+    MatchRemovalRequested = "match_removal_requested",
+    MatchRemovalDeclined = "match_removal_declined",
     ProgramMemberRemoved = "program_member_removed",
     SurveyPrompt = "program_survey_prompt",
     ProgramAnnouncement = "program_announcement",

package/chat/stream/enum/index.js

@@ -52,6 +52,8 @@ var CustomEventType;
     CustomEventType["MatchCreated"] = "match_created";
     CustomEventType["AdminMatchCreated"] = "admin_match_created";
     CustomEventType["AdminMatchRemoved"] = "admin_match_removed";
+    CustomEventType["MatchRemovalRequested"] = "match_removal_requested";
+    CustomEventType["MatchRemovalDeclined"] = "match_removal_declined";
     CustomEventType["ProgramMemberRemoved"] = "program_member_removed";
     CustomEventType["SurveyPrompt"] = "program_survey_prompt";
     CustomEventType["ProgramAnnouncement"] = "program_announcement";

package/chat/stream/enum/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../chat/stream/enum/index.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,IAAY,UAGX;AAHD,WAAY,UAAU;IAClB,+BAAiB,CAAA;IACjB,+BAAiB,CAAA;AACrB,CAAC,EAHW,UAAU,GAAV,kBAAU,KAAV,kBAAU,QAGrB;AAED;;GAEG;AACH,IAAY,YAEX;AAFD,WAAY,YAAY;IACpB,gEAAiB,CAAA;AACrB,CAAC,EAFW,YAAY,GAAZ,oBAAY,KAAZ,oBAAY,QAEvB;AAED;;GAEG;AACH,IAAY,WAGX;AAHD,WAAY,WAAW;IACnB,4BAAa,CAAA;IACb,sCAAuB,CAAA;AAC3B,CAAC,EAHW,WAAW,GAAX,mBAAW,KAAX,mBAAW,QAGtB;AAED;;GAEG;AACH,IAAY,QAKX;AALD,WAAY,QAAQ;IAChB,yBAAa,CAAA;IACb,2BAAe,CAAA;IACf,mCAAuB,CAAA;IACvB,2BAAe,CAAA;AACnB,CAAC,EALW,QAAQ,GAAR,gBAAQ,KAAR,gBAAQ,QAKnB;AAED;;GAEG;AACH,IAAY,eAkBX;AAlBD,WAAY,eAAe;IACvB,qDAAkC,CAAA;IAClC,qDAAkC,CAAA;IAClC,sEAAmD,CAAA;IACnD,qDAAkC,CAAA;IAClC,qEAAkD,CAAA;IAClD,uEAAoD,CAAA;IACpD,+CAA4B,CAAA;IAC5B,uDAAoC,CAAA;IACpC,uDAAoC,CAAA;IACpC,qDAAkC,CAAA;IAClC,iDAA8B,CAAA;IAC9B,4DAAyC,CAAA;IACzC,4DAAyC,CAAA;IACzC,kEAA+C,CAAA;IAC/C,yDAAsC,CAAA;IACtC,+DAA4C,CAAA;IAC5C,8EAA2D,CAAA;AAC/D,CAAC,EAlBW,eAAe,GAAf,uBAAe,KAAf,uBAAe,QAkB1B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../chat/stream/enum/index.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,IAAY,UAGX;AAHD,WAAY,UAAU;IAClB,+BAAiB,CAAA;IACjB,+BAAiB,CAAA;AACrB,CAAC,EAHW,UAAU,GAAV,kBAAU,KAAV,kBAAU,QAGrB;AAED;;GAEG;AACH,IAAY,YAEX;AAFD,WAAY,YAAY;IACpB,gEAAiB,CAAA;AACrB,CAAC,EAFW,YAAY,GAAZ,oBAAY,KAAZ,oBAAY,QAEvB;AAED;;GAEG;AACH,IAAY,WAGX;AAHD,WAAY,WAAW;IACnB,4BAAa,CAAA;IACb,sCAAuB,CAAA;AAC3B,CAAC,EAHW,WAAW,GAAX,mBAAW,KAAX,mBAAW,QAGtB;AAED;;GAEG;AACH,IAAY,QAKX;AALD,WAAY,QAAQ;IAChB,yBAAa,CAAA;IACb,2BAAe,CAAA;IACf,mCAAuB,CAAA;IACvB,2BAAe,CAAA;AACnB,CAAC,EALW,QAAQ,GAAR,gBAAQ,KAAR,gBAAQ,QAKnB;AAED;;GAEG;AACH,IAAY,eAoBX;AApBD,WAAY,eAAe;IACvB,qDAAkC,CAAA;IAClC,qDAAkC,CAAA;IAClC,sEAAmD,CAAA;IACnD,qDAAkC,CAAA;IAClC,qEAAkD,CAAA;IAClD,uEAAoD,CAAA;IACpD,+CAA4B,CAAA;IAC5B,uDAAoC,CAAA;IACpC,uDAAoC,CAAA;IACpC,qDAAkC,CAAA;IAClC,iDAA8B,CAAA;IAC9B,4DAAyC,CAAA;IACzC,4DAAyC,CAAA;IACzC,oEAAiD,CAAA;IACjD,kEAA+C,CAAA;IAC/C,kEAA+C,CAAA;IAC/C,yDAAsC,CAAA;IACtC,+DAA4C,CAAA;IAC5C,8EAA2D,CAAA;AAC/D,CAAC,EApBW,eAAe,GAAf,uBAAe,KAAf,uBAAe,QAoB1B"}

package/chat/stream/models/_/event.data.d.ts

@@ -205,6 +205,17 @@ export interface IEventTypesData {
         mentorRef: string;
         menteeRef: string;
     };
+    [CustomEventType.MatchRemovalRequested]: {
+        programRef: string;
+        programName: string;
+        matchRef: string;
+        memberName: string;
+    };
+    [CustomEventType.MatchRemovalDeclined]: {
+        programRef: string;
+        programName: string;
+        declineExplanation: string;
+    };
     [CustomEventType.ProgramMemberRemoved]: {
         programRef: string;
         programName: string;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@bwi-mentorspaces/application-utils-npm",
-    "version": "0.0.137",
+    "version": "0.0.139",
     "description": "Mentor Spaces npm packages for reusable models, utils, and abstracted, commonly used processes for DB Repo, Logging, etc.",
     "author": {
         "name": "Mentor Spaces",
@@ -21,6 +21,7 @@
         "@types/crypto-js": "^4.1.0",
         "@types/express": "^4.17.13",
         "@types/jest": "^27.4.0",
+        "@types/luxon": "^3.7.6",
         "@types/node": "^17.0.8",
         "@types/supertest": "^2.0.11",
         "@types/uuid": "^8.3.4",
@@ -45,6 +46,7 @@
         "crypto-js": "^4.1.1",
         "express": "^4.17.2",
         "guid-typescript": "^1.0.9",
+        "luxon": "^3.7.2",
         "reflect-metadata": "^0.1.13",
         "serverless-http": "^2.7.0",
         "stream-chat": "^6.6.0",

package/program-engagement/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./model";
+export * from "./period";
+export * from "./query";

package/program-engagement/index.js

@@ -0,0 +1,16 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./model"), exports);
+__exportStar(require("./period"), exports);
+__exportStar(require("./query"), exports);
+//# sourceMappingURL=index.js.map

package/program-engagement/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../program-engagement/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,0CAAwB;AACxB,2CAAyB;AACzB,0CAAwB"}

package/program-engagement/model.d.ts

@@ -0,0 +1,93 @@
+/** Program fields needed for engagement, reusable by callers with an existing program. */
+export interface IEngagementProgram {
+    Ref: string;
+    StartDate: Date | null;
+    EndDate: Date | null;
+    TimeZone: string | null;
+    EngagementType: "MEETINGS" | "MINUTES" | null;
+    EngagementAmount: number | null;
+    EngagementInterval: number | null;
+    EngagementPeriodUnit: "DAY" | "WEEK" | "MONTH" | null;
+}
+/** Validated, complete program engagement configuration. */
+export interface IEngagementConfiguration {
+    timeZone: string;
+    type: NonNullable<IEngagementProgram["EngagementType"]>;
+    amount: number;
+    interval: number;
+    periodUnit: NonNullable<IEngagementProgram["EngagementPeriodUnit"]>;
+}
+/** Calendar boundaries and program-clipped boundaries; end timestamps are exclusive. */
+export interface IEngagementPeriod {
+    calendarStart: Date;
+    calendarEndExclusive: Date;
+    start: Date;
+    endExclusive: Date;
+    fullIntervalDays: number;
+}
+/** Program-level periods resolved using one request timestamp. */
+export interface IEngagementPeriods {
+    previous: IEngagementPeriod | null;
+    current: IEngagementPeriod | null;
+}
+/** Eligible match and participant identity. */
+export interface IEngagementMatch {
+    id: number;
+    ref: string;
+    publishedOn: Date;
+    mentorRef: string;
+    menteeRef: string;
+}
+/** Invitation classification for incomplete sessions. */
+export declare type EngagementInvitationState = "accepted" | "pending" | "declined" | "unclassified";
+/** Incomplete sessions grouped by their position relative to the evaluation timestamp. */
+export declare type EngagementSessionTiming = "future" | "underway" | "endedIncomplete";
+/** Count and scheduled duration, without counting these sessions as completed engagement. */
+export interface IEngagementSessionMeasure {
+    meetings: number;
+    scheduledMinutes: number;
+}
+/** Activity facts for one eligible match-period intersection. */
+export interface IEngagementSessionFacts {
+    completedMeetings: number;
+    completedOfflineMeetings: number;
+    completedMinutes: number;
+    incomplete: Record<EngagementSessionTiming, Record<EngagementInvitationState, IEngagementSessionMeasure>>;
+}
+/** Calculated engagement for one match in one period. */
+export interface IMatchPeriodEngagement {
+    classification: EngagementClassification | null;
+    status: "MET" | "SHORTFALL" | "IN_PROGRESS" | "NOT_APPLICABLE";
+    start: Date | null;
+    endExclusive: Date | null;
+    eligibleDays: number;
+    elapsedEligibleDays: number;
+    remainingEligibleDays: number;
+    requirement: number | null;
+    creditedAmount: number;
+    remainingAmount: number | null;
+    requirementSatisfied: boolean | null;
+    sessions: IEngagementSessionFacts;
+}
+/** Independent engagement results for one match. */
+export interface IMatchEngagement extends IEngagementMatch {
+    previous: IMatchPeriodEngagement | null;
+    current: IMatchPeriodEngagement | null;
+}
+/** Approved session progress states, evaluated independently from member activity. */
+export declare const ENGAGEMENT_CLASSIFICATIONS: readonly ["GREEN", "YELLOW", "RED", "NO_ACTIVITY"];
+/** One supported session progress classification. */
+export declare type EngagementClassification = typeof ENGAGEMENT_CLASSIFICATIONS[number];
+/** One program-local calendar day, serialized as UTC for parameterized SQL. */
+export interface IEngagementCalendarDay {
+    period: "previous" | "current";
+    periodStart: string;
+    endTime: string;
+    dayStart: string;
+    dayEnd: string;
+    offlineStart: string;
+    offlineEnd: string;
+    eligibleDays: number;
+    elapsedDays: number;
+    fullIntervalDays: number;
+}

package/program-engagement/model.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ENGAGEMENT_CLASSIFICATIONS = void 0;
+/** Approved session progress states, evaluated independently from member activity. */
+exports.ENGAGEMENT_CLASSIFICATIONS = ["GREEN", "YELLOW", "RED", "NO_ACTIVITY"];
+//# sourceMappingURL=model.js.map

package/program-engagement/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../program-engagement/model.ts"],"names":[],"mappings":";;;AAuFA,sFAAsF;AACzE,QAAA,0BAA0B,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,CAAU,CAAC"}

package/program-engagement/period.d.ts

@@ -0,0 +1,50 @@
+import { IEngagementProgram, IEngagementConfiguration, IEngagementPeriods, IEngagementCalendarDay } from "./model";
+/**
+ * Determine whether a value is a valid IANA timezone identifier.
+ *
+ * @param {unknown} value Potential timezone identifier
+ * @returns {value is string} Whether the value is a valid timezone identifier
+ */
+export declare function isValidTimeZone(value: unknown): value is string;
+/**
+ * Determine whether the program's exclusive end boundary has been reached.
+ *
+ * @param {Pick<IEngagementProgram, "EndDate">} program Loaded program dates
+ * @param {Date} evaluatedAt Shared request timestamp
+ * @returns {boolean} Whether the program has ended
+ */
+export declare function hasProgramEnded(program: Pick<IEngagementProgram, "EndDate">, evaluatedAt: Date): boolean;
+/**
+ * Validate populated settings and distinguish programs that are not configured yet.
+ *
+ * @param {IEngagementProgram} program Already-loaded program
+ * @returns {IEngagementConfiguration | null} Complete configuration or null
+ */
+export declare function resolveEngagementConfiguration(program: IEngagementProgram): IEngagementConfiguration | null;
+/**
+ * Count calendar days touched by a nonempty half-open timestamp interval.
+ *
+ * @param {Date} start Inclusive lower bound
+ * @param {Date} endExclusive Exclusive upper bound
+ * @param {string} timeZone Program timezone
+ * @returns {number} Whole calendar days; a partial day counts as one
+ */
+export declare function engagementCalendarDays(start: Date, endExclusive: Date, timeZone: string): number;
+/**
+ * Parameterize calendar-day boundaries once per program, including daylight-saving changes.
+ *
+ * @param {IEngagementPeriods} periods Program-clipped periods
+ * @param {string} timeZone Program timezone
+ * @param {Date} evaluatedAt Shared evaluation instant
+ * @returns {IEngagementCalendarDay[]} UTC boundaries and whole-day counts
+ */
+export declare function engagementCalendarRows(periods: IEngagementPeriods, timeZone: string, evaluatedAt: Date): IEngagementCalendarDay[];
+/**
+ * Resolve only the current and immediately preceding program periods.
+ *
+ * @param {IEngagementProgram} program Already-loaded program with a start date
+ * @param {IEngagementConfiguration} configuration Validated settings
+ * @param {Date} evaluatedAt Single request timestamp
+ * @returns {IEngagementPeriods} Calendar periods clipped to program dates
+ */
+export declare function resolveEngagementPeriods(program: IEngagementProgram, configuration: IEngagementConfiguration, evaluatedAt: Date): IEngagementPeriods;

package/program-engagement/period.js

@@ -0,0 +1,193 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveEngagementPeriods = exports.engagementCalendarRows = exports.engagementCalendarDays = exports.resolveEngagementConfiguration = exports.hasProgramEnded = exports.isValidTimeZone = void 0;
+const luxon_1 = require("luxon");
+const core_1 = require("../core");
+/**
+ * Determine whether a value is a valid IANA timezone identifier.
+ *
+ * @param {unknown} value Potential timezone identifier
+ * @returns {value is string} Whether the value is a valid timezone identifier
+ */
+function isValidTimeZone(value) {
+    if (typeof value !== "string" || !value.trim()) {
+        return false;
+    }
+    try {
+        new Intl.DateTimeFormat("en-US", { timeZone: value.trim() }).format();
+        return true;
+    }
+    catch (_a) {
+        return false;
+    }
+}
+exports.isValidTimeZone = isValidTimeZone;
+/**
+ * Determine whether the program's exclusive end boundary has been reached.
+ *
+ * @param {Pick<IEngagementProgram, "EndDate">} program Loaded program dates
+ * @param {Date} evaluatedAt Shared request timestamp
+ * @returns {boolean} Whether the program has ended
+ */
+function hasProgramEnded(program, evaluatedAt) {
+    return program.EndDate != null && evaluatedAt >= program.EndDate;
+}
+exports.hasProgramEnded = hasProgramEnded;
+/**
+ * Validate populated settings and distinguish programs that are not configured yet.
+ *
+ * @param {IEngagementProgram} program Already-loaded program
+ * @returns {IEngagementConfiguration | null} Complete configuration or null
+ */
+function resolveEngagementConfiguration(program) {
+    const validInteger = (value) => value == null || (Number.isInteger(value) && value >= 1 && value <= 65535);
+    if ((program.TimeZone != null && !isValidTimeZone(program.TimeZone)) ||
+        (program.EngagementType != null && !["MEETINGS", "MINUTES"].includes(program.EngagementType)) ||
+        (program.EngagementPeriodUnit != null && !["DAY", "WEEK", "MONTH"].includes(program.EngagementPeriodUnit)) ||
+        !validInteger(program.EngagementAmount) ||
+        !validInteger(program.EngagementInterval) ||
+        (program.StartDate != null && !Number.isFinite(program.StartDate.getTime())) ||
+        (program.EndDate != null && !Number.isFinite(program.EndDate.getTime())) ||
+        (program.StartDate != null && program.EndDate != null && program.EndDate <= program.StartDate)) {
+        throw new core_1.ApiError(500 /* InternalServerError */, "Invalid program engagement configuration or program dates.");
+    }
+    if (program.TimeZone == null ||
+        program.EngagementType == null ||
+        program.EngagementAmount == null ||
+        program.EngagementInterval == null ||
+        program.EngagementPeriodUnit == null)
+        return null;
+    return {
+        timeZone: program.TimeZone.trim(),
+        type: program.EngagementType,
+        amount: program.EngagementAmount,
+        interval: program.EngagementInterval,
+        periodUnit: program.EngagementPeriodUnit
+    };
+}
+exports.resolveEngagementConfiguration = resolveEngagementConfiguration;
+/**
+ * Count calendar days touched by a nonempty half-open timestamp interval.
+ *
+ * @param {Date} start Inclusive lower bound
+ * @param {Date} endExclusive Exclusive upper bound
+ * @param {string} timeZone Program timezone
+ * @returns {number} Whole calendar days; a partial day counts as one
+ */
+function engagementCalendarDays(start, endExclusive, timeZone) {
+    if (endExclusive <= start)
+        return 0;
+    const firstDay = luxon_1.DateTime.fromJSDate(start, { zone: timeZone }).startOf("day");
+    const lastDay = luxon_1.DateTime.fromJSDate(endExclusive, { zone: timeZone }).minus({ milliseconds: 1 }).startOf("day");
+    return Math.round(lastDay.diff(firstDay, "days").days) + 1;
+}
+exports.engagementCalendarDays = engagementCalendarDays;
+/**
+ * Parameterize calendar-day boundaries once per program, including daylight-saving changes.
+ *
+ * @param {IEngagementPeriods} periods Program-clipped periods
+ * @param {string} timeZone Program timezone
+ * @param {Date} evaluatedAt Shared evaluation instant
+ * @returns {IEngagementCalendarDay[]} UTC boundaries and whole-day counts
+ */
+function engagementCalendarRows(periods, timeZone, evaluatedAt) {
+    const rows = [];
+    const today = luxon_1.DateTime.fromJSDate(evaluatedAt, { zone: timeZone }).startOf("day").toJSDate();
+    const sqlDate = (value) => value.toISOString().slice(0, 19).replace("T", " ");
+    for (const key of ["previous", "current"]) {
+        const period = periods[key];
+        if (!period)
+            continue;
+        let day = luxon_1.DateTime.fromJSDate(period.start, { zone: timeZone }).startOf("day");
+        while (day.toMillis() < period.endExclusive.getTime()) {
+            const next = day.plus({ days: 1 });
+            const start = new Date(Math.max(day.toMillis(), period.start.getTime()));
+            const eligibleDays = engagementCalendarDays(start, period.endExclusive, timeZone);
+            rows.push({
+                period: key,
+                periodStart: sqlDate(period.start),
+                endTime: sqlDate(period.endExclusive),
+                dayStart: sqlDate(start),
+                dayEnd: sqlDate(new Date(Math.min(next.toMillis(), period.endExclusive.getTime()))),
+                offlineStart: day.toFormat("yyyy-MM-dd HH:mm:ss"),
+                offlineEnd: luxon_1.DateTime.fromJSDate(period.endExclusive, { zone: timeZone })
+                    .minus({ milliseconds: 1 })
+                    .startOf("day")
+                    .plus({ days: 1 })
+                    .toFormat("yyyy-MM-dd HH:mm:ss"),
+                eligibleDays,
+                elapsedDays: key === "previous"
+                    ? eligibleDays
+                    : engagementCalendarDays(start, new Date(Math.min(today.getTime(), period.endExclusive.getTime())), timeZone),
+                fullIntervalDays: period.fullIntervalDays
+            });
+            day = next;
+        }
+    }
+    return rows;
+}
+exports.engagementCalendarRows = engagementCalendarRows;
+/**
+ * Resolve only the current and immediately preceding program periods.
+ *
+ * @param {IEngagementProgram} program Already-loaded program with a start date
+ * @param {IEngagementConfiguration} configuration Validated settings
+ * @param {Date} evaluatedAt Single request timestamp
+ * @returns {IEngagementPeriods} Calendar periods clipped to program dates
+ */
+function resolveEngagementPeriods(program, configuration, evaluatedAt) {
+    if (!program.StartDate || evaluatedAt < program.StartDate)
+        return { previous: null, current: null };
+    const start = luxon_1.DateTime.fromJSDate(program.StartDate, { zone: configuration.timeZone });
+    const startDay = start.startOf("day");
+    const unit = configuration.periodUnit;
+    const interval = configuration.interval;
+    const advance = (date, count) => unit === "MONTH"
+        ? date.plus({ months: count * interval })
+        : date.plus({ days: count * interval * (unit === "WEEK" ? 7 : 1) });
+    const containingStart = unit === "MONTH"
+        ? startDay.startOf("month")
+        : unit === "WEEK"
+            ? startDay.minus({ days: startDay.weekday % 7 })
+            : startDay;
+    const hasStub = containingStart.toMillis() !== startDay.toMillis();
+    const firstFullStart = !hasStub
+        ? containingStart
+        : unit === "MONTH"
+            ? containingStart.plus({ months: 1 })
+            : containingStart.plus({ weeks: 1 });
+    const ended = hasProgramEnded(program, evaluatedAt);
+    // The instant before an exclusive end belongs to the final ended period.
+    const reference = luxon_1.DateTime.fromJSDate(ended ? program.EndDate : evaluatedAt, { zone: configuration.timeZone });
+    const anchor = ended ? reference.minus({ milliseconds: 1 }) : reference;
+    const months = (anchor.year - firstFullStart.year) * 12 + anchor.month - firstFullStart.month;
+    const index = anchor < firstFullStart
+        ? -1
+        : unit === "MONTH"
+            ? Math.floor(months / interval)
+            : Math.floor(anchor.startOf("day").diff(firstFullStart, "days").days / (interval * (unit === "WEEK" ? 7 : 1)));
+    const periodAt = (periodIndex) => {
+        var _a, _b;
+        if (periodIndex < -1 || (periodIndex === -1 && !hasStub))
+            return null;
+        const nominalStart = periodIndex === -1 ? containingStart : advance(firstFullStart, periodIndex);
+        const nominalEnd = advance(nominalStart, 1);
+        const calendarEnd = periodIndex === -1 ? firstFullStart : nominalEnd;
+        const lower = Math.max(program.StartDate.getTime(), nominalStart.toMillis());
+        const upper = Math.min((_b = (_a = program.EndDate) === null || _a === void 0 ? void 0 : _a.getTime()) !== null && _b !== void 0 ? _b : Infinity, calendarEnd.toMillis());
+        if (upper <= lower)
+            return null;
+        return {
+            calendarStart: nominalStart.toJSDate(),
+            calendarEndExclusive: calendarEnd.toJSDate(),
+            start: new Date(lower),
+            endExclusive: new Date(upper),
+            fullIntervalDays: Math.round(nominalEnd.diff(nominalStart, "days").days)
+        };
+    };
+    return ended
+        ? { previous: periodAt(index), current: null }
+        : { previous: periodAt(index - 1), current: periodAt(index) };
+}
+exports.resolveEngagementPeriods = resolveEngagementPeriods;
+//# sourceMappingURL=period.js.map

package/program-engagement/period.js.map

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

package/program-engagement/query.d.ts

@@ -0,0 +1,11 @@
+import { IEngagementConfiguration, IEngagementPeriods } from "./model";
+/** Parameterized SQL supplied by the consumer's Prisma client. */
+export interface IEngagementSqlAdapter<TSql> {
+    sql: (strings: TemplateStringsArray, ...values: unknown[]) => TSql;
+    empty: TSql;
+}
+/** Bind the shared progress queries to a consumer's SQL implementation. */
+export declare function createEngagementQueries<TSql>(adapter: IEngagementSqlAdapter<TSql>): {
+    engagementSetSql: (programRef: string, programStartDate: Date, matches: TSql, periods: IEngagementPeriods, configuration: IEngagementConfiguration, evaluatedAt: Date, includeFacts?: boolean) => TSql;
+    matchSessionAcceptedSql: (menteeStatus: TSql, mentorStatus: TSql) => TSql;
+};

package/program-engagement/query.js

@@ -0,0 +1,129 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEngagementQueries = void 0;
+const luxon_1 = require("luxon");
+const period_1 = require("./period");
+/** Bind the shared progress queries to a consumer's SQL implementation. */
+function createEngagementQueries(adapter) {
+    /** Require accepted participation from both members. */
+    function matchSessionAcceptedSql(menteeStatus, mentorStatus) {
+        return adapter.sql `(${menteeStatus} IN (${"attending"}, ${"attended"})
+            AND ${mentorStatus} IN (${"attending"}, ${"attended"}))`;
+    }
+    const SESSION_PROGRESS_STARTUP_GRACE_DAYS = 7;
+    /**
+     * Build reusable CTEs for period facts and classification before filtering or pagination.
+     * The input relation supplies id, publishedOn, mentorRef and menteeRef for eligible matches.
+     *
+     * @param {string} programRef Owning program
+     * @param {Date} programStartDate Official program start, independent of reporting periods
+     * @param {TSql} matches Eligible match relation, optionally restricted to a page
+     * @param {IEngagementPeriods} periods Program-clipped periods
+     * @param {IEngagementConfiguration} configuration Validated requirement
+     * @param {Date} evaluatedAt Shared request timestamp
+     * @param {boolean} includeFacts Include grouped supporting facts for the engagement API
+     * @returns {TSql} CTE definitions without a leading WITH
+     */
+    function engagementSetSql(programRef, programStartDate, matches, periods, configuration, evaluatedAt, includeFacts = false) {
+        const calendar = JSON.stringify((0, period_1.engagementCalendarRows)(periods, configuration.timeZone, evaluatedAt));
+        // Relationship starts on or after this boundary are still within their first seven calendar days.
+        const startupGraceCutoff = luxon_1.DateTime.fromJSDate(evaluatedAt, { zone: configuration.timeZone })
+            .startOf("day")
+            .minus({ days: SESSION_PROGRESS_STARTUP_GRACE_DAYS - 1 })
+            .toJSDate();
+        const duration = configuration.type === "MINUTES";
+        const unit = duration ? 60 : 1;
+        const measure = duration ? adapter.sql `seconds` : adapter.sql `meetings`;
+        return adapter.sql `
+        engagement_matches AS (${matches}),
+        engagement_days AS (
+            SELECT d.* FROM JSON_TABLE(${calendar}, '$[*]' COLUMNS (
+                period VARCHAR(8) PATH '$.period',
+                periodStart DATETIME PATH '$.periodStart', endTime DATETIME PATH '$.endTime',
+                dayStart DATETIME PATH '$.dayStart', dayEnd DATETIME PATH '$.dayEnd',
+                offlineStart DATETIME PATH '$.offlineStart', offlineEnd DATETIME PATH '$.offlineEnd',
+                eligibleDays INT PATH '$.eligibleDays', elapsedDays INT PATH '$.elapsedDays',
+                fullIntervalDays INT PATH '$.fullIntervalDays'
+            )) d
+        ),
+        engagement_windows AS (
+            SELECT m.id AS matchId, m.mentorRef, m.menteeRef, d.period,
+                GREATEST(m.publishedOn, d.periodStart) AS startTime, d.endTime,
+                GREATEST(m.publishedOn, ${programStartDate}) >= ${startupGraceCutoff} AS inStartupGrace,
+                d.eligibleDays, d.elapsedDays, d.offlineStart, d.offlineEnd,
+                ROUND(CAST(${configuration.amount} AS DECIMAL(30, 12)) * d.eligibleDays / d.fullIntervalDays) AS requirement
+            FROM engagement_matches m JOIN engagement_days d
+                ON GREATEST(m.publishedOn, d.periodStart) >= d.dayStart
+                AND GREATEST(m.publishedOn, d.periodStart) < d.dayEnd
+        ),
+        engagement_session_facts AS (
+            SELECT /*+ NO_MERGE(w) */ w.matchId, w.period,
+                CASE WHEN s.IsCompleted = 1 THEN 'completed'
+                    WHEN s.StartTime > ${evaluatedAt} THEN 'future'
+                    WHEN s.EndTime > ${evaluatedAt} THEN 'underway'
+                    ELSE 'endedIncomplete' END AS timing,
+                CASE WHEN s.IsCompleted = 1 THEN 'unclassified'
+                    WHEN ma.CurrentAttendanceStatus = ${"declined"}
+                        OR ea.CurrentAttendanceStatus = ${"declined"} THEN 'declined'
+                    WHEN ma.CurrentAttendanceStatus IN (${"invited"}, ${"requested"})
+                        OR ea.CurrentAttendanceStatus IN (${"invited"}, ${"requested"}) THEN 'pending'
+                    WHEN ${matchSessionAcceptedSql(adapter.sql `ea.CurrentAttendanceStatus`, adapter.sql `ma.CurrentAttendanceStatus`)} THEN 'accepted'
+                    ELSE 'unclassified' END AS invitation,
+                CASE WHEN s.IsCompleted = 1 THEN COALESCE(s.DurationSeconds, TIMESTAMPDIFF(SECOND, s.StartTime, s.EndTime))
+                    ELSE TIMESTAMPDIFF(SECOND, s.StartTime, s.EndTime) END AS seconds, 0 AS offline
+            FROM engagement_windows w
+            JOIN session s ON s.MatchId = w.matchId AND s.ProgramRef = ${programRef}
+                AND s.IsOffline = FALSE AND s.Type = ${"ONEONONE"} AND s.StartTime >= w.startTime AND s.StartTime < w.endTime
+            LEFT JOIN sessionattendance ma ON ma.SessionRef = s.Ref AND ma.UserRef = w.mentorRef
+            LEFT JOIN sessionattendance ea ON ea.SessionRef = s.Ref AND ea.UserRef = w.menteeRef
+            UNION ALL
+            SELECT /*+ NO_MERGE(w) */ w.matchId, w.period, 'completed', 'unclassified', 0, 1
+            FROM engagement_windows w
+            JOIN session s ON s.MatchId = w.matchId AND s.ProgramRef = ${programRef}
+                AND s.IsOffline = TRUE AND s.IsCompleted = 1 AND s.Type = ${"ONEONONE"}
+                AND s.StartTime >= w.offlineStart AND s.StartTime < w.offlineEnd
+        ),
+        engagement_aggregates AS (
+            SELECT matchId, period, timing, invitation, COUNT(*) AS meetings, SUM(seconds) AS seconds, SUM(offline) AS offlineMeetings,
+                SUM(CASE WHEN seconds < 0 THEN 1 ELSE 0 END) AS invalidDurations
+            FROM engagement_session_facts GROUP BY matchId, period, timing, invitation
+        ),
+        engagement_totals AS (
+            SELECT matchId, period,
+                SUM(CASE WHEN timing = 'completed' THEN ${measure} ELSE 0 END) AS completedMeasure,
+                SUM(CASE WHEN timing = 'future' AND invitation = 'accepted' THEN ${measure} ELSE 0 END) AS futureMeasure,
+                SUM(CASE WHEN timing = 'completed' OR (timing = 'future' AND invitation = 'accepted')
+                    THEN meetings ELSE 0 END) AS positiveSessions,
+                SUM(invalidDurations) AS invalidDurations, SUM(offlineMeetings) AS completedOfflineMeetings
+                ${includeFacts
+            ? adapter.sql `, JSON_ARRAYAGG(JSON_OBJECT('timing', timing, 'invitation', invitation,
+                    'meetings', meetings, 'seconds', seconds)) AS aggregates`
+            : adapter.empty}
+            FROM engagement_aggregates GROUP BY matchId, period
+        ),
+        engagement_values AS (
+            SELECT /*+ NO_MERGE(w) */ w.*, COALESCE(t.completedMeasure, 0) AS completedMeasure,
+                COALESCE(t.positiveSessions, 0) AS positiveSessions,
+                COALESCE(t.completedOfflineMeetings, 0) AS completedOfflineMeetings,
+                COALESCE(t.futureMeasure, 0) AS futureMeasure, COALESCE(t.invalidDurations, 0) AS invalidDurations
+                ${includeFacts ? adapter.sql `, COALESCE(t.aggregates, JSON_ARRAY()) AS aggregates` : adapter.empty}
+            FROM engagement_windows w LEFT JOIN engagement_totals t ON t.matchId = w.matchId AND t.period = w.period
+        ),
+        engagement_classified AS (
+            SELECT v.*, CASE
+                WHEN period = 'current' AND inStartupGrace AND positiveSessions = 0 THEN 'NO_ACTIVITY'
+                WHEN completedMeasure >= requirement * ${unit} THEN 'GREEN'
+                WHEN period = 'previous' THEN CASE WHEN completedMeasure > 0 THEN 'YELLOW' ELSE 'RED' END
+                WHEN completedMeasure + futureMeasure >= requirement * ${unit} THEN 'GREEN'
+                WHEN inStartupGrace THEN 'YELLOW'
+                WHEN elapsedDays * 2 <= eligibleDays THEN 'YELLOW'
+                WHEN completedMeasure = 0 THEN 'RED'
+                WHEN completedMeasure >= ROUND(CAST(requirement AS DECIMAL(30, 12)) * elapsedDays / eligibleDays) * ${unit} THEN 'GREEN'
+                ELSE 'YELLOW' END AS classification
+            FROM engagement_values v
+        )`;
+    }
+    return { engagementSetSql, matchSessionAcceptedSql };
+}
+exports.createEngagementQueries = createEngagementQueries;
+//# sourceMappingURL=query.js.map

package/program-engagement/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../program-engagement/query.ts"],"names":[],"mappings":";;;AAAA,iCAAiC;AAEjC,qCAAkD;AAQlD,2EAA2E;AAC3E,SAAgB,uBAAuB,CAAO,OAAoC;IAC9E,wDAAwD;IACxD,SAAS,uBAAuB,CAAC,YAAkB,EAAE,YAAkB;QACnE,OAAO,OAAO,CAAC,GAAG,CAAA,IAAI,YAAY,QAAQ,WAAW,KAAK,UAAU;kBAC1D,YAAY,QAAQ,WAAW,KAAK,UAAU,IAAI,CAAC;IACjE,CAAC;IACD,MAAM,mCAAmC,GAAG,CAAC,CAAC;IAE9C;;;;;;;;;;;;OAYG;IACH,SAAS,gBAAgB,CACrB,UAAkB,EAClB,gBAAsB,EACtB,OAAa,EACb,OAA2B,EAC3B,aAAuC,EACvC,WAAiB,EACjB,eAAwB,KAAK;QAE7B,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,IAAA,+BAAsB,EAAC,OAAO,EAAE,aAAa,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;QACtG,kGAAkG;QAClG,MAAM,kBAAkB,GAAG,gBAAQ,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,aAAa,CAAC,QAAQ,EAAE,CAAC;aACxF,OAAO,CAAC,KAAK,CAAC;aACd,KAAK,CAAC,EAAE,IAAI,EAAE,mCAAmC,GAAG,CAAC,EAAE,CAAC;aACxD,QAAQ,EAAE,CAAC;QAChB,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,KAAK,SAAS,CAAC;QAClD,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAA,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAA,UAAU,CAAC;QACxE,OAAO,OAAO,CAAC,GAAG,CAAA;iCACO,OAAO;;yCAEC,QAAQ;;;;;;;;;;;;0CAYP,gBAAgB,QAAQ,kBAAkB;;6BAGhE,aAAa,CAAC,MAClB;;;;;;;;yCAQyB,WAAW;uCACb,WAAW;;;wDAGM,UAAU;0DACR,UAAU;0DACV,SAAS,KAAK,WAAW;4DACvB,SAAS,KAAK,WAAW;2BAC1D,uBAAuB,CAC1B,OAAO,CAAC,GAAG,CAAA,4BAA4B,EACvC,OAAO,CAAC,GAAG,CAAA,4BAA4B,CAC1C;;;;;yEAKoD,UAAU;uDAC5B,UAAU;;;;;;yEAMQ,UAAU;4EACP,UAAU;;;;;;;;;;0DAU5B,OAAO;mFACkB,OAAO;;;;kBAKtE,YAAY;YACR,CAAC,CAAC,OAAO,CAAC,GAAG,CAAA;6EACwC;YACrD,CAAC,CAAC,OAAO,CAAC,KAClB;;;;;;;;kBAQE,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAA,sDAAsD,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK;;;;;;yDAMzD,IAAI;;yEAEY,IAAI;;;;sHAIyC,IAAI;;;UAGhH,CAAC;IACP,CAAC;IAED,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,CAAC;AACzD,CAAC;AAzID,0DAyIC"}

package/meet/index.d.ts

@@ -1,36 +0,0 @@
-import { ClientType } from "./twilio/enum";
-import { IMeetConfig } from "./twilio/models/_/twilio.config";
-/**
- * Meet declarations
- */
-interface IMeet<T> {
-    client: T;
-}
-/**
- * Meet implementation
- */
-export declare class Meet<T> implements IMeet<T> {
-    private _client;
-    private _config;
-    private _clientType;
-    /**
-     * Meet constructor
-     *
-     * @param {ClientType} clientType client type
-     * @param {IMeetConfig} config meet configuration
-     */
-    constructor(clientType: ClientType, config: IMeetConfig);
-    /**
-     * getter for client
-     *
-     * @returns {T} client of type T
-     */
-    get client(): T;
-    /**
-     * initialize method
-     *
-     * @returns {void} promise of type void
-     */
-    private init;
-}
-export {};