@alta-foundation/plaud-extractor 1.0.0

package/dist/storage/atomic.js

@@ -0,0 +1,51 @@
+import fs from 'node:fs/promises';
+import { createWriteStream } from 'node:fs';
+import path from 'node:path';
+import crypto from 'node:crypto';
+import { StorageError } from '../errors.js';
+/** Write a file atomically: write to .tmp-<rand>, then rename. */
+export async function writeFileAtomic(filePath, data) {
+    const tmpPath = `${filePath}.tmp-${crypto.randomBytes(4).toString('hex')}`;
+    try {
+        await fs.mkdir(path.dirname(filePath), { recursive: true });
+        await fs.writeFile(tmpPath, data, { encoding: typeof data === 'string' ? 'utf8' : undefined });
+        await fs.rename(tmpPath, filePath);
+    }
+    catch (err) {
+        // Clean up tmp file on failure
+        await fs.unlink(tmpPath).catch(() => undefined);
+        throw new StorageError(`Failed to write ${filePath}`, filePath, err);
+    }
+}
+/** Stream a ReadableStream to a file atomically. */
+export async function writeStreamAtomic(filePath, stream) {
+    const tmpPath = `${filePath}.tmp-${crypto.randomBytes(4).toString('hex')}`;
+    try {
+        await fs.mkdir(path.dirname(filePath), { recursive: true });
+        await new Promise((resolve, reject) => {
+            const out = createWriteStream(tmpPath);
+            out.on('finish', resolve);
+            out.on('error', reject);
+            if (Symbol.asyncIterator in stream) {
+                ;
+                (async () => {
+                    for await (const chunk of stream) {
+                        out.write(chunk);
+                    }
+                    out.end();
+                })().catch(reject);
+            }
+            else {
+                ;
+                stream.pipe(out);
+                stream.on('error', reject);
+            }
+        });
+        await fs.rename(tmpPath, filePath);
+    }
+    catch (err) {
+        await fs.unlink(tmpPath).catch(() => undefined);
+        throw new StorageError(`Failed to write stream to ${filePath}`, filePath, err);
+    }
+}
+//# sourceMappingURL=atomic.js.map

package/dist/storage/atomic.js.map

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

package/dist/storage/checksums.d.ts

@@ -0,0 +1,15 @@
+import { ChecksumMismatchError } from '../errors.js';
+export interface FileChecksum {
+    sha256: string;
+    sizeBytes: number;
+}
+export interface ChecksumManifest {
+    schemaVersion: 1;
+    recordingId: string;
+    computedAt: string;
+    files: Record<string, FileChecksum>;
+}
+export declare function sha256File(filePath: string): Promise<string>;
+export declare function writeChecksumManifest(dir: string, recordingId: string): Promise<ChecksumManifest>;
+export declare function verifyChecksums(dir: string): Promise<ChecksumMismatchError[]>;
+//# sourceMappingURL=checksums.d.ts.map

package/dist/storage/checksums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checksums.d.ts","sourceRoot":"","sources":["../../src/storage/checksums.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AAEpD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,CAAC,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;CACpC;AAED,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGlE;AAED,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,gBAAgB,CAAC,CAqB3B;AAED,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC,CA0BnF"}

package/dist/storage/checksums.js

@@ -0,0 +1,56 @@
+import crypto from 'node:crypto';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { writeFileAtomic } from './atomic.js';
+import { ChecksumMismatchError } from '../errors.js';
+export async function sha256File(filePath) {
+    const data = await fs.readFile(filePath);
+    return crypto.createHash('sha256').update(data).digest('hex');
+}
+export async function writeChecksumManifest(dir, recordingId) {
+    const files = await fs.readdir(dir);
+    const manifest = {
+        schemaVersion: 1,
+        recordingId,
+        computedAt: new Date().toISOString(),
+        files: {},
+    };
+    for (const file of files.filter(f => f !== 'checksums.json')) {
+        const fPath = path.join(dir, file);
+        const stat = await fs.stat(fPath);
+        if (!stat.isFile())
+            continue;
+        manifest.files[file] = {
+            sha256: await sha256File(fPath),
+            sizeBytes: stat.size,
+        };
+    }
+    await writeFileAtomic(path.join(dir, 'checksums.json'), JSON.stringify(manifest, null, 2));
+    return manifest;
+}
+export async function verifyChecksums(dir) {
+    const manifestPath = path.join(dir, 'checksums.json');
+    let manifest;
+    try {
+        const raw = await fs.readFile(manifestPath, 'utf8');
+        manifest = JSON.parse(raw);
+    }
+    catch {
+        return []; // No manifest yet — skip verification
+    }
+    const mismatches = [];
+    for (const [file, expected] of Object.entries(manifest.files)) {
+        const fPath = path.join(dir, file);
+        try {
+            const actual = await sha256File(fPath);
+            if (actual !== expected.sha256) {
+                mismatches.push(new ChecksumMismatchError(fPath, expected.sha256, actual));
+            }
+        }
+        catch {
+            mismatches.push(new ChecksumMismatchError(fPath, expected.sha256, 'MISSING'));
+        }
+    }
+    return mismatches;
+}
+//# sourceMappingURL=checksums.js.map

package/dist/storage/checksums.js.map

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

package/dist/storage/dataset-writer.d.ts

@@ -0,0 +1,21 @@
+import type { PlaudRecording, PlaudTranscript } from '../client/types.js';
+export interface DatasetEntry {
+    id: string;
+    title: string | null;
+    recorded_at: string;
+    duration_seconds: number;
+    language: string | null;
+    text: string;
+    path: string;
+    segment_count: number;
+}
+export declare class DatasetWriter {
+    private readonly filePath;
+    private stream;
+    constructor(outDir: string);
+    open(): Promise<void>;
+    append(outDir: string, recording: PlaudRecording, transcript: PlaudTranscript): Promise<void>;
+    close(): Promise<void>;
+    get path(): string;
+}
+//# sourceMappingURL=dataset-writer.d.ts.map

package/dist/storage/dataset-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataset-writer.d.ts","sourceRoot":"","sources":["../../src/storage/dataset-writer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAGzE,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,gBAAgB,EAAE,MAAM,CAAA;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,EAAE,MAAM,CAAA;CACtB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;IACjC,OAAO,CAAC,MAAM,CAA2B;gBAE7B,MAAM,EAAE,MAAM;IAIpB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IASrB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,UAAU,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B7F,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/storage/dataset-writer.js

@@ -0,0 +1,52 @@
+import fs from 'node:fs/promises';
+import { createWriteStream } from 'node:fs';
+import path from 'node:path';
+import { datasetPath, recordingDir } from './paths.js';
+import { StorageError } from '../errors.js';
+export class DatasetWriter {
+    filePath;
+    stream = null;
+    constructor(outDir) {
+        this.filePath = datasetPath(outDir);
+    }
+    async open() {
+        await fs.mkdir(path.dirname(this.filePath), { recursive: true });
+        this.stream = createWriteStream(this.filePath, { flags: 'a', encoding: 'utf8' });
+        await new Promise((resolve, reject) => {
+            this.stream.once('open', () => resolve());
+            this.stream.once('error', reject);
+        });
+    }
+    async append(outDir, recording, transcript) {
+        if (!this.stream)
+            throw new StorageError('DatasetWriter not opened', this.filePath);
+        const relPath = path.relative(outDir, path.join(recordingDir(outDir, recording.recordedAt, recording.id), 'transcript.txt'));
+        const entry = {
+            id: `plaud:${recording.id}`,
+            title: recording.title ?? null,
+            recorded_at: recording.recordedAt,
+            duration_seconds: recording.duration,
+            language: recording.language ?? null,
+            text: transcript.fullText,
+            path: relPath,
+            segment_count: transcript.segments.length,
+        };
+        const line = JSON.stringify(entry) + '\n';
+        await new Promise((resolve, reject) => {
+            this.stream.write(line, err => (err ? reject(err) : resolve()));
+        });
+    }
+    async close() {
+        if (!this.stream)
+            return;
+        await new Promise((resolve, reject) => {
+            this.stream.end(() => resolve());
+            this.stream.once('error', reject);
+        });
+        this.stream = null;
+    }
+    get path() {
+        return this.filePath;
+    }
+}
+//# sourceMappingURL=dataset-writer.js.map

package/dist/storage/dataset-writer.js.map

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

package/dist/storage/paths.d.ts

@@ -0,0 +1,9 @@
+export declare function defaultOutDir(): string;
+/** plaud/recordings/2026/02/2026-02-24T083012Z__plaud_<id>/ */
+export declare function recordingDir(outDir: string, recordedAt: string, recordingId: string): string;
+export declare function stateDir(outDir: string): string;
+export declare function syncStatePath(outDir: string): string;
+export declare function runLogsPath(outDir: string): string;
+export declare function datasetPath(outDir: string): string;
+export declare function authTokenPath(): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/storage/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/storage/paths.ts"],"names":[],"mappings":"AAGA,wBAAgB,aAAa,IAAI,MAAM,CAItC;AAED,+DAA+D;AAC/D,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAO5F;AAQD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}

package/dist/storage/paths.js

@@ -0,0 +1,38 @@
+import path from 'node:path';
+import os from 'node:os';
+export function defaultOutDir() {
+    const env = process.env['ALTA_DATA_DIR'];
+    if (env)
+        return path.resolve(env);
+    return path.join(os.homedir(), 'alta', 'data', 'plaud');
+}
+/** plaud/recordings/2026/02/2026-02-24T083012Z__plaud_<id>/ */
+export function recordingDir(outDir, recordedAt, recordingId) {
+    const dt = new Date(recordedAt);
+    const year = String(dt.getUTCFullYear());
+    const month = String(dt.getUTCMonth() + 1).padStart(2, '0');
+    const timestamp = formatISOCompact(dt);
+    const dirName = `${timestamp}__plaud_${recordingId}`;
+    return path.join(outDir, 'recordings', year, month, dirName);
+}
+/** Format: 2026-02-24T083012Z */
+function formatISOCompact(dt) {
+    const iso = dt.toISOString(); // 2026-02-24T08:30:12.000Z
+    return iso.replace(/[-:]/g, '').replace(/\.\d{3}/, '').replace('T', 'T').slice(0, 16) + 'Z';
+}
+export function stateDir(outDir) {
+    return path.join(outDir, '_state');
+}
+export function syncStatePath(outDir) {
+    return path.join(stateDir(outDir), 'sync_state.json');
+}
+export function runLogsPath(outDir) {
+    return path.join(stateDir(outDir), 'run_logs.ndjson');
+}
+export function datasetPath(outDir) {
+    return path.join(outDir, 'datasets', 'plaud_transcripts.jsonl');
+}
+export function authTokenPath() {
+    return path.join(os.homedir(), '.alta', 'plaud-auth.json');
+}
+//# sourceMappingURL=paths.js.map

package/dist/storage/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/storage/paths.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,MAAM,SAAS,CAAA;AAExB,MAAM,UAAU,aAAa;IAC3B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAA;IACxC,IAAI,GAAG;QAAE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IACjC,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;AACzD,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,UAAkB,EAAE,WAAmB;IAClF,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,CAAA;IAC/B,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC,cAAc,EAAE,CAAC,CAAA;IACxC,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IAC3D,MAAM,SAAS,GAAG,gBAAgB,CAAC,EAAE,CAAC,CAAA;IACtC,MAAM,OAAO,GAAG,GAAG,SAAS,WAAW,WAAW,EAAE,CAAA;IACpD,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;AAC9D,CAAC;AAED,iCAAiC;AACjC,SAAS,gBAAgB,CAAC,EAAQ;IAChC,MAAM,GAAG,GAAG,EAAE,CAAC,WAAW,EAAE,CAAA,CAAC,2BAA2B;IACxD,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAA;AAC7F,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,MAAc;IACrC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;AACpC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC,CAAA;AACvD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC,CAAA;AACvD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,yBAAyB,CAAC,CAAA;AACjE,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAA;AAC5D,CAAC"}

package/dist/storage/recording-store.d.ts

@@ -0,0 +1,24 @@
+import type { PlaudRecording, PlaudTranscript } from '../client/types.js';
+import type { ChecksumMismatchError } from '../errors.js';
+import type { HttpClient } from '../client/http.js';
+export type TranscriptFormat = 'json' | 'txt' | 'md';
+export interface RecordingWriteResult {
+    dir: string;
+    hasAudio: boolean;
+    hasTranscript: boolean;
+}
+export declare class RecordingStore {
+    private readonly outDir;
+    constructor(outDir: string);
+    recordingDir(recording: PlaudRecording): string;
+    writeMetadata(recording: PlaudRecording): Promise<string>;
+    writeTranscript(recording: PlaudRecording, transcript: PlaudTranscript, formats?: TranscriptFormat[]): Promise<void>;
+    writeAudio(recording: PlaudRecording, http: HttpClient): Promise<boolean>;
+    private getAudioUrl;
+    writeAudioFromUrl(recording: PlaudRecording, url: string, http: HttpClient): Promise<boolean>;
+    writeChecksums(recording: PlaudRecording): Promise<void>;
+    verify(recording: PlaudRecording): Promise<ChecksumMismatchError[]>;
+    exists(recording: PlaudRecording): Promise<boolean>;
+    hasMissingFiles(recording: PlaudRecording): Promise<boolean>;
+}
+//# sourceMappingURL=recording-store.d.ts.map

package/dist/storage/recording-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording-store.d.ts","sourceRoot":"","sources":["../../src/storage/recording-store.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACzE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAGnD,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI,CAAA;AAEpD,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,OAAO,CAAA;IACjB,aAAa,EAAE,OAAO,CAAA;CACvB;AAED,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,MAAM;IAE3C,YAAY,CAAC,SAAS,EAAE,cAAc,GAAG,MAAM;IAIzC,aAAa,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAQzD,eAAe,CACnB,SAAS,EAAE,cAAc,EACzB,UAAU,EAAE,eAAe,EAC3B,OAAO,GAAE,gBAAgB,EAA0B,GAClD,OAAO,CAAC,IAAI,CAAC;IA0BV,UAAU,CAAC,SAAS,EAAE,cAAc,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;YAmBjE,WAAW;IAMnB,iBAAiB,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IAiB7F,cAAc,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAMxD,MAAM,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAKnE,MAAM,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAUnD,eAAe,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;CAYnE"}

package/dist/storage/recording-store.js

@@ -0,0 +1,161 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { writeFileAtomic, writeStreamAtomic } from './atomic.js';
+import { writeChecksumManifest, verifyChecksums } from './checksums.js';
+import { toPlainText, toMarkdown } from '../transcript/formatter.js';
+import { recordingDir } from './paths.js';
+import { getLogger } from '../logger.js';
+export class RecordingStore {
+    outDir;
+    constructor(outDir) {
+        this.outDir = outDir;
+    }
+    recordingDir(recording) {
+        return recordingDir(this.outDir, recording.recordedAt, recording.id);
+    }
+    async writeMetadata(recording) {
+        const dir = this.recordingDir(recording);
+        const meta = buildMetaJson(recording);
+        await writeFileAtomic(path.join(dir, 'meta.json'), JSON.stringify(meta, null, 2));
+        getLogger().debug({ recordingId: recording.id, dir }, 'Wrote meta.json');
+        return dir;
+    }
+    async writeTranscript(recording, transcript, formats = ['json', 'txt', 'md']) {
+        const dir = this.recordingDir(recording);
+        if (formats.includes('json')) {
+            const json = {
+                recordingId: transcript.recordingId,
+                language: transcript.language,
+                duration: transcript.duration,
+                segments: transcript.segments,
+            };
+            await writeFileAtomic(path.join(dir, 'transcript.json'), JSON.stringify(json, null, 2));
+        }
+        if (formats.includes('txt')) {
+            const txt = toPlainText(transcript);
+            await writeFileAtomic(path.join(dir, 'transcript.txt'), txt);
+        }
+        if (formats.includes('md')) {
+            const md = toMarkdown(transcript, recording);
+            await writeFileAtomic(path.join(dir, 'transcript.md'), md);
+        }
+        getLogger().debug({ recordingId: recording.id, formats }, 'Wrote transcript files');
+    }
+    async writeAudio(recording, http) {
+        const url = await this.getAudioUrl(recording, http);
+        if (!url)
+            return false;
+        const dir = this.recordingDir(recording);
+        const ext = guessAudioExtension(recording.mimeType);
+        const destPath = path.join(dir, `audio.${ext}`);
+        try {
+            const stream = await http.getStream(url);
+            await writeStreamAtomic(destPath, stream);
+            getLogger().debug({ recordingId: recording.id, path: destPath }, 'Wrote audio file');
+            return true;
+        }
+        catch (err) {
+            getLogger().warn({ recordingId: recording.id, err }, 'Failed to download audio');
+            return false;
+        }
+    }
+    async getAudioUrl(recording, http) {
+        // This is a stub — the PlaudApiClient resolves the actual URL
+        // RecordingStore receives the already-resolved URL via writeAudioFromUrl
+        return null;
+    }
+    async writeAudioFromUrl(recording, url, http) {
+        const dir = this.recordingDir(recording);
+        const ext = guessAudioExtension(recording.mimeType);
+        const destPath = path.join(dir, `audio.${ext}`);
+        try {
+            // S3 presigned URLs must be fetched without Plaud auth headers
+            const stream = await http.downloadExternalUrl(url);
+            await writeStreamAtomic(destPath, stream);
+            getLogger().debug({ recordingId: recording.id, path: destPath }, 'Wrote audio file');
+            return true;
+        }
+        catch (err) {
+            getLogger().warn({ recordingId: recording.id, err }, 'Failed to download audio');
+            return false;
+        }
+    }
+    async writeChecksums(recording) {
+        const dir = this.recordingDir(recording);
+        await writeChecksumManifest(dir, recording.id);
+        getLogger().debug({ recordingId: recording.id }, 'Wrote checksums.json');
+    }
+    async verify(recording) {
+        const dir = this.recordingDir(recording);
+        return verifyChecksums(dir);
+    }
+    async exists(recording) {
+        const dir = this.recordingDir(recording);
+        try {
+            await fs.access(dir);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async hasMissingFiles(recording) {
+        const dir = this.recordingDir(recording);
+        const required = ['meta.json'];
+        for (const file of required) {
+            try {
+                await fs.access(path.join(dir, file));
+            }
+            catch {
+                return true;
+            }
+        }
+        return false;
+    }
+}
+function buildMetaJson(recording) {
+    return {
+        source: 'plaud',
+        source_recording_id: recording.id,
+        recorded_at: recording.recordedAt,
+        imported_at: new Date().toISOString(),
+        title: recording.title,
+        duration_seconds: recording.duration,
+        language: recording.language,
+        audio: recording.fileSize
+            ? {
+                filename: `audio.${guessAudioExtension(recording.mimeType)}`,
+                mime: recording.mimeType,
+                bytes: recording.fileSize,
+            }
+            : null,
+        transcript: {
+            has_timestamps: true, // will be updated after writing
+            format: 'segments',
+            filename_json: 'transcript.json',
+            filename_txt: 'transcript.txt',
+            filename_md: 'transcript.md',
+        },
+        integrity: {
+            dedupe_key: `plaud:${recording.id}`,
+        },
+        tags: recording.tags,
+        folder_id: recording.folderId,
+        device_id: recording.deviceId,
+        summary: recording.summary,
+    };
+}
+function guessAudioExtension(mimeType) {
+    if (mimeType.includes('m4a') || mimeType.includes('mp4'))
+        return 'm4a';
+    if (mimeType.includes('wav'))
+        return 'wav';
+    if (mimeType.includes('mp3'))
+        return 'mp3';
+    if (mimeType.includes('ogg'))
+        return 'ogg';
+    if (mimeType.includes('webm'))
+        return 'webm';
+    return 'm4a'; // default
+}
+//# sourceMappingURL=recording-store.js.map

package/dist/storage/recording-store.js.map

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

package/dist/sync/download-queue.d.ts

@@ -0,0 +1,21 @@
+export interface QueueResult<T> {
+    succeeded: T[];
+    failed: Array<{
+        item: T;
+        error: Error;
+    }>;
+}
+/**
+ * Process items with bounded concurrency.
+ * Uses a simple semaphore — no extra dependencies.
+ */
+export declare function processQueue<T>(items: T[], processor: (item: T) => Promise<void>, concurrency: number): Promise<QueueResult<T>>;
+/**
+ * Retry a function with exponential backoff.
+ * Only retries if the error is retryable (isRetryable === true for ApiError).
+ */
+export declare function retryWithBackoff<T>(fn: () => Promise<T>, opts?: {
+    maxAttempts?: number;
+    label?: string;
+}): Promise<T>;
+//# sourceMappingURL=download-queue.d.ts.map

package/dist/sync/download-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"download-queue.d.ts","sourceRoot":"","sources":["../../src/sync/download-queue.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,SAAS,EAAE,CAAC,EAAE,CAAA;IACd,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC,CAAA;CACzC;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,KAAK,EAAE,CAAC,EAAE,EACV,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,EACrC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAuCzB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAClD,OAAO,CAAC,CAAC,CAAC,CA2BZ"}

package/dist/sync/download-queue.js

@@ -0,0 +1,82 @@
+import { ApiError } from '../errors.js';
+import { getLogger } from '../logger.js';
+/**
+ * Process items with bounded concurrency.
+ * Uses a simple semaphore — no extra dependencies.
+ */
+export async function processQueue(items, processor, concurrency) {
+    const succeeded = [];
+    const failed = [];
+    let index = 0;
+    let active = 0;
+    let resolve = null;
+    const tick = async () => {
+        while (active < concurrency && index < items.length) {
+            const item = items[index++];
+            active++;
+            (async () => {
+                try {
+                    await processor(item);
+                    succeeded.push(item);
+                }
+                catch (err) {
+                    failed.push({ item, error: err instanceof Error ? err : new Error(String(err)) });
+                }
+                finally {
+                    active--;
+                    if (resolve) {
+                        const r = resolve;
+                        resolve = null;
+                        r();
+                    }
+                }
+            })().catch(() => undefined);
+        }
+    };
+    await tick();
+    while (active > 0 || index < items.length) {
+        await new Promise(r => { resolve = r; });
+        await tick();
+    }
+    return { succeeded, failed };
+}
+/**
+ * Retry a function with exponential backoff.
+ * Only retries if the error is retryable (isRetryable === true for ApiError).
+ */
+export async function retryWithBackoff(fn, opts = {}) {
+    const maxAttempts = opts.maxAttempts ?? 4;
+    const delays = [0, 1000, 4000, 16000];
+    const log = getLogger();
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            const isLast = attempt === maxAttempts;
+            const retryable = isRetryableError(err);
+            if (isLast || !retryable) {
+                if (attempt > 1) {
+                    log.warn({ attempt, label: opts.label, err }, 'Giving up after retries');
+                }
+                throw err;
+            }
+            const delay = delays[attempt] ?? 16000;
+            log.debug({ attempt, delay, label: opts.label }, 'Retrying after delay');
+            await sleep(delay);
+        }
+    }
+    // Unreachable — TypeScript needs this
+    throw new Error('Retry loop exhausted');
+}
+function isRetryableError(err) {
+    if (err instanceof ApiError)
+        return err.isRetryable;
+    if (err instanceof Error && err.message.includes('429'))
+        return true;
+    return false;
+}
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=download-queue.js.map

package/dist/sync/download-queue.js.map

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

package/dist/sync/incremental.d.ts

@@ -0,0 +1,21 @@
+import { type RecordingState } from './types.js';
+import type { PlaudRecording } from '../client/types.js';
+export declare class IncrementalTracker {
+    private state;
+    load(outDir: string): Promise<void>;
+    persist(outDir: string): Promise<void>;
+    markSuccessfulSync(): void;
+    getSince(): Date | undefined;
+    needsDownload(recording: PlaudRecording): boolean;
+    computeContentHash(recording: PlaudRecording): string;
+    markComplete(recordingId: string, recordedAt: string, opts: {
+        hasAudio: boolean;
+        hasTranscript: boolean;
+        contentHash: string;
+    }): void;
+    markVerified(recordingId: string): void;
+    getRecordingState(recordingId: string): RecordingState | undefined;
+    getAllRecordingIds(): string[];
+    get lastSuccessfulSyncAt(): string | undefined;
+}
+//# sourceMappingURL=incremental.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"incremental.d.ts","sourceRoot":"","sources":["../../src/sync/incremental.ts"],"names":[],"mappings":"AAIA,OAAO,EAAmC,KAAK,cAAc,EAAE,MAAM,YAAY,CAAA;AACjF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAGxD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,KAAK,CAGZ;IAEK,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBnC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5C,kBAAkB,IAAI,IAAI;IAI1B,QAAQ,IAAI,IAAI,GAAG,SAAS;IAK5B,aAAa,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO;IAcjD,kBAAkB,CAAC,SAAS,EAAE,cAAc,GAAG,MAAM;IAYrD,YAAY,CACV,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,aAAa,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GACvE,IAAI;IAWP,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAQvC,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIlE,kBAAkB,IAAI,MAAM,EAAE;IAI9B,IAAI,oBAAoB,IAAI,MAAM,GAAG,SAAS,CAE7C;CACF"}