@spool-lab/core 0.3.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Spool Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,39 @@
+# @spool-lab/core
+
+The engine behind [Spool](https://spool.pro) — a local search engine for your AI sessions and connected sources.
+
+This package provides the core runtime: session parsing, full-text search, the connector sync engine, and the SQLite database layer. It powers both the Spool desktop app and the `@spool-lab/cli`.
+
+## Usage
+
+```ts
+import { getDB, searchFragments, listRecentSessions, Syncer } from '@spool-lab/core'
+
+const db = getDB()
+
+// Search across all indexed sessions
+const results = searchFragments(db, 'authentication middleware', { limit: 10 })
+
+// List recent sessions
+const sessions = listRecentSessions(db, 20)
+
+// Sync new sessions from Claude, Codex, Gemini
+const syncer = new Syncer(db)
+syncer.syncAll()
+```
+
+## What's inside
+
+- **Session parsers** — reads Claude Code, Codex, and Gemini CLI session files
+- **Full-text search** — FTS5 with unicode + trigram indexes for CJK support
+- **Sync engine** — paginated connector sync with cursor-based state, backfill, and error recovery
+- **Connector loader** — discovers and loads connector plugins from `~/.spool/connectors/`
+- **Connector registry** — in-memory registry of available connectors
+
+## Native dependency
+
+This package depends on [`better-sqlite3`](https://github.com/WiseLibs/better-sqlite3), which includes a native C++ addon. On most platforms, prebuilt binaries are downloaded automatically during install. If that fails, you'll need a C++ toolchain (Python 3, node-gyp).
+
+## License
+
+MIT

package/dist/connectors/capabilities/cookies-chrome.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Chrome cookie extraction for X/Twitter authentication.
+ *
+ * Adapted from fieldtheory-cli (https://github.com/afar1/fieldtheory-cli).
+ * Reads Chrome's encrypted cookie database on macOS, decrypts auth_token and
+ * ct0 (CSRF) cookies for x.com using the macOS Keychain.
+ */
+import type { CookiesCapability } from '@spool-lab/connector-sdk';
+export declare function decryptCookieValue(encryptedValue: Buffer, key: Buffer, dbVersion?: number): string;
+/**
+ * Enumerate every Chrome `host_key` value that should match a request to `host`
+ * per RFC 6265 §5.1.3. Chrome stores host-only cookies under the bare hostname
+ * and domain cookies under `.parent.example.com`; a request to `www.example.com`
+ * must see cookies at `www.example.com`, `.www.example.com`, and `.example.com`
+ * but not anything scoped to a sibling (`.other.example.com`) or a TLD alone.
+ */
+export declare function getMatchingHostKeys(host: string): string[];
+export declare function makeChromeCookiesCapability(): CookiesCapability;
+//# sourceMappingURL=cookies-chrome.d.ts.map

package/dist/connectors/capabilities/cookies-chrome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookies-chrome.d.ts","sourceRoot":"","sources":["../../../src/connectors/capabilities/cookies-chrome.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,KAAK,EAAE,iBAAiB,EAAuB,MAAM,0BAA0B,CAAA;AAmCtF,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,SAAI,GAAG,MAAM,CAmB7F;AA0DD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAe1D;AAgDD,wBAAgB,2BAA2B,IAAI,iBAAiB,CAoD/D"}

package/dist/connectors/capabilities/cookies-chrome.js

@@ -0,0 +1,199 @@
+/**
+ * Chrome cookie extraction for X/Twitter authentication.
+ *
+ * Adapted from fieldtheory-cli (https://github.com/afar1/fieldtheory-cli).
+ * Reads Chrome's encrypted cookie database on macOS, decrypts auth_token and
+ * ct0 (CSRF) cookies for x.com using the macOS Keychain.
+ */
+import { execFileSync } from 'node:child_process';
+import { existsSync, unlinkSync, copyFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir, platform, homedir } from 'node:os';
+import { pbkdf2Sync, createDecipheriv, randomUUID } from 'node:crypto';
+import { SyncError, SyncErrorCode } from '@spool-lab/connector-sdk';
+function getMacOSChromeKey() {
+    const candidates = [
+        { service: 'Chrome Safe Storage', account: 'Chrome' },
+        { service: 'Chrome Safe Storage', account: 'Google Chrome' },
+        { service: 'Google Chrome Safe Storage', account: 'Chrome' },
+        { service: 'Google Chrome Safe Storage', account: 'Google Chrome' },
+        { service: 'Chromium Safe Storage', account: 'Chromium' },
+        { service: 'Brave Safe Storage', account: 'Brave' },
+        { service: 'Brave Browser Safe Storage', account: 'Brave Browser' },
+    ];
+    for (const candidate of candidates) {
+        try {
+            const password = execFileSync('security', ['find-generic-password', '-w', '-s', candidate.service, '-a', candidate.account], { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+            if (password) {
+                return pbkdf2Sync(password, 'saltysalt', 1003, 16, 'sha1');
+            }
+        }
+        catch {
+            // Try the next known browser/keychain naming pair.
+        }
+    }
+    throw new SyncError(SyncErrorCode.AUTH_KEYCHAIN_DENIED, 'Could not read a browser Safe Storage password from the macOS Keychain.');
+}
+export function decryptCookieValue(encryptedValue, key, dbVersion = 0) {
+    if (encryptedValue.length === 0)
+        return '';
+    if (encryptedValue[0] === 0x76 && encryptedValue[1] === 0x31 && encryptedValue[2] === 0x30) {
+        const iv = Buffer.alloc(16, 0x20); // 16 spaces
+        const ciphertext = encryptedValue.subarray(3);
+        const decipher = createDecipheriv('aes-128-cbc', key, iv);
+        let decrypted = decipher.update(ciphertext);
+        decrypted = Buffer.concat([decrypted, decipher.final()]);
+        // Chrome DB version >= 24 (Chrome ~130+) prepends SHA256(host_key) to plaintext
+        if (dbVersion >= 24 && decrypted.length > 32) {
+            decrypted = decrypted.subarray(32);
+        }
+        return decrypted.toString('utf8');
+    }
+    return encryptedValue.toString('utf8');
+}
+function detectChromeUserDataDir() {
+    const os = platform();
+    const home = homedir();
+    if (os === 'darwin')
+        return join(home, 'Library', 'Application Support', 'Google', 'Chrome');
+    if (os === 'linux')
+        return join(home, '.config', 'google-chrome');
+    if (os === 'win32')
+        return join(home, 'AppData', 'Local', 'Google', 'Chrome', 'User Data');
+    throw new SyncError(SyncErrorCode.AUTH_CHROME_NOT_FOUND, `Unsupported platform for Chrome cookie extraction: ${os}`);
+}
+/**
+ * Run a sqlite3 query with fallback to a temp copy (Chrome locks the DB while running).
+ * Returns raw stdout string.
+ */
+function runSqliteQuery(dbPath, sql) {
+    const tryQuery = (path) => execFileSync('sqlite3', ['-json', path, sql], {
+        encoding: 'utf8',
+        stdio: ['pipe', 'pipe', 'pipe'],
+        timeout: 10000,
+    }).trim();
+    try {
+        return tryQuery(dbPath);
+    }
+    catch {
+        const tmpDb = join(tmpdir(), `spool-cookies-${randomUUID()}.db`);
+        try {
+            copyFileSync(dbPath, tmpDb);
+            return tryQuery(tmpDb);
+        }
+        catch (e2) {
+            throw new SyncError(SyncErrorCode.AUTH_COOKIE_DECRYPT_FAILED, `Could not read Chrome Cookies database at ${dbPath}. ${e2 instanceof Error ? e2.message : ''}`, e2);
+        }
+        finally {
+            try {
+                unlinkSync(tmpDb);
+            }
+            catch { }
+        }
+    }
+}
+/**
+ * Enumerate every Chrome `host_key` value that should match a request to `host`
+ * per RFC 6265 §5.1.3. Chrome stores host-only cookies under the bare hostname
+ * and domain cookies under `.parent.example.com`; a request to `www.example.com`
+ * must see cookies at `www.example.com`, `.www.example.com`, and `.example.com`
+ * but not anything scoped to a sibling (`.other.example.com`) or a TLD alone.
+ */
+export function getMatchingHostKeys(host) {
+    const normalized = host.toLowerCase().replace(/^\./, '');
+    if (!normalized || !normalized.includes('.'))
+        return [];
+    const keys = [normalized, `.${normalized}`];
+    let cur = normalized;
+    while (true) {
+        const idx = cur.indexOf('.');
+        if (idx < 0)
+            break;
+        const parent = cur.substring(idx + 1);
+        if (!parent.includes('.'))
+            break;
+        keys.push(`.${parent}`);
+        cur = parent;
+    }
+    return keys;
+}
+function queryAllCookiesForHost(dbPath, host) {
+    if (!existsSync(dbPath)) {
+        throw new SyncError(SyncErrorCode.AUTH_CHROME_NOT_FOUND, `Chrome Cookies database not found at: ${dbPath}`);
+    }
+    const keys = getMatchingHostKeys(host);
+    if (keys.length === 0)
+        return { cookies: [], dbVersion: 0 };
+    const quoted = keys.map(k => `'${k.replace(/'/g, "''")}'`).join(',');
+    // Fetch cookies and DB version in one sqlite3 invocation to avoid double process spawn
+    const sql = `SELECT name, host_key, path, hex(encrypted_value) as encrypted_value_hex, value, expires_utc, is_secure, is_httponly, (SELECT value FROM meta WHERE key='version') as db_version FROM cookies WHERE host_key IN (${quoted});`;
+    const output = runSqliteQuery(dbPath, sql);
+    if (!output || output === '[]')
+        return { cookies: [], dbVersion: 0 };
+    try {
+        const rows = JSON.parse(output);
+        const dbVersion = rows.length > 0 ? parseInt(rows[0]?.db_version ?? '0', 10) || 0 : 0;
+        return { cookies: rows, dbVersion };
+    }
+    catch {
+        return { cookies: [], dbVersion: 0 };
+    }
+}
+const CHROMIUM_EPOCH_DELTA = 11644473600;
+function chromiumExpiresToUnix(expiresUtc) {
+    const raw = typeof expiresUtc === 'string' ? parseInt(expiresUtc, 10) : expiresUtc;
+    if (!raw || raw === 0)
+        return null;
+    return raw / 1_000_000 - CHROMIUM_EPOCH_DELTA;
+}
+function domainFromUrl(url) {
+    try {
+        return new URL(url).hostname;
+    }
+    catch {
+        return url;
+    }
+}
+export function makeChromeCookiesCapability() {
+    return {
+        async get(query) {
+            if (query.browser !== 'chrome') {
+                throw new SyncError(SyncErrorCode.AUTH_CHROME_NOT_FOUND, `Unsupported browser: ${query.browser}. Only 'chrome' is supported.`);
+            }
+            const os = platform();
+            if (os !== 'darwin') {
+                throw new SyncError(SyncErrorCode.AUTH_CHROME_NOT_FOUND, `Direct cookie extraction is currently supported on macOS only (detected: ${os}).`);
+            }
+            const profile = query.profile ?? 'Default';
+            const dataDir = detectChromeUserDataDir();
+            const dbPath = join(dataDir, profile, 'Cookies');
+            const key = getMacOSChromeKey();
+            const host = domainFromUrl(query.url);
+            const result = queryAllCookiesForHost(dbPath, host);
+            const cookies = [];
+            for (const raw of result.cookies) {
+                let value;
+                const hexVal = raw.encrypted_value_hex;
+                if (hexVal && hexVal.length > 0) {
+                    const buf = Buffer.from(hexVal, 'hex');
+                    const decrypted = decryptCookieValue(buf, key, result.dbVersion);
+                    value = decrypted.replace(/\0+$/g, '').trim();
+                }
+                else {
+                    value = raw.value ?? '';
+                }
+                cookies.push({
+                    name: raw.name,
+                    value,
+                    domain: raw.host_key,
+                    path: raw.path || '/',
+                    expires: chromiumExpiresToUnix(raw.expires_utc),
+                    secure: raw.is_secure === '1' || raw.is_secure === 'true',
+                    httpOnly: raw.is_httponly === '1' || raw.is_httponly === 'true',
+                });
+            }
+            return cookies;
+        },
+    };
+}
+//# sourceMappingURL=cookies-chrome.js.map

package/dist/connectors/capabilities/cookies-chrome.js.map

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

package/dist/connectors/capabilities/exec-impl.d.ts

@@ -0,0 +1,3 @@
+import type { ExecCapability } from '@spool-lab/connector-sdk';
+export declare function makeExecCapability(): ExecCapability;
+//# sourceMappingURL=exec-impl.d.ts.map

package/dist/connectors/capabilities/exec-impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec-impl.d.ts","sourceRoot":"","sources":["../../../src/connectors/capabilities/exec-impl.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,0BAA0B,CAAA;AAoC1E,wBAAgB,kBAAkB,IAAI,cAAc,CA6EnD"}

package/dist/connectors/capabilities/exec-impl.js

@@ -0,0 +1,108 @@
+import { spawn } from 'node:child_process';
+import { readdirSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+const DEFAULT_TIMEOUT = 60_000;
+function buildEnrichedPath() {
+    const home = homedir();
+    const base = process.env['PATH'] ?? '';
+    const nvmBins = [];
+    const versionsDir = join(home, '.nvm', 'versions', 'node');
+    try {
+        for (const d of readdirSync(versionsDir)) {
+            if (d.startsWith('v'))
+                nvmBins.push(join(versionsDir, d, 'bin'));
+        }
+        nvmBins.sort().reverse();
+    }
+    catch { }
+    const extras = [
+        '/opt/homebrew/bin',
+        '/usr/local/bin',
+        `${home}/.local/bin`,
+        `${home}/.nvm/current/bin`,
+        `${home}/.fnm/aliases/default/bin`,
+        ...nvmBins,
+    ];
+    return [...extras, base].join(':');
+}
+/** POSIX single-quote escaping: wraps in '...' and escapes embedded single quotes. */
+function shellQuote(s) {
+    return `'${s.replace(/'/g, `'\\''`)}'`;
+}
+let enrichedPath = null;
+export function makeExecCapability() {
+    if (!enrichedPath)
+        enrichedPath = buildEnrichedPath();
+    const isWin = process.platform === 'win32';
+    return {
+        run(bin, args, opts) {
+            const timeout = opts?.timeout ?? DEFAULT_TIMEOUT;
+            return new Promise((resolve, reject) => {
+                // GUI-launched apps on macOS don't inherit the user's shell env (no
+                // proxy vars, no nvm PATH, etc.) — running through a login shell
+                // sources .zprofile / .bash_profile so subprocesses get a realistic
+                // env. zsh additionally needs -i to source .zshrc where most users
+                // keep proxy/PATH tweaks; bash -i emits "cannot set terminal process
+                // group" warnings in non-TTY contexts (eg. CI) so we stick to plain
+                // -lc for bash and rely on .bash_profile to source .bashrc as is
+                // standard. On Windows there is no equivalent concept, spawn direct.
+                const shellPath = process.env['SHELL'] || '/bin/zsh';
+                const useInteractive = /\bzsh$/.test(shellPath);
+                const proc = isWin
+                    ? spawn(bin, args, {
+                        stdio: ['pipe', 'pipe', 'pipe'],
+                        env: { ...process.env, PATH: enrichedPath },
+                    })
+                    : spawn(shellPath, [useInteractive ? '-ilc' : '-lc', [bin, ...args].map(shellQuote).join(' ')], {
+                        stdio: ['pipe', 'pipe', 'pipe'],
+                        env: { ...process.env, PATH: enrichedPath },
+                        // Run in own process group so timeout kills the inner command
+                        // too, not just the shell wrapper.
+                        detached: true,
+                    });
+                let stdout = '';
+                let stderr = '';
+                let timedOut = false;
+                const killGroup = () => {
+                    if (!isWin && proc.pid) {
+                        // Kill the whole process group so the shell wrapper AND the
+                        // inner command both terminate. Without this, killing only the
+                        // shell leaves the inner command orphaned and stdio pipes open.
+                        try {
+                            process.kill(-proc.pid, 'SIGKILL');
+                        }
+                        catch {
+                            proc.kill('SIGKILL');
+                        }
+                    }
+                    else {
+                        proc.kill();
+                    }
+                };
+                const timer = setTimeout(() => {
+                    timedOut = true;
+                    killGroup();
+                    // Resolve immediately rather than waiting for stdio drain — the
+                    // 'close' handler may not fire promptly when the process group is
+                    // killed because orphaned descendants can keep pipes open.
+                    reject(new Error(`Process timed out after ${timeout}ms`));
+                }, timeout);
+                proc.stdout.on('data', (d) => { stdout += d.toString(); });
+                proc.stderr.on('data', (d) => { stderr += d.toString(); });
+                proc.on('close', () => {
+                    clearTimeout(timer);
+                    if (!timedOut) {
+                        resolve({ stdout, stderr, exitCode: proc.exitCode ?? 1 });
+                    }
+                });
+                proc.on('error', (err) => {
+                    clearTimeout(timer);
+                    if (!timedOut)
+                        reject(err);
+                });
+            });
+        },
+    };
+}
+//# sourceMappingURL=exec-impl.js.map

package/dist/connectors/capabilities/exec-impl.js.map

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

package/dist/connectors/capabilities/fetch-impl.d.ts

@@ -0,0 +1,3 @@
+import type { FetchCapability } from '@spool-lab/connector-sdk';
+export declare function makeFetchCapability(fetchFn?: typeof globalThis.fetch): FetchCapability;
+//# sourceMappingURL=fetch-impl.d.ts.map

package/dist/connectors/capabilities/fetch-impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-impl.d.ts","sourceRoot":"","sources":["../../../src/connectors/capabilities/fetch-impl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAE/D,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,OAAO,UAAU,CAAC,KAAwB,GAClD,eAAe,CAEjB"}

package/dist/connectors/capabilities/fetch-impl.js

@@ -0,0 +1,4 @@
+export function makeFetchCapability(fetchFn = globalThis.fetch) {
+    return fetchFn;
+}
+//# sourceMappingURL=fetch-impl.js.map

package/dist/connectors/capabilities/fetch-impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-impl.js","sourceRoot":"","sources":["../../../src/connectors/capabilities/fetch-impl.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,mBAAmB,CACjC,UAAmC,UAAU,CAAC,KAAK;IAEnD,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/connectors/capabilities/index.d.ts

@@ -0,0 +1,6 @@
+export { makeFetchCapability } from './fetch-impl.js';
+export { makeChromeCookiesCapability } from './cookies-chrome.js';
+export { makeLogCapabilityFor } from './log-impl.js';
+export { makeSqliteCapability } from './sqlite-impl.js';
+export { makeExecCapability } from './exec-impl.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/connectors/capabilities/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/connectors/capabilities/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAA;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/connectors/capabilities/index.js

@@ -0,0 +1,6 @@
+export { makeFetchCapability } from './fetch-impl.js';
+export { makeChromeCookiesCapability } from './cookies-chrome.js';
+export { makeLogCapabilityFor } from './log-impl.js';
+export { makeSqliteCapability } from './sqlite-impl.js';
+export { makeExecCapability } from './exec-impl.js';
+//# sourceMappingURL=index.js.map

package/dist/connectors/capabilities/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/connectors/capabilities/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAA;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/connectors/capabilities/log-impl.d.ts

@@ -0,0 +1,3 @@
+import type { LogCapability } from '@spool-lab/connector-sdk';
+export declare function makeLogCapabilityFor(connectorId: string): LogCapability;
+//# sourceMappingURL=log-impl.d.ts.map

package/dist/connectors/capabilities/log-impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-impl.d.ts","sourceRoot":"","sources":["../../../src/connectors/capabilities/log-impl.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAa,MAAM,0BAA0B,CAAA;AAExE,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CAuCvE"}

package/dist/connectors/capabilities/log-impl.js

@@ -0,0 +1,26 @@
+import { Effect } from 'effect';
+export function makeLogCapabilityFor(connectorId) {
+    const baseAttrs = { 'connector.id': connectorId };
+    const emit = (level, msg, fields) => {
+        const attrs = { ...baseAttrs, ...fields };
+        const effect = level === 'Debug' ? Effect.logDebug(msg) :
+            level === 'Info' ? Effect.logInfo(msg) :
+                level === 'Warning' ? Effect.logWarning(msg) :
+                    Effect.logError(msg);
+        Effect.runFork(effect.pipe(Effect.annotateLogs(attrs)));
+    };
+    return {
+        debug(msg, fields) { emit('Debug', msg, fields); },
+        info(msg, fields) { emit('Info', msg, fields); },
+        warn(msg, fields) { emit('Warning', msg, fields); },
+        error(msg, fields) { emit('Error', msg, fields); },
+        async span(name, fn, opts) {
+            const attrs = { ...baseAttrs, ...opts?.attributes };
+            return Effect.runPromise(Effect.tryPromise({
+                try: fn,
+                catch: e => e,
+            }).pipe(Effect.withSpan(`connector.${name}`, { attributes: attrs })));
+        },
+    };
+}
+//# sourceMappingURL=log-impl.js.map

package/dist/connectors/capabilities/log-impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-impl.js","sourceRoot":"","sources":["../../../src/connectors/capabilities/log-impl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAG/B,MAAM,UAAU,oBAAoB,CAAC,WAAmB;IACtD,MAAM,SAAS,GAAc,EAAE,cAAc,EAAE,WAAW,EAAE,CAAA;IAE5D,MAAM,IAAI,GAAG,CACX,KAA6C,EAC7C,GAAW,EACX,MAAkB,EAClB,EAAE;QACF,MAAM,KAAK,GAAG,EAAE,GAAG,SAAS,EAAE,GAAG,MAAM,EAAE,CAAA;QACzC,MAAM,MAAM,GACV,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;YAC1C,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;gBACxC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;oBAC9C,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;QACtB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IACzD,CAAC,CAAA;IAED,OAAO;QACL,KAAK,CAAC,GAAG,EAAE,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,CAAA,CAAC,CAAC;QACjD,IAAI,CAAC,GAAG,EAAE,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAA,CAAC,CAAC;QAC/C,IAAI,CAAC,GAAG,EAAE,MAAM,IAAI,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,MAAM,CAAC,CAAA,CAAC,CAAC;QAClD,KAAK,CAAC,GAAG,EAAE,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,CAAA,CAAC,CAAC;QAEjD,KAAK,CAAC,IAAI,CACR,IAAY,EACZ,EAAoB,EACpB,IAAiC;YAEjC,MAAM,KAAK,GAAG,EAAE,GAAG,SAAS,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,CAAA;YACnD,OAAO,MAAM,CAAC,UAAU,CACtB,MAAM,CAAC,UAAU,CAAC;gBAChB,GAAG,EAAE,EAAE;gBACP,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;aACd,CAAC,CAAC,IAAI,CACL,MAAM,CAAC,QAAQ,CAAC,aAAa,IAAI,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAC5D,CACF,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/connectors/capabilities/sqlite-impl.d.ts

@@ -0,0 +1,3 @@
+import type { SqliteCapability } from '@spool-lab/connector-sdk';
+export declare function makeSqliteCapability(): SqliteCapability;
+//# sourceMappingURL=sqlite-impl.d.ts.map

package/dist/connectors/capabilities/sqlite-impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-impl.d.ts","sourceRoot":"","sources":["../../../src/connectors/capabilities/sqlite-impl.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAmC,MAAM,0BAA0B,CAAA;AAEjG,wBAAgB,oBAAoB,IAAI,gBAAgB,CAgBvD"}

package/dist/connectors/capabilities/sqlite-impl.js

@@ -0,0 +1,19 @@
+import Database from 'better-sqlite3';
+export function makeSqliteCapability() {
+    return {
+        openReadonly(path) {
+            const db = new Database(path, { readonly: true, fileMustExist: true });
+            return {
+                prepare(sql) {
+                    const stmt = db.prepare(sql);
+                    return {
+                        all: (...params) => stmt.all(...params),
+                        get: (...params) => stmt.get(...params),
+                    };
+                },
+                close: () => { db.close(); },
+            };
+        },
+    };
+}
+//# sourceMappingURL=sqlite-impl.js.map

package/dist/connectors/capabilities/sqlite-impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-impl.js","sourceRoot":"","sources":["../../../src/connectors/capabilities/sqlite-impl.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAA;AAGrC,MAAM,UAAU,oBAAoB;IAClC,OAAO;QACL,YAAY,CAAC,IAAY;YACvB,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAA;YACtE,OAAO;gBACL,OAAO,CAAc,GAAW;oBAC9B,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;oBAC5B,OAAO;wBACL,GAAG,EAAE,CAAC,GAAG,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAQ;wBAC9C,GAAG,EAAE,CAAC,GAAG,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAkB;qBACzD,CAAA;gBACH,CAAC;gBACD,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,CAAA,CAAC,CAAC;aAC5B,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/connectors/loader.d.ts

@@ -0,0 +1,47 @@
+import type { CookiesCapability, ExecCapability, FetchCapability, LogCapability, Prerequisite, PrerequisitesCapability, SqliteCapability } from '@spool-lab/connector-sdk';
+import type { ConnectorRegistry } from './registry.js';
+interface BaseLogger {
+    info(msg: string, fields?: Record<string, unknown>): void;
+    warn(msg: string, fields?: Record<string, unknown>): void;
+    error(msg: string, fields?: Record<string, unknown>): void;
+}
+import { TrustStore } from './trust-store.js';
+export declare function validatePrerequisites(prereqs: unknown[], packageName: string): Prerequisite[];
+export interface CapabilityImpls {
+    fetch: FetchCapability;
+    cookies: CookiesCapability;
+    sqlite: SqliteCapability;
+    exec: ExecCapability;
+    logFor(connectorId: string): LogCapability;
+    /** Returns the prerequisites capability for the given package id, or undefined if not supported. */
+    prerequisitesFor?: (packageId: string) => PrerequisitesCapability;
+}
+export interface LoaderLogger extends BaseLogger {
+    child?(attrs: Record<string, unknown>): LoaderLogger;
+}
+export interface LoadDeps {
+    connectorsDir: string;
+    capabilityImpls: CapabilityImpls;
+    registry: ConnectorRegistry;
+    log: LoaderLogger;
+    trustStore: TrustStore;
+}
+export type LoadResult = {
+    status: 'loaded';
+    name: string;
+    version: string;
+} | {
+    status: 'failed';
+    name: string;
+    error: unknown;
+} | {
+    status: 'skipped';
+    name: string;
+    reason: 'not-in-allowlist' | 'bad-manifest';
+};
+export interface LoadReport {
+    loadResults: LoadResult[];
+}
+export declare function loadConnectors(deps: LoadDeps): Promise<LoadReport>;
+export {};
+//# sourceMappingURL=loader.d.ts.map

package/dist/connectors/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/connectors/loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAGV,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,aAAa,EACb,YAAY,EACZ,uBAAuB,EACvB,gBAAgB,EACjB,MAAM,0BAA0B,CAAA;AAEjC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AACtD,UAAU,UAAU;IAClB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IACzD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IACzD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CAC3D;AACD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,YAAY,EAAE,CAgC7F;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,eAAe,CAAA;IACtB,OAAO,EAAE,iBAAiB,CAAA;IAC1B,MAAM,EAAE,gBAAgB,CAAA;IACxB,IAAI,EAAE,cAAc,CAAA;IACpB,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CAAA;IAC1C,oGAAoG;IACpG,gBAAgB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,uBAAuB,CAAA;CAClE;AAED,MAAM,WAAW,YAAa,SAAQ,UAAU;IAC9C,KAAK,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,CAAA;CACrD;AAED,MAAM,WAAW,QAAQ;IACvB,aAAa,EAAE,MAAM,CAAA;IACrB,eAAe,EAAE,eAAe,CAAA;IAChC,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,GAAG,EAAE,YAAY,CAAA;IACjB,UAAU,EAAE,UAAU,CAAA;CACvB;AAED,MAAM,MAAM,UAAU,GAClB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAClD;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,CAAA;CAAE,CAAA;AAEpF,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,UAAU,EAAE,CAAA;CAC1B;AAwBD,wBAAsB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAexE"}