@alta-foundation/plaud-extractor 1.0.0

package/dist/cli/options.js

@@ -0,0 +1,11 @@
+// Shared option definitions (reused across commands if needed in future)
+export const COMMON_OPTIONS = {
+    out: { flags: '--out <dir>', description: 'Output directory' },
+    verbose: { flags: '--verbose', description: 'Verbose logging' },
+    redact: { flags: '--redact', description: 'Redact auth tokens from logs' },
+    dryRun: { flags: '--dry-run', description: 'Print plan without downloading' },
+    concurrency: { flags: '--concurrency <n>', description: 'Parallel downloads (default: 3)' },
+    formats: { flags: '--formats <list>', description: 'Transcript formats: json,txt,md' },
+    limit: { flags: '--limit <n>', description: 'Max number of recordings to process' },
+};
+//# sourceMappingURL=options.js.map

package/dist/cli/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/cli/options.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,GAAG,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,kBAAkB,EAAE;IAC9D,OAAO,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,iBAAiB,EAAE;IAC/D,MAAM,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,8BAA8B,EAAE;IAC1E,MAAM,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,gCAAgC,EAAE;IAC7E,WAAW,EAAE,EAAE,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,iCAAiC,EAAE;IAC3F,OAAO,EAAE,EAAE,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,iCAAiC,EAAE;IACtF,KAAK,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,qCAAqC,EAAE;CACpF,CAAA"}

package/dist/client/endpoints.d.ts

@@ -0,0 +1,26 @@
+import type { EndpointMap } from '../auth/types.js';
+export type { EndpointMap };
+/**
+ * Build list URL using skip/limit pagination.
+ * GET /file/simple/web?skip=N&limit=50&is_trash=0&sort_by=start_time&is_desc=true
+ */
+export declare function buildListUrl(map: EndpointMap, skip: number, limit?: number): string;
+/**
+ * Build URL for POST /file/list — batch detail fetch that includes trans_result.
+ * Body: ["file_id_1", "file_id_2"]
+ * Response: { data_file_list: [...full recording objects with trans_result...] }
+ */
+export declare function buildBatchDetailUrl(map: EndpointMap): string;
+/**
+ * Build URL for GET /file/temp-url/<id> — returns a presigned S3 audio download URL.
+ * Response: { temp_url: "https://s3.amazonaws.com/...?X-Amz-..." }
+ */
+export declare function buildAudioTempUrl(map: EndpointMap, id: string): string;
+export declare function buildProfileUrl(map: EndpointMap): string;
+/**
+ * Discover the correct regional API base URL by hitting the global endpoint.
+ * The global api.plaud.ai returns a region-redirect response:
+ *   { status: -302, data: { domains: { api: "https://api-euc1.plaud.ai" } } }
+ */
+export declare function extractRegionalBaseUrl(response: unknown): string | null;
+//# sourceMappingURL=endpoints.d.ts.map

package/dist/client/endpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoints.d.ts","sourceRoot":"","sources":["../../src/client/endpoints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD,YAAY,EAAE,WAAW,EAAE,CAAA;AAU3B;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,MAAM,CAS/E;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAE5D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAGtE;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAExD;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAOvE"}

package/dist/client/endpoints.js

@@ -0,0 +1,54 @@
+// ---------------------------------------------------------------------------
+// Real Plaud API paths (discovered from arbuzmell/plaud-api reference client)
+// The user's account lives on a regional endpoint (e.g. api-euc1.plaud.ai for EU).
+// Hit api.plaud.ai/user/me to discover the correct regional base URL.
+// ---------------------------------------------------------------------------
+const API_BASE = (map) => map.apiBaseUrl ?? 'https://api.plaud.ai';
+/**
+ * Build list URL using skip/limit pagination.
+ * GET /file/simple/web?skip=N&limit=50&is_trash=0&sort_by=start_time&is_desc=true
+ */
+export function buildListUrl(map, skip, limit = 50) {
+    const base = map.listRecordings ?? `${API_BASE(map)}/file/simple/web`;
+    const url = new URL(base.replace('/{id}', ''));
+    url.searchParams.set('skip', String(skip));
+    url.searchParams.set('limit', String(limit));
+    url.searchParams.set('is_trash', '0');
+    url.searchParams.set('sort_by', 'start_time');
+    url.searchParams.set('is_desc', 'true');
+    return url.toString();
+}
+/**
+ * Build URL for POST /file/list — batch detail fetch that includes trans_result.
+ * Body: ["file_id_1", "file_id_2"]
+ * Response: { data_file_list: [...full recording objects with trans_result...] }
+ */
+export function buildBatchDetailUrl(map) {
+    return map.batchDetail ?? `${API_BASE(map)}/file/list`;
+}
+/**
+ * Build URL for GET /file/temp-url/<id> — returns a presigned S3 audio download URL.
+ * Response: { temp_url: "https://s3.amazonaws.com/...?X-Amz-..." }
+ */
+export function buildAudioTempUrl(map, id) {
+    const base = map.getAudioUrl ?? `${API_BASE(map)}/file/temp-url`;
+    return `${base.replace('/{id}', '')}/${id}`;
+}
+export function buildProfileUrl(map) {
+    return map.userProfile ?? `${API_BASE(map)}/user/me`;
+}
+/**
+ * Discover the correct regional API base URL by hitting the global endpoint.
+ * The global api.plaud.ai returns a region-redirect response:
+ *   { status: -302, data: { domains: { api: "https://api-euc1.plaud.ai" } } }
+ */
+export function extractRegionalBaseUrl(response) {
+    const r = response;
+    if (r?.status === -302) {
+        const api = r?.data?.domains;
+        if (typeof api?.api === 'string')
+            return api.api;
+    }
+    return null;
+}
+//# sourceMappingURL=endpoints.js.map

package/dist/client/endpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoints.js","sourceRoot":"","sources":["../../src/client/endpoints.ts"],"names":[],"mappings":"AAIA,8EAA8E;AAC9E,8EAA8E;AAC9E,mFAAmF;AACnF,sEAAsE;AACtE,8EAA8E;AAE9E,MAAM,QAAQ,GAAG,CAAC,GAAgB,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,IAAI,sBAAsB,CAAA;AAE/E;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,GAAgB,EAAE,IAAY,EAAE,KAAK,GAAG,EAAE;IACrE,MAAM,IAAI,GAAG,GAAG,CAAC,cAAc,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,kBAAkB,CAAA;IACrE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAA;IAC9C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;IAC1C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;IAC5C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAA;IACrC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,YAAY,CAAC,CAAA;IAC7C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;IACvC,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAA;AACvB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAgB;IAClD,OAAO,GAAG,CAAC,WAAW,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAA;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAgB,EAAE,EAAU;IAC5D,MAAM,IAAI,GAAG,GAAG,CAAC,WAAW,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,gBAAgB,CAAA;IAChE,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAAA;AAC7C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAgB;IAC9C,OAAO,GAAG,CAAC,WAAW,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAA;AACtD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAiB;IACtD,MAAM,CAAC,GAAG,QAAmC,CAAA;IAC7C,IAAI,CAAC,EAAE,MAAM,KAAK,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,GAAG,GAAI,CAAC,EAAE,IAAgC,EAAE,OAAkC,CAAA;QACpF,IAAI,OAAO,GAAG,EAAE,GAAG,KAAK,QAAQ;YAAE,OAAO,GAAG,CAAC,GAAG,CAAA;IAClD,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/client/http.d.ts

@@ -0,0 +1,17 @@
+import { type RequestInit } from 'undici';
+import type { StoredCredentials } from '../auth/types.js';
+export declare class HttpClient {
+    private readonly creds;
+    constructor(creds: StoredCredentials);
+    private buildHeaders;
+    get<T>(url: string, init?: RequestInit): Promise<T>;
+    post<T>(url: string, body: unknown, init?: RequestInit): Promise<T>;
+    getStream(url: string): Promise<AsyncIterable<Uint8Array>>;
+    /**
+     * Download from an external URL (e.g. presigned S3) without Plaud auth headers.
+     * S3 presigned URLs sign only the `host` header — sending extra headers breaks the request.
+     */
+    downloadExternalUrl(url: string): Promise<AsyncIterable<Uint8Array>>;
+    private assertOk;
+}
+//# sourceMappingURL=http.d.ts.map

package/dist/client/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/client/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,WAAW,EAAiB,MAAM,QAAQ,CAAA;AAG/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAgBzD,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,iBAAiB;IAErD,OAAO,CAAC,YAAY;IAad,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IAcnD,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IAenE,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IAkBhE;;;OAGG;IACG,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;YAc5D,QAAQ;CASvB"}

package/dist/client/http.js

@@ -0,0 +1,92 @@
+import { fetch } from 'undici';
+import { ApiError, AuthError } from '../errors.js';
+import { getLogger } from '../logger.js';
+import { cookieHeader } from '../auth/token-store.js';
+// Browser-like headers that Plaud's API validates.
+// app-platform and edit-from are required custom headers.
+const STATIC_HEADERS = {
+    'Accept': 'application/json, */*',
+    'Accept-Language': 'en-GB,en-US;q=0.9,en;q=0.8',
+    'Origin': 'https://web.plaud.ai',
+    'Referer': 'https://web.plaud.ai/',
+    'app-platform': 'web',
+    'edit-from': 'web',
+    'User-Agent': 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0.0.0 Safari/537.36',
+};
+export class HttpClient {
+    creds;
+    constructor(creds) {
+        this.creds = creds;
+    }
+    buildHeaders() {
+        const headers = {
+            'Content-Type': 'application/json',
+            ...STATIC_HEADERS,
+            'Cookie': cookieHeader(this.creds),
+        };
+        if (this.creds.authToken) {
+            // Plaud API expects lowercase 'bearer' (per arbuzmell/plaud-api reference client)
+            headers['Authorization'] = `bearer ${this.creds.authToken}`;
+        }
+        return headers;
+    }
+    async get(url, init) {
+        const log = getLogger();
+        log.debug({ url }, 'GET');
+        const res = await fetch(url, {
+            ...init,
+            method: 'GET',
+            headers: { ...this.buildHeaders(), ...init?.headers },
+        });
+        await this.assertOk(res, url);
+        return res.json();
+    }
+    async post(url, body, init) {
+        const log = getLogger();
+        log.debug({ url }, 'POST');
+        const res = await fetch(url, {
+            ...init,
+            method: 'POST',
+            headers: { ...this.buildHeaders(), ...init?.headers },
+            body: JSON.stringify(body),
+        });
+        await this.assertOk(res, url);
+        return res.json();
+    }
+    async getStream(url) {
+        const log = getLogger();
+        log.debug({ url }, 'GET (stream)');
+        const res = await fetch(url, {
+            method: 'GET',
+            headers: this.buildHeaders(),
+        });
+        await this.assertOk(res, url);
+        if (!res.body) {
+            throw new ApiError(`No response body from ${url}`, res.status);
+        }
+        return res.body;
+    }
+    /**
+     * Download from an external URL (e.g. presigned S3) without Plaud auth headers.
+     * S3 presigned URLs sign only the `host` header — sending extra headers breaks the request.
+     */
+    async downloadExternalUrl(url) {
+        const log = getLogger();
+        log.debug({ url: url.split('?')[0] }, 'GET (external)');
+        const res = await fetch(url, { method: 'GET' });
+        await this.assertOk(res, url);
+        if (!res.body) {
+            throw new ApiError(`No response body from external URL`, res.status);
+        }
+        return res.body;
+    }
+    async assertOk(res, url) {
+        if (res.ok)
+            return;
+        if (res.status === 401 || res.status === 403) {
+            throw new AuthError(`Auth failed for ${url} (${res.status}) — run 'alta-plaud auth' to re-authenticate`);
+        }
+        throw new ApiError(`HTTP ${res.status} for ${url}`, res.status);
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/client/http.js.map

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

package/dist/client/plaud-client.d.ts

@@ -0,0 +1,14 @@
+import type { StoredCredentials } from '../auth/types.js';
+import { HttpClient } from './http.js';
+import { type PlaudRecording, type PlaudTranscript, type ListOptions, type PlaudClient } from './types.js';
+export declare class PlaudApiClient implements PlaudClient {
+    private readonly http;
+    private endpoints;
+    constructor(creds: StoredCredentials);
+    isAuthenticated(): Promise<boolean>;
+    listRecordings(opts?: ListOptions): AsyncGenerator<PlaudRecording>;
+    getTranscript(recordingId: string): Promise<PlaudTranscript>;
+    getAudioDownloadUrl(recordingId: string): Promise<string | null>;
+    getHttpClient(): HttpClient;
+}
+//# sourceMappingURL=plaud-client.d.ts.map

package/dist/client/plaud-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plaud-client.d.ts","sourceRoot":"","sources":["../../src/client/plaud-client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AASzD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AACtC,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,WAAW,EACjB,MAAM,YAAY,CAAA;AAEnB,qBAAa,cAAe,YAAW,WAAW;IAChD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAY;IACjC,OAAO,CAAC,SAAS,CAAa;gBAElB,KAAK,EAAE,iBAAiB;IAQ9B,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAgBlC,cAAc,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,cAAc,CAAC,cAAc,CAAC;IAkCnE,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAgB5D,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAWtE,aAAa,IAAI,UAAU;CAG5B"}

package/dist/client/plaud-client.js

@@ -0,0 +1,216 @@
+import { ApiError, AuthError } from '../errors.js';
+import { getLogger } from '../logger.js';
+import { buildListUrl, buildBatchDetailUrl, buildAudioTempUrl, buildProfileUrl, extractRegionalBaseUrl, } from './endpoints.js';
+import { HttpClient } from './http.js';
+import { PlaudRecordingSchema, PlaudTranscriptSchema, } from './types.js';
+export class PlaudApiClient {
+    http;
+    endpoints;
+    constructor(creds) {
+        this.http = new HttpClient(creds);
+        this.endpoints = {
+            ...creds.endpointMap,
+            apiBaseUrl: creds.apiBaseUrl,
+        };
+    }
+    async isAuthenticated() {
+        try {
+            const profileUrl = buildProfileUrl(this.endpoints);
+            const raw = await this.http.get(profileUrl);
+            // A region-redirect response still means we're authenticated
+            if (extractRegionalBaseUrl(raw) !== null)
+                return true;
+            // Check for error status in response body
+            const r = raw;
+            return r?.status === 0 || r?.data_user != null;
+        }
+        catch (err) {
+            if (err instanceof AuthError)
+                return false;
+            if (err instanceof ApiError && (err.statusCode === 401 || err.statusCode === 403))
+                return false;
+            return false;
+        }
+    }
+    async *listRecordings(opts) {
+        const log = getLogger();
+        let skip = 0;
+        const limit = 50;
+        let count = 0;
+        while (true) {
+            const url = buildListUrl(this.endpoints, skip, limit);
+            const raw = await this.http.get(url);
+            const items = extractFileList(raw);
+            if (items.length === 0)
+                break;
+            for (const item of items) {
+                const recording = normalizeRecording(item);
+                const parsed = PlaudRecordingSchema.parse(recording);
+                // Apply since filter (no server-side date filtering)
+                if (opts?.since && new Date(parsed.recordedAt) < opts.since)
+                    continue;
+                yield parsed;
+                count++;
+                if (opts?.limit && count >= opts.limit)
+                    return;
+            }
+            log.debug({ skip, fetched: items.length }, 'Fetched recording page');
+            // Stop when we get fewer items than the limit (last page)
+            if (items.length < limit)
+                break;
+            skip += items.length;
+        }
+    }
+    async getTranscript(recordingId) {
+        // Transcript data lives inside the recording object (trans_result field).
+        // Fetch it via POST /file/list with the single recording ID.
+        const url = buildBatchDetailUrl(this.endpoints);
+        const raw = await this.http.post(url, [recordingId]);
+        const items = extractFileList(raw);
+        if (items.length === 0) {
+            throw new ApiError(`Recording ${recordingId} not found`, 404);
+        }
+        const recording = items[0];
+        const normalized = normalizeTranscript(recording, recordingId);
+        return PlaudTranscriptSchema.parse(normalized);
+    }
+    async getAudioDownloadUrl(recordingId) {
+        try {
+            const url = buildAudioTempUrl(this.endpoints, recordingId);
+            const raw = await this.http.get(url);
+            return extractTempUrl(raw);
+        }
+        catch (err) {
+            getLogger().debug({ recordingId, err }, 'Could not get audio download URL');
+            return null;
+        }
+    }
+    getHttpClient() {
+        return this.http;
+    }
+}
+function extractFileList(raw) {
+    const obj = raw;
+    // Primary response shape: { data_file_list: [...] }
+    if (Array.isArray(obj?.data_file_list))
+        return obj.data_file_list;
+    // Fallback shapes
+    if (Array.isArray(obj?.data))
+        return obj.data;
+    if (Array.isArray(obj?.list))
+        return obj.list;
+    if (Array.isArray(raw))
+        return raw;
+    return [];
+}
+function normalizeRecording(raw) {
+    const r = raw;
+    // duration is in milliseconds — convert to seconds
+    const durationMs = Number(r['duration'] ?? r['duration_ms'] ?? 0);
+    const duration = durationMs / 1000;
+    // start_time is Unix milliseconds (the actual recording start time)
+    const startTimeMs = Number(r['start_time'] ?? 0);
+    const recordedAt = startTimeMs > 0 ? new Date(startTimeMs).toISOString() : new Date().toISOString();
+    // version_ms is when the record was last synced; edit_time is seconds
+    const versionMs = Number(r['version_ms'] ?? 0);
+    const editTimeSec = Number(r['edit_time'] ?? 0);
+    const updatedAt = versionMs > 0 ? new Date(versionMs).toISOString() : recordedAt;
+    const createdAt = editTimeSec > 0 ? new Date(editTimeSec * 1000).toISOString() : recordedAt;
+    // Determine mime type from the fullname file extension
+    const fullname = String(r['fullname'] ?? '');
+    const ext = fullname.split('.').pop()?.toLowerCase();
+    const mimeType = ext === 'ogg' ? 'audio/ogg' :
+        ext === 'm4a' ? 'audio/m4a' :
+            ext === 'mp3' ? 'audio/mpeg' :
+                ext === 'opus' ? 'audio/ogg; codecs=opus' :
+                    'audio/mp4';
+    return {
+        id: String(r['id'] ?? ''),
+        title: stringOrUndefined(r['filename'] ?? r['name'] ?? r['title']),
+        duration,
+        recordedAt,
+        createdAt,
+        updatedAt,
+        fileSize: numberOrUndefined(r['filesize'] ?? r['file_size']),
+        mimeType,
+        hasTranscript: Boolean(r['is_trans'] ?? r['has_transcription'] ?? r['hasNote']),
+        transcriptStatus: r['is_trans'] ? 'completed' : undefined,
+        language: stringOrUndefined(r['language'] ?? r['lang']),
+        deviceId: stringOrUndefined(r['serial_number'] ?? r['device_id'] ?? r['deviceId']),
+        tags: arrayOfStrings(r['filetag_id_list'] ?? r['tags']),
+        folderId: undefined,
+        summary: extractSummaryText(r['ai_content']),
+        _raw: r,
+    };
+}
+function normalizeTranscript(raw, recordingId) {
+    const r = raw;
+    const transResult = r['trans_result'];
+    const segmentsRaw = Array.isArray(transResult) ? transResult : [];
+    const segments = segmentsRaw.map((s, i) => ({
+        index: i,
+        startMs: Number(s['start_time_ms'] ?? s['startMs'] ?? s['startTime'] ?? 0),
+        endMs: Number(s['end_time_ms'] ?? s['endMs'] ?? s['endTime'] ?? 0),
+        speaker: stringOrUndefined(s['speaker']),
+        text: String(s['text'] ?? '').trim(),
+        confidence: undefined,
+    }));
+    const fullText = segments.map(s => s.text).filter(Boolean).join('\n\n');
+    // duration field from POST /file/list is in milliseconds — convert to seconds
+    const durationMs = Number(r['duration_ms'] ?? r['duration'] ?? 0);
+    const duration = durationMs / 1000;
+    return {
+        recordingId,
+        language: stringOrUndefined(r['language'] ?? r['lang']),
+        duration,
+        segments,
+        fullText,
+        createdAt: stringOrUndefined(r['created_at'] ?? r['createTime']) ? toIso(r['created_at'] ?? r['createTime']) : undefined,
+        _raw: r,
+    };
+}
+function extractTempUrl(raw) {
+    const obj = raw;
+    return stringOrUndefined(obj?.['temp_url'] ?? obj?.['url'] ?? obj?.['downloadUrl']) ?? null;
+}
+function extractSummaryText(aiContent) {
+    if (!aiContent || typeof aiContent !== 'object')
+        return undefined;
+    const obj = aiContent;
+    // ai_content can have various summary fields
+    const text = obj['summary'] ?? obj['text'] ?? obj['content'];
+    return stringOrUndefined(text);
+}
+// ─── Utilities ────────────────────────────────────────────────────────────────
+function toIso(val) {
+    if (typeof val === 'string' && val.length > 0) {
+        // Already ISO string
+        if (val.includes('T') || val.includes('-'))
+            return new Date(val).toISOString();
+        // Unix ms as string
+        const n = Number(val);
+        if (isFinite(n) && n > 0) {
+            return new Date(n > 1e12 ? n : n * 1000).toISOString();
+        }
+    }
+    if (typeof val === 'number' && val > 0) {
+        return new Date(val > 1e12 ? val : val * 1000).toISOString();
+    }
+    return new Date().toISOString();
+}
+function stringOrUndefined(val) {
+    if (typeof val === 'string' && val.length > 0)
+        return val;
+    return undefined;
+}
+function numberOrUndefined(val) {
+    const n = Number(val);
+    return isFinite(n) && n >= 0 ? n : undefined;
+}
+function arrayOfStrings(val) {
+    if (!Array.isArray(val))
+        return undefined;
+    const result = val.filter(v => typeof v === 'string');
+    return result.length > 0 ? result : undefined;
+}
+//# sourceMappingURL=plaud-client.js.map

package/dist/client/plaud-client.js.map

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

package/dist/client/types.d.ts

@@ -0,0 +1,154 @@
+import { z } from 'zod';
+export declare const TranscriptSegmentSchema: z.ZodObject<{
+    index: z.ZodNumber;
+    startMs: z.ZodNumber;
+    endMs: z.ZodNumber;
+    speaker: z.ZodOptional<z.ZodString>;
+    text: z.ZodString;
+    confidence: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    index: number;
+    startMs: number;
+    endMs: number;
+    text: string;
+    speaker?: string | undefined;
+    confidence?: number | undefined;
+}, {
+    index: number;
+    startMs: number;
+    endMs: number;
+    text: string;
+    speaker?: string | undefined;
+    confidence?: number | undefined;
+}>;
+export type TranscriptSegment = z.infer<typeof TranscriptSegmentSchema>;
+export declare const PlaudRecordingSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    /** Duration in seconds */
+    duration: z.ZodNumber;
+    recordedAt: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    fileSize: z.ZodOptional<z.ZodNumber>;
+    mimeType: z.ZodDefault<z.ZodString>;
+    hasTranscript: z.ZodBoolean;
+    transcriptStatus: z.ZodOptional<z.ZodEnum<["pending", "processing", "completed", "failed"]>>;
+    language: z.ZodOptional<z.ZodString>;
+    deviceId: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    folderId: z.ZodOptional<z.ZodString>;
+    summary: z.ZodOptional<z.ZodString>;
+    /** Raw API payload preserved verbatim for forward-compatibility */
+    _raw: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    duration: number;
+    recordedAt: string;
+    createdAt: string;
+    updatedAt: string;
+    mimeType: string;
+    hasTranscript: boolean;
+    _raw: Record<string, unknown>;
+    title?: string | undefined;
+    fileSize?: number | undefined;
+    transcriptStatus?: "pending" | "processing" | "completed" | "failed" | undefined;
+    language?: string | undefined;
+    deviceId?: string | undefined;
+    tags?: string[] | undefined;
+    folderId?: string | undefined;
+    summary?: string | undefined;
+}, {
+    id: string;
+    duration: number;
+    recordedAt: string;
+    createdAt: string;
+    updatedAt: string;
+    hasTranscript: boolean;
+    _raw: Record<string, unknown>;
+    title?: string | undefined;
+    fileSize?: number | undefined;
+    mimeType?: string | undefined;
+    transcriptStatus?: "pending" | "processing" | "completed" | "failed" | undefined;
+    language?: string | undefined;
+    deviceId?: string | undefined;
+    tags?: string[] | undefined;
+    folderId?: string | undefined;
+    summary?: string | undefined;
+}>;
+export type PlaudRecording = z.infer<typeof PlaudRecordingSchema>;
+export declare const PlaudTranscriptSchema: z.ZodObject<{
+    recordingId: z.ZodString;
+    language: z.ZodOptional<z.ZodString>;
+    /** Duration in seconds */
+    duration: z.ZodNumber;
+    segments: z.ZodArray<z.ZodObject<{
+        index: z.ZodNumber;
+        startMs: z.ZodNumber;
+        endMs: z.ZodNumber;
+        speaker: z.ZodOptional<z.ZodString>;
+        text: z.ZodString;
+        confidence: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        index: number;
+        startMs: number;
+        endMs: number;
+        text: string;
+        speaker?: string | undefined;
+        confidence?: number | undefined;
+    }, {
+        index: number;
+        startMs: number;
+        endMs: number;
+        text: string;
+        speaker?: string | undefined;
+        confidence?: number | undefined;
+    }>, "many">;
+    /** Concatenated full text for convenience */
+    fullText: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodString>;
+    _raw: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    duration: number;
+    _raw: Record<string, unknown>;
+    recordingId: string;
+    segments: {
+        index: number;
+        startMs: number;
+        endMs: number;
+        text: string;
+        speaker?: string | undefined;
+        confidence?: number | undefined;
+    }[];
+    fullText: string;
+    createdAt?: string | undefined;
+    language?: string | undefined;
+}, {
+    duration: number;
+    _raw: Record<string, unknown>;
+    recordingId: string;
+    segments: {
+        index: number;
+        startMs: number;
+        endMs: number;
+        text: string;
+        speaker?: string | undefined;
+        confidence?: number | undefined;
+    }[];
+    fullText: string;
+    createdAt?: string | undefined;
+    language?: string | undefined;
+}>;
+export type PlaudTranscript = z.infer<typeof PlaudTranscriptSchema>;
+export interface ListOptions {
+    since?: Date;
+    limit?: number;
+    cursor?: string;
+}
+export interface PlaudClient {
+    isAuthenticated(): Promise<boolean>;
+    listRecordings(options?: ListOptions): AsyncGenerator<PlaudRecording>;
+    getTranscript(recordingId: string): Promise<PlaudTranscript>;
+    getAudioDownloadUrl(recordingId: string): Promise<string | null>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;EAOlC,CAAA;AAEF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAEvE,eAAO,MAAM,oBAAoB;;;IAG/B,0BAA0B;;;;;;;;;;;;;;IAc1B,mEAAmE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEnE,CAAA;AAEF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEjE,eAAO,MAAM,qBAAqB;;;IAGhC,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;IAG1B,6CAA6C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAI7C,CAAA;AAEF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEnE,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,IAAI,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;IACnC,cAAc,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,cAAc,CAAC,cAAc,CAAC,CAAA;IACrE,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;IAC5D,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;CACjE"}