@alta-foundation/plaud-extractor 1.0.0

package/dist/sync/incremental.js

@@ -0,0 +1,96 @@
+import fs from 'node:fs/promises';
+import crypto from 'node:crypto';
+import { syncStatePath } from '../storage/paths.js';
+import { writeFileAtomic } from '../storage/atomic.js';
+import { SyncStateSchema } from './types.js';
+import { getLogger } from '../logger.js';
+export class IncrementalTracker {
+    state = {
+        schemaVersion: 1,
+        recordings: {},
+    };
+    async load(outDir) {
+        const filePath = syncStatePath(outDir);
+        try {
+            const raw = await fs.readFile(filePath, 'utf8');
+            const json = JSON.parse(raw);
+            const result = SyncStateSchema.safeParse(json);
+            if (result.success) {
+                this.state = result.data;
+                getLogger().debug({ recordingCount: Object.keys(this.state.recordings).length }, 'Loaded sync state');
+            }
+            else {
+                getLogger().warn({ issues: result.error.issues }, 'Sync state schema invalid — starting fresh');
+            }
+        }
+        catch (err) {
+            if (err.code !== 'ENOENT') {
+                getLogger().warn({ err }, 'Failed to read sync state — starting fresh');
+            }
+        }
+    }
+    async persist(outDir) {
+        this.state.lastAttemptAt = new Date().toISOString();
+        await writeFileAtomic(syncStatePath(outDir), JSON.stringify(this.state, null, 2));
+    }
+    markSuccessfulSync() {
+        this.state.lastSuccessfulSyncAt = new Date().toISOString();
+    }
+    getSince() {
+        if (!this.state.lastSuccessfulSyncAt)
+            return undefined;
+        return new Date(this.state.lastSuccessfulSyncAt);
+    }
+    needsDownload(recording) {
+        const existing = this.state.recordings[recording.id];
+        if (!existing)
+            return true;
+        const newHash = this.computeContentHash(recording);
+        if (existing.contentHash !== newHash)
+            return true;
+        // Re-download if key files are missing
+        if (!existing.hasTranscript && recording.hasTranscript)
+            return true;
+        if (!existing.downloadedAt)
+            return true;
+        return false;
+    }
+    computeContentHash(recording) {
+        const key = JSON.stringify({
+            id: recording.id,
+            updatedAt: recording.updatedAt,
+            hasTranscript: recording.hasTranscript,
+            transcriptStatus: recording.transcriptStatus,
+            duration: recording.duration,
+            title: recording.title,
+        });
+        return crypto.createHash('sha256').update(key).digest('hex').slice(0, 16);
+    }
+    markComplete(recordingId, recordedAt, opts) {
+        this.state.recordings[recordingId] = {
+            recordedAt,
+            contentHash: opts.contentHash,
+            downloadedAt: new Date().toISOString(),
+            hasAudio: opts.hasAudio,
+            hasTranscript: opts.hasTranscript,
+            verified: false,
+        };
+    }
+    markVerified(recordingId) {
+        const existing = this.state.recordings[recordingId];
+        if (existing) {
+            existing.verified = true;
+            existing.verifiedAt = new Date().toISOString();
+        }
+    }
+    getRecordingState(recordingId) {
+        return this.state.recordings[recordingId];
+    }
+    getAllRecordingIds() {
+        return Object.keys(this.state.recordings);
+    }
+    get lastSuccessfulSyncAt() {
+        return this.state.lastSuccessfulSyncAt;
+    }
+}
+//# sourceMappingURL=incremental.js.map

package/dist/sync/incremental.js.map

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

package/dist/sync/sync-engine.d.ts

@@ -0,0 +1,6 @@
+import type { SyncOptions, SyncResult } from './types.js';
+import type { PlaudClient } from '../client/types.js';
+export declare class SyncEngine {
+    run(client: PlaudClient, opts: SyncOptions, mode?: 'sync' | 'backfill'): Promise<SyncResult>;
+}
+//# sourceMappingURL=sync-engine.d.ts.map

package/dist/sync/sync-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-engine.d.ts","sourceRoot":"","sources":["../../src/sync/sync-engine.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAmB,MAAM,YAAY,CAAA;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAkB,MAAM,oBAAoB,CAAA;AAGrE,qBAAa,UAAU;IACf,GAAG,CACP,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,WAAW,EACjB,IAAI,GAAE,MAAM,GAAG,UAAmB,GACjC,OAAO,CAAC,UAAU,CAAC;CA4GvB"}

package/dist/sync/sync-engine.js

@@ -0,0 +1,135 @@
+import { AuthError } from '../errors.js';
+import { getLogger } from '../logger.js';
+import { IncrementalTracker } from './incremental.js';
+import { processQueue, retryWithBackoff } from './download-queue.js';
+import { RecordingStore } from '../storage/recording-store.js';
+import { DatasetWriter } from '../storage/dataset-writer.js';
+export class SyncEngine {
+    async run(client, opts, mode = 'sync') {
+        const log = getLogger();
+        const startedAt = Date.now();
+        // 1. Verify auth
+        const authed = await client.isAuthenticated();
+        if (!authed) {
+            throw new AuthError("Not authenticated — run 'alta-plaud auth' first");
+        }
+        // 2. Load sync state
+        const tracker = new IncrementalTracker();
+        await tracker.load(opts.outDir);
+        // 3. Determine effective --since
+        const since = opts.since ?? (mode === 'sync' ? tracker.getSince() : undefined);
+        log.info({ mode, since: since?.toISOString(), outDir: opts.outDir }, 'Starting sync');
+        // 4. Collect recordings to process
+        const toProcess = [];
+        const skipped = [];
+        let listCount = 0;
+        for await (const recording of client.listRecordings({ since, limit: opts.limit })) {
+            listCount++;
+            if (mode === 'sync' && !tracker.needsDownload(recording)) {
+                skipped.push(recording);
+            }
+            else {
+                toProcess.push(recording);
+            }
+            if (opts.limit && toProcess.length >= opts.limit)
+                break;
+        }
+        log.info({ total: listCount, toProcess: toProcess.length, skipped: skipped.length }, 'Recordings collected');
+        // 5. Dry run — just print plan
+        if (opts.dryRun) {
+            for (const rec of toProcess) {
+                log.info({ id: rec.id, title: rec.title, recordedAt: rec.recordedAt }, '[dry-run] Would download');
+            }
+            return {
+                mode,
+                attempted: 0,
+                succeeded: 0,
+                failed: 0,
+                skipped: skipped.length,
+                durationMs: Date.now() - startedAt,
+                errors: [],
+            };
+        }
+        // 6. Initialize storage
+        const store = new RecordingStore(opts.outDir);
+        const dataset = opts.includeDataset ? new DatasetWriter(opts.outDir) : null;
+        if (dataset)
+            await dataset.open();
+        // 7. Run download queue
+        const errors = [];
+        const httpClient = getHttpClient(client);
+        const { succeeded, failed } = await processQueue(toProcess, async (recording) => {
+            await retryWithBackoff(() => downloadRecording(recording, client, store, dataset, tracker, httpClient, opts), { label: `recording:${recording.id}` });
+        }, opts.concurrency);
+        for (const { item, error } of failed) {
+            errors.push({ recordingId: item.id, error });
+            log.error({ recordingId: item.id, err: error }, 'Failed to download recording');
+        }
+        // 8. Mark successful sync only if zero failures
+        if (errors.length === 0) {
+            tracker.markSuccessfulSync();
+        }
+        // 9. Persist state
+        await tracker.persist(opts.outDir);
+        if (dataset)
+            await dataset.close();
+        const result = {
+            mode,
+            attempted: toProcess.length,
+            succeeded: succeeded.length,
+            failed: failed.length,
+            skipped: skipped.length,
+            durationMs: Date.now() - startedAt,
+            errors,
+            datasetPath: dataset?.path,
+        };
+        log.info(result, 'Sync complete');
+        return result;
+    }
+}
+async function downloadRecording(recording, client, store, dataset, tracker, httpClient, opts) {
+    const log = getLogger();
+    log.info({ recordingId: recording.id, title: recording.title }, 'Downloading recording');
+    // a. Write metadata
+    await store.writeMetadata(recording);
+    // b. Download transcript
+    let hasTranscript = false;
+    if (recording.hasTranscript) {
+        try {
+            const transcript = await client.getTranscript(recording.id);
+            await store.writeTranscript(recording, transcript, opts.formats);
+            if (dataset) {
+                await dataset.append(opts.outDir, recording, transcript);
+            }
+            hasTranscript = true;
+        }
+        catch (err) {
+            log.warn({ recordingId: recording.id, err }, 'Failed to get transcript');
+        }
+    }
+    // c. Download audio
+    let hasAudio = false;
+    if (httpClient) {
+        const audioUrl = await client.getAudioDownloadUrl(recording.id);
+        if (audioUrl) {
+            hasAudio = await store.writeAudioFromUrl(recording, audioUrl, httpClient);
+        }
+    }
+    // d. Write checksums
+    await store.writeChecksums(recording);
+    // e. Mark complete in state
+    tracker.markComplete(recording.id, recording.recordedAt, {
+        hasAudio,
+        hasTranscript,
+        contentHash: tracker.computeContentHash(recording),
+    });
+}
+/** Extract HttpClient from PlaudApiClient for audio downloads */
+function getHttpClient(client) {
+    // PlaudApiClient exposes getHttpClient()
+    if ('getHttpClient' in client && typeof client.getHttpClient === 'function') {
+        return client.getHttpClient();
+    }
+    return null;
+}
+//# sourceMappingURL=sync-engine.js.map

package/dist/sync/sync-engine.js.map

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

package/dist/sync/types.d.ts

@@ -0,0 +1,130 @@
+import { z } from 'zod';
+import type { TranscriptFormat } from '../storage/recording-store.js';
+export declare const RecordingStateSchema: z.ZodObject<{
+    recordedAt: z.ZodString;
+    contentHash: z.ZodOptional<z.ZodString>;
+    downloadedAt: z.ZodOptional<z.ZodString>;
+    hasAudio: z.ZodDefault<z.ZodBoolean>;
+    hasTranscript: z.ZodDefault<z.ZodBoolean>;
+    verified: z.ZodDefault<z.ZodBoolean>;
+    verifiedAt: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    recordedAt: string;
+    hasTranscript: boolean;
+    hasAudio: boolean;
+    verified: boolean;
+    contentHash?: string | undefined;
+    downloadedAt?: string | undefined;
+    verifiedAt?: string | undefined;
+}, {
+    recordedAt: string;
+    hasTranscript?: boolean | undefined;
+    contentHash?: string | undefined;
+    downloadedAt?: string | undefined;
+    hasAudio?: boolean | undefined;
+    verified?: boolean | undefined;
+    verifiedAt?: string | undefined;
+}>;
+export type RecordingState = z.infer<typeof RecordingStateSchema>;
+export declare const SyncStateSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    lastSuccessfulSyncAt: z.ZodOptional<z.ZodString>;
+    lastAttemptAt: z.ZodOptional<z.ZodString>;
+    recordings: z.ZodRecord<z.ZodString, z.ZodObject<{
+        recordedAt: z.ZodString;
+        contentHash: z.ZodOptional<z.ZodString>;
+        downloadedAt: z.ZodOptional<z.ZodString>;
+        hasAudio: z.ZodDefault<z.ZodBoolean>;
+        hasTranscript: z.ZodDefault<z.ZodBoolean>;
+        verified: z.ZodDefault<z.ZodBoolean>;
+        verifiedAt: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        recordedAt: string;
+        hasTranscript: boolean;
+        hasAudio: boolean;
+        verified: boolean;
+        contentHash?: string | undefined;
+        downloadedAt?: string | undefined;
+        verifiedAt?: string | undefined;
+    }, {
+        recordedAt: string;
+        hasTranscript?: boolean | undefined;
+        contentHash?: string | undefined;
+        downloadedAt?: string | undefined;
+        hasAudio?: boolean | undefined;
+        verified?: boolean | undefined;
+        verifiedAt?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    recordings: Record<string, {
+        recordedAt: string;
+        hasTranscript: boolean;
+        hasAudio: boolean;
+        verified: boolean;
+        contentHash?: string | undefined;
+        downloadedAt?: string | undefined;
+        verifiedAt?: string | undefined;
+    }>;
+    schemaVersion: 1;
+    lastSuccessfulSyncAt?: string | undefined;
+    lastAttemptAt?: string | undefined;
+}, {
+    recordings: Record<string, {
+        recordedAt: string;
+        hasTranscript?: boolean | undefined;
+        contentHash?: string | undefined;
+        downloadedAt?: string | undefined;
+        hasAudio?: boolean | undefined;
+        verified?: boolean | undefined;
+        verifiedAt?: string | undefined;
+    }>;
+    schemaVersion: 1;
+    lastSuccessfulSyncAt?: string | undefined;
+    lastAttemptAt?: string | undefined;
+}>;
+export type SyncState = z.infer<typeof SyncStateSchema>;
+export interface SyncOptions {
+    /** Output directory root */
+    outDir: string;
+    /** Only sync recordings after this date */
+    since?: Date;
+    /** Max number of recordings to process */
+    limit?: number;
+    /** Parallel downloads (default: 3) */
+    concurrency: number;
+    /** Transcript formats to write */
+    formats: TranscriptFormat[];
+    /** Append to JSONL dataset */
+    includeDataset: boolean;
+    /** Print plan without downloading */
+    dryRun: boolean;
+}
+export interface BackfillOptions extends Omit<SyncOptions, 'since'> {
+    /** Backfill from a specific date; defaults to all-time */
+    since?: Date;
+}
+export interface SyncResult {
+    mode: 'sync' | 'backfill';
+    attempted: number;
+    succeeded: number;
+    failed: number;
+    skipped: number;
+    durationMs: number;
+    errors: Array<{
+        recordingId: string;
+        error: Error;
+    }>;
+    datasetPath?: string;
+}
+export interface VerifyResult {
+    scanned: number;
+    ok: number;
+    failed: number;
+    repaired: number;
+    issues: Array<{
+        recordingId: string;
+        file: string;
+        issue: string;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/sync/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/sync/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAA;AAErE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;EAQ/B,CAAA;AAEF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEjE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAK1B,CAAA;AAEF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAEvD,MAAM,WAAW,WAAW;IAC1B,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,2CAA2C;IAC3C,KAAK,CAAC,EAAE,IAAI,CAAA;IACZ,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAA;IACnB,kCAAkC;IAClC,OAAO,EAAE,gBAAgB,EAAE,CAAA;IAC3B,8BAA8B;IAC9B,cAAc,EAAE,OAAO,CAAA;IACvB,qCAAqC;IACrC,MAAM,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC;IACjE,0DAA0D;IAC1D,KAAK,CAAC,EAAE,IAAI,CAAA;CACb;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,GAAG,UAAU,CAAA;IACzB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC,CAAA;IACpD,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACpE"}

package/dist/sync/types.js

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+export const RecordingStateSchema = z.object({
+    recordedAt: z.string().datetime(),
+    contentHash: z.string().optional(),
+    downloadedAt: z.string().datetime().optional(),
+    hasAudio: z.boolean().default(false),
+    hasTranscript: z.boolean().default(false),
+    verified: z.boolean().default(false),
+    verifiedAt: z.string().datetime().optional(),
+});
+export const SyncStateSchema = z.object({
+    schemaVersion: z.literal(1),
+    lastSuccessfulSyncAt: z.string().datetime().optional(),
+    lastAttemptAt: z.string().datetime().optional(),
+    recordings: z.record(z.string(), RecordingStateSchema),
+});
+//# sourceMappingURL=types.js.map

package/dist/sync/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sync/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC9C,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACpC,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACzC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACpC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAC7C,CAAC,CAAA;AAIF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3B,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACtD,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC/C,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,oBAAoB,CAAC;CACvD,CAAC,CAAA"}

package/dist/transcript/formatter.d.ts

@@ -0,0 +1,4 @@
+import type { PlaudTranscript, PlaudRecording } from '../client/types.js';
+export declare function toPlainText(transcript: PlaudTranscript): string;
+export declare function toMarkdown(transcript: PlaudTranscript, recording: PlaudRecording): string;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/transcript/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../src/transcript/formatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAEzE,wBAAgB,WAAW,CAAC,UAAU,EAAE,eAAe,GAAG,MAAM,CAO/D;AAED,wBAAgB,UAAU,CAAC,UAAU,EAAE,eAAe,EAAE,SAAS,EAAE,cAAc,GAAG,MAAM,CA2CzF"}

package/dist/transcript/formatter.js

@@ -0,0 +1,88 @@
+export function toPlainText(transcript) {
+    return transcript.segments
+        .map(seg => {
+        const speaker = seg.speaker ? `${seg.speaker}: ` : '';
+        return `${speaker}${seg.text}`;
+    })
+        .join('\n\n');
+}
+export function toMarkdown(transcript, recording) {
+    const lines = [];
+    // YAML frontmatter
+    lines.push('---');
+    lines.push('source: plaud');
+    lines.push(`id: "${recording.id}"`);
+    lines.push(`recorded_at: "${recording.recordedAt}"`);
+    if (recording.title)
+        lines.push(`title: "${recording.title.replace(/"/g, '\\"')}"`);
+    if (recording.language)
+        lines.push(`language: "${recording.language}"`);
+    lines.push(`duration_seconds: ${recording.duration}`);
+    if (recording.tags?.length)
+        lines.push(`tags: [${recording.tags.map(t => `"${t}"`).join(', ')}]`);
+    lines.push('---');
+    lines.push('');
+    // Title
+    lines.push(`# ${recording.title ?? 'Untitled Recording'}`);
+    lines.push('');
+    // Metadata block
+    lines.push(`**Recorded:** ${formatDate(recording.recordedAt)}`);
+    lines.push(`**Duration:** ${formatDuration(recording.duration)}`);
+    if (recording.language)
+        lines.push(`**Language:** ${recording.language}`);
+    lines.push('');
+    lines.push('## Transcript');
+    lines.push('');
+    // Segments
+    const hasTimestamps = transcript.segments.some(s => s.startMs > 0 || s.endMs > 0);
+    for (const seg of transcript.segments) {
+        if (hasTimestamps) {
+            const ts = `\`[${msToTimestamp(seg.startMs)}]\``;
+            const speaker = seg.speaker ? ` **${seg.speaker}**` : '';
+            lines.push(`${ts}${speaker}`);
+        }
+        else if (seg.speaker) {
+            lines.push(`**${seg.speaker}**`);
+        }
+        lines.push(seg.text);
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+function msToTimestamp(ms) {
+    const totalSeconds = Math.floor(ms / 1000);
+    const h = Math.floor(totalSeconds / 3600);
+    const m = Math.floor((totalSeconds % 3600) / 60);
+    const s = totalSeconds % 60;
+    if (h > 0) {
+        return `${h}:${String(m).padStart(2, '0')}:${String(s).padStart(2, '0')}`;
+    }
+    return `${m}:${String(s).padStart(2, '0')}`;
+}
+function formatDuration(seconds) {
+    const h = Math.floor(seconds / 3600);
+    const m = Math.floor((seconds % 3600) / 60);
+    const s = Math.floor(seconds % 60);
+    if (h > 0)
+        return `${h}h ${m}m ${s}s`;
+    if (m > 0)
+        return `${m}m ${s}s`;
+    return `${s}s`;
+}
+function formatDate(iso) {
+    try {
+        return new Date(iso).toLocaleString('en-US', {
+            weekday: 'long',
+            year: 'numeric',
+            month: 'long',
+            day: 'numeric',
+            hour: '2-digit',
+            minute: '2-digit',
+            timeZoneName: 'short',
+        });
+    }
+    catch {
+        return iso;
+    }
+}
+//# sourceMappingURL=formatter.js.map

package/dist/transcript/formatter.js.map

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

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@alta-foundation/plaud-extractor",
+  "version": "1.0.0",
+  "description": "Export recordings, transcripts, and metadata from Plaud — SDK + CLI",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "bin": {
+    "alta-plaud": "./dist/cli/bin.js",
+    "alta-plaud-mcp": "./dist/mcp/server.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "commander": "^12.1.0",
+    "pino": "^9.5.0",
+    "pino-pretty": "^11.3.0",
+    "playwright": "^1.49.0",
+    "undici": "^6.21.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsx src/cli/bin.ts",
+    "dev:mcp": "tsx src/mcp/server.ts",
+    "typecheck": "tsc --noEmit"
+  }
+}