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

package/match-guidance/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./model";
+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

@@ -0,0 +1,19 @@
+"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("./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

@@ -0,0 +1 @@
+{"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/invitation-history.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Read an established origin; only an original invitation can infer a missing origin.
+ *
+ * @param {unknown} value Stored history.
+ * @param {Date} createdOn Session creation occurrence.
+ * @returns {Date | null} Verified origin or unknown.
+ */
+export declare function sessionInvitationOrigin(value: unknown, createdOn: Date): Date | null;
+/**
+ * Stamp a server-generated invitation and its known or unknown episode origin.
+ *
+ * @param {unknown} value Stored history, never client-owned metadata.
+ * @param {Date} occurredOn New invitation occurrence.
+ * @param {Date | null} since Origin of the uninterrupted invitation episode.
+ * @returns {string} Existing JSON history representation.
+ */
+export declare function stampUnansweredInvitationHistory(value: unknown, occurredOn: Date, since: Date | null): string;
+/**
+ * Keep internal maintenance metadata out of existing public status maps.
+ *
+ * @param {T} history Parsed status map.
+ * @returns {T} Existing public entries without internal metadata.
+ */
+export declare function publicSessionInvitationHistory<T extends object>(history: T): T;
+/**
+ * Existing invitation histories contain one map, either native JSON or a JSON string.
+ *
+ * @param {unknown} value Value to validate or normalize.
+ * @returns {Record<string, unknown>} Calculated result.
+ */
+export declare function readSessionInvitationHistory(value: unknown): Record<string, unknown>;
+/**
+ * Zero and missing history entries are existing representations of no such action.
+ *
+ * @param {Record<string, unknown>} history Server invitation history.
+ * @param {string} status Invitation action status.
+ * @returns {Date | null} Calculated result.
+ */
+export declare function sessionInvitationDate(history: Record<string, unknown>, status: string): Date | null;
+/**
+ * Preserve server history and stamp only the authenticated action being performed.
+ *
+ * @param {unknown} value Value to validate or normalize.
+ * @param {string} status Invitation action status.
+ * @param {Date} occurredOn Server action occurrence timestamp.
+ * @returns {string} Calculated result.
+ */
+export declare function stampSessionInvitationHistory(value: unknown, status: string, occurredOn: Date): string;

package/match-guidance/invitation-history.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stampSessionInvitationHistory = exports.sessionInvitationDate = exports.readSessionInvitationHistory = exports.publicSessionInvitationHistory = exports.stampUnansweredInvitationHistory = exports.sessionInvitationOrigin = void 0;
+const core_1 = require("../core");
+/** Server-owned origin, separate from the latest invited status timestamp. */
+const invitationOriginKey = "unansweredInvitationSince";
+/**
+ * Read an established origin; only an original invitation can infer a missing origin.
+ *
+ * @param {unknown} value Stored history.
+ * @param {Date} createdOn Session creation occurrence.
+ * @returns {Date | null} Verified origin or unknown.
+ */
+function sessionInvitationOrigin(value, createdOn) {
+    const history = readSessionInvitationHistory(value);
+    if (Object.prototype.hasOwnProperty.call(history, invitationOriginKey))
+        return sessionInvitationDate(history, invitationOriginKey);
+    const invited = sessionInvitationDate(history, "invited");
+    return (invited === null || invited === void 0 ? void 0 : invited.getTime()) === Math.floor(createdOn.getTime() / 1000) * 1000 ? invited : null;
+}
+exports.sessionInvitationOrigin = sessionInvitationOrigin;
+/**
+ * Stamp a server-generated invitation and its known or unknown episode origin.
+ *
+ * @param {unknown} value Stored history, never client-owned metadata.
+ * @param {Date} occurredOn New invitation occurrence.
+ * @param {Date | null} since Origin of the uninterrupted invitation episode.
+ * @returns {string} Existing JSON history representation.
+ */
+function stampUnansweredInvitationHistory(value, occurredOn, since) {
+    var _a;
+    return JSON.stringify([
+        Object.assign(Object.assign({}, readSessionInvitationHistory(value)), { invited: occurredOn.toISOString(), [invitationOriginKey]: (_a = since === null || since === void 0 ? void 0 : since.toISOString()) !== null && _a !== void 0 ? _a : null })
+    ]);
+}
+exports.stampUnansweredInvitationHistory = stampUnansweredInvitationHistory;
+/**
+ * Keep internal maintenance metadata out of existing public status maps.
+ *
+ * @param {T} history Parsed status map.
+ * @returns {T} Existing public entries without internal metadata.
+ */
+function publicSessionInvitationHistory(history) {
+    const publicHistory = Object.assign({}, history);
+    Reflect.deleteProperty(publicHistory, invitationOriginKey);
+    return publicHistory;
+}
+exports.publicSessionInvitationHistory = publicSessionInvitationHistory;
+/**
+ * Existing invitation histories contain one map, either native JSON or a JSON string.
+ *
+ * @param {unknown} value Value to validate or normalize.
+ * @returns {Record<string, unknown>} Calculated result.
+ */
+function readSessionInvitationHistory(value) {
+    const parsed = typeof value === "string" ? JSON.parse(value) : value;
+    if (parsed == null)
+        return {};
+    if (!Array.isArray(parsed) || parsed.length !== 1 || !parsed[0] || typeof parsed[0] !== "object") {
+        throw new core_1.ApiError(500 /* InternalServerError */, "Session invitation history is invalid.");
+    }
+    return Object.assign({}, parsed[0]);
+}
+exports.readSessionInvitationHistory = readSessionInvitationHistory;
+/**
+ * Zero and missing history entries are existing representations of no such action.
+ *
+ * @param {Record<string, unknown>} history Server invitation history.
+ * @param {string} status Invitation action status.
+ * @returns {Date | null} Calculated result.
+ */
+function sessionInvitationDate(history, status) {
+    const value = history[status];
+    if (value == null || value === 0 || value === "0")
+        return null;
+    const date = value instanceof Date ? value : typeof value === "string" ? new Date(value) : null;
+    if (!date || !Number.isFinite(date.getTime())) {
+        throw new core_1.ApiError(500 /* InternalServerError */, "Session invitation history contains an invalid timestamp.");
+    }
+    return new Date(Math.floor(date.getTime() / 1000) * 1000);
+}
+exports.sessionInvitationDate = sessionInvitationDate;
+/**
+ * Preserve server history and stamp only the authenticated action being performed.
+ *
+ * @param {unknown} value Value to validate or normalize.
+ * @param {string} status Invitation action status.
+ * @param {Date} occurredOn Server action occurrence timestamp.
+ * @returns {string} Calculated result.
+ */
+function stampSessionInvitationHistory(value, status, occurredOn) {
+    return JSON.stringify([Object.assign(Object.assign({}, readSessionInvitationHistory(value)), { [status]: occurredOn.toISOString() })]);
+}
+exports.stampSessionInvitationHistory = stampSessionInvitationHistory;
+//# sourceMappingURL=invitation-history.js.map

package/match-guidance/invitation-history.js.map

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

package/match-guidance/message-facts.d.ts

@@ -0,0 +1,63 @@
+import { IGuidanceContext, IGuidanceConnection, IGuidanceSql } from "./model";
+/** Narrow, validated projection shared by webhook and historical chat reads. */
+export interface IHumanActivityMessage {
+    user?: {
+        id?: string;
+    };
+    user_id?: string;
+    type?: string;
+    text?: string;
+    attachments?: unknown[];
+    silent?: boolean;
+    deleted_at?: string | Date | null;
+    created_at?: string | Date;
+    custom?: unknown;
+    customData?: unknown;
+}
+/**
+ * Exclude automated messages from human activity.
+ *
+ * @param {IHumanActivityMessage} message Candidate source message.
+ * @returns {boolean} Calculated result.
+ */
+export declare function isHumanActivityMessage(message: IHumanActivityMessage): boolean;
+/** Minimal transport boundary compatible with the application's installed Stream SDK. */
+export interface IGuidanceMessageSource {
+    available: (cids: string[]) => Promise<boolean>;
+    search: (request: {
+        cids: string[];
+        author: string;
+        start: Date;
+        end: Date;
+        direction: 1 | -1;
+        next?: string;
+        limit: number;
+    }) => Promise<{
+        results: {
+            message: IHumanActivityMessage;
+        }[];
+        next?: string;
+        results_warning?: unknown;
+    }>;
+}
+/** Share bounded source metadata reads without depending on a particular Stream SDK version. */
+export declare function createGuidanceMessageReader(source: IGuidanceMessageSource): {
+    assertSearchableChannels: (cids: string[]) => Promise<void>;
+    searchMessage: (cids: string[], author: string, start: Date | null, end: Date, direction: 1 | -1) => Promise<Date | null>;
+    latestPublishedMessages: (contexts: IGuidanceContext[], channels: Map<string, {
+        StreamRef: string;
+    }[]>, now: Date) => Promise<{
+        messages: Map<number, Map<string, Date>>;
+        cids: string[];
+    }>;
+};
+/** Match only historical 1:1 channels with exactly these two participants. */
+export declare function readGuidanceChannels<TSql, TChannel extends {
+    Id: number;
+    StreamRef: string;
+}>(adapter: IGuidanceSql<TSql>, connection: IGuidanceConnection<TSql>, pairs: {
+    firstUserId: number;
+    firstUserRef: string;
+    secondUserId: number;
+    secondUserRef: string;
+}[]): Promise<Map<string, TChannel[]>>;

package/match-guidance/message-facts.js

@@ -0,0 +1,139 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readGuidanceChannels = exports.createGuidanceMessageReader = exports.isHumanActivityMessage = void 0;
+const core_1 = require("../core");
+// Automated notifications use silent delivery and/or the custom notification envelope.
+/**
+ * Exclude automated messages from human activity.
+ *
+ * @param {IHumanActivityMessage} message Candidate source message.
+ * @returns {boolean} Calculated result.
+ */
+function isHumanActivityMessage(message) {
+    return (!message.silent &&
+        !message.deleted_at &&
+        (message.type === "regular" || message.type === "reply") &&
+        [message.custom, message.customData].every((metadata) => metadata == null || (typeof metadata === "object" && Object.keys(metadata).length === 0)) &&
+        ((typeof message.text === "string" && !!message.text.trim()) ||
+            (Array.isArray(message.attachments) && message.attachments.length > 0)));
+}
+exports.isHumanActivityMessage = isHumanActivityMessage;
+/** Share bounded source metadata reads without depending on a particular Stream SDK version. */
+function createGuidanceMessageReader(source) {
+    function assertSearchableChannels(cids) {
+        return __awaiter(this, void 0, void 0, function* () {
+            for (let offset = 0; offset < cids.length; offset += 100) {
+                if (!(yield source.available(cids.slice(offset, offset + 100))))
+                    throw new core_1.ApiError(500 /* InternalServerError */, "Chat history is unavailable for one or more match channels.");
+            }
+        });
+    }
+    function searchMessage(cids, author, start, end, direction) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!start || start >= end || !cids.length)
+                return null;
+            const pageSize = 100;
+            if (cids.length > pageSize) {
+                let selected = null;
+                for (let offset = 0; offset < cids.length; offset += pageSize) {
+                    const candidate = yield searchMessage(cids.slice(offset, offset + pageSize), author, start, end, direction);
+                    if (candidate && (!selected || (direction === 1 ? candidate < selected : candidate > selected)))
+                        selected = candidate;
+                }
+                return selected;
+            }
+            let next;
+            do {
+                const response = yield source.search({ cids, author, start, end, direction, next, limit: pageSize });
+                if (response.results_warning)
+                    throw new core_1.ApiError(500 /* InternalServerError */, "Chat history search was incomplete.");
+                for (const result of response.results) {
+                    if (isHumanActivityMessage(result.message) && result.message.created_at) {
+                        const date = new Date(result.message.created_at);
+                        if (!Number.isFinite(date.getTime()))
+                            throw new core_1.ApiError(500 /* InternalServerError */, "Invalid chat occurrence time.");
+                        return date;
+                    }
+                }
+                if (response.next && response.next === next)
+                    throw new core_1.ApiError(500 /* InternalServerError */, "Chat history cursor did not advance.");
+                next = response.next;
+            } while (next);
+            return null;
+        });
+    }
+    function latestPublishedMessages(contexts, channels, now) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const messages = new Map();
+            const channelsByMatch = new Map();
+            for (const context of contexts) {
+                messages.set(context.Id, new Map());
+                const pair = channels.get([context.MentorRef, context.MenteeRef].sort().join(":"));
+                if (!(pair === null || pair === void 0 ? void 0 : pair.length))
+                    throw new core_1.ApiError(500 /* InternalServerError */, "Match chat history is unavailable.");
+                channelsByMatch.set(context.Id, [...new Set(pair.map((channel) => `team:${channel.StreamRef}`))].sort());
+            }
+            const cids = [...new Set([...channelsByMatch.values()].flat())];
+            yield assertSearchableChannels(cids);
+            const searches = new Map();
+            for (const context of contexts) {
+                const matchChannels = channelsByMatch.get(context.Id);
+                const result = messages.get(context.Id);
+                if (!matchChannels || !result)
+                    throw new Error("Missing initialized message facts");
+                const end = context.EndDate && context.EndDate < now ? context.EndDate : now;
+                yield Promise.all([context.MentorRef, context.MenteeRef].map((author) => __awaiter(this, void 0, void 0, function* () {
+                    const key = JSON.stringify([matchChannels, author, context.PublishedOn, end]);
+                    if (!searches.has(key))
+                        searches.set(key, searchMessage(matchChannels, author, context.PublishedOn, end, -1));
+                    const date = yield searches.get(key);
+                    if (date)
+                        result.set(author.toLowerCase(), date);
+                })));
+            }
+            return { messages, cids };
+        });
+    }
+    return { assertSearchableChannels, searchMessage, latestPublishedMessages };
+}
+exports.createGuidanceMessageReader = createGuidanceMessageReader;
+/** Match only historical 1:1 channels with exactly these two participants. */
+function readGuidanceChannels(adapter, connection, pairs) {
+    var _a;
+    return __awaiter(this, void 0, void 0, function* () {
+        const result = new Map();
+        if (!pairs.length)
+            return result;
+        const rows = yield connection.$queryRaw(adapter.sql `
+        SELECT DISTINCT c.*, p.firstRef, p.secondRef
+        FROM JSON_TABLE(${JSON.stringify(pairs)}, '$[*]' COLUMNS (
+            firstId INT PATH '$.firstUserId', secondId INT PATH '$.secondUserId',
+            firstRef CHAR(36) PATH '$.firstUserRef', secondRef CHAR(36) PATH '$.secondUserRef')) p
+        JOIN member a ON a.UserId = p.firstId
+        JOIN channel c ON c.Id = a.ChannelId AND c.Type = ${"1:1"}
+        JOIN member b ON b.ChannelId = c.Id AND b.UserId = p.secondId
+        WHERE NOT EXISTS (SELECT 1 FROM member other JOIN user u ON u.Id = other.UserId
+            WHERE other.ChannelId = c.Id AND BINARY u.Ref <> BINARY p.firstRef AND BINARY u.Ref <> BINARY p.secondRef)
+        ORDER BY c.CreatedOn, c.Id`);
+        for (const row of rows) {
+            const key = [row.firstRef, row.secondRef].sort().join(":");
+            const values = (_a = result.get(key)) !== null && _a !== void 0 ? _a : [];
+            Reflect.deleteProperty(row, "firstRef");
+            Reflect.deleteProperty(row, "secondRef");
+            values.push(row);
+            result.set(key, values);
+        }
+        return result;
+    });
+}
+exports.readGuidanceChannels = readGuidanceChannels;
+//# sourceMappingURL=message-facts.js.map

package/match-guidance/message-facts.js.map

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

package/match-guidance/model.d.ts

@@ -0,0 +1,53 @@
+/** Participant-specific Home guidance, independent of report grades. */
+export declare type HomeMatchNextStep = "ATTEND" | "RESPOND" | "REPLY" | "PREPARE" | "RECOVER" | "SCHEDULE_NEXT" | "SCHEDULE_FIRST" | "INTRODUCE" | "WAITING_INVITATION" | "WAITING_REPLY" | "UNAVAILABLE";
+/** Minimal retained session facts needed by the deterministic resolver. */
+export interface IHomeMatchSession {
+    id: number;
+    start: Date;
+    end: Date | null;
+    completed: boolean;
+}
+/** Bounded aggregates for a single match. */
+export interface IHomeMatchFacts {
+    historyAvailable: boolean;
+    incomingMessage: Date | null;
+    outgoingMessage: Date | null;
+    latestAcceptance: Date | null;
+    latestCompletion: Date | null;
+    totalSessions: number;
+    hasRecordedScheduling: boolean;
+    latestEnded: IHomeMatchSession | null;
+    ongoing: IHomeMatchSession | null;
+    incomingInvitation: IHomeMatchSession | null;
+    accepted: IHomeMatchSession | null;
+    outgoingInvitation: IHomeMatchSession | null;
+}
+/** Minimal source context; callers retain authorization ownership. */
+export interface IGuidanceContext {
+    Id: number;
+    MentorUserId: number;
+    MenteeUserId: number;
+    MentorRef: string;
+    MenteeRef: string;
+    PublishedOn: Date | null;
+    EndDate: Date | null;
+    TimeZone?: string | null;
+}
+/** One authorized participant whose Home guidance is required. */
+export interface IGuidanceRecipient extends IGuidanceContext {
+    recipientRef: string;
+}
+/** Caller-owned SQL construction and database connection. */
+export interface IGuidanceSql<TSql> {
+    sql: (strings: TemplateStringsArray, ...values: unknown[]) => TSql;
+    join: (values: readonly unknown[], separator?: string) => TSql;
+}
+export interface IGuidanceConnection<TSql> {
+    $queryRaw: <T>(query: TSql) => Promise<T>;
+}
+/** Stable request-local lookup key, not a stored identifier. */
+export declare function guidanceKey(matchId: number, recipientRef: string): string;
+/** Initialize the same neutral facts for both Home and notification selection. */
+export declare function emptyGuidanceFacts(hasRecordedScheduling: boolean): IHomeMatchFacts;
+/** Require a fact row already initialized by the authorized caller. */
+export declare function requireGuidanceFacts(facts: Map<string, IHomeMatchFacts>, matchId: number, recipientRef: string): IHomeMatchFacts;

package/match-guidance/model.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.requireGuidanceFacts = exports.emptyGuidanceFacts = exports.guidanceKey = void 0;
+/** Stable request-local lookup key, not a stored identifier. */
+function guidanceKey(matchId, recipientRef) {
+    return `${matchId}:${recipientRef.toLowerCase()}`;
+}
+exports.guidanceKey = guidanceKey;
+/** Initialize the same neutral facts for both Home and notification selection. */
+function emptyGuidanceFacts(hasRecordedScheduling) {
+    return {
+        historyAvailable: true,
+        incomingMessage: null,
+        outgoingMessage: null,
+        latestAcceptance: null,
+        latestCompletion: null,
+        totalSessions: 0,
+        hasRecordedScheduling,
+        latestEnded: null,
+        ongoing: null,
+        incomingInvitation: null,
+        accepted: null,
+        outgoingInvitation: null
+    };
+}
+exports.emptyGuidanceFacts = emptyGuidanceFacts;
+/** Require a fact row already initialized by the authorized caller. */
+function requireGuidanceFacts(facts, matchId, recipientRef) {
+    const value = facts.get(guidanceKey(matchId, recipientRef));
+    if (!value)
+        throw new Error("Missing initialized match guidance facts");
+    return value;
+}
+exports.requireGuidanceFacts = requireGuidanceFacts;
+//# sourceMappingURL=model.js.map

package/match-guidance/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../match-guidance/model.ts"],"names":[],"mappings":";;;AA6DA,gEAAgE;AAChE,SAAgB,WAAW,CAAC,OAAe,EAAE,YAAoB;IAC7D,OAAO,GAAG,OAAO,IAAI,YAAY,CAAC,WAAW,EAAE,EAAE,CAAC;AACtD,CAAC;AAFD,kCAEC;AACD,kFAAkF;AAClF,SAAgB,kBAAkB,CAAC,qBAA8B;IAC7D,OAAO;QACH,gBAAgB,EAAE,IAAI;QACtB,eAAe,EAAE,IAAI;QACrB,eAAe,EAAE,IAAI;QACrB,gBAAgB,EAAE,IAAI;QACtB,gBAAgB,EAAE,IAAI;QACtB,aAAa,EAAE,CAAC;QAChB,qBAAqB;QACrB,WAAW,EAAE,IAAI;QACjB,OAAO,EAAE,IAAI;QACb,kBAAkB,EAAE,IAAI;QACxB,QAAQ,EAAE,IAAI;QACd,kBAAkB,EAAE,IAAI;KAC3B,CAAC;AACN,CAAC;AAfD,gDAeC;AAED,uEAAuE;AACvE,SAAgB,oBAAoB,CAChC,KAAmC,EACnC,OAAe,EACf,YAAoB;IAEpB,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC;IAC5D,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IACxE,OAAO,KAAK,CAAC;AACjB,CAAC;AARD,oDAQC"}

package/match-guidance/next-step.d.ts

@@ -0,0 +1,10 @@
+import { HomeMatchNextStep, IHomeMatchFacts } from "./model";
+/**
+ * Resolve the approved display precedence using authoritative participant facts.
+ *
+ * @param {IHomeMatchFacts} facts Aggregated source facts.
+ * @returns {HomeMatchNextStep} One next step, without inventing missing history.
+ */
+export declare function resolveHomeMatchNextStep(facts: IHomeMatchFacts): HomeMatchNextStep;
+/** The same optional reporting action on Home and engagement emails. */
+export declare function canReportOffline(facts: IHomeMatchFacts, behind: boolean, hasCommunication: boolean): boolean;

package/match-guidance/next-step.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.canReportOffline = exports.resolveHomeMatchNextStep = void 0;
+/**
+ * Resolve the approved display precedence using authoritative participant facts.
+ *
+ * @param {IHomeMatchFacts} facts Aggregated source facts.
+ * @returns {HomeMatchNextStep} One next step, without inventing missing history.
+ */
+function resolveHomeMatchNextStep(facts) {
+    var _a, _b, _c, _d, _e, _f, _g, _h;
+    if (facts.ongoing)
+        return "ATTEND";
+    if (facts.incomingInvitation)
+        return "RESPOND";
+    // Unknown messaging can outrank preparation: do not silently treat it as empty.
+    if (!facts.historyAvailable)
+        return "UNAVAILABLE";
+    const incoming = (_b = (_a = facts.incomingMessage) === null || _a === void 0 ? void 0 : _a.getTime()) !== null && _b !== void 0 ? _b : 0;
+    const superseded = Math.max((_d = (_c = facts.outgoingMessage) === null || _c === void 0 ? void 0 : _c.getTime()) !== null && _d !== void 0 ? _d : 0, (_f = (_e = facts.latestAcceptance) === null || _e === void 0 ? void 0 : _e.getTime()) !== null && _f !== void 0 ? _f : 0, (_h = (_g = facts.latestCompletion) === null || _g === void 0 ? void 0 : _g.getTime()) !== null && _h !== void 0 ? _h : 0);
+    if (incoming > superseded)
+        return "REPLY";
+    if (facts.accepted)
+        return "PREPARE";
+    if (facts.outgoingInvitation)
+        return "WAITING_INVITATION";
+    if (facts.latestEnded)
+        return facts.latestEnded.completed ? "SCHEDULE_NEXT" : "RECOVER";
+    if (facts.totalSessions > 0)
+        return "SCHEDULE_NEXT";
+    if (facts.incomingMessage && facts.outgoingMessage)
+        return "SCHEDULE_FIRST";
+    // A canceled/deleted booking can still have positive scheduling evidence.
+    if (!facts.incomingMessage && !facts.outgoingMessage)
+        return facts.hasRecordedScheduling ? "SCHEDULE_NEXT" : "INTRODUCE";
+    return "WAITING_REPLY";
+}
+exports.resolveHomeMatchNextStep = resolveHomeMatchNextStep;
+/** The same optional reporting action on Home and engagement emails. */
+function canReportOffline(facts, behind, hasCommunication) {
+    return (behind &&
+        ["RECOVER", "SCHEDULE_NEXT", "SCHEDULE_FIRST", "WAITING_REPLY"].includes(resolveHomeMatchNextStep(facts)) &&
+        (!!facts.latestCompletion || !!facts.incomingMessage || !!facts.outgoingMessage || hasCommunication));
+}
+exports.canReportOffline = canReportOffline;
+//# sourceMappingURL=next-step.js.map

package/match-guidance/next-step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-step.js","sourceRoot":"","sources":["../../match-guidance/next-step.ts"],"names":[],"mappings":";;;AAEA;;;;;GAKG;AACH,SAAgB,wBAAwB,CAAC,KAAsB;;IAC3D,IAAI,KAAK,CAAC,OAAO;QAAE,OAAO,QAAQ,CAAC;IACnC,IAAI,KAAK,CAAC,kBAAkB;QAAE,OAAO,SAAS,CAAC;IAC/C,gFAAgF;IAChF,IAAI,CAAC,KAAK,CAAC,gBAAgB;QAAE,OAAO,aAAa,CAAC;IAClD,MAAM,QAAQ,GAAG,MAAA,MAAA,KAAK,CAAC,eAAe,0CAAE,OAAO,EAAE,mCAAI,CAAC,CAAC;IACvD,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CACvB,MAAA,MAAA,KAAK,CAAC,eAAe,0CAAE,OAAO,EAAE,mCAAI,CAAC,EACrC,MAAA,MAAA,KAAK,CAAC,gBAAgB,0CAAE,OAAO,EAAE,mCAAI,CAAC,EACtC,MAAA,MAAA,KAAK,CAAC,gBAAgB,0CAAE,OAAO,EAAE,mCAAI,CAAC,CACzC,CAAC;IACF,IAAI,QAAQ,GAAG,UAAU;QAAE,OAAO,OAAO,CAAC;IAC1C,IAAI,KAAK,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IACrC,IAAI,KAAK,CAAC,kBAAkB;QAAE,OAAO,oBAAoB,CAAC;IAC1D,IAAI,KAAK,CAAC,WAAW;QAAE,OAAO,KAAK,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC;IACxF,IAAI,KAAK,CAAC,aAAa,GAAG,CAAC;QAAE,OAAO,eAAe,CAAC;IACpD,IAAI,KAAK,CAAC,eAAe,IAAI,KAAK,CAAC,eAAe;QAAE,OAAO,gBAAgB,CAAC;IAC5E,0EAA0E;IAC1E,IAAI,CAAC,KAAK,CAAC,eAAe,IAAI,CAAC,KAAK,CAAC,eAAe;QAChD,OAAO,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,WAAW,CAAC;IACvE,OAAO,eAAe,CAAC;AAC3B,CAAC;AArBD,4DAqBC;AAED,wEAAwE;AACxE,SAAgB,gBAAgB,CAAC,KAAsB,EAAE,MAAe,EAAE,gBAAyB;IAC/F,OAAO,CACH,MAAM;QACN,CAAC,SAAS,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC;QACzG,CAAC,CAAC,CAAC,KAAK,CAAC,gBAAgB,IAAI,CAAC,CAAC,KAAK,CAAC,eAAe,IAAI,CAAC,CAAC,KAAK,CAAC,eAAe,IAAI,gBAAgB,CAAC,CACvG,CAAC;AACN,CAAC;AAND,4CAMC"}

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/match-guidance/session-facts.d.ts

@@ -0,0 +1,5 @@
+import { IGuidanceSql, IGuidanceConnection, IGuidanceRecipient, IHomeMatchFacts } from "./model";
+/** Bind existing batched Home queries to the caller's Prisma SQL implementation. */
+export declare function createGuidanceQueries<TSql>(adapter: IGuidanceSql<TSql>): {
+    readHomeMatchSessionFacts: (connection: IGuidanceConnection<TSql>, contexts: IGuidanceRecipient[], now: Date, facts: Map<string, IHomeMatchFacts>) => Promise<number>;
+};

package/match-guidance/session-facts.js

@@ -0,0 +1,234 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createGuidanceQueries = void 0;
+const luxon_1 = require("luxon");
+const period_1 = require("../program-engagement/period");
+const invitation_history_1 = require("./invitation-history");
+const model_1 = require("./model");
+/** Bind existing batched Home queries to the caller's Prisma SQL implementation. */
+function createGuidanceQueries(adapter) {
+    /**
+     * Recognize only canonical UTC strings whose calendar fields can be aggregated without coercion.
+     * Other existing values remain the responsibility of sessionInvitationDate.
+     *
+     * @param {TSql} value JSON timestamp expression.
+     * @returns {TSql} Strict canonical timestamp predicate.
+     */
+    function canonicalTimestamp(value) {
+        const text = adapter.sql `JSON_UNQUOTE(${value})`;
+        return adapter.sql `(JSON_TYPE(${value}) = 'STRING'
+        AND REGEXP_LIKE(${text}, '^[1-9][0-9]{3}-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9][.][0-9]{3}Z$', 'c')
+        AND SUBSTRING(${text}, 9, 2) <= DAY(LAST_DAY(CONCAT(SUBSTRING(${text}, 1, 7), '-01'))))`;
+    }
+    /**
+     * Normalize supported JSON storage without changing shared parser acceptance or error behavior.
+     *
+     * @param {TSql} scope Already authorized match/participant rows.
+     * @returns {TSql} Reusable invitation-history CTEs.
+     */
+    function acceptanceHistory(scope) {
+        const invited = adapter.sql `JSON_EXTRACT(document, '$[0].invited')`;
+        const accepted = adapter.sql `JSON_EXTRACT(document, '$[0].attending')`;
+        const safeInvited = canonicalTimestamp(invited);
+        const safeAccepted = canonicalTimestamp(accepted);
+        return adapter.sql `WITH scoped_matches AS (${scope}), raw_history AS (
+        SELECT DISTINCT a.Id AS id, s.MatchId AS matchId, a.InvitationStatus AS history,
+            CASE WHEN JSON_TYPE(a.InvitationStatus) = 'STRING'
+                THEN JSON_UNQUOTE(a.InvitationStatus) ELSE a.InvitationStatus END AS rawHistory
+        FROM scoped_matches m
+        JOIN session s ON s.MatchId = m.matchId AND s.Type = ${"ONEONONE"}
+        JOIN sessionattendance a ON a.SessionRef = s.Ref
+            AND (BINARY a.UserRef = BINARY m.mentorRef OR BINARY a.UserRef = BINARY m.menteeRef)
+    ), decoded_history AS (
+        SELECT *, CASE WHEN JSON_VALID(rawHistory) THEN CAST(rawHistory AS JSON) ELSE NULL END AS document
+        FROM raw_history
+    ), classified_history AS (
+        SELECT *, COALESCE((rawHistory IS NULL OR JSON_TYPE(document) = 'NULL'
+            OR (JSON_TYPE(document) = 'ARRAY' AND JSON_LENGTH(document) = 1
+                AND JSON_TYPE(JSON_EXTRACT(document, '$[0]')) IN ('OBJECT', 'ARRAY')))
+            AND (${invited} IS NULL OR JSON_TYPE(${invited}) = 'NULL' OR JSON_UNQUOTE(${invited}) = '0' OR ${safeInvited})
+            AND (${accepted} IS NULL OR JSON_TYPE(${accepted}) = 'NULL' OR JSON_UNQUOTE(${accepted}) = '0' OR ${safeAccepted}), 0) AS canonical,
+            CASE WHEN ${safeInvited} THEN STR_TO_DATE(SUBSTRING(JSON_UNQUOTE(${invited}), 1, 19), '%Y-%m-%dT%H:%i:%s') END AS invitedOn,
+            CASE WHEN ${safeAccepted} THEN STR_TO_DATE(SUBSTRING(JSON_UNQUOTE(${accepted}), 1, 19), '%Y-%m-%dT%H:%i:%s') END AS acceptedOn
+        FROM decoded_history
+    )`;
+    }
+    /**
+     * Populate Home facts with batched summaries and ranked candidates, never full session histories.
+     *
+     * @param {IGuidanceConnection<TSql>} connection Existing database connection.
+     * @param {IGuidanceRecipient[]} contexts Already authorized match identities.
+     * @param {Date} now Stable evaluation timestamp.
+     * @param {Map<string, IHomeMatchFacts>} facts Request-local facts to populate.
+     * @returns {Promise<number>} Earliest future session transition, or Infinity.
+     */
+    function readHomeMatchSessionFacts(connection, contexts, now, facts) {
+        var _a, _b, _c;
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!contexts.length)
+                return Infinity;
+            const scope = adapter.sql `SELECT * FROM JSON_TABLE(${JSON.stringify(contexts.map((context) => ({
+                matchId: context.Id,
+                mentorRef: context.MentorRef,
+                menteeRef: context.MenteeRef,
+                recipientRef: context.recipientRef
+            })))}, '$[*]' COLUMNS(matchId INT PATH '$.matchId', mentorRef CHAR(36) PATH '$.mentorRef', menteeRef CHAR(36) PATH '$.menteeRef', recipientRef CHAR(36) PATH '$.recipientRef')) AS authorized`;
+            const matchIds = adapter.join(contexts.map((context) => context.Id));
+            const summaries = yield connection.$queryRaw(adapter.sql `
+        WITH scoped_sessions AS (
+            SELECT Id, MatchId, StartTime, EndTime, IsCompleted, IsOffline FROM session
+            WHERE MatchId IN (${matchIds}) AND Type = ${"ONEONONE"}
+        ), summary AS (
+            SELECT MatchId, COUNT(*) AS total,
+                MAX(CASE WHEN IsOffline = 1 AND IsCompleted = 1 THEN StartTime END) AS offlineCompletedOn,
+                MAX(CASE WHEN EndTime > ${now} AND (IsCompleted IS NULL OR IsCompleted <> 1) THEN 1 ELSE 0 END) AS hasUpcoming,
+                MAX(CASE WHEN IsCompleted = 1 THEN CASE WHEN IsOffline = 1 THEN StartTime
+                    WHEN EndTime <= ${now} THEN EndTime END END) AS completedOn
+            FROM scoped_sessions GROUP BY MatchId
+        ), ended AS (
+            SELECT *, ROW_NUMBER() OVER (PARTITION BY MatchId ORDER BY CASE WHEN IsOffline = 1 THEN StartTime ELSE EndTime END DESC, Id DESC) AS position
+            FROM scoped_sessions WHERE EndTime <= ${now} OR (IsOffline = 1 AND IsCompleted = 1)
+        )
+        SELECT summary.MatchId AS matchId, summary.total, summary.completedOn, summary.hasUpcoming, summary.offlineCompletedOn,
+            ended.Id AS id, ended.StartTime AS startsOn, ended.EndTime AS endsOn, ended.IsCompleted AS completed
+        FROM summary LEFT JOIN ended ON ended.MatchId = summary.MatchId AND ended.position = 1
+    `);
+            if (!summaries.length)
+                return Infinity;
+            for (const row of summaries) {
+                const values = contexts
+                    .filter((context) => context.Id === row.matchId)
+                    .map((context) => (0, model_1.requireGuidanceFacts)(facts, context.Id, context.recipientRef));
+                for (const value of values) {
+                    value.totalSessions = Number(row.total);
+                    value.latestCompletion = row.completedOn;
+                    if (row.offlineCompletedOn) {
+                        const zone = (_a = contexts.find((context) => context.Id === row.matchId)) === null || _a === void 0 ? void 0 : _a.TimeZone;
+                        const offlineZone = { zone: (0, period_1.isValidTimeZone)(zone) ? zone : "UTC" };
+                        const offlineDay = luxon_1.DateTime.fromISO(row.offlineCompletedOn.toISOString().slice(0, 10), offlineZone)
+                            .endOf("day")
+                            .toJSDate();
+                        if (!value.latestCompletion || offlineDay > value.latestCompletion)
+                            value.latestCompletion = offlineDay;
+                    }
+                    if (row.id !== null)
+                        value.latestEnded = {
+                            id: row.id,
+                            start: row.startsOn,
+                            end: row.endsOn,
+                            completed: row.completed === 1
+                        };
+                }
+            }
+            const acceptedStatuses = ["attending", "attended"];
+            const acceptedValues = adapter.join(acceptedStatuses);
+            const candidates = summaries.some((row) => Boolean(row.hasUpcoming))
+                ? yield connection.$queryRaw(adapter.sql `
+        WITH scoped_matches AS (${scope}), upcoming AS (
+            SELECT m.recipientRef, s.MatchId AS matchId, s.Id AS id, s.StartTime AS startsOn, s.EndTime AS endsOn,
+                currentAttendance.CurrentAttendanceStatus AS currentStatus,
+                partnerAttendance.CurrentAttendanceStatus AS partnerStatus
+            FROM scoped_matches m
+            JOIN session s ON s.MatchId = m.matchId AND s.Type = ${"ONEONONE"}
+                AND s.EndTime > ${now} AND (s.IsCompleted IS NULL OR s.IsCompleted <> 1)
+            JOIN sessionattendance currentAttendance ON currentAttendance.SessionRef = s.Ref
+                AND BINARY currentAttendance.UserRef = BINARY m.recipientRef
+            JOIN sessionattendance partnerAttendance ON partnerAttendance.SessionRef = s.Ref
+                AND BINARY partnerAttendance.UserRef <> BINARY currentAttendance.UserRef
+                AND BINARY partnerAttendance.UserRef = BINARY CASE WHEN BINARY m.mentorRef = BINARY m.recipientRef THEN m.menteeRef ELSE m.mentorRef END
+        ), ranked AS (
+            SELECT *, ROW_NUMBER() OVER (PARTITION BY matchId, recipientRef, BINARY currentStatus, BINARY partnerStatus, (startsOn <= ${now}) ORDER BY startsOn, id) AS statusRank,
+                ROW_NUMBER() OVER (PARTITION BY matchId, recipientRef ORDER BY startsOn, id) AS firstRank,
+                MIN(CASE WHEN startsOn > ${now} THEN startsOn END) OVER (PARTITION BY matchId, recipientRef) AS nextStart,
+                MIN(endsOn) OVER (PARTITION BY matchId, recipientRef) AS nextEnd
+            FROM upcoming
+        )
+        SELECT recipientRef, matchId, id, startsOn, endsOn, currentStatus, partnerStatus, nextStart, nextEnd FROM ranked
+        WHERE firstRank = 1 OR (statusRank = 1 AND (
+            (BINARY currentStatus IN (${acceptedValues}) AND BINARY partnerStatus IN (${acceptedValues}))
+            OR (BINARY currentStatus = ${"invited"} AND BINARY partnerStatus IN (${acceptedValues}))
+            OR (BINARY currentStatus IN (${acceptedValues}) AND BINARY partnerStatus IN (${"invited"}, ${"requested"}))
+        ))
+    `)
+                : [];
+            let nextTransition = Infinity;
+            for (const row of candidates) {
+                const value = (0, model_1.requireGuidanceFacts)(facts, row.matchId, row.recipientRef);
+                nextTransition = Math.min(nextTransition, (_c = (_b = row.nextStart) === null || _b === void 0 ? void 0 : _b.getTime()) !== null && _c !== void 0 ? _c : Infinity, row.nextEnd.getTime());
+                const candidate = { id: row.id, start: row.startsOn, end: row.endsOn, completed: false };
+                const keys = [];
+                const currentAccepted = acceptedStatuses.includes(row.currentStatus);
+                const partnerAccepted = acceptedStatuses.includes(row.partnerStatus);
+                if (currentAccepted && partnerAccepted) {
+                    keys.push("accepted");
+                    if (row.startsOn <= now)
+                        keys.push("ongoing");
+                }
+                else if (row.currentStatus === "invited" && partnerAccepted)
+                    keys.push("incomingInvitation");
+                else if (currentAccepted && ["invited", "requested"].includes(row.partnerStatus))
+                    keys.push("outgoingInvitation");
+                for (const key of keys) {
+                    const previous = value[key];
+                    if (!previous ||
+                        candidate.start < previous.start ||
+                        (candidate.start.getTime() === previous.start.getTime() && candidate.id < previous.id))
+                        value[key] = candidate;
+                }
+            }
+            const history = acceptanceHistory(scope);
+            const acceptances = yield connection.$queryRaw(adapter.sql `
+        ${history}
+        SELECT matchId, MAX(CASE WHEN canonical = 1 AND invitedOn IS NOT NULL
+            AND acceptedOn >= invitedOn AND acceptedOn <= ${now} THEN acceptedOn END) AS acceptedOn,
+            MAX(canonical = 0) AS needsFallback
+        FROM classified_history GROUP BY matchId
+    `);
+            for (const row of acceptances)
+                for (const context of contexts.filter((item) => item.Id === row.matchId))
+                    (0, model_1.requireGuidanceFacts)(facts, context.Id, context.recipientRef).latestAcceptance = row.acceptedOn;
+            if (acceptances.some((row) => Boolean(row.needsFallback))) {
+                let afterId = 0;
+                while (true) {
+                    const page = yield connection.$queryRaw(adapter.sql `
+                ${history}
+                SELECT id, matchId, history FROM classified_history
+                WHERE canonical = 0 AND id > ${afterId} ORDER BY id LIMIT 100
+            `);
+                    if (!page.length)
+                        break;
+                    for (const row of page) {
+                        const parsed = (0, invitation_history_1.readSessionInvitationHistory)(row.history);
+                        const invited = (0, invitation_history_1.sessionInvitationDate)(parsed, "invited");
+                        const accepted = (0, invitation_history_1.sessionInvitationDate)(parsed, "attending");
+                        for (const context of contexts.filter((item) => item.Id === row.matchId)) {
+                            const value = (0, model_1.requireGuidanceFacts)(facts, context.Id, context.recipientRef);
+                            if (invited &&
+                                accepted &&
+                                accepted >= invited &&
+                                accepted <= now &&
+                                (!value.latestAcceptance || accepted > value.latestAcceptance))
+                                value.latestAcceptance = accepted;
+                        }
+                    }
+                    afterId = page[page.length - 1].id;
+                    if (page.length < 100)
+                        break;
+                }
+            }
+            return nextTransition;
+        });
+    }
+    return { readHomeMatchSessionFacts };
+}
+exports.createGuidanceQueries = createGuidanceQueries;
+//# sourceMappingURL=session-facts.js.map

package/match-guidance/session-facts.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@bwi-mentorspaces/application-utils-npm",
-    "version": "0.0.141",
+    "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",