@mentra/engine 0.1.0-dev.0 → 3.1.0-dev.10

package/build/services/PhoneCalendarHelpers.js

@@ -0,0 +1,157 @@
+import { MiniappErrorCode } from "@mentra/miniapp";
+const DEFAULT_LIMIT = 50;
+const MAX_LIMIT = 100;
+const MAX_RANGE_MS = 31 * 24 * 60 * 60 * 1000;
+export class PhoneCalendarError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "PhoneCalendarError";
+    }
+}
+export function validateCalendarListRequest(request) {
+    const startsAt = parseDate(request.startsAt, "startsAt");
+    const endsAt = parseDate(request.endsAt, "endsAt");
+    if (endsAt.getTime() <= startsAt.getTime()) {
+        throw new PhoneCalendarError(MiniappErrorCode.INVALID_ARGUMENT, "endsAt must be after startsAt");
+    }
+    if (endsAt.getTime() - startsAt.getTime() > MAX_RANGE_MS) {
+        throw new PhoneCalendarError(MiniappErrorCode.INVALID_ARGUMENT, "Calendar query range may not exceed 31 days");
+    }
+    const limit = request.limit === undefined ? DEFAULT_LIMIT : request.limit;
+    if (typeof limit !== "number" || !Number.isInteger(limit) || limit < 1 || limit > MAX_LIMIT) {
+        throw new PhoneCalendarError(MiniappErrorCode.INVALID_ARGUMENT, `limit must be an integer between 1 and ${MAX_LIMIT}`);
+    }
+    return { startsAt, endsAt, limit };
+}
+function parseDate(value, field) {
+    if (typeof value !== "string") {
+        throw new PhoneCalendarError(MiniappErrorCode.INVALID_ARGUMENT, `${field} must be an ISO 8601 string`);
+    }
+    const date = new Date(value);
+    if (Number.isNaN(date.getTime())) {
+        throw new PhoneCalendarError(MiniappErrorCode.INVALID_ARGUMENT, `${field} must be a valid ISO 8601 string`);
+    }
+    return date;
+}
+export function extractHttpsLinks(...values) {
+    const links = new Set();
+    for (const value of values) {
+        for (const match of value?.match(/https:\/\/[^\s<>"']+/gi) ?? []) {
+            let link = match;
+            while (".,;:!?)]}".includes(link[link.length - 1] ?? ""))
+                link = link.slice(0, -1);
+            if (link)
+                links.add(link);
+        }
+    }
+    return [...links];
+}
+function localDateParts(date) {
+    return {
+        year: date.getFullYear(),
+        month: date.getMonth() + 1,
+        day: date.getDate(),
+        hour: date.getHours(),
+        minute: date.getMinutes(),
+        second: date.getSeconds(),
+    };
+}
+function datePartsInTimeZone(date, timeZone) {
+    try {
+        const parts = new Intl.DateTimeFormat("en-US", {
+            timeZone,
+            year: "numeric",
+            month: "2-digit",
+            day: "2-digit",
+            hour: "2-digit",
+            minute: "2-digit",
+            second: "2-digit",
+            hourCycle: "h23",
+        }).formatToParts(date);
+        const value = (type) => Number(parts.find((part) => part.type === type)?.value);
+        return {
+            year: value("year"),
+            month: value("month"),
+            day: value("day"),
+            hour: value("hour"),
+            minute: value("minute"),
+            second: value("second"),
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+function timeZoneOffsetMinutes(date, timeZone) {
+    const parts = datePartsInTimeZone(date, timeZone);
+    if (!parts)
+        return undefined;
+    const representedAsUtc = Date.UTC(parts.year, parts.month - 1, parts.day, parts.hour, parts.minute, parts.second, date.getUTCMilliseconds());
+    return Math.round((representedAsUtc - date.getTime()) / 60_000);
+}
+function pad(value, length = 2) {
+    return String(value).padStart(length, "0");
+}
+function formatOffset(offsetMinutes) {
+    if (offsetMinutes === 0)
+        return "Z";
+    const sign = offsetMinutes < 0 ? "-" : "+";
+    const absolute = Math.abs(offsetMinutes);
+    return `${sign}${pad(Math.floor(absolute / 60))}:${pad(absolute % 60)}`;
+}
+function formatAllDayDate(value, timeZone) {
+    const dateOnly = typeof value === "string" ? /^(\d{4})-(\d{2})-(\d{2})$/.exec(value) : null;
+    if (dateOnly) {
+        const [, year, month, day] = dateOnly;
+        const localMidnight = new Date(Number(year), Number(month) - 1, Number(day));
+        let offsetMinutes = -localMidnight.getTimezoneOffset();
+        if (timeZone) {
+            // Resolve the offset at midnight in the event timezone. Repeating once
+            // accounts for the initial UTC guess landing across a DST boundary.
+            const wallTime = Date.UTC(Number(year), Number(month) - 1, Number(day));
+            let instant = new Date(wallTime);
+            for (let attempt = 0; attempt < 2; attempt += 1) {
+                const offset = timeZoneOffsetMinutes(instant, timeZone);
+                if (offset === undefined)
+                    break;
+                offsetMinutes = offset;
+                instant = new Date(wallTime - offset * 60_000);
+            }
+        }
+        return `${year}-${month}-${day}T00:00:00.000${formatOffset(offsetMinutes)}`;
+    }
+    const date = new Date(value);
+    const zonedParts = timeZone ? datePartsInTimeZone(date, timeZone) : undefined;
+    const parts = zonedParts ?? localDateParts(date);
+    const offsetMinutes = timeZone && zonedParts
+        ? (timeZoneOffsetMinutes(date, timeZone) ?? -date.getTimezoneOffset())
+        : -date.getTimezoneOffset();
+    return `${pad(parts.year, 4)}-${pad(parts.month)}-${pad(parts.day)}T${pad(parts.hour)}:${pad(parts.minute)}:${pad(parts.second)}.${pad(date.getUTCMilliseconds(), 3)}${formatOffset(offsetMinutes)}`;
+}
+export function normalizeCalendarEvent(event) {
+    const startsAt = event.allDay
+        ? formatAllDayDate(event.startDate, event.timeZone)
+        : new Date(event.startDate).toISOString();
+    const endsAt = event.allDay ? formatAllDayDate(event.endDate, event.timeZone) : new Date(event.endDate).toISOString();
+    const calendarId = event.calendarId ?? "";
+    const eventId = event.id ?? "";
+    return {
+        id: `${calendarId}:${eventId}:${startsAt}`,
+        calendarId,
+        title: event.title ?? "",
+        startsAt,
+        endsAt,
+        ...(event.timeZone ? { timezone: event.timeZone } : {}),
+        allDay: !!event.allDay,
+        ...(event.location ? { location: event.location } : {}),
+        ...(event.notes ? { notes: event.notes } : {}),
+        ...(event.url ? { url: event.url } : {}),
+        links: extractHttpsLinks(event.url, event.location, event.notes),
+    };
+}
+export function calendarEventOverlapsWindow(event, startsAt, endsAt) {
+    return Date.parse(event.endsAt) > startsAt.getTime() && Date.parse(event.startsAt) < endsAt.getTime();
+}
+//# sourceMappingURL=PhoneCalendarHelpers.js.map

package/build/services/PhoneCalendarHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PhoneCalendarHelpers.js","sourceRoot":"","sources":["../../src/services/PhoneCalendarHelpers.ts"],"names":[],"mappings":"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","sourcesContent":["import {MiniappErrorCode, type CalendarEvent} from \"@mentra/miniapp\"\n\nconst DEFAULT_LIMIT = 50\nconst MAX_LIMIT = 100\nconst MAX_RANGE_MS = 31 * 24 * 60 * 60 * 1000\n\nexport interface CalendarListRequest {\n  startsAt?: unknown\n  endsAt?: unknown\n  limit?: unknown\n}\n\nexport class PhoneCalendarError extends Error {\n  constructor(\n    public readonly code: MiniappErrorCode,\n    message: string,\n  ) {\n    super(message)\n    this.name = \"PhoneCalendarError\"\n  }\n}\n\nexport interface ValidatedCalendarListRequest {\n  startsAt: Date\n  endsAt: Date\n  limit: number\n}\n\nexport interface RawCalendarEvent {\n  id?: string\n  calendarId?: string\n  title?: string | null\n  startDate: string | Date\n  endDate: string | Date\n  timeZone?: string | null\n  allDay?: boolean\n  location?: string | null\n  notes?: string | null\n  url?: string | null\n}\n\nexport function validateCalendarListRequest(request: CalendarListRequest): ValidatedCalendarListRequest {\n  const startsAt = parseDate(request.startsAt, \"startsAt\")\n  const endsAt = parseDate(request.endsAt, \"endsAt\")\n  if (endsAt.getTime() <= startsAt.getTime()) {\n    throw new PhoneCalendarError(MiniappErrorCode.INVALID_ARGUMENT, \"endsAt must be after startsAt\")\n  }\n  if (endsAt.getTime() - startsAt.getTime() > MAX_RANGE_MS) {\n    throw new PhoneCalendarError(MiniappErrorCode.INVALID_ARGUMENT, \"Calendar query range may not exceed 31 days\")\n  }\n\n  const limit = request.limit === undefined ? DEFAULT_LIMIT : request.limit\n  if (typeof limit !== \"number\" || !Number.isInteger(limit) || limit < 1 || limit > MAX_LIMIT) {\n    throw new PhoneCalendarError(\n      MiniappErrorCode.INVALID_ARGUMENT,\n      `limit must be an integer between 1 and ${MAX_LIMIT}`,\n    )\n  }\n  return {startsAt, endsAt, limit}\n}\n\nfunction parseDate(value: unknown, field: string): Date {\n  if (typeof value !== \"string\") {\n    throw new PhoneCalendarError(MiniappErrorCode.INVALID_ARGUMENT, `${field} must be an ISO 8601 string`)\n  }\n  const date = new Date(value)\n  if (Number.isNaN(date.getTime())) {\n    throw new PhoneCalendarError(MiniappErrorCode.INVALID_ARGUMENT, `${field} must be a valid ISO 8601 string`)\n  }\n  return date\n}\n\nexport function extractHttpsLinks(...values: Array<string | null | undefined>): string[] {\n  const links = new Set<string>()\n  for (const value of values) {\n    for (const match of value?.match(/https:\\/\\/[^\\s<>\"']+/gi) ?? []) {\n      let link = match\n      while (\".,;:!?)]}\".includes(link[link.length - 1] ?? \"\")) link = link.slice(0, -1)\n      if (link) links.add(link)\n    }\n  }\n  return [...links]\n}\n\ninterface CalendarDateParts {\n  year: number\n  month: number\n  day: number\n  hour: number\n  minute: number\n  second: number\n}\n\nfunction localDateParts(date: Date): CalendarDateParts {\n  return {\n    year: date.getFullYear(),\n    month: date.getMonth() + 1,\n    day: date.getDate(),\n    hour: date.getHours(),\n    minute: date.getMinutes(),\n    second: date.getSeconds(),\n  }\n}\n\nfunction datePartsInTimeZone(date: Date, timeZone: string): CalendarDateParts | undefined {\n  try {\n    const parts = new Intl.DateTimeFormat(\"en-US\", {\n      timeZone,\n      year: \"numeric\",\n      month: \"2-digit\",\n      day: \"2-digit\",\n      hour: \"2-digit\",\n      minute: \"2-digit\",\n      second: \"2-digit\",\n      hourCycle: \"h23\",\n    }).formatToParts(date)\n    const value = (type: Intl.DateTimeFormatPartTypes) => Number(parts.find((part) => part.type === type)?.value)\n    return {\n      year: value(\"year\"),\n      month: value(\"month\"),\n      day: value(\"day\"),\n      hour: value(\"hour\"),\n      minute: value(\"minute\"),\n      second: value(\"second\"),\n    }\n  } catch {\n    return undefined\n  }\n}\n\nfunction timeZoneOffsetMinutes(date: Date, timeZone: string): number | undefined {\n  const parts = datePartsInTimeZone(date, timeZone)\n  if (!parts) return undefined\n  const representedAsUtc = Date.UTC(\n    parts.year,\n    parts.month - 1,\n    parts.day,\n    parts.hour,\n    parts.minute,\n    parts.second,\n    date.getUTCMilliseconds(),\n  )\n  return Math.round((representedAsUtc - date.getTime()) / 60_000)\n}\n\nfunction pad(value: number, length = 2): string {\n  return String(value).padStart(length, \"0\")\n}\n\nfunction formatOffset(offsetMinutes: number): string {\n  if (offsetMinutes === 0) return \"Z\"\n  const sign = offsetMinutes < 0 ? \"-\" : \"+\"\n  const absolute = Math.abs(offsetMinutes)\n  return `${sign}${pad(Math.floor(absolute / 60))}:${pad(absolute % 60)}`\n}\n\nfunction formatAllDayDate(value: string | Date, timeZone?: string | null): string {\n  const dateOnly = typeof value === \"string\" ? /^(\\d{4})-(\\d{2})-(\\d{2})$/.exec(value) : null\n  if (dateOnly) {\n    const [, year, month, day] = dateOnly\n    const localMidnight = new Date(Number(year), Number(month) - 1, Number(day))\n    let offsetMinutes = -localMidnight.getTimezoneOffset()\n    if (timeZone) {\n      // Resolve the offset at midnight in the event timezone. Repeating once\n      // accounts for the initial UTC guess landing across a DST boundary.\n      const wallTime = Date.UTC(Number(year), Number(month) - 1, Number(day))\n      let instant = new Date(wallTime)\n      for (let attempt = 0; attempt < 2; attempt += 1) {\n        const offset = timeZoneOffsetMinutes(instant, timeZone)\n        if (offset === undefined) break\n        offsetMinutes = offset\n        instant = new Date(wallTime - offset * 60_000)\n      }\n    }\n    return `${year}-${month}-${day}T00:00:00.000${formatOffset(offsetMinutes)}`\n  }\n\n  const date = new Date(value)\n  const zonedParts = timeZone ? datePartsInTimeZone(date, timeZone) : undefined\n  const parts = zonedParts ?? localDateParts(date)\n  const offsetMinutes =\n    timeZone && zonedParts\n      ? (timeZoneOffsetMinutes(date, timeZone) ?? -date.getTimezoneOffset())\n      : -date.getTimezoneOffset()\n  return `${pad(parts.year, 4)}-${pad(parts.month)}-${pad(parts.day)}T${pad(parts.hour)}:${pad(parts.minute)}:${pad(parts.second)}.${pad(date.getUTCMilliseconds(), 3)}${formatOffset(offsetMinutes)}`\n}\n\nexport function normalizeCalendarEvent(event: RawCalendarEvent): CalendarEvent {\n  const startsAt = event.allDay\n    ? formatAllDayDate(event.startDate, event.timeZone)\n    : new Date(event.startDate).toISOString()\n  const endsAt = event.allDay ? formatAllDayDate(event.endDate, event.timeZone) : new Date(event.endDate).toISOString()\n  const calendarId = event.calendarId ?? \"\"\n  const eventId = event.id ?? \"\"\n  return {\n    id: `${calendarId}:${eventId}:${startsAt}`,\n    calendarId,\n    title: event.title ?? \"\",\n    startsAt,\n    endsAt,\n    ...(event.timeZone ? {timezone: event.timeZone} : {}),\n    allDay: !!event.allDay,\n    ...(event.location ? {location: event.location} : {}),\n    ...(event.notes ? {notes: event.notes} : {}),\n    ...(event.url ? {url: event.url} : {}),\n    links: extractHttpsLinks(event.url, event.location, event.notes),\n  }\n}\n\nexport function calendarEventOverlapsWindow(event: CalendarEvent, startsAt: Date, endsAt: Date): boolean {\n  return Date.parse(event.endsAt) > startsAt.getTime() && Date.parse(event.startsAt) < endsAt.getTime()\n}\n"]}

package/build/services/PhoneCalendarService.d.ts

@@ -0,0 +1,5 @@
+import { type CalendarListResult } from "@mentra/miniapp";
+import { type CalendarListRequest } from "./PhoneCalendarHelpers";
+export { PhoneCalendarError } from "./PhoneCalendarHelpers";
+export declare function listPhoneCalendarEvents(request: CalendarListRequest): Promise<CalendarListResult>;
+//# sourceMappingURL=PhoneCalendarService.d.ts.map

package/build/services/PhoneCalendarService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PhoneCalendarService.d.ts","sourceRoot":"","sources":["../../src/services/PhoneCalendarService.ts"],"names":[],"mappings":"AAIA,OAAO,EAAmB,KAAK,kBAAkB,EAAC,MAAM,iBAAiB,CAAA;AAEzE,OAAO,EAEL,KAAK,mBAAmB,EAIzB,MAAM,wBAAwB,CAAA;AAE/B,OAAO,EAAC,kBAAkB,EAAC,MAAM,wBAAwB,CAAA;AA0BzD,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAwBvG"}

package/build/services/PhoneCalendarService.js

@@ -0,0 +1,45 @@
+import * as Calendar from "expo-calendar";
+import { Platform } from "react-native";
+import { check, PERMISSIONS, RESULTS } from "react-native-permissions";
+import { MiniappErrorCode } from "@mentra/miniapp";
+import { calendarEventOverlapsWindow, normalizeCalendarEvent, PhoneCalendarError, validateCalendarListRequest, } from "./PhoneCalendarHelpers";
+export { PhoneCalendarError } from "./PhoneCalendarHelpers";
+/**
+ * expo-calendar reports anything below EventKit full access as not granted,
+ * so distinguish the states the user can actually fix. "Reopen the miniapp"
+ * is only true while the permission is undetermined — once iOS has resolved
+ * it (denied or write-only/limited), only Settings can change it.
+ */
+async function calendarPermissionMessage(status) {
+    if (status === "undetermined") {
+        return "Calendar permission has not been granted yet. Reopen the miniapp and allow calendar access.";
+    }
+    if (Platform.OS === "ios") {
+        const writeOnly = await check(PERMISSIONS.IOS.CALENDARS_WRITE_ONLY).catch(() => null);
+        if (writeOnly === RESULTS.GRANTED || writeOnly === RESULTS.LIMITED) {
+            return 'Calendar access is limited to write-only. Enable "Full Access" for Mentra in Settings › Privacy & Security › Calendars.';
+        }
+        return "Calendar access is denied. Enable it for Mentra in Settings › Privacy & Security › Calendars.";
+    }
+    return "Calendar access is denied. Enable the Calendar permission for Mentra in your phone's app settings.";
+}
+export async function listPhoneCalendarEvents(request) {
+    const { startsAt, endsAt, limit } = validateCalendarListRequest(request);
+    const permission = await Calendar.getCalendarPermissionsAsync();
+    if (permission.status !== "granted") {
+        throw new PhoneCalendarError(MiniappErrorCode.PERMISSION_DENIED, await calendarPermissionMessage(permission.status));
+    }
+    const calendars = await Calendar.getCalendarsAsync(Calendar.EntityTypes.EVENT);
+    if (calendars.length === 0)
+        return { events: [], truncated: false };
+    const rawEvents = await Calendar.getEventsAsync(calendars.map((calendar) => calendar.id), startsAt, endsAt);
+    const events = rawEvents
+        .map(normalizeCalendarEvent)
+        .filter((event) => calendarEventOverlapsWindow(event, startsAt, endsAt))
+        .sort((a, b) => Date.parse(a.startsAt) - Date.parse(b.startsAt) || Date.parse(a.endsAt) - Date.parse(b.endsAt));
+    return {
+        events: events.slice(0, limit),
+        truncated: events.length > limit,
+    };
+}
+//# sourceMappingURL=PhoneCalendarService.js.map

package/build/services/PhoneCalendarService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PhoneCalendarService.js","sourceRoot":"","sources":["../../src/services/PhoneCalendarService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,EAAC,QAAQ,EAAC,MAAM,cAAc,CAAA;AACrC,OAAO,EAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAC,MAAM,0BAA0B,CAAA;AAEpE,OAAO,EAAC,gBAAgB,EAA0B,MAAM,iBAAiB,CAAA;AAEzE,OAAO,EACL,2BAA2B,EAE3B,sBAAsB,EACtB,kBAAkB,EAClB,2BAA2B,GAC5B,MAAM,wBAAwB,CAAA;AAE/B,OAAO,EAAC,kBAAkB,EAAC,MAAM,wBAAwB,CAAA;AAMzD;;;;;GAKG;AACH,KAAK,UAAU,yBAAyB,CAAC,MAAgC;IACvE,IAAI,MAAM,KAAK,cAAc,EAAE,CAAC;QAC9B,OAAO,6FAA6F,CAAA;IACtG,CAAC;IACD,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;QAC1B,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAA;QACrF,IAAI,SAAS,KAAK,OAAO,CAAC,OAAO,IAAI,SAAS,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC;YACnE,OAAO,yHAAyH,CAAA;QAClI,CAAC;QACD,OAAO,+FAA+F,CAAA;IACxG,CAAC;IACD,OAAO,oGAAoG,CAAA;AAC7G,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,OAA4B;IACxE,MAAM,EAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAC,GAAG,2BAA2B,CAAC,OAAO,CAAC,CAAA;IACtE,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,2BAA2B,EAAE,CAAA;IAC/D,IAAI,UAAU,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACpC,MAAM,IAAI,kBAAkB,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,MAAM,yBAAyB,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAA;IACtH,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,iBAAiB,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;IAC9E,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAC,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAC,CAAA;IAEjE,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,cAAc,CAC7C,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EACxC,QAAQ,EACR,MAAM,CACP,CAAA;IACD,MAAM,MAAM,GAAG,SAAS;SACrB,GAAG,CAAC,sBAAsB,CAAC;SAC3B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,2BAA2B,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;SACvE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAA;IAEjH,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;QAC9B,SAAS,EAAE,MAAM,CAAC,MAAM,GAAG,KAAK;KACjC,CAAA;AACH,CAAC","sourcesContent":["import * as Calendar from \"expo-calendar\"\nimport {Platform} from \"react-native\"\nimport {check, PERMISSIONS, RESULTS} from \"react-native-permissions\"\n\nimport {MiniappErrorCode, type CalendarListResult} from \"@mentra/miniapp\"\n\nimport {\n  calendarEventOverlapsWindow,\n  type CalendarListRequest,\n  normalizeCalendarEvent,\n  PhoneCalendarError,\n  validateCalendarListRequest,\n} from \"./PhoneCalendarHelpers\"\n\nexport {PhoneCalendarError} from \"./PhoneCalendarHelpers\"\n\ntype CalendarPermissionStatus = Awaited<\n  ReturnType<typeof Calendar.getCalendarPermissionsAsync>\n>[\"status\"]\n\n/**\n * expo-calendar reports anything below EventKit full access as not granted,\n * so distinguish the states the user can actually fix. \"Reopen the miniapp\"\n * is only true while the permission is undetermined — once iOS has resolved\n * it (denied or write-only/limited), only Settings can change it.\n */\nasync function calendarPermissionMessage(status: CalendarPermissionStatus): Promise<string> {\n  if (status === \"undetermined\") {\n    return \"Calendar permission has not been granted yet. Reopen the miniapp and allow calendar access.\"\n  }\n  if (Platform.OS === \"ios\") {\n    const writeOnly = await check(PERMISSIONS.IOS.CALENDARS_WRITE_ONLY).catch(() => null)\n    if (writeOnly === RESULTS.GRANTED || writeOnly === RESULTS.LIMITED) {\n      return 'Calendar access is limited to write-only. Enable \"Full Access\" for Mentra in Settings › Privacy & Security › Calendars.'\n    }\n    return \"Calendar access is denied. Enable it for Mentra in Settings › Privacy & Security › Calendars.\"\n  }\n  return \"Calendar access is denied. Enable the Calendar permission for Mentra in your phone's app settings.\"\n}\n\nexport async function listPhoneCalendarEvents(request: CalendarListRequest): Promise<CalendarListResult> {\n  const {startsAt, endsAt, limit} = validateCalendarListRequest(request)\n  const permission = await Calendar.getCalendarPermissionsAsync()\n  if (permission.status !== \"granted\") {\n    throw new PhoneCalendarError(MiniappErrorCode.PERMISSION_DENIED, await calendarPermissionMessage(permission.status))\n  }\n\n  const calendars = await Calendar.getCalendarsAsync(Calendar.EntityTypes.EVENT)\n  if (calendars.length === 0) return {events: [], truncated: false}\n\n  const rawEvents = await Calendar.getEventsAsync(\n    calendars.map((calendar) => calendar.id),\n    startsAt,\n    endsAt,\n  )\n  const events = rawEvents\n    .map(normalizeCalendarEvent)\n    .filter((event) => calendarEventOverlapsWindow(event, startsAt, endsAt))\n    .sort((a, b) => Date.parse(a.startsAt) - Date.parse(b.startsAt) || Date.parse(a.endsAt) - Date.parse(b.endsAt))\n\n  return {\n    events: events.slice(0, limit),\n    truncated: events.length > limit,\n  }\n}\n"]}

package/build/services/PhoneCameraFovCoordinator.d.ts

@@ -0,0 +1,30 @@
+import { type CameraFovRequest, type CameraFovResult } from "@mentra/bluetooth-sdk/internal";
+export declare const CAMERA_FOV_OVERRIDE_TTL_MS = 300000;
+export declare const CAMERA_FOV_OVERRIDE_REFRESH_MS = 120000;
+/**
+ * Serializes miniapp-owned FOV/ROI overrides. The last live owner wins; releasing it applies the
+ * previous owner or asks ASG to restore its persistent base. ASG refreshes are no-restart TTL
+ * extensions for crash safety.
+ */
+export declare class PhoneCameraFovCoordinator {
+    private readonly legacyRestartSettleMs;
+    private readonly overrides;
+    private effectiveLeaseId;
+    private sequence;
+    private queue;
+    private refreshTimer;
+    private legacyMode;
+    constructor(legacyRestartSettleMs?: number);
+    /** Report-safe FOV ownership snapshot for incident diagnostics. */
+    getDiagnosticSnapshot(): Record<string, unknown>;
+    setOverride(packageName: string, request: CameraFovRequest): Promise<CameraFovResult>;
+    releaseForApp(packageName: string): Promise<void>;
+    private scheduleRefresh;
+    private clearRefresh;
+    private setLegacyOverride;
+    private applyLegacyFov;
+    private waitForLegacyCameraRestart;
+    private enqueue;
+}
+export declare const phoneCameraFovCoordinator: PhoneCameraFovCoordinator;
+//# sourceMappingURL=PhoneCameraFovCoordinator.d.ts.map

package/build/services/PhoneCameraFovCoordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PhoneCameraFovCoordinator.d.ts","sourceRoot":"","sources":["../../src/services/PhoneCameraFovCoordinator.ts"],"names":[],"mappings":"AAAA,OAAqB,EAAC,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAC,MAAM,gCAAgC,CAAA;AAExG,eAAO,MAAM,0BAA0B,SAAU,CAAA;AACjD,eAAO,MAAM,8BAA8B,SAAU,CAAA;AAyBrD;;;;GAIG;AACH,qBAAa,yBAAyB;IAQxB,OAAO,CAAC,QAAQ,CAAC,qBAAqB;IAPlD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmC;IAC7D,OAAO,CAAC,gBAAgB,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAI;IACpB,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,YAAY,CAA2C;IAC/D,OAAO,CAAC,UAAU,CAAQ;gBAEG,qBAAqB,SAAkC;IAEpF,mEAAmE;IACnE,qBAAqB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAchD,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IAkCrF,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoDjD,OAAO,CAAC,eAAe;IAqBvB,OAAO,CAAC,YAAY;YAKN,iBAAiB;YAkBjB,cAAc;IAM5B,OAAO,CAAC,0BAA0B;IAKlC,OAAO,CAAC,OAAO;CAQhB;AAED,eAAO,MAAM,yBAAyB,2BAAkC,CAAA"}

package/build/services/PhoneCameraFovCoordinator.js

@@ -0,0 +1,194 @@
+import BluetoothSdk from "@mentra/bluetooth-sdk/internal";
+export const CAMERA_FOV_OVERRIDE_TTL_MS = 300_000;
+export const CAMERA_FOV_OVERRIDE_REFRESH_MS = 120_000;
+// Legacy ASG clients restart the camera HAL for an FOV update but cannot acknowledge
+// when it is usable again. The ASG cooldown is 5s; retain a small settling margin so
+// miniapps cannot submit a photo against the stale camera service.
+const LEGACY_CAMERA_RESTART_SETTLE_MS = 7_000;
+let leaseCounter = 0;
+function mintLeaseId() {
+    leaseCounter = (leaseCounter + 1) & 0xffff;
+    return `fov-${leaseCounter.toString(16).padStart(4, "0")}`;
+}
+function isLegacyFovCompatibilityError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return /timed out waiting for glasses response|not available|unknown method/i.test(message);
+}
+/**
+ * Serializes miniapp-owned FOV/ROI overrides. The last live owner wins; releasing it applies the
+ * previous owner or asks ASG to restore its persistent base. ASG refreshes are no-restart TTL
+ * extensions for crash safety.
+ */
+export class PhoneCameraFovCoordinator {
+    legacyRestartSettleMs;
+    overrides = new Map();
+    effectiveLeaseId;
+    sequence = 0;
+    queue = Promise.resolve();
+    refreshTimer;
+    legacyMode = false;
+    constructor(legacyRestartSettleMs = LEGACY_CAMERA_RESTART_SETTLE_MS) {
+        this.legacyRestartSettleMs = legacyRestartSettleMs;
+    }
+    /** Report-safe FOV ownership snapshot for incident diagnostics. */
+    getDiagnosticSnapshot() {
+        return {
+            owners: [...this.overrides.entries()]
+                .sort(([, a], [, b]) => b.order - a.order)
+                .map(([packageName, entry]) => ({
+                packageName,
+                effective: entry.leaseId === this.effectiveLeaseId,
+                fov: entry.fov,
+                roiPosition: entry.roiPosition,
+            })),
+            legacyMode: this.legacyMode,
+        };
+    }
+    setOverride(packageName, request) {
+        return this.enqueue(async () => {
+            const previous = this.overrides.get(packageName);
+            const leaseId = previous?.leaseId ?? mintLeaseId();
+            const order = ++this.sequence;
+            try {
+                if (this.legacyMode)
+                    return this.setLegacyOverride(packageName, request, leaseId, order);
+                const result = await BluetoothSdk.setCameraFovOverride({
+                    ...request,
+                    leaseId,
+                    ttlMs: CAMERA_FOV_OVERRIDE_TTL_MS,
+                });
+                this.overrides.set(packageName, {
+                    leaseId,
+                    fov: result.fov,
+                    roiPosition: result.roiPosition,
+                    order,
+                });
+                this.effectiveLeaseId = leaseId;
+                this.scheduleRefresh();
+                return result;
+            }
+            catch (error) {
+                if (!isLegacyFovCompatibilityError(error))
+                    throw error;
+                console.warn("[PhoneCameraFovCoordinator] override unavailable; using legacy FOV command", error);
+                const result = await this.setLegacyOverride(packageName, request, leaseId, order);
+                // Only cache compatibility mode after the fallback itself succeeds. A
+                // disconnect or missing native bridge must not permanently downgrade
+                // future requests on a healthy/newer glasses connection.
+                this.legacyMode = true;
+                return result;
+            }
+        });
+    }
+    releaseForApp(packageName) {
+        return this.enqueue(async () => {
+            const removed = this.overrides.get(packageName);
+            if (!removed)
+                return;
+            if (removed.leaseId !== this.effectiveLeaseId) {
+                this.overrides.delete(packageName);
+                return;
+            }
+            const next = [...this.overrides.entries()]
+                .filter(([candidatePackage]) => candidatePackage !== packageName)
+                .map(([, entry]) => entry)
+                .sort((a, b) => b.order - a.order)[0];
+            if (this.legacyMode) {
+                if (next) {
+                    await this.applyLegacyFov({ fov: next.fov, roiPosition: next.roiPosition });
+                    this.overrides.delete(packageName);
+                    this.effectiveLeaseId = next.leaseId;
+                }
+                else {
+                    // Legacy commands are one-way and have no lease-release protocol.
+                    // Ask native to replay its unchanged persistent base setting, then
+                    // probe the modern override path again for the next ownership cycle.
+                    await BluetoothSdk.restoreLegacyCameraFov();
+                    await this.waitForLegacyCameraRestart();
+                    this.overrides.delete(packageName);
+                    this.clearRefresh();
+                    this.effectiveLeaseId = undefined;
+                    this.legacyMode = false;
+                }
+                return;
+            }
+            if (next) {
+                await BluetoothSdk.setCameraFovOverride({
+                    leaseId: next.leaseId,
+                    fov: next.fov,
+                    roiPosition: next.roiPosition,
+                    ttlMs: CAMERA_FOV_OVERRIDE_TTL_MS,
+                });
+                // Commit phone-side ownership only after ASG accepted the replacement. On failure the
+                // closing app remains effective here, allowing unregister/reconnect cleanup to retry.
+                this.overrides.delete(packageName);
+                this.effectiveLeaseId = next.leaseId;
+                this.scheduleRefresh();
+            }
+            else {
+                await BluetoothSdk.releaseCameraFovOverride(removed.leaseId);
+                this.overrides.delete(packageName);
+                this.clearRefresh();
+                this.effectiveLeaseId = undefined;
+            }
+        });
+    }
+    scheduleRefresh() {
+        if (this.legacyMode)
+            return;
+        this.clearRefresh();
+        const leaseId = this.effectiveLeaseId;
+        if (!leaseId)
+            return;
+        this.refreshTimer = setTimeout(() => {
+            void this.enqueue(async () => {
+                if (this.effectiveLeaseId !== leaseId)
+                    return;
+                const entry = [...this.overrides.values()].find((candidate) => candidate.leaseId === leaseId);
+                if (!entry)
+                    return;
+                await BluetoothSdk.setCameraFovOverride({
+                    leaseId,
+                    fov: entry.fov,
+                    roiPosition: entry.roiPosition,
+                    ttlMs: CAMERA_FOV_OVERRIDE_TTL_MS,
+                });
+                this.scheduleRefresh();
+            }).catch((error) => console.warn("[PhoneCameraFovCoordinator] failed to refresh override", error));
+        }, CAMERA_FOV_OVERRIDE_REFRESH_MS);
+    }
+    clearRefresh() {
+        if (this.refreshTimer)
+            clearTimeout(this.refreshTimer);
+        this.refreshTimer = undefined;
+    }
+    async setLegacyOverride(packageName, request, leaseId, order) {
+        const result = await this.applyLegacyFov(request);
+        this.overrides.set(packageName, {
+            leaseId,
+            fov: result.fov,
+            roiPosition: result.roiPosition,
+            order,
+        });
+        this.effectiveLeaseId = leaseId;
+        this.clearRefresh();
+        return result;
+    }
+    async applyLegacyFov(request) {
+        const result = await BluetoothSdk.setLegacyCameraFov(request);
+        await this.waitForLegacyCameraRestart();
+        return result;
+    }
+    waitForLegacyCameraRestart() {
+        if (this.legacyRestartSettleMs <= 0)
+            return Promise.resolve();
+        return new Promise((resolve) => setTimeout(resolve, this.legacyRestartSettleMs));
+    }
+    enqueue(operation) {
+        const result = this.queue.then(operation, operation);
+        this.queue = result.then(() => undefined, () => undefined);
+        return result;
+    }
+}
+export const phoneCameraFovCoordinator = new PhoneCameraFovCoordinator();
+//# sourceMappingURL=PhoneCameraFovCoordinator.js.map

package/build/services/PhoneCameraFovCoordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PhoneCameraFovCoordinator.js","sourceRoot":"","sources":["../../src/services/PhoneCameraFovCoordinator.ts"],"names":[],"mappings":"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","sourcesContent":["import BluetoothSdk, {type CameraFovRequest, type CameraFovResult} from \"@mentra/bluetooth-sdk/internal\"\n\nexport const CAMERA_FOV_OVERRIDE_TTL_MS = 300_000\nexport const CAMERA_FOV_OVERRIDE_REFRESH_MS = 120_000\n// Legacy ASG clients restart the camera HAL for an FOV update but cannot acknowledge\n// when it is usable again. The ASG cooldown is 5s; retain a small settling margin so\n// miniapps cannot submit a photo against the stale camera service.\nconst LEGACY_CAMERA_RESTART_SETTLE_MS = 7_000\n\ninterface OverrideEntry {\n  leaseId: string\n  fov: number\n  roiPosition: \"center\" | \"bottom\" | \"top\"\n  order: number\n}\n\nlet leaseCounter = 0\n\nfunction mintLeaseId(): string {\n  leaseCounter = (leaseCounter + 1) & 0xffff\n  return `fov-${leaseCounter.toString(16).padStart(4, \"0\")}`\n}\n\nfunction isLegacyFovCompatibilityError(error: unknown): boolean {\n  const message = error instanceof Error ? error.message : String(error)\n  return /timed out waiting for glasses response|not available|unknown method/i.test(message)\n}\n\n/**\n * Serializes miniapp-owned FOV/ROI overrides. The last live owner wins; releasing it applies the\n * previous owner or asks ASG to restore its persistent base. ASG refreshes are no-restart TTL\n * extensions for crash safety.\n */\nexport class PhoneCameraFovCoordinator {\n  private readonly overrides = new Map<string, OverrideEntry>()\n  private effectiveLeaseId: string | undefined\n  private sequence = 0\n  private queue: Promise<unknown> = Promise.resolve()\n  private refreshTimer: ReturnType<typeof setTimeout> | undefined\n  private legacyMode = false\n\n  constructor(private readonly legacyRestartSettleMs = LEGACY_CAMERA_RESTART_SETTLE_MS) {}\n\n  /** Report-safe FOV ownership snapshot for incident diagnostics. */\n  getDiagnosticSnapshot(): Record<string, unknown> {\n    return {\n      owners: [...this.overrides.entries()]\n        .sort(([, a], [, b]) => b.order - a.order)\n        .map(([packageName, entry]) => ({\n          packageName,\n          effective: entry.leaseId === this.effectiveLeaseId,\n          fov: entry.fov,\n          roiPosition: entry.roiPosition,\n        })),\n      legacyMode: this.legacyMode,\n    }\n  }\n\n  setOverride(packageName: string, request: CameraFovRequest): Promise<CameraFovResult> {\n    return this.enqueue(async () => {\n      const previous = this.overrides.get(packageName)\n      const leaseId = previous?.leaseId ?? mintLeaseId()\n      const order = ++this.sequence\n      try {\n        if (this.legacyMode) return this.setLegacyOverride(packageName, request, leaseId, order)\n        const result = await BluetoothSdk.setCameraFovOverride({\n          ...request,\n          leaseId,\n          ttlMs: CAMERA_FOV_OVERRIDE_TTL_MS,\n        })\n        this.overrides.set(packageName, {\n          leaseId,\n          fov: result.fov,\n          roiPosition: result.roiPosition,\n          order,\n        })\n        this.effectiveLeaseId = leaseId\n        this.scheduleRefresh()\n        return result\n      } catch (error) {\n        if (!isLegacyFovCompatibilityError(error)) throw error\n        console.warn(\"[PhoneCameraFovCoordinator] override unavailable; using legacy FOV command\", error)\n        const result = await this.setLegacyOverride(packageName, request, leaseId, order)\n        // Only cache compatibility mode after the fallback itself succeeds. A\n        // disconnect or missing native bridge must not permanently downgrade\n        // future requests on a healthy/newer glasses connection.\n        this.legacyMode = true\n        return result\n      }\n    })\n  }\n\n  releaseForApp(packageName: string): Promise<void> {\n    return this.enqueue(async () => {\n      const removed = this.overrides.get(packageName)\n      if (!removed) return\n      if (removed.leaseId !== this.effectiveLeaseId) {\n        this.overrides.delete(packageName)\n        return\n      }\n\n      const next = [...this.overrides.entries()]\n        .filter(([candidatePackage]) => candidatePackage !== packageName)\n        .map(([, entry]) => entry)\n        .sort((a, b) => b.order - a.order)[0]\n      if (this.legacyMode) {\n        if (next) {\n          await this.applyLegacyFov({fov: next.fov, roiPosition: next.roiPosition})\n          this.overrides.delete(packageName)\n          this.effectiveLeaseId = next.leaseId\n        } else {\n          // Legacy commands are one-way and have no lease-release protocol.\n          // Ask native to replay its unchanged persistent base setting, then\n          // probe the modern override path again for the next ownership cycle.\n          await BluetoothSdk.restoreLegacyCameraFov()\n          await this.waitForLegacyCameraRestart()\n          this.overrides.delete(packageName)\n          this.clearRefresh()\n          this.effectiveLeaseId = undefined\n          this.legacyMode = false\n        }\n        return\n      }\n      if (next) {\n        await BluetoothSdk.setCameraFovOverride({\n          leaseId: next.leaseId,\n          fov: next.fov,\n          roiPosition: next.roiPosition,\n          ttlMs: CAMERA_FOV_OVERRIDE_TTL_MS,\n        })\n        // Commit phone-side ownership only after ASG accepted the replacement. On failure the\n        // closing app remains effective here, allowing unregister/reconnect cleanup to retry.\n        this.overrides.delete(packageName)\n        this.effectiveLeaseId = next.leaseId\n        this.scheduleRefresh()\n      } else {\n        await BluetoothSdk.releaseCameraFovOverride(removed.leaseId)\n        this.overrides.delete(packageName)\n        this.clearRefresh()\n        this.effectiveLeaseId = undefined\n      }\n    })\n  }\n\n  private scheduleRefresh(): void {\n    if (this.legacyMode) return\n    this.clearRefresh()\n    const leaseId = this.effectiveLeaseId\n    if (!leaseId) return\n    this.refreshTimer = setTimeout(() => {\n      void this.enqueue(async () => {\n        if (this.effectiveLeaseId !== leaseId) return\n        const entry = [...this.overrides.values()].find((candidate) => candidate.leaseId === leaseId)\n        if (!entry) return\n        await BluetoothSdk.setCameraFovOverride({\n          leaseId,\n          fov: entry.fov,\n          roiPosition: entry.roiPosition,\n          ttlMs: CAMERA_FOV_OVERRIDE_TTL_MS,\n        })\n        this.scheduleRefresh()\n      }).catch((error) => console.warn(\"[PhoneCameraFovCoordinator] failed to refresh override\", error))\n    }, CAMERA_FOV_OVERRIDE_REFRESH_MS)\n  }\n\n  private clearRefresh(): void {\n    if (this.refreshTimer) clearTimeout(this.refreshTimer)\n    this.refreshTimer = undefined\n  }\n\n  private async setLegacyOverride(\n    packageName: string,\n    request: CameraFovRequest,\n    leaseId: string,\n    order: number,\n  ): Promise<CameraFovResult> {\n    const result = await this.applyLegacyFov(request)\n    this.overrides.set(packageName, {\n      leaseId,\n      fov: result.fov,\n      roiPosition: result.roiPosition,\n      order,\n    })\n    this.effectiveLeaseId = leaseId\n    this.clearRefresh()\n    return result\n  }\n\n  private async applyLegacyFov(request: CameraFovRequest): Promise<CameraFovResult> {\n    const result = await BluetoothSdk.setLegacyCameraFov(request)\n    await this.waitForLegacyCameraRestart()\n    return result\n  }\n\n  private waitForLegacyCameraRestart(): Promise<void> {\n    if (this.legacyRestartSettleMs <= 0) return Promise.resolve()\n    return new Promise<void>((resolve) => setTimeout(resolve, this.legacyRestartSettleMs))\n  }\n\n  private enqueue<T>(operation: () => Promise<T>): Promise<T> {\n    const result = this.queue.then(operation, operation)\n    this.queue = result.then(\n      () => undefined,\n      () => undefined,\n    )\n    return result\n  }\n}\n\nexport const phoneCameraFovCoordinator = new PhoneCameraFovCoordinator()\n"]}

package/build/services/PhoneNotificationsSync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PhoneNotificationsSync.d.ts","sourceRoot":"","sources":["../../src/services/PhoneNotificationsSync.ts"],"names":[],"mappings":"AA2BA,wBAAgB,2BAA2B,IAAI,IAAI,CAWlD;AAED,wBAAgB,0BAA0B,IAAI,IAAI,CAGjD"}
+{"version":3,"file":"PhoneNotificationsSync.d.ts","sourceRoot":"","sources":["../../src/services/PhoneNotificationsSync.ts"],"names":[],"mappings":"AA6BA,wBAAgB,2BAA2B,IAAI,IAAI,CAWlD;AAED,wBAAgB,0BAA0B,IAAI,IAAI,CAGjD"}

package/build/services/PhoneNotificationsSync.js

@@ -1,10 +1,15 @@
 /**
  * Phone-notifications sync — engine-owned. Pushes the notification-forwarding
- * config (`notifications_enabled` + `notifications_blocklist`) to the native
+ * operational kill switch + config (`android_notification_listener_enabled`
+ * and `notifications_blocklist`) to the native
  * NotificationListener via `CrustModule.setNotificationConfig`, so
- * `engine.phoneNotifications.setEnabled()/setBlocklist()` actually reach the
- * listener for ANY host — not just the Mentra app, where this used to live in
- * MantleManager. Android-only; a no-op elsewhere. Started by `engine.start()`.
+ * the blocklist reaches the listener for ANY host — not just the Mentra App,
+ * where this used to live in MantleManager. The Android service is desired by
+ * default now that its cold start is isolated from React Native. Native code
+ * keeps the component discoverable in Android's notification-access Settings,
+ * but only binds the service after access is granted. The debug setting remains
+ * a hidden emergency kill switch; Notify's running state gates presentation,
+ * not capture. Android-only; a no-op elsewhere. Started by `engine.start()`.
  */
 import { shallow } from "zustand/shallow";
 import CrustModule from "@mentra/crust";
@@ -12,19 +17,16 @@ import { useSettingsStore, SETTINGS } from "../stores/settings";
 let unsubscribe = null;
 function pushConfig() {
     const s = useSettingsStore.getState();
-    const enabled = Boolean(s.getSetting(SETTINGS.notifications_enabled.key));
+    const listenerEnabled = Boolean(s.getSetting(SETTINGS.android_notification_listener_enabled.key));
     const blocklist = s.getSetting(SETTINGS.notifications_blocklist.key);
-    // Unconditional (matches the prior MantleManager sync) — the listener is
-    // Android-only, but CrustModule.setNotificationConfig is a safe no-op elsewhere;
-    // the Android-only gating lives on the facade's setEnabled/setBlocklist.
-    CrustModule.setNotificationConfig(enabled, Array.isArray(blocklist) ? blocklist : []).catch((err) => console.warn(`PhoneNotificationsSync: setNotificationConfig failed: ${err?.message ?? err}`));
+    CrustModule.setNotificationConfig(listenerEnabled, Array.isArray(blocklist) ? blocklist : []).catch((err) => console.warn(`PhoneNotificationsSync: setNotificationConfig failed: ${err?.message ?? err}`));
 }
 export function startPhoneNotificationsSync() {
     if (unsubscribe)
         return;
     pushConfig(); // initial sync so the listener has the current config
     unsubscribe = useSettingsStore.subscribe((state) => ({
-        enabled: state.getSetting(SETTINGS.notifications_enabled.key),
+        listenerEnabled: state.getSetting(SETTINGS.android_notification_listener_enabled.key),
         blocklist: state.getSetting(SETTINGS.notifications_blocklist.key),
     }), () => pushConfig(), { equalityFn: shallow });
 }

package/build/services/PhoneNotificationsSync.js.map

@@ -1 +1 @@
-{"version":3,"file":"PhoneNotificationsSync.js","sourceRoot":"","sources":["../../src/services/PhoneNotificationsSync.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAC,OAAO,EAAC,MAAM,iBAAiB,CAAA;AACvC,OAAO,WAAW,MAAM,eAAe,CAAA;AAEvC,OAAO,EAAC,gBAAgB,EAAE,QAAQ,EAAC,MAAM,oBAAoB,CAAA;AAE7D,IAAI,WAAW,GAAwB,IAAI,CAAA;AAE3C,SAAS,UAAU;IACjB,MAAM,CAAC,GAAG,gBAAgB,CAAC,QAAQ,EAAE,CAAA;IACrC,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAA;IACzE,MAAM,SAAS,GAAG,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,uBAAuB,CAAC,GAAG,CAAC,CAAA;IACpE,yEAAyE;IACzE,iFAAiF;IACjF,yEAAyE;IACzE,WAAW,CAAC,qBAAqB,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE,CAC3G,OAAO,CAAC,IAAI,CAAC,yDAA0D,GAAa,EAAE,OAAO,IAAI,GAAG,EAAE,CAAC,CACxG,CAAA;AACH,CAAC;AAED,MAAM,UAAU,2BAA2B;IACzC,IAAI,WAAW;QAAE,OAAM;IACvB,UAAU,EAAE,CAAA,CAAC,sDAAsD;IACnE,WAAW,GAAG,gBAAgB,CAAC,SAAS,CACtC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACV,OAAO,EAAE,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,qBAAqB,CAAC,GAAG,CAAC;QAC7D,SAAS,EAAE,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,uBAAuB,CAAC,GAAG,CAAC;KAClE,CAAC,EACF,GAAG,EAAE,CAAC,UAAU,EAAE,EAClB,EAAC,UAAU,EAAE,OAAO,EAAC,CACtB,CAAA;AACH,CAAC;AAED,MAAM,UAAU,0BAA0B;IACxC,WAAW,EAAE,EAAE,CAAA;IACf,WAAW,GAAG,IAAI,CAAA;AACpB,CAAC","sourcesContent":["/**\n * Phone-notifications sync — engine-owned. Pushes the notification-forwarding\n * config (`notifications_enabled` + `notifications_blocklist`) to the native\n * NotificationListener via `CrustModule.setNotificationConfig`, so\n * `engine.phoneNotifications.setEnabled()/setBlocklist()` actually reach the\n * listener for ANY host — not just the Mentra app, where this used to live in\n * MantleManager. Android-only; a no-op elsewhere. Started by `engine.start()`.\n */\nimport {shallow} from \"zustand/shallow\"\nimport CrustModule from \"@mentra/crust\"\n\nimport {useSettingsStore, SETTINGS} from \"../stores/settings\"\n\nlet unsubscribe: (() => void) | null = null\n\nfunction pushConfig(): void {\n  const s = useSettingsStore.getState()\n  const enabled = Boolean(s.getSetting(SETTINGS.notifications_enabled.key))\n  const blocklist = s.getSetting(SETTINGS.notifications_blocklist.key)\n  // Unconditional (matches the prior MantleManager sync) — the listener is\n  // Android-only, but CrustModule.setNotificationConfig is a safe no-op elsewhere;\n  // the Android-only gating lives on the facade's setEnabled/setBlocklist.\n  CrustModule.setNotificationConfig(enabled, Array.isArray(blocklist) ? blocklist : []).catch((err: unknown) =>\n    console.warn(`PhoneNotificationsSync: setNotificationConfig failed: ${(err as Error)?.message ?? err}`),\n  )\n}\n\nexport function startPhoneNotificationsSync(): void {\n  if (unsubscribe) return\n  pushConfig() // initial sync so the listener has the current config\n  unsubscribe = useSettingsStore.subscribe(\n    (state) => ({\n      enabled: state.getSetting(SETTINGS.notifications_enabled.key),\n      blocklist: state.getSetting(SETTINGS.notifications_blocklist.key),\n    }),\n    () => pushConfig(),\n    {equalityFn: shallow},\n  )\n}\n\nexport function stopPhoneNotificationsSync(): void {\n  unsubscribe?.()\n  unsubscribe = null\n}\n"]}
+{"version":3,"file":"PhoneNotificationsSync.js","sourceRoot":"","sources":["../../src/services/PhoneNotificationsSync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAC,OAAO,EAAC,MAAM,iBAAiB,CAAA;AACvC,OAAO,WAAW,MAAM,eAAe,CAAA;AAEvC,OAAO,EAAC,gBAAgB,EAAE,QAAQ,EAAC,MAAM,oBAAoB,CAAA;AAE7D,IAAI,WAAW,GAAwB,IAAI,CAAA;AAE3C,SAAS,UAAU;IACjB,MAAM,CAAC,GAAG,gBAAgB,CAAC,QAAQ,EAAE,CAAA;IACrC,MAAM,eAAe,GAAG,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,qCAAqC,CAAC,GAAG,CAAC,CAAC,CAAA;IACjG,MAAM,SAAS,GAAG,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,uBAAuB,CAAC,GAAG,CAAC,CAAA;IACpE,WAAW,CAAC,qBAAqB,CAAC,eAAe,EAAE,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE,CACnH,OAAO,CAAC,IAAI,CAAC,yDAA0D,GAAa,EAAE,OAAO,IAAI,GAAG,EAAE,CAAC,CACxG,CAAA;AACH,CAAC;AAED,MAAM,UAAU,2BAA2B;IACzC,IAAI,WAAW;QAAE,OAAM;IACvB,UAAU,EAAE,CAAA,CAAC,sDAAsD;IACnE,WAAW,GAAG,gBAAgB,CAAC,SAAS,CACtC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACV,eAAe,EAAE,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,qCAAqC,CAAC,GAAG,CAAC;QACrF,SAAS,EAAE,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,uBAAuB,CAAC,GAAG,CAAC;KAClE,CAAC,EACF,GAAG,EAAE,CAAC,UAAU,EAAE,EAClB,EAAC,UAAU,EAAE,OAAO,EAAC,CACtB,CAAA;AACH,CAAC;AAED,MAAM,UAAU,0BAA0B;IACxC,WAAW,EAAE,EAAE,CAAA;IACf,WAAW,GAAG,IAAI,CAAA;AACpB,CAAC","sourcesContent":["/**\n * Phone-notifications sync — engine-owned. Pushes the notification-forwarding\n * operational kill switch + config (`android_notification_listener_enabled`\n * and `notifications_blocklist`) to the native\n * NotificationListener via `CrustModule.setNotificationConfig`, so\n * the blocklist reaches the listener for ANY host — not just the Mentra App,\n * where this used to live in MantleManager. The Android service is desired by\n * default now that its cold start is isolated from React Native. Native code\n * keeps the component discoverable in Android's notification-access Settings,\n * but only binds the service after access is granted. The debug setting remains\n * a hidden emergency kill switch; Notify's running state gates presentation,\n * not capture. Android-only; a no-op elsewhere. Started by `engine.start()`.\n */\nimport {shallow} from \"zustand/shallow\"\nimport CrustModule from \"@mentra/crust\"\n\nimport {useSettingsStore, SETTINGS} from \"../stores/settings\"\n\nlet unsubscribe: (() => void) | null = null\n\nfunction pushConfig(): void {\n  const s = useSettingsStore.getState()\n  const listenerEnabled = Boolean(s.getSetting(SETTINGS.android_notification_listener_enabled.key))\n  const blocklist = s.getSetting(SETTINGS.notifications_blocklist.key)\n  CrustModule.setNotificationConfig(listenerEnabled, Array.isArray(blocklist) ? blocklist : []).catch((err: unknown) =>\n    console.warn(`PhoneNotificationsSync: setNotificationConfig failed: ${(err as Error)?.message ?? err}`),\n  )\n}\n\nexport function startPhoneNotificationsSync(): void {\n  if (unsubscribe) return\n  pushConfig() // initial sync so the listener has the current config\n  unsubscribe = useSettingsStore.subscribe(\n    (state) => ({\n      listenerEnabled: state.getSetting(SETTINGS.android_notification_listener_enabled.key),\n      blocklist: state.getSetting(SETTINGS.notifications_blocklist.key),\n    }),\n    () => pushConfig(),\n    {equalityFn: shallow},\n  )\n}\n\nexport function stopPhoneNotificationsSync(): void {\n  unsubscribe?.()\n  unsubscribe = null\n}\n"]}