plaud-notes-to-notion 1.0.0

package/dist/notion.js

@@ -0,0 +1,254 @@
+import { NOTION_RICH_TEXT_PER_BLOCK, NOTION_TEXT_CHUNK, NOTION_VERSION, TYPE_SUMMARY } from "./constants.js";
+import { redactSecrets } from "./redact.js";
+export class NotionError extends Error {
+    status;
+    code;
+    constructor(message, status, code) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.name = "NotionError";
+    }
+    get unauthorized() {
+        return this.status === 401 || this.status === 403 || (this.status === 404 && this.code === "object_not_found");
+    }
+    get transient() {
+        return this.status === 429 || this.status >= 500 || this.status === 0;
+    }
+}
+function plain(rich) {
+    return Array.isArray(rich) ? rich.map((r) => r.plain_text || "").join("") : "";
+}
+function optionNames(prop) {
+    if (!prop) {
+        return [];
+    }
+    if (Array.isArray(prop.multi_select)) {
+        return prop.multi_select.map((o) => String(o.name));
+    }
+    if (prop.select && typeof prop.select === "object") {
+        return [String(prop.select.name)];
+    }
+    return [];
+}
+export function rowFromPage(page) {
+    const props = (page.properties || {});
+    const recorded = props.Recorded?.date;
+    return {
+        id: String(page.id),
+        title: plain(props.Meeting?.title),
+        types: optionNames(props.Type),
+        participants: optionNames(props.Participants),
+        recorded: recorded?.start ?? null,
+        lastEdited: String(page.last_edited_time || "")
+    };
+}
+export function textToRichText(text) {
+    const out = [];
+    for (let i = 0; i < text.length; i += NOTION_TEXT_CHUNK) {
+        out.push({ type: "text", text: { content: text.slice(i, i + NOTION_TEXT_CHUNK) } });
+    }
+    return out;
+}
+/** One paragraph (like the Zap's) holding the whole transcript; split only past Notion's per-block cap. */
+export function transcriptBlocks(text) {
+    const rich = textToRichText(text);
+    const blocks = [];
+    for (let i = 0; i < rich.length; i += NOTION_RICH_TEXT_PER_BLOCK) {
+        blocks.push({
+            object: "block",
+            type: "paragraph",
+            paragraph: { rich_text: rich.slice(i, i + NOTION_RICH_TEXT_PER_BLOCK) }
+        });
+    }
+    return blocks.length ? blocks : [{ object: "block", type: "paragraph", paragraph: { rich_text: [] } }];
+}
+/** Fallback when Notion cannot parse a summary as markdown: one plain paragraph per line. */
+export function plainLineBlocks(markdown) {
+    return markdown
+        .split("\n")
+        .filter((l) => l.trim())
+        .map((line) => ({ object: "block", type: "paragraph", paragraph: { rich_text: textToRichText(line) } }));
+}
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+export class HttpNotionStore {
+    options;
+    cachedSchema = null;
+    constructor(options) {
+        this.options = options;
+    }
+    async api(method, path, body, attempt = 0) {
+        // Creates/appends are not idempotent: a 5xx can hide a success, so only reads retry on 5xx/network.
+        // 429 is always safe to retry (Notion rejected it before doing anything).
+        const idempotent = method === "GET" || path.endsWith("/query") || (method === "PATCH" && path.startsWith("/pages/"));
+        let res;
+        try {
+            res = await (this.options.fetchImpl || fetch)(`https://api.notion.com/v1${path}`, {
+                method,
+                headers: {
+                    Authorization: `Bearer ${this.options.token}`,
+                    "Notion-Version": NOTION_VERSION,
+                    "Content-Type": "application/json"
+                },
+                body: body === undefined ? undefined : JSON.stringify(body),
+                signal: AbortSignal.timeout(120_000)
+            });
+        }
+        catch (err) {
+            if (idempotent && attempt < 2) {
+                await (this.options.sleepImpl || sleep)(2000 * (attempt + 1));
+                return this.api(method, path, body, attempt + 1);
+            }
+            throw new NotionError(redactSecrets(`Notion unreachable (${err instanceof Error ? err.name : "network"})`), 0, "network");
+        }
+        if ((res.status === 429 || (idempotent && res.status >= 500)) && attempt < 3) {
+            const retryAfter = Number(res.headers.get("retry-after"));
+            const wait = Number.isFinite(retryAfter) && retryAfter > 0 ? Math.min(30, retryAfter) * 1000 : 1500 * (attempt + 1);
+            await (this.options.sleepImpl || sleep)(wait);
+            return this.api(method, path, body, attempt + 1);
+        }
+        const json = (await res.json().catch(() => ({})));
+        if (!res.ok) {
+            throw new NotionError(redactSecrets(`Notion HTTP ${res.status}: ${String(json.message || json.code || "error")}`), res.status, String(json.code || ""));
+        }
+        return json;
+    }
+    props(row, schema) {
+        const multi = (kind, names) => kind === "multi_select" ? { multi_select: names.map((name) => ({ name })) } : { select: names[0] ? { name: names[0] } : null };
+        return {
+            Meeting: { title: textToRichText(row.title) },
+            Recorded: { date: { start: row.recorded } },
+            Type: multi(schema.typeKind, [row.type]),
+            Participants: multi(schema.participantsKind, row.participants)
+        };
+    }
+    async schema() {
+        if (this.cachedSchema && Date.now() - this.cachedSchema.at < 10 * 60_000) {
+            return this.cachedSchema.value;
+        }
+        const ds = await this.api("GET", `/data_sources/${this.options.dataSourceId}`);
+        const props = (ds.properties || {});
+        const missing = [
+            ["Meeting", "title"],
+            ["Recorded", "date"]
+        ].filter(([name, type]) => props[name]?.type !== type);
+        const kindOf = (name) => props[name]?.type === "multi_select" ? "multi_select" : props[name]?.type === "select" ? "select" : null;
+        const typeKind = kindOf("Type");
+        const participantsKind = kindOf("Participants");
+        if (missing.length || !typeKind || !participantsKind) {
+            throw new NotionError("Plaud Notes schema mismatch: need Meeting (title), Recorded (date), Type and Participants (select or multi-select)", 400, "schema_mismatch");
+        }
+        const optionsProp = props.Participants[participantsKind];
+        const value = {
+            typeKind,
+            participantsKind,
+            participantOptions: (optionsProp?.options || []).map((o) => String(o.name))
+        };
+        this.cachedSchema = { at: Date.now(), value };
+        return value;
+    }
+    async queryAll(filter, sorts) {
+        const rows = [];
+        let cursor;
+        do {
+            const json = await this.api("POST", `/data_sources/${this.options.dataSourceId}/query`, {
+                filter,
+                sorts,
+                page_size: 100,
+                start_cursor: cursor
+            });
+            for (const page of (json.results || [])) {
+                rows.push(rowFromPage(page));
+            }
+            cursor = json.has_more ? String(json.next_cursor) : undefined;
+        } while (cursor);
+        return rows;
+    }
+    async rowsAtMinute(minuteIso) {
+        const start = new Date(minuteIso);
+        const end = new Date(start.getTime() + 60_000);
+        return this.queryAll({
+            and: [
+                { property: "Recorded", date: { on_or_after: start.toISOString() } },
+                { property: "Recorded", date: { before: end.toISOString() } }
+            ]
+        });
+    }
+    async createSummary(row, markdown) {
+        const schema = await this.schema();
+        const parent = { type: "data_source_id", data_source_id: this.options.dataSourceId };
+        try {
+            const page = await this.api("POST", "/pages", { parent, properties: this.props(row, schema), markdown });
+            return { id: String(page.id), usedFallback: false };
+        }
+        catch (err) {
+            if (!(err instanceof NotionError) || err.code !== "validation_error" || !/markdown/i.test(err.message)) {
+                throw err;
+            }
+            const blocks = plainLineBlocks(markdown);
+            const page = await this.api("POST", "/pages", { parent, properties: this.props(row, schema), children: blocks.slice(0, 100) });
+            for (let i = 100; i < blocks.length; i += 100) {
+                await this.api("PATCH", `/blocks/${String(page.id)}/children`, { children: blocks.slice(i, i + 100) });
+            }
+            return { id: String(page.id), usedFallback: true };
+        }
+    }
+    async createTranscript(row, text) {
+        const schema = await this.schema();
+        const blocks = transcriptBlocks(text);
+        const page = await this.api("POST", "/pages", {
+            parent: { type: "data_source_id", data_source_id: this.options.dataSourceId },
+            properties: this.props(row, schema),
+            children: blocks.slice(0, 100)
+        });
+        for (let i = 100; i < blocks.length; i += 100) {
+            await this.api("PATCH", `/blocks/${String(page.id)}/children`, { children: blocks.slice(i, i + 100) });
+        }
+        return { id: String(page.id) };
+    }
+    async summariesEditedSince(sinceIso) {
+        const schema = await this.schema();
+        const typeFilter = schema.typeKind === "multi_select"
+            ? { property: "Type", multi_select: { contains: TYPE_SUMMARY } }
+            : { property: "Type", select: { equals: TYPE_SUMMARY } };
+        return this.queryAll({
+            and: [typeFilter, { timestamp: "last_edited_time", last_edited_time: { on_or_after: sinceIso } }]
+        });
+    }
+    async rowsRecordedSince(sinceIso) {
+        return this.queryAll({ property: "Recorded", date: { on_or_after: sinceIso } }, [
+            { property: "Recorded", direction: "descending" }
+        ]);
+    }
+    async pageState(pageId) {
+        try {
+            const page = await this.api("GET", `/pages/${pageId}`);
+            return page.in_trash === true || page.archived === true ? "trashed" : "live";
+        }
+        catch (err) {
+            // 404 means permanently deleted *or* lost access — never treat that as a deletion.
+            if (err instanceof NotionError && err.status === 404) {
+                return "unknown";
+            }
+            throw err;
+        }
+    }
+    async setTrashed(pageId, inTrash) {
+        await this.api("PATCH", `/pages/${pageId}`, { in_trash: inTrash });
+    }
+    async updateRow(pageId, patch) {
+        const schema = await this.schema();
+        const properties = {};
+        if (patch.title !== undefined) {
+            properties.Meeting = { title: textToRichText(patch.title) };
+        }
+        if (patch.participants !== undefined) {
+            properties.Participants =
+                schema.participantsKind === "multi_select"
+                    ? { multi_select: patch.participants.map((name) => ({ name })) }
+                    : { select: patch.participants[0] ? { name: patch.participants[0] } : null };
+        }
+        await this.api("PATCH", `/pages/${pageId}`, { properties });
+    }
+}
+//# sourceMappingURL=notion.js.map

package/dist/notion.js.map

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

package/dist/paths.d.ts

@@ -0,0 +1,11 @@
+export declare function getHomeDir(env?: NodeJS.ProcessEnv): string;
+export declare function getStateDir(env?: NodeJS.ProcessEnv): string;
+export declare function getConfigPath(env?: NodeJS.ProcessEnv): string;
+export declare function getProfileStatePath(profile: string, env?: NodeJS.ProcessEnv): string;
+export declare function getStatusPath(env?: NodeJS.ProcessEnv): string;
+export declare function getLockFilePath(env?: NodeJS.ProcessEnv): string;
+export declare function getLogFilePath(env?: NodeJS.ProcessEnv): string;
+export declare function ensureDir(dir: string): void;
+/** Write JSON atomically (tmp + rename) so a crash never leaves half a state file. */
+export declare function writeJsonAtomic(file: string, value: unknown): void;
+export declare function readJson<T>(file: string): T | null;

package/dist/paths.js

@@ -0,0 +1,51 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { LOCK_FILE_NAME, LOG_FILE_NAME, PACKAGE_NAME } from "./constants.js";
+export function getHomeDir(env = process.env) {
+    const override = env.PLAUD_NOTES_HOME?.trim();
+    if (override) {
+        return path.resolve(override);
+    }
+    return os.homedir();
+}
+export function getStateDir(env = process.env) {
+    return path.join(getHomeDir(env), `.${PACKAGE_NAME}`);
+}
+export function getConfigPath(env = process.env) {
+    return path.join(getStateDir(env), "config.json");
+}
+export function getProfileStatePath(profile, env = process.env) {
+    return path.join(getStateDir(env), "state", `${profile}.json`);
+}
+export function getStatusPath(env = process.env) {
+    return path.join(getStateDir(env), "status.json");
+}
+export function getLockFilePath(env = process.env) {
+    return path.join(getStateDir(env), LOCK_FILE_NAME);
+}
+export function getLogFilePath(env = process.env) {
+    return path.join(getHomeDir(env), "Library", "Logs", LOG_FILE_NAME);
+}
+export function ensureDir(dir) {
+    fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+}
+/** Write JSON atomically (tmp + rename) so a crash never leaves half a state file. */
+export function writeJsonAtomic(file, value) {
+    ensureDir(path.dirname(file));
+    const tmp = `${file}.${process.pid}.tmp`;
+    fs.writeFileSync(tmp, `${JSON.stringify(value, null, 2)}\n`, { mode: 0o600 });
+    fs.renameSync(tmp, file);
+}
+export function readJson(file) {
+    try {
+        return JSON.parse(fs.readFileSync(file, "utf8"));
+    }
+    catch (err) {
+        if (err.code === "ENOENT") {
+            return null;
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE7E,MAAM,UAAU,UAAU,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC7D,MAAM,QAAQ,GAAG,GAAG,CAAC,gBAAgB,EAAE,IAAI,EAAE,CAAC;IAC9C,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC9D,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,IAAI,YAAY,EAAE,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAyB,OAAO,CAAC,GAAG;IAChE,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,aAAa,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAe,EAAE,MAAyB,OAAO,CAAC,GAAG;IACvF,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,OAAO,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAyB,OAAO,CAAC,GAAG;IAChE,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,aAAa,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAyB,OAAO,CAAC,GAAG;IAClE,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,cAAc,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAyB,OAAO,CAAC,GAAG;IACjE,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AACtD,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,KAAc;IAC1D,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9B,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,MAAM,CAAC;IACzC,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9E,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,QAAQ,CAAI,IAAY;IACtC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAM,CAAC;IACxD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/plaud/callback.d.ts

@@ -0,0 +1,19 @@
+export type OAuthCallbackStatus = "success" | "timeout" | "denied" | "exchange-failed" | "listen-failed";
+export interface OAuthCallbackResult {
+    status: OAuthCallbackStatus;
+    error?: Error;
+}
+export interface RunOAuthCallbackOptions {
+    expectedState: string;
+    exchangeCode: (code: string) => Promise<void>;
+    port?: number;
+    path?: string;
+    timeoutMs?: number;
+    onListening?: () => void;
+    postSuccessDelayMs?: number;
+}
+/**
+ * Loopback OAuth callback on localhost:8199 (Plaud's registered redirect).
+ * Binds 127.0.0.1 and ::1 only. Rejects unexpected `state` without exchanging a code.
+ */
+export declare function runOAuthCallback(options: RunOAuthCallbackOptions): Promise<OAuthCallbackResult>;

package/dist/plaud/callback.js

@@ -0,0 +1,162 @@
+import { createServer } from "node:http";
+import { OAUTH_CALLBACK_PATH, OAUTH_CALLBACK_PORT } from "./constants.js";
+import { redactSecrets } from "../redact.js";
+const SUCCESS_HTML = "<!doctype html><html><head><meta charset=\"utf-8\"><title>Plaud</title></head><body style=\"font-family:system-ui;padding:2rem;text-align:center;\"><h1>Authorization successful</h1><p>You can close this tab and return to the terminal.</p></body></html>";
+const NEUTRAL_HTML = "<!doctype html><html><head><meta charset=\"utf-8\"><title>Plaud</title></head><body style=\"font-family:system-ui;padding:2rem;text-align:center;\"><h1>Continue authorization in the original window.</h1><p>This page can be closed.</p></body></html>";
+function errorHtml(message) {
+    const escaped = redactSecrets(message).replace(/[&<>]/g, (c) => c === "&" ? "&amp;" : c === "<" ? "&lt;" : "&gt;");
+    return `<!doctype html><html><head><meta charset="utf-8"><title>Plaud</title></head><body style="font-family:system-ui;padding:2rem;text-align:center;"><h1>Authorization failed</h1><p>${escaped}</p></body></html>`;
+}
+const LOOPBACK_HOSTS = ["127.0.0.1", "::1"];
+const IPV6_UNAVAILABLE = new Set(["EAFNOSUPPORT", "EADDRNOTAVAIL", "EINVAL", "EPROTONOSUPPORT"]);
+function listenOne(port, host, handler) {
+    return new Promise((resolve, reject) => {
+        const server = createServer(handler);
+        server.once("error", reject);
+        server.listen(port, host, () => {
+            server.removeListener("error", reject);
+            resolve(server);
+        });
+    });
+}
+async function closeServers(servers) {
+    await Promise.all(servers.map((server) => new Promise((resolve) => {
+        try {
+            server.closeAllConnections?.();
+        }
+        catch {
+            /* ignore */
+        }
+        server.close(() => resolve());
+    })));
+}
+async function listenLoopback(port, handler) {
+    const servers = [];
+    for (const host of LOOPBACK_HOSTS) {
+        try {
+            servers.push(await listenOne(port, host, handler));
+        }
+        catch (err) {
+            const code = err && typeof err === "object" && "code" in err ? String(err.code ?? "") : "";
+            if (host !== "127.0.0.1" && IPV6_UNAVAILABLE.has(code)) {
+                continue;
+            }
+            await closeServers(servers);
+            throw err;
+        }
+    }
+    return servers;
+}
+/**
+ * Loopback OAuth callback on localhost:8199 (Plaud's registered redirect).
+ * Binds 127.0.0.1 and ::1 only. Rejects unexpected `state` without exchanging a code.
+ */
+export function runOAuthCallback(options) {
+    const port = options.port ?? OAUTH_CALLBACK_PORT;
+    const callbackPath = options.path ?? OAUTH_CALLBACK_PATH;
+    const timeoutMs = options.timeoutMs ?? 120_000;
+    const postSuccessDelayMs = options.postSuccessDelayMs ?? 1500;
+    return new Promise((resolve) => {
+        let settled = false;
+        let exchangeStarted = false;
+        let exchangeSucceeded = false;
+        let timeoutId = null;
+        let servers = [];
+        const handler = (req, res) => {
+            const reqUrl = new URL(req.url ?? "/", `http://127.0.0.1:${port}`);
+            if (reqUrl.pathname !== callbackPath) {
+                res.writeHead(404);
+                res.end();
+                return;
+            }
+            const error = reqUrl.searchParams.get("error");
+            const state = reqUrl.searchParams.get("state");
+            const code = reqUrl.searchParams.get("code");
+            if (error) {
+                const desc = reqUrl.searchParams.get("error_description") ?? error;
+                res.writeHead(400, { "Content-Type": "text/html" });
+                res.end(errorHtml(`Authorization denied.`));
+                finalize({ status: "denied", error: new Error(desc) });
+                return;
+            }
+            if (!state || state !== options.expectedState) {
+                res.writeHead(200, { "Content-Type": "text/html" });
+                res.end(NEUTRAL_HTML);
+                return;
+            }
+            if (exchangeSucceeded) {
+                res.writeHead(200, { "Content-Type": "text/html" });
+                res.end(SUCCESS_HTML);
+                return;
+            }
+            if (!code) {
+                res.writeHead(200, { "Content-Type": "text/html" });
+                res.end(NEUTRAL_HTML);
+                return;
+            }
+            if (exchangeStarted) {
+                res.writeHead(200, { "Content-Type": "text/html" });
+                res.end(NEUTRAL_HTML);
+                return;
+            }
+            exchangeStarted = true;
+            options.exchangeCode(code).then(() => {
+                exchangeSucceeded = true;
+                res.writeHead(200, { "Content-Type": "text/html" });
+                res.end(SUCCESS_HTML);
+                finalize({ status: "success" });
+            }, (err) => {
+                const e = err instanceof Error ? err : new Error(String(err));
+                res.writeHead(500, { "Content-Type": "text/html" });
+                res.end(errorHtml("Token exchange failed."));
+                finalize({ status: "exchange-failed", error: e });
+            });
+        };
+        timeoutId = setTimeout(() => {
+            finalize({ status: "timeout" }, true);
+        }, timeoutMs);
+        listenLoopback(port, handler).then((bound) => {
+            if (settled) {
+                void closeServers(bound);
+                return;
+            }
+            servers = bound;
+            for (const server of servers) {
+                server.on("error", (err) => {
+                    if (settled) {
+                        return;
+                    }
+                    finalize({ status: "listen-failed", error: new Error(`callback server error: ${err.message}`) }, true);
+                });
+            }
+            options.onListening?.();
+        }, (err) => {
+            const code = err && typeof err === "object" && "code" in err ? String(err.code ?? "") : "";
+            const message = code === "EADDRINUSE"
+                ? `port ${port} is in use — another Plaud login may still be running. Wait a few seconds and retry.`
+                : `callback server error: ${err instanceof Error ? err.message : String(err)}`;
+            finalize({ status: "listen-failed", error: new Error(message) }, true);
+        });
+        function finalize(result, immediate = false) {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            if (timeoutId) {
+                clearTimeout(timeoutId);
+                timeoutId = null;
+            }
+            const close = () => {
+                void closeServers(servers).then(() => resolve(result));
+            };
+            if (immediate || result.status !== "success") {
+                close();
+            }
+            else {
+                const closeTimeoutId = setTimeout(close, postSuccessDelayMs);
+                closeTimeoutId.unref?.();
+            }
+        }
+    });
+}
+//# sourceMappingURL=callback.js.map

package/dist/plaud/callback.js.map

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

package/dist/plaud/client.d.ts

@@ -0,0 +1,55 @@
+import type { PlaudAuthSession } from "./session.js";
+/** One recording as listed by Plaud. Times are UTC instants. */
+export interface PlaudFileListing {
+    id: string;
+    name: string;
+    /** When the file landed in Plaud (upload/sync). Drives the ingest watermark. */
+    createdAt: Date | null;
+    /** When recording started. Becomes Notion `Recorded`. */
+    startAt: Date | null;
+    durationMs: number | null;
+}
+export interface PlaudSegment {
+    speaker: string;
+    startMs: number;
+    text: string;
+}
+export interface PlaudRecording extends PlaudFileListing {
+    /** Plaud's auto summary markdown (`auto_sum_note`), or null while it is still generating. */
+    summaryMarkdown: string | null;
+    /** Raw transcript segments (`transaction` block), empty while still generating. */
+    segments: PlaudSegment[];
+}
+export interface PlaudClient {
+    listFiles(page?: number, pageSize?: number): Promise<PlaudFileListing[]>;
+    getRecording(fileId: string): Promise<PlaudRecording>;
+    currentUser(): Promise<Record<string, unknown>>;
+}
+/**
+ * Plaud's third-party API returns naive ISO strings that are UTC
+ * (e.g. start_at 2026-09-25T20:00:25 for a 3:00 PM CDT call); epoch seconds or
+ * milliseconds are accepted too.
+ */
+export declare function parsePlaudTime(value: unknown): Date | null;
+export declare function assertFileId(fileId: string): string;
+export declare function extractFileList(payload: unknown): Record<string, unknown>[];
+export declare function normalizeListing(raw: Record<string, unknown>): PlaudFileListing;
+export declare function segmentsFromUnknown(list: unknown): PlaudSegment[];
+export declare function fetchHttpsBlock(rawUrl: string, fetchImpl?: typeof fetch): Promise<string>;
+export declare class HttpPlaudClient implements PlaudClient {
+    private readonly session;
+    private readonly fetchImpl;
+    private readonly baseUrl;
+    constructor(session: PlaudAuthSession, options?: {
+        fetchImpl?: typeof fetch;
+        baseUrl?: string;
+    });
+    listFiles(page?: number, pageSize?: number): Promise<PlaudFileListing[]>;
+    currentUser(): Promise<Record<string, unknown>>;
+    getRecording(fileId: string): Promise<PlaudRecording>;
+    private blockContent;
+    /** The Summary tab (`auto_sum_note`) — what the Zap's "Summary" field carried. */
+    private autoSummary;
+    private transcriptSegments;
+    private requestJson;
+}