@avakado.ai/schemas 1.1.21 → 1.1.23

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@avakado.ai/schemas",
-  "version": "1.1.21",
+  "version": "1.1.23",
   "description": "Canonical Mongo schemas, models, enums and index declarations shared by the Avakado services.",
   "license": "UNLICENSED",
   "type": "module",

package/src/contactWindows.js

@@ -0,0 +1,74 @@
+/** Session chat Meta allows after the lead's last inbound message. */
+export const CHAT_SESSION_MS = 24 * 60 * 60 * 1000;
+/** Callback window after a user-initiated WhatsApp call. */
+export const WHATSAPP_CALL_CALLBACK_MS = 7 * 24 * 60 * 60 * 1000;
+
+function windowUntil(mode, platform, at) {
+    const when = new Date(at);
+    if (mode === 'chat' && platform === 'telegram') return null;
+    if (mode === 'call' && platform === 'phone') return null;
+    if (mode === 'call' && platform === 'whatsapp') return new Date(when.getTime() + WHATSAPP_CALL_CALLBACK_MS);
+    return new Date(when.getTime() + CHAT_SESSION_MS);
+}
+
+export function contactWindowValue(mode, platform, at) {
+    return { allowed: true, validUntil: windowUntil(mode, platform, at) };
+}
+
+/** Replace the matched handle's window. Use this when the user grants or refuses permission. */
+export function setContactWindow(update, mode, platform, { allowed, validUntil = null }) {
+    const prefix = `contactDetails.${platform}.$.${mode}`;
+    update.$set ??= {};
+    update.$set[`${prefix}.allowed`] = Boolean(allowed);
+    update.$set[`${prefix}.validUntil`] = validUntil;
+    return update;
+}
+
+/** Merge a window refresh onto the matched contactDetails entry. The query must match that handle. A later inbound only extends validUntil. */
+export function applyContactWindow(update, mode, platform, at) {
+    const prefix = `contactDetails.${platform}.$.${mode}`;
+    const until = windowUntil(mode, platform, at);
+    update.$set ??= {};
+    update.$set[`${prefix}.allowed`] = true;
+    if (!until) {
+        update.$set[`${prefix}.validUntil`] = null;
+        return update;
+    }
+    update.$max ??= {};
+    update.$max[`${prefix}.validUntil`] = until;
+    return update;
+}
+
+export function contactWindowIsOpen(window, at = new Date()) {
+    if (!window?.allowed) return false;
+    if (!window.validUntil) return true;
+    return new Date(window.validUntil).getTime() > new Date(at).getTime();
+}
+
+function recordedWindow(window) {
+    if (!window || (window.allowed == null && window.validUntil == null)) return null;
+    return window;
+}
+
+/** The window on the primary handle, or the one that stays open longest. */
+export function storedContactWindow(lead, mode, platform) {
+    const entries = lead?.contactDetails?.[platform];
+    if (!Array.isArray(entries)) return null;
+    const primary = recordedWindow(entries.find((entry) => entry.isPrimary)?.[mode]);
+    if (primary) return primary;
+    return entries.reduce((best, entry) => {
+        const window = recordedWindow(entry?.[mode]);
+        if (!window) return best;
+        if (!best) return window;
+        if (!window.validUntil) return window;
+        if (!best.validUntil) return best;
+        return new Date(window.validUntil) > new Date(best.validUntil) ? window : best;
+    }, null);
+}
+
+/** True only when a stored window exists and is closed. A missing window is left to the caller. */
+export function sessionChatClosed(lead, platform, at = new Date()) {
+    const window = storedContactWindow(lead, 'chat', platform);
+    if (!window) return false;
+    return !contactWindowIsOpen(window, at);
+}

package/src/index.js

@@ -3,3 +3,13 @@ export * from "./models/index.js";
 export * from "./enums/index.js";
 export * from "./media.js";
 export { configureSchemas, defineModel, getSchemaConfig } from "./runtime.js";
+export {
+    CHAT_SESSION_MS,
+    WHATSAPP_CALL_CALLBACK_MS,
+    applyContactWindow,
+    contactWindowIsOpen,
+    contactWindowValue,
+    sessionChatClosed,
+    setContactWindow,
+    storedContactWindow,
+} from "./contactWindows.js";

package/src/models/Leads.js

@@ -2,12 +2,18 @@ import { Schema } from "mongoose";
 import { defineModel } from "../runtime.js";
 import { LEAD_STATUS } from "../enums/index.js";
 import { attachStatusChangeTrigger } from "../statusTrigger.js";
+const contactWindowSchema = new Schema({
+    allowed: Boolean,
+    validUntil: Date,
+}, { _id: false });
 const platformEntrySchema = new Schema({
     platform: { type: String, required: true },   // Phone,'Twitter', 'Instagram', 'Whatsapp', etc.
     handle: { type: String, trim: true },
     label: { type: String, trim: true },        // 'work', 'personal', 'brand'
     isPrimary: { type: Boolean, default: false },
-    metadata: { type: Schema.Types.Mixed, default: {} }
+    metadata: { type: Schema.Types.Mixed, default: {} },
+    chat: contactWindowSchema,
+    call: contactWindowSchema,
 }, { _id: false });
 const contactDetailsSchema = new Schema({
     whatsapp: [platformEntrySchema],

package/types.d.ts

@@ -304,7 +304,7 @@ export interface Lead {
     business: Types.ObjectId;
     createdBy?: Types.ObjectId;
     name?: string;
-    contactDetails?: { whatsapp?: { platform: string; handle?: string; label?: string; isPrimary?: boolean; metadata?: any; }[]; telegram?: { platform: string; handle?: string; label?: string; isPrimary?: boolean; metadata?: any; }[]; email?: { platform: string; handle?: string; label?: string; isPrimary?: boolean; metadata?: any; }[]; phone?: { platform: string; handle?: string; label?: string; isPrimary?: boolean; metadata?: any; }[]; twitter?: { platform: string; handle?: string; label?: string; isPrimary?: boolean; metadata?: any; }[]; instagram?: { platform: string; handle?: string; label?: string; isPrimary?: boolean; metadata?: any; }[]; facebook?: { platform: string; handle?: string; label?: string; isPrimary?: boolean; metadata?: any; }[]; };
+    contactDetails?: { whatsapp?: { platform: string; handle?: string; label?: string; isPrimary?: boolean; metadata?: any; chat?: { allowed?: boolean; validUntil?: Date; }; call?: { allowed?: boolean; validUntil?: Date; }; }[]; telegram?: { platform: string; handle?: string; label?: string; isPrimary?: boolean; metadata?: any; chat?: { allowed?: boolean; validUntil?: Date; }; call?: { allowed?: boolean; validUntil?: Date; }; }[]; email?: { platform: string; handle?: string; label?: string; isPrimary?: boolean; metadata?: any; chat?: { allowed?: boolean; validUntil?: Date; }; call?: { allowed?: boolean; validUntil?: Date; }; }[]; phone?: { platform: string; handle?: string; label?: string; isPrimary?: boolean; metadata?: any; chat?: { allowed?: boolean; validUntil?: Date; }; call?: { allowed?: boolean; validUntil?: Date; }; }[]; twitter?: { platform: string; handle?: string; label?: string; isPrimary?: boolean; metadata?: any; chat?: { allowed?: boolean; validUntil?: Date; }; call?: { allowed?: boolean; validUntil?: Date; }; }[]; instagram?: { platform: string; handle?: string; label?: string; isPrimary?: boolean; metadata?: any; chat?: { allowed?: boolean; validUntil?: Date; }; call?: { allowed?: boolean; validUntil?: Date; }; }[]; facebook?: { platform: string; handle?: string; label?: string; isPrimary?: boolean; metadata?: any; chat?: { allowed?: boolean; validUntil?: Date; }; call?: { allowed?: boolean; validUntil?: Date; }; }[]; };
     source?: string;
     tags?: string[];
     leadScore?: number;