@xopcai/xopc 0.0.127 → 0.0.129

package/dist/src/mobile/notification-service.js

@@ -0,0 +1,139 @@
+import { createLogger } from "../utils/logger/index.js";
+import { init_logger } from "../utils/logger.js";
+import { createMobileActivityEvent, disableMobileDeviceForPushToken, listEnabledMobileDevices } from "./notification-store.js";
+//#region src/mobile/notification-service.ts
+init_logger();
+const log = createLogger("MobileNotifications");
+const EXPO_PUSH_URL = "https://exp.host/--/api/v2/push/send";
+function shouldDeliver(type, preferences) {
+	if (type === "goal.needs_input") return preferences.needsInput;
+	if (type === "goal.blocked") return preferences.failed;
+	if (type === "automation.failed") return preferences.automationFailed;
+	return preferences.completed;
+}
+function goalEvent(payload) {
+	if (!payload || typeof payload !== "object") return null;
+	const data = payload;
+	const goal = data.goal;
+	const goalId = typeof goal?.id === "string" ? goal.id : typeof data.goalId === "string" ? data.goalId : "";
+	const status = typeof data.status === "string" ? data.status : "";
+	if (!goalId || ![
+		"needs_input",
+		"blocked",
+		"done"
+	].includes(status)) return null;
+	const type = status === "needs_input" ? "goal.needs_input" : status === "blocked" ? "goal.blocked" : "goal.completed";
+	const sessionKey = typeof goal?.activeSessionKey === "string" ? goal.activeSessionKey : "";
+	const route = sessionKey ? `/chat/${encodeURIComponent(sessionKey)}` : "/";
+	return {
+		type,
+		entity: {
+			kind: "goal",
+			id: goalId
+		},
+		priority: type === "goal.needs_input" || type === "goal.blocked" ? "high" : "normal",
+		title: type === "goal.needs_input" ? "Action needed" : type === "goal.blocked" ? "Goal blocked" : "Goal completed",
+		body: typeof goal?.title === "string" ? goal.title.slice(0, 120) : void 0,
+		deepLink: route,
+		payload: {
+			route,
+			goalId,
+			eventType: type
+		}
+	};
+}
+function automationEvent(payload) {
+	if (!payload || typeof payload !== "object") return null;
+	const run = payload.run;
+	if (!run || run.status !== "failed" && run.status !== "timeout" && run.status !== "succeeded") return null;
+	const type = run.status === "succeeded" ? "automation.completed" : "automation.failed";
+	return {
+		type,
+		entity: {
+			kind: "automation",
+			id: run.automationId
+		},
+		priority: type === "automation.failed" ? "high" : "normal",
+		title: type === "automation.failed" ? "Automation failed" : "Automation completed",
+		body: run.automationName.slice(0, 120),
+		deepLink: "/automation",
+		payload: {
+			route: "/automation",
+			automationId: run.automationId,
+			runId: run.id,
+			eventType: type
+		}
+	};
+}
+/** Converts gateway domain events into a portable mobile activity and push payload. */
+function mobileNotificationEventFromGatewayEvent(type, payload) {
+	if (type === "goal.status.updated") return goalEvent(payload);
+	if (type === "automation.run.completed") return automationEvent(payload);
+	return null;
+}
+async function sendExpoPush(token, event) {
+	const response = await fetch(EXPO_PUSH_URL, {
+		method: "POST",
+		headers: {
+			"content-type": "application/json",
+			accept: "application/json"
+		},
+		body: JSON.stringify({
+			to: token,
+			title: event.title,
+			body: event.body,
+			sound: event.priority === "high" ? "default" : void 0,
+			priority: event.priority,
+			data: {
+				eventId: event.id,
+				...event.payload
+			}
+		})
+	});
+	if (!response.ok) throw new Error(`Expo push request failed (${response.status})`);
+	const result = await response.json().catch(() => null);
+	const item = Array.isArray(result?.data) ? result?.data[0] : result?.data;
+	if (item?.status === "error") {
+		if (item.details?.error === "DeviceNotRegistered") {
+			disableMobileDeviceForPushToken(token);
+			return;
+		}
+		throw new Error(`Expo push rejected: ${item.details?.error ?? "unknown error"}`);
+	}
+}
+var MobileNotificationService = class {
+	sent = /* @__PURE__ */ new Set();
+	handleGatewayEvent(type, payload) {
+		const event = mobileNotificationEventFromGatewayEvent(type, payload);
+		if (!event) return;
+		const dedupeKey = `${event.type}:${event.entity.kind}:${event.entity.id}:${JSON.stringify(event.payload)}`;
+		if (this.sent.has(dedupeKey)) return;
+		this.sent.add(dedupeKey);
+		this.deliver(event).catch((err) => {
+			log.warn({
+				err,
+				eventType: event.type,
+				entityId: event.entity.id
+			}, "Mobile notification delivery failed");
+		}).finally(() => this.sent.delete(dedupeKey));
+	}
+	async deliver(input) {
+		const event = createMobileActivityEvent(input);
+		const devices = listEnabledMobileDevices().filter((device) => shouldDeliver(event.type, device.preferences));
+		await Promise.all(devices.map(async (device) => {
+			try {
+				await sendExpoPush(device.pushToken, event);
+			} catch (err) {
+				log.warn({
+					err,
+					eventId: event.id,
+					deviceId: device.id
+				}, "Mobile push request failed");
+			}
+		}));
+	}
+};
+//#endregion
+export { MobileNotificationService, mobileNotificationEventFromGatewayEvent };
+
+//# sourceMappingURL=notification-service.js.map

package/dist/src/mobile/notification-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-service.js","names":[],"sources":["../../../src/mobile/notification-service.ts"],"sourcesContent":["import { createLogger } from '../utils/logger.js';\nimport type { AutomationRun } from '../automations/domain/types.js';\n\nimport {\n  createMobileActivityEvent,\n  disableMobileDeviceForPushToken,\n  listEnabledMobileDevices,\n} from './notification-store.js';\nimport type {\n  MobileActivityEvent,\n  MobileNotificationEventType,\n} from './notification-types.js';\n\nconst log = createLogger('MobileNotifications');\nconst EXPO_PUSH_URL = 'https://exp.host/--/api/v2/push/send';\n\ntype GoalPayload = {\n  goal?: { id?: unknown; title?: unknown; activeSessionKey?: unknown };\n  goalId?: unknown;\n  status?: unknown;\n};\n\ntype ExpoPushResult = { status?: string; details?: { error?: string } };\n\nfunction shouldDeliver(type: MobileNotificationEventType, preferences: {\n  needsInput: boolean;\n  failed: boolean;\n  completed: boolean;\n  automationFailed: boolean;\n}): boolean {\n  if (type === 'goal.needs_input') return preferences.needsInput;\n  if (type === 'goal.blocked') return preferences.failed;\n  if (type === 'automation.failed') return preferences.automationFailed;\n  return preferences.completed;\n}\n\nfunction goalEvent(payload: unknown): Omit<MobileActivityEvent, 'id' | 'createdAt'> | null {\n  if (!payload || typeof payload !== 'object') return null;\n  const data = payload as GoalPayload;\n  const goal = data.goal;\n  const goalId = typeof goal?.id === 'string' ? goal.id : typeof data.goalId === 'string' ? data.goalId : '';\n  const status = typeof data.status === 'string' ? data.status : '';\n  if (!goalId || !['needs_input', 'blocked', 'done'].includes(status)) return null;\n  const type: MobileNotificationEventType = status === 'needs_input'\n    ? 'goal.needs_input'\n    : status === 'blocked'\n      ? 'goal.blocked'\n      : 'goal.completed';\n  const sessionKey = typeof goal?.activeSessionKey === 'string' ? goal.activeSessionKey : '';\n  const route = sessionKey ? `/chat/${encodeURIComponent(sessionKey)}` : '/';\n  return {\n    type,\n    entity: { kind: 'goal', id: goalId },\n    priority: type === 'goal.needs_input' || type === 'goal.blocked' ? 'high' : 'normal',\n    title: type === 'goal.needs_input' ? 'Action needed' : type === 'goal.blocked' ? 'Goal blocked' : 'Goal completed',\n    body: typeof goal?.title === 'string' ? goal.title.slice(0, 120) : undefined,\n    deepLink: route,\n    payload: { route, goalId, eventType: type },\n  };\n}\n\nfunction automationEvent(payload: unknown): Omit<MobileActivityEvent, 'id' | 'createdAt'> | null {\n  if (!payload || typeof payload !== 'object') return null;\n  const run = (payload as { run?: AutomationRun }).run;\n  if (!run || (run.status !== 'failed' && run.status !== 'timeout' && run.status !== 'succeeded')) return null;\n  const type: MobileNotificationEventType = run.status === 'succeeded'\n    ? 'automation.completed'\n    : 'automation.failed';\n  return {\n    type,\n    entity: { kind: 'automation', id: run.automationId },\n    priority: type === 'automation.failed' ? 'high' : 'normal',\n    title: type === 'automation.failed' ? 'Automation failed' : 'Automation completed',\n    body: run.automationName.slice(0, 120),\n    deepLink: '/automation',\n    payload: { route: '/automation', automationId: run.automationId, runId: run.id, eventType: type },\n  };\n}\n\n/** Converts gateway domain events into a portable mobile activity and push payload. */\nexport function mobileNotificationEventFromGatewayEvent(\n  type: string,\n  payload: unknown,\n): Omit<MobileActivityEvent, 'id' | 'createdAt'> | null {\n  if (type === 'goal.status.updated') return goalEvent(payload);\n  if (type === 'automation.run.completed') return automationEvent(payload);\n  return null;\n}\n\nasync function sendExpoPush(token: string, event: MobileActivityEvent): Promise<void> {\n  const response = await fetch(EXPO_PUSH_URL, {\n    method: 'POST',\n    headers: { 'content-type': 'application/json', accept: 'application/json' },\n    body: JSON.stringify({\n      to: token,\n      title: event.title,\n      body: event.body,\n      sound: event.priority === 'high' ? 'default' : undefined,\n      priority: event.priority,\n      data: { eventId: event.id, ...event.payload },\n    }),\n  });\n  if (!response.ok) throw new Error(`Expo push request failed (${response.status})`);\n  const result = await response.json().catch(() => null) as { data?: ExpoPushResult | ExpoPushResult[] } | null;\n  const item = Array.isArray(result?.data) ? result?.data[0] : result?.data;\n  if (item?.status === 'error') {\n    if (item.details?.error === 'DeviceNotRegistered') {\n      disableMobileDeviceForPushToken(token);\n      return;\n    }\n    throw new Error(`Expo push rejected: ${item.details?.error ?? 'unknown error'}`);\n  }\n}\n\nexport class MobileNotificationService {\n  private readonly sent = new Set<string>();\n\n  handleGatewayEvent(type: string, payload: unknown): void {\n    const event = mobileNotificationEventFromGatewayEvent(type, payload);\n    if (!event) return;\n    const dedupeKey = `${event.type}:${event.entity.kind}:${event.entity.id}:${JSON.stringify(event.payload)}`;\n    if (this.sent.has(dedupeKey)) return;\n    this.sent.add(dedupeKey);\n    void this.deliver(event)\n      .catch((err) => {\n        log.warn({ err, eventType: event.type, entityId: event.entity.id }, 'Mobile notification delivery failed');\n      })\n      .finally(() => this.sent.delete(dedupeKey));\n  }\n\n  private async deliver(input: Omit<MobileActivityEvent, 'id' | 'createdAt'>): Promise<void> {\n    const event = createMobileActivityEvent(input);\n    const devices = listEnabledMobileDevices().filter((device) => shouldDeliver(event.type, device.preferences));\n    await Promise.all(devices.map(async (device) => {\n      try {\n        await sendExpoPush(device.pushToken, event);\n      } catch (err) {\n        log.warn({ err, eventId: event.id, deviceId: device.id }, 'Mobile push request failed');\n      }\n    }));\n  }\n}\n"],"mappings":"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"}

package/dist/src/mobile/notification-store.d.ts

@@ -0,0 +1,28 @@
+import { type MobileActivityEvent, type MobileDevice, type MobileNotificationPermission, type MobileNotificationPreferences, type MobilePlatform } from './notification-types.js';
+export type RegisterMobileDeviceInput = {
+    id: string;
+    platform: MobilePlatform;
+    pushToken: string;
+    permissions: MobileNotificationPermission;
+    preferences?: Partial<MobileNotificationPreferences>;
+    appVersion?: string;
+};
+export declare function registerMobileDevice(input: RegisterMobileDeviceInput): MobileDevice;
+export declare function getMobileDevice(deviceId: string): MobileDevice | null;
+export declare function listEnabledMobileDevices(): MobileDevice[];
+export declare function updateMobileDevicePreferences(deviceId: string, patch: Partial<MobileNotificationPreferences>): MobileDevice | null;
+export declare function removeMobileDevice(deviceId: string): boolean;
+export declare function disableMobileDeviceForPushToken(pushToken: string): void;
+export type CreateMobileActivityEventInput = Omit<MobileActivityEvent, 'id' | 'createdAt'> & {
+    id?: string;
+    createdAt?: number;
+};
+export declare function createMobileActivityEvent(input: CreateMobileActivityEventInput): MobileActivityEvent;
+export declare function listMobileActivityEvents(options?: {
+    cursor?: number;
+    limit?: number;
+}): {
+    items: MobileActivityEvent[];
+    nextCursor: number | null;
+};
+export declare function acknowledgeMobileActivityEvent(eventId: string, deviceId: string): boolean;

package/dist/src/mobile/notification-store.js

@@ -0,0 +1,134 @@
+import { getSqliteDatabase, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
+import { DEFAULT_MOBILE_NOTIFICATION_PREFERENCES } from "./notification-types.js";
+import { randomUUID } from "node:crypto";
+//#region src/mobile/notification-store.ts
+function parseJson(raw, fallback) {
+	try {
+		return JSON.parse(raw);
+	} catch {
+		return fallback;
+	}
+}
+function normalizePreferences(input) {
+	return {
+		needsInput: input?.needsInput ?? DEFAULT_MOBILE_NOTIFICATION_PREFERENCES.needsInput,
+		failed: input?.failed ?? DEFAULT_MOBILE_NOTIFICATION_PREFERENCES.failed,
+		completed: input?.completed ?? DEFAULT_MOBILE_NOTIFICATION_PREFERENCES.completed,
+		automationFailed: input?.automationFailed ?? DEFAULT_MOBILE_NOTIFICATION_PREFERENCES.automationFailed
+	};
+}
+function deviceFromRow(row) {
+	return {
+		id: row.device_id,
+		platform: row.platform === "android" ? "android" : "ios",
+		pushToken: row.push_token,
+		enabled: row.enabled !== 0,
+		permissions: row.permissions === "granted" || row.permissions === "denied" ? row.permissions : "unknown",
+		preferences: normalizePreferences(parseJson(row.preferences_json, {})),
+		appVersion: row.app_version ?? void 0,
+		lastSeenAt: row.last_seen_at,
+		createdAt: row.created_at,
+		updatedAt: row.updated_at
+	};
+}
+function activityFromRow(row) {
+	return {
+		id: row.event_id,
+		type: row.event_type,
+		entity: {
+			kind: row.entity_kind,
+			id: row.entity_id
+		},
+		priority: row.priority,
+		title: row.title,
+		body: row.body ?? void 0,
+		deepLink: row.deep_link,
+		payload: parseJson(row.payload_json, {}),
+		createdAt: row.created_at
+	};
+}
+function registerMobileDevice(input) {
+	const now = Date.now();
+	const preferences = input.preferences ? normalizePreferences(input.preferences) : getMobileDevice(input.id)?.preferences ?? normalizePreferences();
+	runSqliteWriteTransaction((db) => {
+		db.prepare(`DELETE FROM mobile_devices
+       WHERE push_provider = 'expo' AND push_token = ? AND device_id <> ?`).run(input.pushToken, input.id);
+		db.prepare(`INSERT INTO mobile_devices (
+        device_id, platform, push_token, permissions, preferences_json,
+        app_version, last_seen_at, created_at, updated_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+      ON CONFLICT(device_id) DO UPDATE SET
+        platform = excluded.platform,
+        push_token = excluded.push_token,
+        enabled = 1,
+        permissions = excluded.permissions,
+        preferences_json = excluded.preferences_json,
+        app_version = excluded.app_version,
+        last_seen_at = excluded.last_seen_at,
+        updated_at = excluded.updated_at`).run(input.id, input.platform, input.pushToken, input.permissions, JSON.stringify(preferences), input.appVersion?.trim() || null, now, now, now);
+	});
+	return getMobileDevice(input.id);
+}
+function getMobileDevice(deviceId) {
+	const row = getSqliteDatabase().prepare(`SELECT * FROM mobile_devices WHERE device_id = ?`).get(deviceId);
+	return row ? deviceFromRow(row) : null;
+}
+function listEnabledMobileDevices() {
+	return getSqliteDatabase().prepare(`SELECT * FROM mobile_devices WHERE enabled = 1 AND permissions = 'granted' ORDER BY updated_at DESC`).all().map(deviceFromRow);
+}
+function updateMobileDevicePreferences(deviceId, patch) {
+	const current = getMobileDevice(deviceId);
+	if (!current) return null;
+	const preferences = normalizePreferences({
+		...current.preferences,
+		...patch
+	});
+	runSqliteWriteTransaction((db) => {
+		db.prepare(`UPDATE mobile_devices SET preferences_json = ?, updated_at = ? WHERE device_id = ?`).run(JSON.stringify(preferences), Date.now(), deviceId);
+	});
+	return getMobileDevice(deviceId);
+}
+function removeMobileDevice(deviceId) {
+	return runSqliteWriteTransaction((db) => db.prepare(`DELETE FROM mobile_devices WHERE device_id = ?`).run(deviceId).changes > 0);
+}
+function disableMobileDeviceForPushToken(pushToken) {
+	runSqliteWriteTransaction((db) => {
+		db.prepare(`UPDATE mobile_devices SET enabled = 0, updated_at = ? WHERE push_token = ?`).run(Date.now(), pushToken);
+	});
+}
+function createMobileActivityEvent(input) {
+	const event = {
+		...input,
+		id: input.id ?? randomUUID(),
+		createdAt: input.createdAt ?? Date.now()
+	};
+	runSqliteWriteTransaction((db) => {
+		db.prepare(`INSERT INTO mobile_activity_events (
+        event_id, event_type, entity_kind, entity_id, priority, title, body,
+        deep_link, payload_json, created_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(event.id, event.type, event.entity.kind, event.entity.id, event.priority, event.title, event.body ?? null, event.deepLink, JSON.stringify(event.payload), event.createdAt);
+	});
+	return event;
+}
+function listMobileActivityEvents(options) {
+	const limit = Math.max(1, Math.min(100, options?.limit ?? 50));
+	const cursor = options?.cursor;
+	const items = (cursor == null ? getSqliteDatabase().prepare(`SELECT * FROM mobile_activity_events ORDER BY created_at DESC LIMIT ?`).all(limit) : getSqliteDatabase().prepare(`SELECT * FROM mobile_activity_events WHERE created_at < ? ORDER BY created_at DESC LIMIT ?`).all(cursor, limit)).map(activityFromRow);
+	return {
+		items,
+		nextCursor: items.length === limit ? items[items.length - 1].createdAt : null
+	};
+}
+function acknowledgeMobileActivityEvent(eventId, deviceId) {
+	if (!getMobileDevice(deviceId)) return false;
+	if (!getSqliteDatabase().prepare(`SELECT 1 FROM mobile_activity_events WHERE event_id = ?`).get(eventId)) return false;
+	runSqliteWriteTransaction((db) => {
+		db.prepare(`INSERT OR REPLACE INTO mobile_activity_acknowledgements (event_id, device_id, acknowledged_at)
+       VALUES (?, ?, ?)`).run(eventId, deviceId, Date.now());
+	});
+	return true;
+}
+//#endregion
+export { acknowledgeMobileActivityEvent, createMobileActivityEvent, disableMobileDeviceForPushToken, getMobileDevice, listEnabledMobileDevices, listMobileActivityEvents, registerMobileDevice, removeMobileDevice, updateMobileDevicePreferences };
+
+//# sourceMappingURL=notification-store.js.map

package/dist/src/mobile/notification-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-store.js","names":[],"sources":["../../../src/mobile/notification-store.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport { getSqliteDatabase, runSqliteWriteTransaction } from '../storage/sqlite/transaction.js';\n\nimport {\n  DEFAULT_MOBILE_NOTIFICATION_PREFERENCES,\n  type MobileActivityEvent,\n  type MobileDevice,\n  type MobileNotificationPermission,\n  type MobileNotificationPreferences,\n  type MobilePlatform,\n} from './notification-types.js';\n\ntype MobileDeviceRow = {\n  device_id: string;\n  platform: string;\n  push_token: string;\n  enabled: number;\n  permissions: string;\n  preferences_json: string;\n  app_version: string | null;\n  last_seen_at: number;\n  created_at: number;\n  updated_at: number;\n};\n\ntype MobileActivityEventRow = {\n  event_id: string;\n  event_type: MobileActivityEvent['type'];\n  entity_kind: MobileActivityEvent['entity']['kind'];\n  entity_id: string;\n  priority: MobileActivityEvent['priority'];\n  title: string;\n  body: string | null;\n  deep_link: string;\n  payload_json: string;\n  created_at: number;\n};\n\nfunction parseJson<T>(raw: string, fallback: T): T {\n  try {\n    return JSON.parse(raw) as T;\n  } catch {\n    return fallback;\n  }\n}\n\nfunction normalizePreferences(input?: Partial<MobileNotificationPreferences>): MobileNotificationPreferences {\n  return {\n    needsInput: input?.needsInput ?? DEFAULT_MOBILE_NOTIFICATION_PREFERENCES.needsInput,\n    failed: input?.failed ?? DEFAULT_MOBILE_NOTIFICATION_PREFERENCES.failed,\n    completed: input?.completed ?? DEFAULT_MOBILE_NOTIFICATION_PREFERENCES.completed,\n    automationFailed: input?.automationFailed ?? DEFAULT_MOBILE_NOTIFICATION_PREFERENCES.automationFailed,\n  };\n}\n\nfunction deviceFromRow(row: MobileDeviceRow): MobileDevice {\n  return {\n    id: row.device_id,\n    platform: row.platform === 'android' ? 'android' : 'ios',\n    pushToken: row.push_token,\n    enabled: row.enabled !== 0,\n    permissions: row.permissions === 'granted' || row.permissions === 'denied' ? row.permissions : 'unknown',\n    preferences: normalizePreferences(parseJson<Partial<MobileNotificationPreferences>>(row.preferences_json, {})),\n    appVersion: row.app_version ?? undefined,\n    lastSeenAt: row.last_seen_at,\n    createdAt: row.created_at,\n    updatedAt: row.updated_at,\n  };\n}\n\nfunction activityFromRow(row: MobileActivityEventRow): MobileActivityEvent {\n  return {\n    id: row.event_id,\n    type: row.event_type,\n    entity: { kind: row.entity_kind, id: row.entity_id },\n    priority: row.priority,\n    title: row.title,\n    body: row.body ?? undefined,\n    deepLink: row.deep_link,\n    payload: parseJson<Record<string, unknown>>(row.payload_json, {}),\n    createdAt: row.created_at,\n  };\n}\n\nexport type RegisterMobileDeviceInput = {\n  id: string;\n  platform: MobilePlatform;\n  pushToken: string;\n  permissions: MobileNotificationPermission;\n  preferences?: Partial<MobileNotificationPreferences>;\n  appVersion?: string;\n};\n\nexport function registerMobileDevice(input: RegisterMobileDeviceInput): MobileDevice {\n  const now = Date.now();\n  const preferences = input.preferences\n    ? normalizePreferences(input.preferences)\n    : getMobileDevice(input.id)?.preferences ?? normalizePreferences();\n  runSqliteWriteTransaction((db) => {\n    // An Expo token can rotate or be restored onto a new installation id. Keep one\n    // active device record per token so the unique index cannot reject a re-register.\n    db.prepare(\n      `DELETE FROM mobile_devices\n       WHERE push_provider = 'expo' AND push_token = ? AND device_id <> ?`,\n    ).run(input.pushToken, input.id);\n    db.prepare(\n      `INSERT INTO mobile_devices (\n        device_id, platform, push_token, permissions, preferences_json,\n        app_version, last_seen_at, created_at, updated_at\n      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)\n      ON CONFLICT(device_id) DO UPDATE SET\n        platform = excluded.platform,\n        push_token = excluded.push_token,\n        enabled = 1,\n        permissions = excluded.permissions,\n        preferences_json = excluded.preferences_json,\n        app_version = excluded.app_version,\n        last_seen_at = excluded.last_seen_at,\n        updated_at = excluded.updated_at`,\n    ).run(\n      input.id,\n      input.platform,\n      input.pushToken,\n      input.permissions,\n      JSON.stringify(preferences),\n      input.appVersion?.trim() || null,\n      now,\n      now,\n      now,\n    );\n  });\n  return getMobileDevice(input.id)!;\n}\n\nexport function getMobileDevice(deviceId: string): MobileDevice | null {\n  const row = getSqliteDatabase()\n    .prepare(`SELECT * FROM mobile_devices WHERE device_id = ?`)\n    .get(deviceId) as MobileDeviceRow | undefined;\n  return row ? deviceFromRow(row) : null;\n}\n\nexport function listEnabledMobileDevices(): MobileDevice[] {\n  return (getSqliteDatabase()\n    .prepare(`SELECT * FROM mobile_devices WHERE enabled = 1 AND permissions = 'granted' ORDER BY updated_at DESC`)\n    .all() as MobileDeviceRow[]).map(deviceFromRow);\n}\n\nexport function updateMobileDevicePreferences(\n  deviceId: string,\n  patch: Partial<MobileNotificationPreferences>,\n): MobileDevice | null {\n  const current = getMobileDevice(deviceId);\n  if (!current) return null;\n  const preferences = normalizePreferences({ ...current.preferences, ...patch });\n  runSqliteWriteTransaction((db) => {\n    db.prepare(`UPDATE mobile_devices SET preferences_json = ?, updated_at = ? WHERE device_id = ?`)\n      .run(JSON.stringify(preferences), Date.now(), deviceId);\n  });\n  return getMobileDevice(deviceId);\n}\n\nexport function removeMobileDevice(deviceId: string): boolean {\n  return runSqliteWriteTransaction((db) =>\n    db.prepare(`DELETE FROM mobile_devices WHERE device_id = ?`).run(deviceId).changes > 0,\n  );\n}\n\nexport function disableMobileDeviceForPushToken(pushToken: string): void {\n  runSqliteWriteTransaction((db) => {\n    db.prepare(`UPDATE mobile_devices SET enabled = 0, updated_at = ? WHERE push_token = ?`)\n      .run(Date.now(), pushToken);\n  });\n}\n\nexport type CreateMobileActivityEventInput = Omit<MobileActivityEvent, 'id' | 'createdAt'> & {\n  id?: string;\n  createdAt?: number;\n};\n\nexport function createMobileActivityEvent(input: CreateMobileActivityEventInput): MobileActivityEvent {\n  const event: MobileActivityEvent = {\n    ...input,\n    id: input.id ?? randomUUID(),\n    createdAt: input.createdAt ?? Date.now(),\n  };\n  runSqliteWriteTransaction((db) => {\n    db.prepare(\n      `INSERT INTO mobile_activity_events (\n        event_id, event_type, entity_kind, entity_id, priority, title, body,\n        deep_link, payload_json, created_at\n      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,\n    ).run(\n      event.id,\n      event.type,\n      event.entity.kind,\n      event.entity.id,\n      event.priority,\n      event.title,\n      event.body ?? null,\n      event.deepLink,\n      JSON.stringify(event.payload),\n      event.createdAt,\n    );\n  });\n  return event;\n}\n\nexport function listMobileActivityEvents(options?: { cursor?: number; limit?: number }): {\n  items: MobileActivityEvent[];\n  nextCursor: number | null;\n} {\n  const limit = Math.max(1, Math.min(100, options?.limit ?? 50));\n  const cursor = options?.cursor;\n  const rows = (cursor == null\n    ? getSqliteDatabase().prepare(`SELECT * FROM mobile_activity_events ORDER BY created_at DESC LIMIT ?`).all(limit)\n    : getSqliteDatabase().prepare(`SELECT * FROM mobile_activity_events WHERE created_at < ? ORDER BY created_at DESC LIMIT ?`).all(cursor, limit)\n  ) as MobileActivityEventRow[];\n  const items = rows.map(activityFromRow);\n  return { items, nextCursor: items.length === limit ? items[items.length - 1]!.createdAt : null };\n}\n\nexport function acknowledgeMobileActivityEvent(eventId: string, deviceId: string): boolean {\n  if (!getMobileDevice(deviceId)) return false;\n  const exists = getSqliteDatabase()\n    .prepare(`SELECT 1 FROM mobile_activity_events WHERE event_id = ?`)\n    .get(eventId);\n  if (!exists) return false;\n  runSqliteWriteTransaction((db) => {\n    db.prepare(\n      `INSERT OR REPLACE INTO mobile_activity_acknowledgements (event_id, device_id, acknowledged_at)\n       VALUES (?, ?, ?)`,\n    ).run(eventId, deviceId, Date.now());\n  });\n  return true;\n}\n"],"mappings":"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"}

package/dist/src/mobile/notification-types.d.ts

@@ -0,0 +1,37 @@
+export type MobilePlatform = 'ios' | 'android';
+export type MobileNotificationPermission = 'granted' | 'denied' | 'unknown';
+export type MobileNotificationPriority = 'normal' | 'high';
+export type MobileNotificationEventType = 'goal.needs_input' | 'goal.blocked' | 'goal.completed' | 'automation.failed' | 'automation.completed';
+export type MobileNotificationPreferences = {
+    needsInput: boolean;
+    failed: boolean;
+    completed: boolean;
+    automationFailed: boolean;
+};
+export type MobileDevice = {
+    id: string;
+    platform: MobilePlatform;
+    pushToken: string;
+    enabled: boolean;
+    permissions: MobileNotificationPermission;
+    preferences: MobileNotificationPreferences;
+    appVersion?: string;
+    lastSeenAt: number;
+    createdAt: number;
+    updatedAt: number;
+};
+export type MobileActivityEvent = {
+    id: string;
+    type: MobileNotificationEventType;
+    entity: {
+        kind: 'goal' | 'automation';
+        id: string;
+    };
+    priority: MobileNotificationPriority;
+    title: string;
+    body?: string;
+    deepLink: string;
+    payload: Record<string, unknown>;
+    createdAt: number;
+};
+export declare const DEFAULT_MOBILE_NOTIFICATION_PREFERENCES: MobileNotificationPreferences;

package/dist/src/mobile/notification-types.js

@@ -0,0 +1,11 @@
+//#region src/mobile/notification-types.ts
+const DEFAULT_MOBILE_NOTIFICATION_PREFERENCES = {
+	needsInput: true,
+	failed: true,
+	completed: false,
+	automationFailed: true
+};
+//#endregion
+export { DEFAULT_MOBILE_NOTIFICATION_PREFERENCES };
+
+//# sourceMappingURL=notification-types.js.map

package/dist/src/mobile/notification-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-types.js","names":[],"sources":["../../../src/mobile/notification-types.ts"],"sourcesContent":["export type MobilePlatform = 'ios' | 'android';\nexport type MobileNotificationPermission = 'granted' | 'denied' | 'unknown';\nexport type MobileNotificationPriority = 'normal' | 'high';\nexport type MobileNotificationEventType =\n  | 'goal.needs_input'\n  | 'goal.blocked'\n  | 'goal.completed'\n  | 'automation.failed'\n  | 'automation.completed';\n\nexport type MobileNotificationPreferences = {\n  needsInput: boolean;\n  failed: boolean;\n  completed: boolean;\n  automationFailed: boolean;\n};\n\nexport type MobileDevice = {\n  id: string;\n  platform: MobilePlatform;\n  pushToken: string;\n  enabled: boolean;\n  permissions: MobileNotificationPermission;\n  preferences: MobileNotificationPreferences;\n  appVersion?: string;\n  lastSeenAt: number;\n  createdAt: number;\n  updatedAt: number;\n};\n\nexport type MobileActivityEvent = {\n  id: string;\n  type: MobileNotificationEventType;\n  entity: { kind: 'goal' | 'automation'; id: string };\n  priority: MobileNotificationPriority;\n  title: string;\n  body?: string;\n  deepLink: string;\n  payload: Record<string, unknown>;\n  createdAt: number;\n};\n\nexport const DEFAULT_MOBILE_NOTIFICATION_PREFERENCES: MobileNotificationPreferences = {\n  needsInput: true,\n  failed: true,\n  completed: false,\n  automationFailed: true,\n};\n"],"mappings":";AA0CA,MAAa,0CAAyE;CACpF,YAAY;CACZ,QAAQ;CACR,WAAW;CACX,kBAAkB;CACnB"}

package/dist/src/storage/sqlite/migrations/026_goal_contracts.sql

@@ -0,0 +1,10 @@
+CREATE TABLE IF NOT EXISTS goal_contracts (
+  goal_id              TEXT PRIMARY KEY,
+  version              INTEGER NOT NULL DEFAULT 1,
+  objective            TEXT NOT NULL,
+  scope_boundary       TEXT,
+  evidence_plan_json   TEXT NOT NULL DEFAULT '[]',
+  created_at           INTEGER NOT NULL,
+  updated_at           INTEGER NOT NULL,
+  FOREIGN KEY (goal_id) REFERENCES goals(goal_id) ON DELETE CASCADE
+);

package/dist/src/storage/sqlite/migrations/027_mobile_notifications.sql

@@ -0,0 +1,43 @@
+CREATE TABLE IF NOT EXISTS mobile_devices (
+  device_id             TEXT PRIMARY KEY,
+  platform              TEXT NOT NULL,
+  push_token            TEXT NOT NULL,
+  push_provider         TEXT NOT NULL DEFAULT 'expo',
+  enabled               INTEGER NOT NULL DEFAULT 1,
+  permissions           TEXT NOT NULL DEFAULT 'unknown',
+  preferences_json      TEXT NOT NULL DEFAULT '{}',
+  app_version           TEXT,
+  last_seen_at          INTEGER NOT NULL,
+  created_at            INTEGER NOT NULL,
+  updated_at            INTEGER NOT NULL
+);
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_mobile_devices_push_token
+  ON mobile_devices(push_provider, push_token);
+CREATE INDEX IF NOT EXISTS idx_mobile_devices_enabled
+  ON mobile_devices(enabled, updated_at DESC);
+
+CREATE TABLE IF NOT EXISTS mobile_activity_events (
+  event_id              TEXT PRIMARY KEY,
+  event_type            TEXT NOT NULL,
+  entity_kind           TEXT NOT NULL,
+  entity_id             TEXT NOT NULL,
+  priority              TEXT NOT NULL,
+  title                 TEXT NOT NULL,
+  body                  TEXT,
+  deep_link             TEXT NOT NULL,
+  payload_json          TEXT NOT NULL DEFAULT '{}',
+  created_at            INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_mobile_activity_events_created
+  ON mobile_activity_events(created_at DESC);
+
+CREATE TABLE IF NOT EXISTS mobile_activity_acknowledgements (
+  event_id              TEXT NOT NULL,
+  device_id             TEXT NOT NULL,
+  acknowledged_at       INTEGER NOT NULL,
+  PRIMARY KEY (event_id, device_id),
+  FOREIGN KEY (event_id) REFERENCES mobile_activity_events(event_id) ON DELETE CASCADE,
+  FOREIGN KEY (device_id) REFERENCES mobile_devices(device_id) ON DELETE CASCADE
+);

package/dist/src/storage/sqlite/migrations/028_goal_evidence_requirements.sql

@@ -0,0 +1,47 @@
+CREATE TABLE IF NOT EXISTS goal_evidence_requirements (
+  requirement_id              TEXT PRIMARY KEY,
+  goal_id                     TEXT NOT NULL,
+  text                        TEXT NOT NULL,
+  status                      TEXT NOT NULL DEFAULT 'pending',
+  review_reason               TEXT,
+  review_confidence           REAL,
+  reviewed_by                 TEXT,
+  reviewed_at                 INTEGER,
+  requires_human_approval     INTEGER NOT NULL DEFAULT 1,
+  created_at                  INTEGER NOT NULL,
+  updated_at                  INTEGER NOT NULL,
+  sort_order                  INTEGER NOT NULL,
+  UNIQUE(goal_id, text),
+  FOREIGN KEY (goal_id) REFERENCES goals(goal_id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_goal_evidence_requirements_goal_order
+  ON goal_evidence_requirements(goal_id, sort_order ASC);
+
+CREATE TABLE IF NOT EXISTS goal_evidence_requirement_links (
+  requirement_id TEXT NOT NULL,
+  evidence_id    TEXT NOT NULL,
+  linked_by      TEXT NOT NULL,
+  created_at     INTEGER NOT NULL,
+  PRIMARY KEY (requirement_id, evidence_id),
+  FOREIGN KEY (requirement_id) REFERENCES goal_evidence_requirements(requirement_id) ON DELETE CASCADE,
+  FOREIGN KEY (evidence_id) REFERENCES goal_evidence(evidence_id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_goal_evidence_requirement_links_evidence
+  ON goal_evidence_requirement_links(evidence_id);
+
+INSERT OR IGNORE INTO goal_evidence_requirements (
+  requirement_id, goal_id, text, status, requires_human_approval, created_at, updated_at, sort_order
+)
+SELECT
+  lower(hex(randomblob(16))),
+  goal_contracts.goal_id,
+  json_each.value,
+  'pending',
+  1,
+  goal_contracts.created_at,
+  goal_contracts.updated_at,
+  CAST(json_each.key AS INTEGER) + 1
+FROM goal_contracts, json_each(goal_contracts.evidence_plan_json)
+WHERE json_valid(goal_contracts.evidence_plan_json) AND json_each.type = 'text';

package/dist/src/storage/sqlite/migrations/runner.d.ts

@@ -3,7 +3,7 @@ import type { ApplyMigrationsOptions } from './types.js';
 /** Baseline schema version applied from schema.sql on first open. */
 export declare const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;
 /** Latest schema version this release supports (increment when adding migrations). */
-export declare const XOPC_DB_SCHEMA_VERSION = 25;
+export declare const XOPC_DB_SCHEMA_VERSION = 28;
 export declare function resolveMigrationsDir(override?: string): string;
 /**
  * Apply sequential SQL migrations from (currentVersion + 1) through targetVersion.

package/dist/src/storage/sqlite/migrations/runner.js

@@ -12,7 +12,7 @@ const log = createLogger("Sqlite:Migrations");
 /** Baseline schema version applied from schema.sql on first open. */
 const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;
 /** Latest schema version this release supports (increment when adding migrations). */
-const XOPC_DB_SCHEMA_VERSION = 25;
+const XOPC_DB_SCHEMA_VERSION = 28;
 const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
 function resolveMigrationsDir(override) {
 	if (override) return override;
@@ -46,7 +46,7 @@ function applySingleMigration(db, migration) {
 * Each step runs in its own transaction and updates schema_meta on success.
 */
 function applyPendingMigrations(db, options = {}) {
-	const targetVersion = options.targetVersion ?? 25;
+	const targetVersion = options.targetVersion ?? 28;
 	let currentVersion = readSchemaVersion(db);
 	if (currentVersion > targetVersion) throw new DatabaseSchemaTooNewError(currentVersion, targetVersion);
 	if (currentVersion >= targetVersion) return currentVersion;
@@ -62,7 +62,7 @@ function applyPendingMigrations(db, options = {}) {
 }
 /** Inspect schema version without mutating the database. */
 function inspectSchemaMigrationStatus(db, options = {}) {
-	const appVersion = options.targetVersion ?? 25;
+	const appVersion = options.targetVersion ?? 28;
 	const dbVersion = readSchemaVersion(db);
 	if (dbVersion > appVersion) return {
 		dbVersion,

package/dist/src/storage/sqlite/migrations/runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"runner.js","names":[],"sources":["../../../../../src/storage/sqlite/migrations/runner.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport type { DatabaseSync } from 'node:sqlite';\n\nimport { createLogger } from '../../../utils/logger.js';\nimport { readSchemaVersion, setSchemaVersion } from '../schema-version.js';\nimport { discoverSqlMigrations } from './discover.js';\nimport {\n  DatabaseSchemaMigrationGapError,\n  DatabaseSchemaTooNewError,\n} from './errors.js';\nimport type { ApplyMigrationsOptions, SqlMigration } from './types.js';\n\nconst log = createLogger('Sqlite:Migrations');\n\n/** Baseline schema version applied from schema.sql on first open. */\nexport const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;\n\n/** Latest schema version this release supports (increment when adding migrations). */\nexport const XOPC_DB_SCHEMA_VERSION = 25;\n\nconst MODULE_DIR = dirname(fileURLToPath(import.meta.url));\n\nexport function resolveMigrationsDir(override?: string): string {\n  if (override) {\n    return override;\n  }\n  // Packaged Electron gateway bundle: `out/server/index.js` + `out/server/migrations/`.\n  const siblingDir = join(MODULE_DIR, 'migrations');\n  if (existsSync(siblingDir)) {\n    return siblingDir;\n  }\n  // Dev / dist: SQL files live next to `migrations/runner.js`.\n  return MODULE_DIR;\n}\n\nfunction migrationByTarget(\n  migrations: SqlMigration[],\n  targetVersion: number,\n): SqlMigration | undefined {\n  return migrations.find((migration) => migration.targetVersion === targetVersion);\n}\n\nfunction applySingleMigration(db: DatabaseSync, migration: SqlMigration): void {\n  log.info({ targetVersion: migration.targetVersion, file: migration.filename }, 'Applying SQLite migration');\n  db.exec('BEGIN IMMEDIATE');\n  try {\n    db.exec(migration.sql);\n    setSchemaVersion(db, migration.targetVersion);\n    db.exec('COMMIT');\n  } catch (error) {\n    try {\n      db.exec('ROLLBACK');\n    } catch {\n      /* preserve original error */\n    }\n    const em = error instanceof Error ? error.message : String(error);\n    throw new Error(\n      `SQLite migration to v${migration.targetVersion} (${migration.filename}) failed: ${em}`,\n      { cause: error },\n    );\n  }\n}\n\n/**\n * Apply sequential SQL migrations from (currentVersion + 1) through targetVersion.\n * Each step runs in its own transaction and updates schema_meta on success.\n */\nexport function applyPendingMigrations(\n  db: DatabaseSync,\n  options: ApplyMigrationsOptions = {},\n): number {\n  const targetVersion = options.targetVersion ?? XOPC_DB_SCHEMA_VERSION;\n  let currentVersion = readSchemaVersion(db);\n\n  if (currentVersion > targetVersion) {\n    throw new DatabaseSchemaTooNewError(currentVersion, targetVersion);\n  }\n\n  if (currentVersion >= targetVersion) {\n    return currentVersion;\n  }\n\n  const migrations = discoverSqlMigrations(resolveMigrationsDir(options.migrationsDir));\n\n  while (currentVersion < targetVersion) {\n    const nextVersion = currentVersion + 1;\n    const migration = migrationByTarget(migrations, nextVersion);\n    if (!migration) {\n      throw new DatabaseSchemaMigrationGapError(currentVersion, targetVersion, nextVersion);\n    }\n    applySingleMigration(db, migration);\n    currentVersion = nextVersion;\n  }\n\n  return currentVersion;\n}\n\nexport type SchemaMigrationStatus = {\n  dbVersion: number;\n  appVersion: number;\n  pendingVersions: number[];\n  isTooNew: boolean;\n  hasMigrationGap: boolean;\n  missingVersion: number | null;\n};\n\n/** Inspect schema version without mutating the database. */\nexport function inspectSchemaMigrationStatus(\n  db: DatabaseSync,\n  options: Pick<ApplyMigrationsOptions, 'migrationsDir' | 'targetVersion'> = {},\n): SchemaMigrationStatus {\n  const appVersion = options.targetVersion ?? XOPC_DB_SCHEMA_VERSION;\n  const dbVersion = readSchemaVersion(db);\n  const isTooNew = dbVersion > appVersion;\n\n  if (isTooNew) {\n    return {\n      dbVersion,\n      appVersion,\n      pendingVersions: [],\n      isTooNew: true,\n      hasMigrationGap: false,\n      missingVersion: null,\n    };\n  }\n\n  const migrations = discoverSqlMigrations(resolveMigrationsDir(options.migrationsDir));\n  const pendingVersions: number[] = [];\n  let hasMigrationGap = false;\n  let missingVersion: number | null = null;\n\n  for (let version = dbVersion + 1; version <= appVersion; version++) {\n    if (migrationByTarget(migrations, version)) {\n      pendingVersions.push(version);\n    } else {\n      hasMigrationGap = true;\n      missingVersion = version;\n      break;\n    }\n  }\n\n  return {\n    dbVersion,\n    appVersion,\n    pendingVersions,\n    isTooNew: false,\n    hasMigrationGap,\n    missingVersion,\n  };\n}\n"],"mappings":";;;;;;;;;aAMwD;AASxD,MAAM,MAAM,aAAa,oBAAoB;;AAG7C,MAAa,kCAAkC;;AAG/C,MAAa,yBAAyB;AAEtC,MAAM,aAAa,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC;AAE1D,SAAgB,qBAAqB,UAA2B;AAC9D,KAAI,SACF,QAAO;CAGT,MAAM,aAAa,KAAK,YAAY,aAAa;AACjD,KAAI,WAAW,WAAW,CACxB,QAAO;AAGT,QAAO;;AAGT,SAAS,kBACP,YACA,eAC0B;AAC1B,QAAO,WAAW,MAAM,cAAc,UAAU,kBAAkB,cAAc;;AAGlF,SAAS,qBAAqB,IAAkB,WAA+B;AAC7E,KAAI,KAAK;EAAE,eAAe,UAAU;EAAe,MAAM,UAAU;EAAU,EAAE,4BAA4B;AAC3G,IAAG,KAAK,kBAAkB;AAC1B,KAAI;AACF,KAAG,KAAK,UAAU,IAAI;AACtB,mBAAiB,IAAI,UAAU,cAAc;AAC7C,KAAG,KAAK,SAAS;UACV,OAAO;AACd,MAAI;AACF,MAAG,KAAK,WAAW;UACb;EAGR,MAAM,KAAK,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AACjE,QAAM,IAAI,MACR,wBAAwB,UAAU,cAAc,IAAI,UAAU,SAAS,YAAY,MACnF,EAAE,OAAO,OAAO,CACjB;;;;;;;AAQL,SAAgB,uBACd,IACA,UAAkC,EAAE,EAC5B;CACR,MAAM,gBAAgB,QAAQ,iBAAA;CAC9B,IAAI,iBAAiB,kBAAkB,GAAG;AAE1C,KAAI,iBAAiB,cACnB,OAAM,IAAI,0BAA0B,gBAAgB,cAAc;AAGpE,KAAI,kBAAkB,cACpB,QAAO;CAGT,MAAM,aAAa,sBAAsB,qBAAqB,QAAQ,cAAc,CAAC;AAErF,QAAO,iBAAiB,eAAe;EACrC,MAAM,cAAc,iBAAiB;EACrC,MAAM,YAAY,kBAAkB,YAAY,YAAY;AAC5D,MAAI,CAAC,UACH,OAAM,IAAI,gCAAgC,gBAAgB,eAAe,YAAY;AAEvF,uBAAqB,IAAI,UAAU;AACnC,mBAAiB;;AAGnB,QAAO;;;AAaT,SAAgB,6BACd,IACA,UAA2E,EAAE,EACtD;CACvB,MAAM,aAAa,QAAQ,iBAAA;CAC3B,MAAM,YAAY,kBAAkB,GAAG;AAGvC,KAFiB,YAAY,WAG3B,QAAO;EACL;EACA;EACA,iBAAiB,EAAE;EACnB,UAAU;EACV,iBAAiB;EACjB,gBAAgB;EACjB;CAGH,MAAM,aAAa,sBAAsB,qBAAqB,QAAQ,cAAc,CAAC;CACrF,MAAM,kBAA4B,EAAE;CACpC,IAAI,kBAAkB;CACtB,IAAI,iBAAgC;AAEpC,MAAK,IAAI,UAAU,YAAY,GAAG,WAAW,YAAY,UACvD,KAAI,kBAAkB,YAAY,QAAQ,CACxC,iBAAgB,KAAK,QAAQ;MACxB;AACL,oBAAkB;AAClB,mBAAiB;AACjB;;AAIJ,QAAO;EACL;EACA;EACA;EACA,UAAU;EACV;EACA;EACD"}
+{"version":3,"file":"runner.js","names":[],"sources":["../../../../../src/storage/sqlite/migrations/runner.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport type { DatabaseSync } from 'node:sqlite';\n\nimport { createLogger } from '../../../utils/logger.js';\nimport { readSchemaVersion, setSchemaVersion } from '../schema-version.js';\nimport { discoverSqlMigrations } from './discover.js';\nimport {\n  DatabaseSchemaMigrationGapError,\n  DatabaseSchemaTooNewError,\n} from './errors.js';\nimport type { ApplyMigrationsOptions, SqlMigration } from './types.js';\n\nconst log = createLogger('Sqlite:Migrations');\n\n/** Baseline schema version applied from schema.sql on first open. */\nexport const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;\n\n/** Latest schema version this release supports (increment when adding migrations). */\nexport const XOPC_DB_SCHEMA_VERSION = 28;\n\nconst MODULE_DIR = dirname(fileURLToPath(import.meta.url));\n\nexport function resolveMigrationsDir(override?: string): string {\n  if (override) {\n    return override;\n  }\n  // Packaged Electron gateway bundle: `out/server/index.js` + `out/server/migrations/`.\n  const siblingDir = join(MODULE_DIR, 'migrations');\n  if (existsSync(siblingDir)) {\n    return siblingDir;\n  }\n  // Dev / dist: SQL files live next to `migrations/runner.js`.\n  return MODULE_DIR;\n}\n\nfunction migrationByTarget(\n  migrations: SqlMigration[],\n  targetVersion: number,\n): SqlMigration | undefined {\n  return migrations.find((migration) => migration.targetVersion === targetVersion);\n}\n\nfunction applySingleMigration(db: DatabaseSync, migration: SqlMigration): void {\n  log.info({ targetVersion: migration.targetVersion, file: migration.filename }, 'Applying SQLite migration');\n  db.exec('BEGIN IMMEDIATE');\n  try {\n    db.exec(migration.sql);\n    setSchemaVersion(db, migration.targetVersion);\n    db.exec('COMMIT');\n  } catch (error) {\n    try {\n      db.exec('ROLLBACK');\n    } catch {\n      /* preserve original error */\n    }\n    const em = error instanceof Error ? error.message : String(error);\n    throw new Error(\n      `SQLite migration to v${migration.targetVersion} (${migration.filename}) failed: ${em}`,\n      { cause: error },\n    );\n  }\n}\n\n/**\n * Apply sequential SQL migrations from (currentVersion + 1) through targetVersion.\n * Each step runs in its own transaction and updates schema_meta on success.\n */\nexport function applyPendingMigrations(\n  db: DatabaseSync,\n  options: ApplyMigrationsOptions = {},\n): number {\n  const targetVersion = options.targetVersion ?? XOPC_DB_SCHEMA_VERSION;\n  let currentVersion = readSchemaVersion(db);\n\n  if (currentVersion > targetVersion) {\n    throw new DatabaseSchemaTooNewError(currentVersion, targetVersion);\n  }\n\n  if (currentVersion >= targetVersion) {\n    return currentVersion;\n  }\n\n  const migrations = discoverSqlMigrations(resolveMigrationsDir(options.migrationsDir));\n\n  while (currentVersion < targetVersion) {\n    const nextVersion = currentVersion + 1;\n    const migration = migrationByTarget(migrations, nextVersion);\n    if (!migration) {\n      throw new DatabaseSchemaMigrationGapError(currentVersion, targetVersion, nextVersion);\n    }\n    applySingleMigration(db, migration);\n    currentVersion = nextVersion;\n  }\n\n  return currentVersion;\n}\n\nexport type SchemaMigrationStatus = {\n  dbVersion: number;\n  appVersion: number;\n  pendingVersions: number[];\n  isTooNew: boolean;\n  hasMigrationGap: boolean;\n  missingVersion: number | null;\n};\n\n/** Inspect schema version without mutating the database. */\nexport function inspectSchemaMigrationStatus(\n  db: DatabaseSync,\n  options: Pick<ApplyMigrationsOptions, 'migrationsDir' | 'targetVersion'> = {},\n): SchemaMigrationStatus {\n  const appVersion = options.targetVersion ?? XOPC_DB_SCHEMA_VERSION;\n  const dbVersion = readSchemaVersion(db);\n  const isTooNew = dbVersion > appVersion;\n\n  if (isTooNew) {\n    return {\n      dbVersion,\n      appVersion,\n      pendingVersions: [],\n      isTooNew: true,\n      hasMigrationGap: false,\n      missingVersion: null,\n    };\n  }\n\n  const migrations = discoverSqlMigrations(resolveMigrationsDir(options.migrationsDir));\n  const pendingVersions: number[] = [];\n  let hasMigrationGap = false;\n  let missingVersion: number | null = null;\n\n  for (let version = dbVersion + 1; version <= appVersion; version++) {\n    if (migrationByTarget(migrations, version)) {\n      pendingVersions.push(version);\n    } else {\n      hasMigrationGap = true;\n      missingVersion = version;\n      break;\n    }\n  }\n\n  return {\n    dbVersion,\n    appVersion,\n    pendingVersions,\n    isTooNew: false,\n    hasMigrationGap,\n    missingVersion,\n  };\n}\n"],"mappings":";;;;;;;;;aAMwD;AASxD,MAAM,MAAM,aAAa,oBAAoB;;AAG7C,MAAa,kCAAkC;;AAG/C,MAAa,yBAAyB;AAEtC,MAAM,aAAa,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC;AAE1D,SAAgB,qBAAqB,UAA2B;AAC9D,KAAI,SACF,QAAO;CAGT,MAAM,aAAa,KAAK,YAAY,aAAa;AACjD,KAAI,WAAW,WAAW,CACxB,QAAO;AAGT,QAAO;;AAGT,SAAS,kBACP,YACA,eAC0B;AAC1B,QAAO,WAAW,MAAM,cAAc,UAAU,kBAAkB,cAAc;;AAGlF,SAAS,qBAAqB,IAAkB,WAA+B;AAC7E,KAAI,KAAK;EAAE,eAAe,UAAU;EAAe,MAAM,UAAU;EAAU,EAAE,4BAA4B;AAC3G,IAAG,KAAK,kBAAkB;AAC1B,KAAI;AACF,KAAG,KAAK,UAAU,IAAI;AACtB,mBAAiB,IAAI,UAAU,cAAc;AAC7C,KAAG,KAAK,SAAS;UACV,OAAO;AACd,MAAI;AACF,MAAG,KAAK,WAAW;UACb;EAGR,MAAM,KAAK,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AACjE,QAAM,IAAI,MACR,wBAAwB,UAAU,cAAc,IAAI,UAAU,SAAS,YAAY,MACnF,EAAE,OAAO,OAAO,CACjB;;;;;;;AAQL,SAAgB,uBACd,IACA,UAAkC,EAAE,EAC5B;CACR,MAAM,gBAAgB,QAAQ,iBAAA;CAC9B,IAAI,iBAAiB,kBAAkB,GAAG;AAE1C,KAAI,iBAAiB,cACnB,OAAM,IAAI,0BAA0B,gBAAgB,cAAc;AAGpE,KAAI,kBAAkB,cACpB,QAAO;CAGT,MAAM,aAAa,sBAAsB,qBAAqB,QAAQ,cAAc,CAAC;AAErF,QAAO,iBAAiB,eAAe;EACrC,MAAM,cAAc,iBAAiB;EACrC,MAAM,YAAY,kBAAkB,YAAY,YAAY;AAC5D,MAAI,CAAC,UACH,OAAM,IAAI,gCAAgC,gBAAgB,eAAe,YAAY;AAEvF,uBAAqB,IAAI,UAAU;AACnC,mBAAiB;;AAGnB,QAAO;;;AAaT,SAAgB,6BACd,IACA,UAA2E,EAAE,EACtD;CACvB,MAAM,aAAa,QAAQ,iBAAA;CAC3B,MAAM,YAAY,kBAAkB,GAAG;AAGvC,KAFiB,YAAY,WAG3B,QAAO;EACL;EACA;EACA,iBAAiB,EAAE;EACnB,UAAU;EACV,iBAAiB;EACjB,gBAAgB;EACjB;CAGH,MAAM,aAAa,sBAAsB,qBAAqB,QAAQ,cAAc,CAAC;CACrF,MAAM,kBAA4B,EAAE;CACpC,IAAI,kBAAkB;CACtB,IAAI,iBAAgC;AAEpC,MAAK,IAAI,UAAU,YAAY,GAAG,WAAW,YAAY,UACvD,KAAI,kBAAkB,YAAY,QAAQ,CACxC,iBAAgB,KAAK,QAAQ;MACxB;AACL,oBAAkB;AAClB,mBAAiB;AACjB;;AAIJ,QAAO;EACL;EACA;EACA;EACA,UAAU;EACV;EACA;EACD"}

package/dist/src/storage/sqlite/migrations/runner.ts

@@ -19,7 +19,7 @@ const log = createLogger('Sqlite:Migrations');
 export const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;
 
 /** Latest schema version this release supports (increment when adding migrations). */
-export const XOPC_DB_SCHEMA_VERSION = 25;
+export const XOPC_DB_SCHEMA_VERSION = 28;
 
 const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
 

package/dist/src/storage/sqlite/schema.js

@@ -31,7 +31,7 @@ function ensureXopcDatabaseSchema(db) {
 		bootstrapFreshDatabase(db);
 		currentVersion = 11;
 	}
-	applyPendingMigrations(db, { targetVersion: 25 });
+	applyPendingMigrations(db, { targetVersion: 28 });
 }
 //#endregion
 export { SCHEMA_META_SCHEMA_VERSION_KEY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_SCHEMA_VERSION, ensureSchemaMetaTable, ensureXopcDatabaseSchema, readSchemaVersion, readSchemaVersionForTest, setSchemaVersion };