@alta-foundation/plaud-extractor 1.0.0

package/dist/PlaudExtractor.js

@@ -0,0 +1,236 @@
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import { createLogger, setLogger } from './logger.js';
+import { loadCredentials, saveCredentials, isExpired } from './auth/token-store.js';
+import { runBrowserAuth } from './auth/browser-auth.js';
+import { PlaudApiClient } from './client/plaud-client.js';
+import { SyncEngine } from './sync/sync-engine.js';
+import { IncrementalTracker } from './sync/incremental.js';
+import { verifyChecksums } from './storage/checksums.js';
+import { recordingDir, defaultOutDir } from './storage/paths.js';
+import { AuthError } from './errors.js';
+export class PlaudExtractor {
+    outDir;
+    engine;
+    constructor(config = {}) {
+        this.outDir = config.outDir
+            ? path.resolve(config.outDir.replace(/^~/, os.homedir()))
+            : defaultOutDir();
+        if (config.logger) {
+            setLogger(config.logger);
+        }
+        else {
+            createLogger(this.outDir, { verbose: config.verbose, redact: config.redact });
+        }
+        this.engine = new SyncEngine();
+    }
+    /**
+     * Launch browser for authentication.
+     * Saves credentials to ~/.alta/plaud-auth.json.
+     */
+    async authenticate(opts = {}) {
+        const session = await runBrowserAuth(opts);
+        await saveCredentials(session);
+    }
+    /**
+     * Check if credentials exist and are not expired.
+     */
+    async isAuthenticated() {
+        const creds = await loadCredentials();
+        if (!creds)
+            return false;
+        if (isExpired(creds))
+            return false;
+        return true;
+    }
+    /**
+     * Incremental sync: only download new or changed recordings since last run.
+     * If the token expires mid-sync, re-authenticates automatically and retries once.
+     */
+    async sync(opts = {}) {
+        return this.runWithReauth(opts, 'sync');
+    }
+    /**
+     * Full backfill: re-evaluate all recordings regardless of sync state.
+     * If the token expires mid-backfill, re-authenticates automatically and retries once.
+     */
+    async backfill(opts = {}) {
+        return this.runWithReauth(opts, 'backfill');
+    }
+    /**
+     * Run sync/backfill, and if a token-expired AuthError occurs mid-run,
+     * automatically re-authenticate and retry once.
+     */
+    async runWithReauth(opts, mode) {
+        try {
+            const client = await this.buildClient();
+            return await this.engine.run(client, this.buildSyncOptions(opts), mode);
+        }
+        catch (err) {
+            if (!(err instanceof AuthError))
+                throw err;
+            // Token expired or rejected mid-run — re-authenticate and try once more
+            console.error('\nSession expired during sync. Re-authenticating...');
+            await this.authenticate();
+            console.log('Re-authenticated. Resuming sync...\n');
+            const client = await this.buildClient();
+            return this.engine.run(client, this.buildSyncOptions(opts), mode);
+        }
+    }
+    /**
+     * Walk all recording folders and verify checksums.
+     * With repair=true, re-download any file with a mismatch.
+     */
+    async verify(opts = {}) {
+        const client = opts.repair ? await this.buildClient() : null;
+        const tracker = new IncrementalTracker();
+        await tracker.load(this.outDir);
+        const result = { scanned: 0, ok: 0, failed: 0, repaired: 0, issues: [] };
+        const recordingIds = tracker.getAllRecordingIds();
+        for (const id of recordingIds) {
+            const state = tracker.getRecordingState(id);
+            if (!state)
+                continue;
+            const dir = recordingDir(this.outDir, state.recordedAt, id);
+            result.scanned++;
+            try {
+                const mismatches = await verifyChecksums(dir);
+                if (mismatches.length === 0) {
+                    result.ok++;
+                    tracker.markVerified(id);
+                }
+                else {
+                    result.failed++;
+                    for (const m of mismatches) {
+                        result.issues.push({
+                            recordingId: id,
+                            file: path.basename(m.filePath),
+                            issue: `checksum mismatch (expected: ${m.expected.slice(0, 8)}..., got: ${m.actual === 'MISSING' ? 'MISSING' : m.actual.slice(0, 8) + '...'})`,
+                        });
+                    }
+                    // TODO: repair support requires re-fetching the recording object
+                    // For now, log the mismatch
+                }
+            }
+            catch (err) {
+                result.failed++;
+                result.issues.push({ recordingId: id, file: '', issue: String(err) });
+            }
+        }
+        await tracker.persist(this.outDir);
+        return result;
+    }
+    /**
+     * Export all local recordings to a JSONL dataset file.
+     * Returns the path to the generated file.
+     */
+    async exportDataset(opts = {}) {
+        const { DatasetWriter } = await import('./storage/dataset-writer.js');
+        const { default: fsSync } = await import('node:fs');
+        // Walk recordings dir and collect existing transcript data
+        const datasetWriter = new DatasetWriter(this.outDir);
+        await datasetWriter.open();
+        // Re-generate from existing transcript.json files on disk
+        const recordingsBase = path.join(this.outDir, 'recordings');
+        try {
+            await this.walkAndExport(recordingsBase, datasetWriter);
+        }
+        finally {
+            await datasetWriter.close();
+        }
+        return datasetWriter.path;
+    }
+    async walkAndExport(recordingsBase, dataset) {
+        const { PlaudRecordingSchema } = await import('./client/types.js');
+        const { PlaudTranscriptSchema } = await import('./client/types.js');
+        // Walk year/month/dir structure
+        let yearDirs;
+        try {
+            yearDirs = await fs.readdir(recordingsBase);
+        }
+        catch {
+            return;
+        }
+        for (const year of yearDirs) {
+            const yearPath = path.join(recordingsBase, year);
+            let monthDirs;
+            try {
+                monthDirs = await fs.readdir(yearPath);
+            }
+            catch {
+                continue;
+            }
+            for (const month of monthDirs) {
+                const monthPath = path.join(yearPath, month);
+                let recDirs;
+                try {
+                    recDirs = await fs.readdir(monthPath);
+                }
+                catch {
+                    continue;
+                }
+                for (const recDir of recDirs) {
+                    const recPath = path.join(monthPath, recDir);
+                    try {
+                        const metaRaw = await fs.readFile(path.join(recPath, 'meta.json'), 'utf8');
+                        const transcriptRaw = await fs.readFile(path.join(recPath, 'transcript.json'), 'utf8');
+                        const meta = JSON.parse(metaRaw);
+                        const transcriptData = JSON.parse(transcriptRaw);
+                        // Reconstruct minimal PlaudRecording from meta.json
+                        const recording = PlaudRecordingSchema.parse({
+                            id: meta['source_recording_id'],
+                            title: meta['title'],
+                            duration: meta['duration_seconds'],
+                            recordedAt: meta['recorded_at'],
+                            createdAt: meta['recorded_at'],
+                            updatedAt: meta['recorded_at'],
+                            hasTranscript: true,
+                            _raw: meta,
+                        });
+                        const fullText = (transcriptData['segments'] ?? [])
+                            .map(s => s.text ?? '')
+                            .filter(Boolean)
+                            .join('\n\n');
+                        const transcript = PlaudTranscriptSchema.parse({
+                            recordingId: String(meta['source_recording_id'] ?? ''),
+                            duration: Number(meta['duration_seconds'] ?? 0),
+                            segments: transcriptData['segments'] ?? [],
+                            fullText,
+                            _raw: transcriptData,
+                        });
+                        await dataset.append(this.outDir, recording, transcript);
+                    }
+                    catch {
+                        // Skip recordings with missing/invalid files
+                    }
+                }
+            }
+        }
+    }
+    async buildClient() {
+        const creds = await loadCredentials();
+        if (!creds) {
+            throw new AuthError("No credentials found — run 'alta-plaud auth' to authenticate");
+        }
+        if (isExpired(creds)) {
+            throw new AuthError("Credentials expired — run 'alta-plaud auth' to re-authenticate");
+        }
+        return new PlaudApiClient(creds);
+    }
+    buildSyncOptions(partial) {
+        return {
+            outDir: this.outDir,
+            since: partial.since,
+            limit: partial.limit,
+            concurrency: partial.concurrency ?? 3,
+            formats: partial.formats ?? ['json', 'txt', 'md'],
+            includeDataset: partial.includeDataset ?? true,
+            dryRun: partial.dryRun ?? false,
+        };
+    }
+    get dataDir() {
+        return this.outDir;
+    }
+}
+//# sourceMappingURL=PlaudExtractor.js.map

package/dist/PlaudExtractor.js.map

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

package/dist/auth/browser-auth.d.ts

@@ -0,0 +1,10 @@
+import type { AuthSession } from './types.js';
+export interface BrowserAuthOptions {
+    headless?: boolean;
+    email?: string;
+    password?: string;
+    /** How long to wait for the user to log in (ms). Default: 5 minutes. */
+    loginTimeoutMs?: number;
+}
+export declare function runBrowserAuth(opts?: BrowserAuthOptions): Promise<AuthSession>;
+//# sourceMappingURL=browser-auth.d.ts.map

package/dist/auth/browser-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-auth.d.ts","sourceRoot":"","sources":["../../src/auth/browser-auth.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,YAAY,CAAA;AAI1D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,wEAAwE;IACxE,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,wBAAsB,cAAc,CAAC,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,WAAW,CAAC,CA4FxF"}

package/dist/auth/browser-auth.js

@@ -0,0 +1,220 @@
+import { execSync } from 'node:child_process';
+import { chromium } from 'playwright';
+import { AuthError } from '../errors.js';
+import { getLogger } from '../logger.js';
+import { loadCredentials } from './token-store.js';
+import { extractRegionalBaseUrl } from '../client/endpoints.js';
+const PLAUD_APP_URL = 'https://web.plaud.ai';
+export async function runBrowserAuth(opts = {}) {
+    const log = getLogger();
+    const launchOpts = {
+        channel: 'chrome',
+        headless: opts.headless ?? false,
+        args: ['--disable-blink-features=AutomationControlled'],
+    };
+    const browser = await chromium.launch(launchOpts).catch(async (err) => {
+        const msg = String(err);
+        if (msg.includes("Executable doesn't exist") || msg.includes('not found')) {
+            log.warn('System Chrome not found, falling back to Playwright Chromium (Google OAuth may be blocked)');
+            return chromium.launch({ headless: opts.headless ?? false }).catch(err2 => {
+                if (String(err2).includes("Executable doesn't exist")) {
+                    log.info('Installing Playwright Chromium (one-time setup)...');
+                    execSync('npx playwright install chromium', { stdio: 'inherit' });
+                    return chromium.launch({ headless: opts.headless ?? false });
+                }
+                throw err2;
+            });
+        }
+        throw err;
+    });
+    const context = await browser.newContext({ userAgent: undefined });
+    const page = await context.newPage();
+    // Remove webdriver property that Google checks for automation detection
+    await page.addInitScript('Object.defineProperty(navigator, "webdriver", { get: () => undefined })');
+    // Inject existing plaud.ai cookies so we don't need a fresh login if session is still valid
+    await injectExistingCookies(context);
+    try {
+        log.info('Opening Plaud...');
+        // Set up Bearer token capture BEFORE navigation — the SPA fires API calls on load
+        const loginTimeoutMs = opts.loginTimeoutMs ?? 5 * 60_000;
+        const bearerTokenCapture = captureBearerToken(page, loginTimeoutMs, log);
+        await page.goto(PLAUD_APP_URL, { waitUntil: 'domcontentloaded' });
+        // Give SPA time to initialize and run its auth check (may redirect to /login)
+        await page.waitForLoadState('networkidle', { timeout: 10_000 }).catch(() => { });
+        if (opts.email && opts.password) {
+            await automatedLogin(page, opts.email, opts.password);
+        }
+        else if (isLoginUrl(page.url())) {
+            // Not logged in — prompt user and wait
+            console.log('\n──────────────────────────────────────────────────────────');
+            console.log('  Log in to Plaud in the browser window.');
+            console.log('  The browser will close automatically once connected.');
+            console.log(`  (Waiting up to ${Math.round(loginTimeoutMs / 60_000)} minutes)`);
+            console.log('──────────────────────────────────────────────────────────\n');
+        }
+        else {
+            log.info('Already connected — capturing token...');
+        }
+        // Wait for Bearer token from any API request (fires on page load if session is active,
+        // or after login if the user needed to authenticate)
+        const authToken = await bearerTokenCapture;
+        log.info('Bearer token captured — closing browser');
+        const cookies = await context.cookies();
+        // Close browser without blocking — Chrome can take a long time to flush its profile
+        void browser.close().catch(() => { });
+        // Discover the correct regional API base URL (e.g. api-euc1.plaud.ai for EU users)
+        const apiBaseUrl = await discoverApiRegion(authToken);
+        log.info({ apiBaseUrl }, 'Regional API base URL discovered');
+        return {
+            cookies: cookies.map(c => ({
+                name: c.name,
+                value: c.value,
+                domain: c.domain,
+                path: c.path,
+                httpOnly: c.httpOnly,
+                secure: c.secure,
+                sameSite: c.sameSite,
+                expires: c.expires && c.expires > 0 ? c.expires : undefined,
+            })),
+            authToken,
+            apiBaseUrl,
+            capturedAt: new Date().toISOString(),
+            endpointMap: buildEndpointMap(apiBaseUrl),
+        };
+    }
+    catch (err) {
+        await browser.close().catch(() => { });
+        throw err;
+    }
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+/**
+ * Inject plaud.ai cookies from the previous auth session so the browser picks up
+ * an existing session without requiring the user to log in again.
+ */
+async function injectExistingCookies(context) {
+    const log = getLogger();
+    const existing = await loadCredentials().catch(() => null);
+    if (!existing?.cookies?.length)
+        return;
+    const plaudCookies = existing.cookies.filter(c => c.domain === 'web.plaud.ai' || c.domain.endsWith('.plaud.ai') || c.domain === 'plaud.ai');
+    if (plaudCookies.length === 0)
+        return;
+    try {
+        await context.addCookies(plaudCookies.map(c => ({
+            name: c.name,
+            value: c.value,
+            domain: c.domain,
+            path: c.path,
+            httpOnly: c.httpOnly,
+            secure: c.secure,
+            sameSite: (c.sameSite ?? 'Lax'),
+            expires: c.expires ?? -1,
+        })));
+        log.debug({ count: plaudCookies.length }, 'Injected existing session cookies');
+    }
+    catch (err) {
+        log.debug({ err }, 'Could not inject existing cookies — fresh login required');
+    }
+}
+/**
+ * Wait for the first API request that carries a Bearer token.
+ * This fires automatically when:
+ *   - The page loads with an existing authenticated session (cookies restored)
+ *   - The user completes login via Google OAuth or email
+ *
+ * Resolves with the raw token string (without "bearer " prefix).
+ */
+function captureBearerToken(page, timeoutMs, log) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            page.off('request', handler);
+            reject(new AuthError(`Login timeout after ${Math.round(timeoutMs / 60_000)} minutes — no token captured`));
+        }, timeoutMs);
+        const handler = (req) => {
+            const auth = req.headers()['authorization'] ?? req.headers()['Authorization'];
+            if (!auth)
+                return;
+            const token = auth.replace(/^bearer\s+/i, '').trim();
+            // Basic sanity check: JWT has 3 parts separated by dots
+            if (token.split('.').length === 3) {
+                clearTimeout(timer);
+                page.off('request', handler);
+                log.debug({ url: req.url() }, 'Bearer token found in request');
+                resolve(token);
+            }
+        };
+        page.on('request', handler);
+    });
+}
+/** Discover the correct regional API base URL (e.g. https://api-euc1.plaud.ai). */
+async function discoverApiRegion(token) {
+    const log = getLogger();
+    try {
+        // The global endpoint returns a region-redirect response pointing to the right server
+        const res = await fetch('https://api.plaud.ai/user/me', {
+            headers: {
+                'Authorization': `bearer ${token}`,
+                'app-platform': 'web',
+                'Origin': 'https://web.plaud.ai',
+            },
+        });
+        const body = await res.json();
+        const regional = extractRegionalBaseUrl(body);
+        if (regional)
+            return regional;
+        // If the global endpoint returns user data directly (no redirect), it IS the right base
+        if (body?.data_user)
+            return 'https://api.plaud.ai';
+    }
+    catch (err) {
+        log.debug({ err }, 'Region discovery failed — using global API');
+    }
+    return 'https://api.plaud.ai';
+}
+/** Build the complete endpoint map from the known regional API base URL. */
+function buildEndpointMap(apiBaseUrl) {
+    return {
+        listRecordings: `${apiBaseUrl}/file/simple/web`,
+        batchDetail: `${apiBaseUrl}/file/list`,
+        getAudioUrl: `${apiBaseUrl}/file/temp-url`,
+        userProfile: `${apiBaseUrl}/user/me`,
+        apiBaseUrl,
+    };
+}
+function isLoginUrl(url) {
+    try {
+        const p = new URL(url).pathname;
+        return p.startsWith('/login') || p.startsWith('/signin') || p.startsWith('/auth');
+    }
+    catch {
+        return false;
+    }
+}
+async function automatedLogin(page, email, password) {
+    const log = getLogger();
+    log.info('Attempting automated login...');
+    const emailSelectors = [
+        'input[type="email"]', 'input[name="email"]',
+        'input[name="username"]', '[data-testid="email"]', '#email',
+    ];
+    const passwordSelectors = [
+        'input[type="password"]', 'input[name="password"]',
+        '[data-testid="password"]', '#password',
+    ];
+    for (const sel of emailSelectors) {
+        if (await page.locator(sel).count() > 0) {
+            await page.fill(sel, email);
+            break;
+        }
+    }
+    for (const sel of passwordSelectors) {
+        if (await page.locator(sel).count() > 0) {
+            await page.fill(sel, password);
+            break;
+        }
+    }
+    await page.click('button[type="submit"], [type="submit"], button:has-text("Login"), button:has-text("Sign in")');
+    await page.waitForLoadState('networkidle', { timeout: 15_000 }).catch(() => undefined);
+}
+//# sourceMappingURL=browser-auth.js.map

package/dist/auth/browser-auth.js.map

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

package/dist/auth/token-store.d.ts

@@ -0,0 +1,9 @@
+import { authTokenPath } from '../storage/paths.js';
+import { type AuthSession, type StoredCredentials } from './types.js';
+export declare function loadCredentials(): Promise<StoredCredentials | null>;
+export declare function saveCredentials(session: AuthSession): Promise<void>;
+/** Returns true if the stored credentials are expired. */
+export declare function isExpired(creds: StoredCredentials): boolean;
+export declare function cookieHeader(creds: StoredCredentials): string;
+export { authTokenPath };
+//# sourceMappingURL=token-store.d.ts.map

package/dist/auth/token-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-store.d.ts","sourceRoot":"","sources":["../../src/auth/token-store.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAA2B,KAAK,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAI9F,wBAAsB,eAAe,IAAI,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAgBzE;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAKzE;AAED,0DAA0D;AAC1D,wBAAgB,SAAS,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CA2B3D;AAeD,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAE7D;AAED,OAAO,EAAE,aAAa,EAAE,CAAA"}

package/dist/auth/token-store.js

@@ -0,0 +1,74 @@
+import fs from 'node:fs/promises';
+import { authTokenPath } from '../storage/paths.js';
+import { StoredCredentialsSchema } from './types.js';
+import { writeFileAtomic } from '../storage/atomic.js';
+import { getLogger } from '../logger.js';
+export async function loadCredentials() {
+    const tokenPath = authTokenPath();
+    try {
+        const raw = await fs.readFile(tokenPath, 'utf8');
+        const json = JSON.parse(raw);
+        const result = StoredCredentialsSchema.safeParse(json);
+        if (!result.success) {
+            getLogger().warn({ issues: result.error.issues }, 'Stored credentials failed schema validation — re-authenticate');
+            return null;
+        }
+        return result.data;
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return null;
+        getLogger().warn({ err }, 'Failed to read credentials file');
+        return null;
+    }
+}
+export async function saveCredentials(session) {
+    const tokenPath = authTokenPath();
+    const stored = { ...session, schemaVersion: 1 };
+    await writeFileAtomic(tokenPath, JSON.stringify(stored, null, 2));
+    getLogger().info({ path: tokenPath }, 'Auth credentials saved');
+}
+/** Returns true if the stored credentials are expired. */
+export function isExpired(creds) {
+    const now = Date.now();
+    // Explicit expiresAt takes precedence
+    if (creds.expiresAt) {
+        return now > new Date(creds.expiresAt).getTime();
+    }
+    // If we have a JWT bearer token, decode the exp claim (most reliable)
+    if (creds.authToken) {
+        const jwtExp = decodeJwtExp(creds.authToken);
+        if (jwtExp !== null)
+            return now > jwtExp * 1000;
+    }
+    // Fallback: check only plaud.ai session cookies (ignore analytics/CDN cookies
+    // which have short TTLs and would cause false "expired" readings)
+    const plaudCookies = creds.cookies.filter(c => c.expires && c.expires > 0 && (c.domain.endsWith('.plaud.ai') || c.domain === 'plaud.ai'));
+    if (plaudCookies.length > 0) {
+        const minExpiry = Math.min(...plaudCookies.map(c => (c.expires ?? 0) * 1000));
+        if (minExpiry > 0 && now > minExpiry)
+            return true;
+    }
+    // Last resort: treat as expired after 30 days
+    const capturedAt = new Date(creds.capturedAt).getTime();
+    return now - capturedAt > 30 * 24 * 60 * 60 * 1000;
+}
+/** Decode the `exp` claim from a JWT (no signature verification — just decode). */
+function decodeJwtExp(token) {
+    try {
+        const parts = token.split('.');
+        if (parts.length !== 3)
+            return null;
+        const payload = JSON.parse(Buffer.from(parts[1], 'base64url').toString('utf8'));
+        const exp = payload['exp'];
+        return typeof exp === 'number' ? exp : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function cookieHeader(creds) {
+    return creds.cookies.map(c => `${c.name}=${c.value}`).join('; ');
+}
+export { authTokenPath };
+//# sourceMappingURL=token-store.js.map

package/dist/auth/token-store.js.map

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