@mattheworiordan/remi 0.1.0

package/dist/core/membership.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Section membership orchestration.
+ *
+ * All database operations are routed through the compiled section-helper binary
+ * (which has its own Info.plist for macOS permissions). The binary handles the
+ * atomic transaction internally: write data + checksum + token map in one go.
+ *
+ * Flow:
+ * 1. Read current memberships via binary
+ * 2. Modify in TypeScript (add/remove entries)
+ * 3. Send updated JSON to binary for atomic write + sync trigger
+ */
+import type { MembershipData } from "../types.js";
+/**
+ * Assign a reminder to a section within its list, with iCloud sync.
+ * Idempotent: assigning to a section it's already in returns success.
+ */
+export declare function assignToSection(listName: string, reminderTitle: string, sectionName: string): Promise<{
+    warning?: string;
+}>;
+/**
+ * Remove a reminder from its current section.
+ */
+export declare function removeFromSection(listName: string, reminderTitle: string): Promise<{
+    warning?: string;
+}>;
+/**
+ * Get all membership entries for a list.
+ */
+export declare function getMemberships(listName: string): Promise<MembershipData>;

package/dist/core/membership.js

@@ -0,0 +1,92 @@
+/**
+ * Section membership orchestration.
+ *
+ * All database operations are routed through the compiled section-helper binary
+ * (which has its own Info.plist for macOS permissions). The binary handles the
+ * atomic transaction internally: write data + checksum + token map in one go.
+ *
+ * Flow:
+ * 1. Read current memberships via binary
+ * 2. Modify in TypeScript (add/remove entries)
+ * 3. Send updated JSON to binary for atomic write + sync trigger
+ */
+import { dbFindReminder, dbFindSection, dbReadMemberships, dbWriteMembershipSync, } from "./reminderkit.js";
+/** Convert hex UUID (32 chars) to dashed format (8-4-4-4-12) */
+function hexToUuid(hex) {
+    const h = hex.toUpperCase();
+    return `${h.slice(0, 8)}-${h.slice(8, 12)}-${h.slice(12, 16)}-${h.slice(16, 20)}-${h.slice(20)}`;
+}
+/** Core Data timestamp: seconds since 2001-01-01 00:00:00 UTC */
+function coreDataTimestamp() {
+    return Date.now() / 1000 - 978307200;
+}
+/**
+ * Assign a reminder to a section within its list, with iCloud sync.
+ * Idempotent: assigning to a section it's already in returns success.
+ */
+export async function assignToSection(listName, reminderTitle, sectionName) {
+    const reminder = await dbFindReminder(reminderTitle, listName);
+    const section = await dbFindSection(sectionName, listName);
+    const memberUuid = hexToUuid(reminder.identifier);
+    const sectionUuid = hexToUuid(section.identifier);
+    const timestamp = coreDataTimestamp();
+    // Read current membership data
+    const currentData = await dbReadMemberships(listName);
+    let membership;
+    if (currentData && currentData.trim() !== "") {
+        membership = JSON.parse(currentData);
+        // Idempotent: already assigned to this section
+        const existing = membership.memberships.find((m) => m.memberID === memberUuid && m.groupID === sectionUuid);
+        if (existing)
+            return {};
+        // Remove any existing assignment (move semantics)
+        membership.memberships = membership.memberships.filter((m) => m.memberID !== memberUuid);
+        membership.memberships.push({
+            memberID: memberUuid,
+            groupID: sectionUuid,
+            modifiedOn: timestamp,
+        });
+    }
+    else {
+        membership = {
+            minimumSupportedVersion: 20230430,
+            memberships: [{ memberID: memberUuid, groupID: sectionUuid, modifiedOn: timestamp }],
+        };
+    }
+    // Atomic write + sync via compiled binary
+    const warning = await dbWriteMembershipSync(listName, JSON.stringify(membership));
+    return { warning };
+}
+/**
+ * Remove a reminder from its current section.
+ */
+export async function removeFromSection(listName, reminderTitle) {
+    const reminder = await dbFindReminder(reminderTitle, listName);
+    const memberUuid = hexToUuid(reminder.identifier);
+    const currentData = await dbReadMemberships(listName);
+    if (!currentData || currentData.trim() === "")
+        return {};
+    const membership = JSON.parse(currentData);
+    const originalLength = membership.memberships.length;
+    membership.memberships = membership.memberships.filter((m) => m.memberID !== memberUuid);
+    if (membership.memberships.length === originalLength)
+        return {};
+    const warning = await dbWriteMembershipSync(listName, JSON.stringify(membership));
+    return { warning };
+}
+/**
+ * Get all membership entries for a list.
+ */
+export async function getMemberships(listName) {
+    const data = await dbReadMemberships(listName);
+    if (!data || data.trim() === "")
+        return { memberships: [] };
+    const blob = JSON.parse(data);
+    return {
+        memberships: blob.memberships.map((m) => ({
+            reminderID: m.memberID,
+            sectionID: m.groupID,
+        })),
+    };
+}
+//# sourceMappingURL=membership.js.map

package/dist/core/membership.js.map

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

package/dist/core/recurrence.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Parse human-friendly --repeat strings into EKRecurrenceRule parameters.
+ *
+ * Supported formats:
+ *   "daily", "weekly", "monthly", "yearly"
+ *   "every 2 weeks", "every 3 months"
+ *   "every 2 weeks on monday,friday"
+ */
+export interface RecurrenceParams {
+    rruleFreq: string;
+    rruleInterval: number;
+    rruleDays?: number[];
+}
+export declare function parseRepeat(input: string): RecurrenceParams;

package/dist/core/recurrence.js

@@ -0,0 +1,90 @@
+/**
+ * Parse human-friendly --repeat strings into EKRecurrenceRule parameters.
+ *
+ * Supported formats:
+ *   "daily", "weekly", "monthly", "yearly"
+ *   "every 2 weeks", "every 3 months"
+ *   "every 2 weeks on monday,friday"
+ */
+import { ErrorCode, RemiCommandError } from "./errors.js";
+const DAY_MAP = {
+    sunday: 1,
+    sun: 1,
+    monday: 2,
+    mon: 2,
+    tuesday: 3,
+    tue: 3,
+    wednesday: 4,
+    wed: 4,
+    thursday: 5,
+    thu: 5,
+    friday: 6,
+    fri: 6,
+    saturday: 7,
+    sat: 7,
+};
+const FREQ_ALIASES = {
+    daily: "DAILY",
+    weekly: "WEEKLY",
+    monthly: "MONTHLY",
+    yearly: "YEARLY",
+    day: "DAILY",
+    days: "DAILY",
+    week: "WEEKLY",
+    weeks: "WEEKLY",
+    month: "MONTHLY",
+    months: "MONTHLY",
+    year: "YEARLY",
+    years: "YEARLY",
+};
+export function parseRepeat(input) {
+    const s = input.trim().toLowerCase();
+    // Simple: "daily", "weekly", "monthly", "yearly"
+    if (FREQ_ALIASES[s]) {
+        return { rruleFreq: FREQ_ALIASES[s], rruleInterval: 1 };
+    }
+    // "every N <unit>" with optional "on <days>"
+    const match = s.match(/^every\s+(\d+)\s+(\w+?)(?:\s+on\s+(.+))?$/);
+    if (match) {
+        const interval = Number.parseInt(match[1], 10);
+        const unit = match[2];
+        const freq = FREQ_ALIASES[unit];
+        if (!freq) {
+            throw new RemiCommandError(ErrorCode.INVALID_ARGUMENT, `Unknown frequency unit "${unit}"`, "Use: day(s), week(s), month(s), year(s)");
+        }
+        const result = { rruleFreq: freq, rruleInterval: interval };
+        if (match[3]) {
+            result.rruleDays = parseDays(match[3]);
+        }
+        return result;
+    }
+    // "every <unit>" (no number = interval 1)
+    const simpleEvery = s.match(/^every\s+(\w+?)(?:\s+on\s+(.+))?$/);
+    if (simpleEvery) {
+        const unit = simpleEvery[1];
+        const freq = FREQ_ALIASES[unit];
+        if (freq) {
+            const result = { rruleFreq: freq, rruleInterval: 1 };
+            if (simpleEvery[2]) {
+                result.rruleDays = parseDays(simpleEvery[2]);
+            }
+            return result;
+        }
+    }
+    throw new RemiCommandError(ErrorCode.INVALID_ARGUMENT, `Cannot parse repeat rule "${input}"`, 'Examples: "daily", "weekly", "every 2 weeks", "every 3 months"');
+}
+function parseDays(input) {
+    const days = input.split(/[,\s]+/).map((d) => d.trim().toLowerCase());
+    const result = [];
+    for (const day of days) {
+        if (!day)
+            continue;
+        const num = DAY_MAP[day];
+        if (!num) {
+            throw new RemiCommandError(ErrorCode.INVALID_ARGUMENT, `Unknown day "${day}"`, "Use: monday, tuesday, wednesday, thursday, friday, saturday, sunday (or mon, tue, etc.)");
+        }
+        result.push(num);
+    }
+    return result;
+}
+//# sourceMappingURL=recurrence.js.map

package/dist/core/recurrence.js.map

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

package/dist/core/reminderkit.d.ts

@@ -0,0 +1,33 @@
+/**
+ * ReminderKit bridge — executes the compiled section-helper binary
+ * for section CRUD, sync trigger, and database operations.
+ *
+ * Permissions note: macOS TCC always attributes permissions to the
+ * "responsible process" (the terminal app), not the child binary.
+ * The embedded Info.plist provides NSRemindersUsageDescription for
+ * the permission dialog text, but the grant goes to the terminal.
+ */
+import type { Section } from "../types.js";
+export declare function listSections(listName: string): Promise<Section[]>;
+export declare function createSection(listName: string, sectionName: string): Promise<string>;
+export declare function deleteSection(listName: string, sectionName: string): Promise<string>;
+export declare function triggerSync(listName: string): Promise<string | undefined>;
+export declare function dbFindDb(): Promise<string>;
+export declare function dbStats(): Promise<{
+    dbPath: string;
+    lists: number;
+    sections: number;
+    reminders: number;
+}>;
+export declare function dbFindList(listName: string): Promise<number>;
+export declare function dbFindReminder(title: string, listName: string): Promise<{
+    pk: number;
+    identifier: string;
+}>;
+export declare function dbFindSection(sectionName: string, listName: string): Promise<{
+    pk: number;
+    identifier: string;
+}>;
+export declare function dbReadMemberships(listName: string): Promise<string | null>;
+export declare function dbReadTokenMap(listName: string): Promise<string | null>;
+export declare function dbWriteMembershipSync(listName: string, membershipJSON: string): Promise<string | undefined>;

package/dist/core/reminderkit.js

@@ -0,0 +1,154 @@
+/**
+ * ReminderKit bridge — executes the compiled section-helper binary
+ * for section CRUD, sync trigger, and database operations.
+ *
+ * Permissions note: macOS TCC always attributes permissions to the
+ * "responsible process" (the terminal app), not the child binary.
+ * The embedded Info.plist provides NSRemindersUsageDescription for
+ * the permission dialog text, but the grant goes to the terminal.
+ */
+import { execFile } from "node:child_process";
+import { existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { promisify } from "node:util";
+import { ErrorCode, RemiCommandError } from "./errors.js";
+const execFileAsync = promisify(execFile);
+const TIMEOUT_MS = 30000;
+function findSectionHelper() {
+    const currentDir = dirname(fileURLToPath(import.meta.url));
+    const candidates = [
+        join(currentDir, "../section-helper"), // From dist/core/ -> dist/section-helper
+        join(currentDir, "../../dist/section-helper"), // From src/core/ -> dist/section-helper
+    ];
+    for (const p of candidates) {
+        if (existsSync(p))
+            return p;
+    }
+    throw new RemiCommandError(ErrorCode.REMINDERKIT_UNAVAILABLE, "section-helper binary not found", "Run: npm run build:swift");
+}
+async function runSectionHelper(command, ...args) {
+    const binaryPath = findSectionHelper();
+    const cmdArgs = [command, ...args];
+    try {
+        const { stdout } = await execFileAsync(binaryPath, cmdArgs, {
+            timeout: TIMEOUT_MS,
+            env: { ...process.env },
+        });
+        return JSON.parse(stdout.trim());
+    }
+    catch (error) {
+        const err = error;
+        if (err.stdout) {
+            try {
+                const result = JSON.parse(err.stdout.trim());
+                if (result.error) {
+                    throw new RemiCommandError(ErrorCode.REMINDERKIT_UNAVAILABLE, result.error);
+                }
+            }
+            catch (parseErr) {
+                if (parseErr instanceof RemiCommandError)
+                    throw parseErr;
+            }
+        }
+        throw new RemiCommandError(ErrorCode.REMINDERKIT_UNAVAILABLE, `Section helper failed: ${err.stderr || err.message}`, "Ensure macOS 13+ and Xcode Command Line Tools are installed");
+    }
+}
+export async function listSections(listName) {
+    const result = await runSectionHelper("list-sections", listName);
+    if (!result.success) {
+        throw new RemiCommandError(ErrorCode.LIST_NOT_FOUND, result.error || `Failed to list sections for "${listName}"`);
+    }
+    return (result.sections || []).map((s, i) => ({
+        id: s.objectID,
+        displayName: s.name,
+        listName,
+        sortOrder: i,
+    }));
+}
+export async function createSection(listName, sectionName) {
+    const result = await runSectionHelper("create-section", listName, sectionName);
+    if (!result.success) {
+        throw new RemiCommandError(ErrorCode.REMINDERKIT_UNAVAILABLE, result.error || `Failed to create section "${sectionName}"`);
+    }
+    return result.message || "OK";
+}
+export async function deleteSection(listName, sectionName) {
+    const result = await runSectionHelper("delete-section", listName, sectionName);
+    if (!result.success) {
+        throw new RemiCommandError(ErrorCode.SECTION_NOT_FOUND, result.error || `Failed to delete section "${sectionName}"`);
+    }
+    return result.message || "OK";
+}
+export async function triggerSync(listName) {
+    const result = await runSectionHelper("trigger-sync", listName);
+    if (!result.success) {
+        return result.error || "Sync trigger failed";
+    }
+    return result.warning;
+}
+async function runDbCommand(command, ...args) {
+    return runSectionHelper(command, ...args);
+}
+export async function dbFindDb() {
+    const result = await runDbCommand("db-find-db");
+    if (!result.success) {
+        throw new RemiCommandError(ErrorCode.DB_NOT_FOUND, result.error || "Database not found");
+    }
+    return result.dbPath;
+}
+export async function dbStats() {
+    const result = await runDbCommand("db-stats");
+    if (!result.success) {
+        throw new RemiCommandError(ErrorCode.DB_NOT_FOUND, result.error || "Database not found");
+    }
+    return {
+        dbPath: result.dbPath,
+        lists: result.lists,
+        sections: result.sections,
+        reminders: result.reminders,
+    };
+}
+export async function dbFindList(listName) {
+    const result = await runDbCommand("db-find-list", listName);
+    if (!result.success) {
+        throw new RemiCommandError(ErrorCode.LIST_NOT_FOUND, result.error || `List "${listName}" not found`);
+    }
+    return result.pk;
+}
+export async function dbFindReminder(title, listName) {
+    const result = await runDbCommand("db-find-reminder", title, listName);
+    if (!result.success) {
+        throw new RemiCommandError(ErrorCode.REMINDER_NOT_FOUND, result.error || `Reminder "${title}" not found`);
+    }
+    return { pk: result.pk, identifier: result.identifier };
+}
+export async function dbFindSection(sectionName, listName) {
+    const result = await runDbCommand("db-find-section", sectionName, listName);
+    if (!result.success) {
+        throw new RemiCommandError(ErrorCode.SECTION_NOT_FOUND, result.error || `Section "${sectionName}" not found`);
+    }
+    return { pk: result.pk, identifier: result.identifier };
+}
+export async function dbReadMemberships(listName) {
+    const result = await runDbCommand("db-read-memberships", listName);
+    if (!result.success) {
+        throw new RemiCommandError(ErrorCode.DB_NOT_FOUND, result.error || "Failed to read memberships");
+    }
+    return result.data ?? null;
+}
+export async function dbReadTokenMap(listName) {
+    const result = await runDbCommand("db-read-tokenmap", listName);
+    if (!result.success) {
+        throw new RemiCommandError(ErrorCode.DB_NOT_FOUND, result.error || "Failed to read token map");
+    }
+    return result.data ?? null;
+}
+export async function dbWriteMembershipSync(listName, membershipJSON) {
+    const result = await runDbCommand("db-write-membership-sync", listName, membershipJSON);
+    if (!result.success) {
+        throw new RemiCommandError(ErrorCode.SYNC_TRIGGER_FAILED, result.error || "Membership sync failed");
+    }
+    return result.warning;
+}
+//# sourceMappingURL=reminderkit.js.map

package/dist/core/reminderkit.js.map

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

package/dist/core/sqlite.d.ts

@@ -0,0 +1,65 @@
+/**
+ * SQLite access for Apple Reminders database.
+ *
+ * Uses better-sqlite3 for proper transactions and prepared statements.
+ * This is a key improvement over the predecessor which shelled out to /usr/bin/sqlite3
+ * for each statement, making the 3-step membership write non-atomic.
+ */
+import Database from "better-sqlite3";
+/**
+ * Find the active Apple Reminders SQLite database.
+ * Scans all .sqlite files and returns the one with actual reminder data.
+ */
+export declare function findRemindersDbPath(): string;
+/**
+ * Get a database connection. Caches the connection for reuse.
+ * Uses WAL mode and busy_timeout for safe concurrent access with remindd.
+ */
+export declare function getDb(): Database.Database;
+/**
+ * Close the cached database connection.
+ */
+export declare function closeDb(): void;
+/**
+ * Find a list's Z_PK by name.
+ */
+export declare function findListPk(listName: string): number;
+/**
+ * Find a reminder's identifier (hex UUID) by title and list name.
+ */
+export declare function findReminderIdentifier(title: string, listName: string): {
+    pk: number;
+    identifier: string;
+};
+/**
+ * Find a section's identifier (hex UUID) by name and list.
+ */
+export declare function findSectionIdentifier(sectionName: string, listName: string): {
+    pk: number;
+    identifier: string;
+};
+/**
+ * Read the current membership data JSON from a list.
+ */
+export declare function readMembershipData(listPk: number): string | null;
+/**
+ * Read the resolution token map JSON from a list.
+ * The token map may be stored as a BLOB or TEXT — handle both.
+ */
+export declare function readTokenMap(listPk: number): string | null;
+/**
+ * Write membership data, checksum, and token map in a SINGLE ATOMIC TRANSACTION.
+ *
+ * This is the key improvement over the predecessor which used separate sqlite3 process
+ * calls for each statement. A partial write (data updated but checksum not) would cause
+ * remindd to detect data corruption.
+ */
+export declare function writeMembershipSync(listPk: number, membershipJson: string, checksumHex: string, tokenMapJson: string): void;
+/**
+ * Convert a hex blob string (32 chars, no hyphens) to standard UUID format.
+ */
+export declare function hexToUuid(hex: string): string;
+/**
+ * Convert a JS Date to Core Data timestamp (seconds since 2001-01-01 00:00:00 UTC).
+ */
+export declare function coreDataTimestamp(date?: Date): number;