@chronicle.app/things-todo 0.3.0 → 0.4.0

package/dist/connectors/ThingsTodoExtractor.d.ts

@@ -11,6 +11,11 @@ export declare class ThingsTodoExtractor extends SqliteExtractor<typeof ThingsTo
     static default: boolean;
     static schema: any;
     static defaultTransformer: typeof ThingsTodoTransformer;
+    /**
+     * The default database lives in a folder macOS guards: say whether it's
+     * missing or refused before SQLite reports "unable to open database file".
+     */
+    setup(): Promise<void>;
     /** The owner's name from the local machine, used when `agentName` isn't set. */
     protected resolveAgentName(): string | undefined;
     private getStatusLabel;

package/dist/connectors/ThingsTodoExtractor.js

@@ -1,3 +1,4 @@
+import { fileError } from '@chronicle.app/etl';
 import { SqliteExtractor, timeRangeConditions } from '@chronicle.app/etl-sqlite';
 import { existsSync, readdirSync } from 'node:fs';
 import { join } from 'node:path';
@@ -12,11 +13,20 @@ import ThingsTodoTransformer from './ThingsTodoTransformer.js';
  * cannot be hardcoded. Glob the Group Containers directory for the
  * `ThingsData-*` folder and return the database inside it.
  */
+const containerDir = `${process.env.HOME}/Library/Group Containers/JLMPQHK86H.com.culturedcode.ThingsMac`;
 function resolveThingsDbPath() {
-    const containerDir = `${process.env.HOME}/Library/Group Containers/JLMPQHK86H.com.culturedcode.ThingsMac`;
     const dbSuffix = 'Things Database.thingsdatabase/main.sqlite';
+    // Listing the container needs Full Disk Access; without it, fall through to
+    // the conventional path and let setup() say what's wrong.
     if (existsSync(containerDir)) {
-        const thingsDataDirs = readdirSync(containerDir).filter(name => name.startsWith('ThingsData-'));
+        let entries = [];
+        try {
+            entries = readdirSync(containerDir);
+        }
+        catch {
+            // Reported by setup().
+        }
+        const thingsDataDirs = entries.filter(name => name.startsWith('ThingsData-'));
         for (const dir of thingsDataDirs) {
             const dbPath = join(containerDir, dir, dbSuffix);
             if (existsSync(dbPath)) {
@@ -51,6 +61,22 @@ export class ThingsTodoExtractor extends SqliteExtractor {
             .describe("Name of the task owner. Defaults to the OS account's full name"),
     });
     static defaultTransformer = ThingsTodoTransformer;
+    /**
+     * The default database lives in a folder macOS guards: say whether it's
+     * missing or refused before SQLite reports "unable to open database file".
+     */
+    async setup() {
+        const { input } = this.config;
+        if (input.startsWith(containerDir)) {
+            try {
+                readdirSync(containerDir);
+            }
+            catch (error) {
+                throw fileError(error, containerDir, 'Things library');
+            }
+        }
+        await super.setup();
+    }
     /** The owner's name from the local machine, used when `agentName` isn't set. */
     resolveAgentName() {
         return localAccountName();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chronicle.app/things-todo",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
@@ -19,9 +19,9 @@
   "type": "module",
   "description": "Chronicle things-todo extraction plugin",
   "devDependencies": {
-    "@chronicle.app/etl": "0.3.0",
-    "@chronicle.app/schema": "0.3.0",
-    "@chronicle.app/tsconfig": "0.3.0",
+    "@chronicle.app/etl": "0.4.0",
+    "@chronicle.app/schema": "0.4.0",
+    "@chronicle.app/tsconfig": "0.4.0",
     "@types/node": "^22.10.1",
     "typescript": "^5.7.2"
   },
@@ -36,7 +36,7 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@chronicle.app/etl-sqlite": "0.3.0",
+    "@chronicle.app/etl-sqlite": "0.4.0",
     "zod": "^3.24.1"
   },
   "peerDependencies": {