@profullstack/agenticjobs 0.11.0 → 0.12.0

package/dist/core/inbox.d.ts

@@ -0,0 +1,155 @@
+/**
+ * The inbox: private conversations between the people on this board.
+ *
+ * There is no public comment box anywhere on the site, and that is the design
+ * rather than an omission. A board with one got used as the place to hand in
+ * invoices, because an invoice has to go *somewhere* and a comment under a
+ * listing was the only somewhere. A conversation here is between the people in
+ * it and nobody else, and an invoice is a message in one with money attached
+ * (see invoices.ts).
+ *
+ * Who can be written to is whoever has a page: a candidate with a published
+ * resume, or an employer. Writing to an employer reaches every member of it.
+ * Who can write is anybody signed in, which is the cheapest thing that keeps
+ * the inbox from being a contact form for strangers: twenty new conversations
+ * a day, per account, in the database, however the message arrived.
+ */
+import type pg from 'pg';
+import type { Mailer } from './mail.ts';
+/** The most a message can say. */
+export declare const MESSAGE_MAX = 4000;
+export declare const SUBJECT_MAX = 140;
+/** New conversations per person, per day. Replies are not counted. */
+export declare const DAILY_THREADS = 20;
+/** Who a conversation is with. */
+export type Counterparty = {
+    kind: 'candidate';
+    userId: string;
+} | {
+    kind: 'employer';
+    orgId: string;
+};
+export interface Party {
+    kind: 'candidate' | 'employer';
+    name: string;
+    /** Their page, when they have one. */
+    slug: string | null;
+}
+export interface ThreadSummary {
+    id: string;
+    subject: string;
+    job: {
+        slug: string;
+        title: string;
+    } | null;
+    /** The other side, as the viewer sees it. */
+    with: Party;
+    lastMessageAt: string;
+    /** Messages from the other side newer than the viewer last opened it. */
+    unread: number;
+    /** The start of the latest message. */
+    preview: string;
+}
+export interface Message {
+    id: string;
+    kind: 'text' | 'invoice';
+    body: string;
+    invoiceId: string | null;
+    createdAt: string;
+    sender: {
+        id: string;
+        name: string;
+        party: Party | null;
+    };
+    /** Whether the viewer wrote it. */
+    mine: boolean;
+}
+export interface Thread {
+    id: string;
+    subject: string;
+    job: {
+        slug: string;
+        title: string;
+    } | null;
+    with: Party;
+    /** Everyone in it, for the page and for "who gets paid". */
+    participants: {
+        userId: string;
+        name: string;
+        orgId: string | null;
+    }[];
+    messages: Message[];
+    createdAt: string;
+}
+/**
+ * Start a conversation, or continue the one that already exists.
+ *
+ * The same two parties about the same listing (or about nothing in
+ * particular) is one conversation, not one per click: a second "message"
+ * from a candidate page lands as a new message in the thread they already
+ * have, which is what the person meant. Returns the thread id, or a sentence
+ * saying why not.
+ *
+ * `as` lets a member write as their employer, so the candidate sees the
+ * company they applied to rather than a name they do not know. It has to be
+ * an employer the sender belongs to, checked here rather than trusted.
+ */
+export declare function startThread(pool: pg.Pool, senderId: string, to: Counterparty, input: {
+    subject: unknown;
+    body: unknown;
+    jobId?: string | null;
+    as?: string | null;
+}): Promise<{
+    threadId: string;
+    messageId: string;
+    created: boolean;
+} | string>;
+/**
+ * Reply. Only a participant can, and the reply marks the thread read for
+ * them: you have seen what you are answering.
+ */
+export declare function sendMessage(pool: pg.Pool, threadId: string, senderId: string, rawBody: unknown, invoice?: {
+    id: string;
+} | null): Promise<{
+    id: string;
+    createdAt: string;
+} | string>;
+/** Everything the viewer is in, newest activity first. */
+export declare function listThreads(pool: pg.Pool, viewerId: string): Promise<ThreadSummary[]>;
+/**
+ * One conversation, for a participant. Null for anybody else, and null rather
+ * than 403 so the existence of a conversation is not itself something a
+ * stranger can learn by guessing ids.
+ */
+export declare function getThread(pool: pg.Pool, threadId: string, viewerId: string): Promise<Thread | null>;
+/** Opening a thread is reading it. */
+export declare function markRead(pool: pg.Pool, threadId: string, viewerId: string): Promise<void>;
+/** Threads with something the viewer has not seen, for the nav. */
+export declare function unreadThreads(pool: pg.Pool, viewerId: string): Promise<number>;
+/**
+ * Tell the other participants there is something to read.
+ *
+ * One email per person per hour per thread, and none to anyone who has the
+ * thread open (their last read is newer than the message). The email says
+ * who wrote and that there is a message; it does not carry the body, because
+ * an inbox on this board is private and somebody else's mail server is not.
+ */
+export declare function notifyParticipants(pool: pg.Pool, options: {
+    mailer: Mailer | null;
+    boardName: string;
+    publicUrl: string;
+    threadId: string;
+    senderId: string;
+    kind: 'text' | 'invoice';
+}): Promise<number>;
+/**
+ * Resolve who a new message is for from the slugs a URL or a body carries.
+ *
+ * Exactly one of the two, and it has to be somebody with a page: a candidate
+ * who published a resume, or an employer. Null means "no such person", and is
+ * the same null for a private resume as for a typo, on purpose.
+ */
+export declare function counterpartyFrom(pool: pg.Pool, input: {
+    candidate?: string | null;
+    employer?: string | null;
+}): Promise<Counterparty | null>;

package/dist/core/inbox.js

@@ -0,0 +1,353 @@
+/**
+ * The inbox: private conversations between the people on this board.
+ *
+ * There is no public comment box anywhere on the site, and that is the design
+ * rather than an omission. A board with one got used as the place to hand in
+ * invoices, because an invoice has to go *somewhere* and a comment under a
+ * listing was the only somewhere. A conversation here is between the people in
+ * it and nobody else, and an invoice is a message in one with money attached
+ * (see invoices.ts).
+ *
+ * Who can be written to is whoever has a page: a candidate with a published
+ * resume, or an employer. Writing to an employer reaches every member of it.
+ * Who can write is anybody signed in, which is the cheapest thing that keeps
+ * the inbox from being a contact form for strangers: twenty new conversations
+ * a day, per account, in the database, however the message arrived.
+ */
+import { clean } from "../schema/text.js";
+import { inboxMessage } from "./mail.js";
+/** The most a message can say. */
+export const MESSAGE_MAX = 4000;
+export const SUBJECT_MAX = 140;
+/** New conversations per person, per day. Replies are not counted. */
+export const DAILY_THREADS = 20;
+/** How long a thread stays quiet in somebody's email after they were told. */
+const NOTIFY_GAP_MS = 60 * 60 * 1000;
+/**
+ * A participant, named for display.
+ *
+ * An employer's member shows as the employer: the other side wrote to Acme
+ * and should see Acme answer. A person shows by the name on their account,
+ * then the email they signed in with. The email is fine here where it is not
+ * on an update: a conversation is between signed-in members, who can read the
+ * contact block of a resume anyway.
+ */
+function partyOf(row) {
+    if (row.org_id !== null) {
+        return { kind: 'employer', name: row.org_name ?? 'An employer', slug: row.org_slug };
+    }
+    const name = (row.user_name ?? '').trim();
+    return { kind: 'candidate', name: name === '' ? row.email : name, slug: row.public_slug };
+}
+function personName(row) {
+    const name = (row.user_name ?? '').trim();
+    return name === '' ? row.email : name;
+}
+const PARTICIPANTS = `
+  select tp.thread_id, tp.user_id, tp.org_id, tp.last_read_at,
+         u.name as user_name, u.email,
+         (select r.public_slug from resumes r
+           where r.user_id = tp.user_id and r.public_slug is not null
+             and r.visibility in ('link', 'public')
+           order by r.updated_at desc limit 1) as public_slug,
+         o.name as org_name, o.slug as org_slug
+    from thread_participants tp
+    join users u on u.id = tp.user_id
+    left join organisations o on o.id = tp.org_id`;
+/**
+ * The other side of a thread, from one participant's point of view.
+ *
+ * When the other side is an employer, every member is a participant and they
+ * are all the same party, so the first is as good as any.
+ */
+function otherParty(rows, viewerId) {
+    const mine = rows.find((row) => row.user_id === viewerId);
+    const others = rows.filter((row) => row.user_id !== viewerId &&
+        // A member of the same employer as the viewer is on the viewer's side.
+        (mine?.org_id === null || mine?.org_id === undefined || row.org_id !== mine.org_id));
+    const first = others[0];
+    if (first === undefined)
+        return { kind: 'candidate', name: 'Nobody', slug: null };
+    return partyOf(first);
+}
+function preview(body) {
+    const line = body.replace(/\s+/g, ' ').trim();
+    return line.length > 120 ? `${line.slice(0, 117)}...` : line;
+}
+async function isParticipant(pool, threadId, userId) {
+    const result = await pool.query(`select 1 from thread_participants where thread_id = $1 and user_id = $2`, [threadId, userId]);
+    return result.rows.length > 0;
+}
+/**
+ * Start a conversation, or continue the one that already exists.
+ *
+ * The same two parties about the same listing (or about nothing in
+ * particular) is one conversation, not one per click: a second "message"
+ * from a candidate page lands as a new message in the thread they already
+ * have, which is what the person meant. Returns the thread id, or a sentence
+ * saying why not.
+ *
+ * `as` lets a member write as their employer, so the candidate sees the
+ * company they applied to rather than a name they do not know. It has to be
+ * an employer the sender belongs to, checked here rather than trusted.
+ */
+export async function startThread(pool, senderId, to, input) {
+    const subject = clean(input.subject, SUBJECT_MAX);
+    const body = clean(input.body, MESSAGE_MAX, { multiline: true });
+    if (body === '')
+        return 'Write something.';
+    if (to.kind === 'candidate' && to.userId === senderId)
+        return 'That is you.';
+    const asOrg = input.as ?? null;
+    if (asOrg !== null) {
+        const member = await pool.query(`select 1 from memberships where user_id = $1 and org_id = $2`, [senderId, asOrg]);
+        if (member.rows.length === 0)
+            return 'You can only write as an employer you belong to.';
+        if (to.kind === 'employer' && to.orgId === asOrg)
+            return 'That is you.';
+    }
+    const jobId = input.jobId ?? null;
+    // Find the existing conversation between these parties about this listing.
+    const existing = await pool.query(`select t.id from threads t
+      where t.job_id is not distinct from $3
+        and exists (select 1 from thread_participants me
+                     where me.thread_id = t.id and me.user_id = $1)
+        and exists (select 1 from thread_participants them
+                     where them.thread_id = t.id
+                       and ${to.kind === 'candidate' ? 'them.user_id = $2 and them.org_id is null' : 'them.org_id = $2'})
+      order by t.last_message_at desc limit 1`, [senderId, to.kind === 'candidate' ? to.userId : to.orgId, jobId]);
+    const found = existing.rows[0];
+    if (found !== undefined) {
+        const message = await sendMessage(pool, found.id, senderId, body);
+        if (typeof message === 'string')
+            return message;
+        return { threadId: found.id, messageId: message.id, created: false };
+    }
+    // The limit is on *new* conversations: replying in one you already have is
+    // never what a spammer is doing.
+    const recent = await pool.query(`select count(*)::int as count from threads
+      where created_by = $1 and created_at > now() - interval '1 day'`, [senderId]);
+    if ((recent.rows[0]?.count ?? 0) >= DAILY_THREADS) {
+        return `That is ${DAILY_THREADS} new conversations today. Reply in one you have, or come back tomorrow.`;
+    }
+    const client = await pool.connect();
+    try {
+        await client.query('begin');
+        const thread = await client.query(`insert into threads (subject, job_id, created_by) values ($1, $2, $3) returning id`, [subject === '' ? preview(body).slice(0, SUBJECT_MAX) : subject, jobId, senderId]);
+        const threadId = thread.rows[0].id;
+        // The sender, as themselves or as every member of their employer.
+        if (asOrg === null) {
+            await client.query(`insert into thread_participants (thread_id, user_id, org_id, last_read_at)
+         values ($1, $2, null, now())`, [threadId, senderId]);
+        }
+        else {
+            await client.query(`insert into thread_participants (thread_id, user_id, org_id, last_read_at)
+         select $1, m.user_id, $2, case when m.user_id = $3 then now() else null end
+           from memberships m where m.org_id = $2`, [threadId, asOrg, senderId]);
+        }
+        // The other side.
+        if (to.kind === 'candidate') {
+            await client.query(`insert into thread_participants (thread_id, user_id, org_id) values ($1, $2, null)
+         on conflict do nothing`, [threadId, to.userId]);
+        }
+        else {
+            await client.query(`insert into thread_participants (thread_id, user_id, org_id)
+         select $1, m.user_id, $2 from memberships m where m.org_id = $2
+         on conflict do nothing`, [threadId, to.orgId]);
+        }
+        const message = await client.query(`insert into messages (thread_id, sender_id, kind, body) values ($1, $2, 'text', $3)
+       returning id`, [threadId, senderId, body]);
+        await client.query('commit');
+        return { threadId, messageId: message.rows[0].id, created: true };
+    }
+    catch (error) {
+        await client.query('rollback');
+        throw error;
+    }
+    finally {
+        client.release();
+    }
+}
+/**
+ * Reply. Only a participant can, and the reply marks the thread read for
+ * them: you have seen what you are answering.
+ */
+export async function sendMessage(pool, threadId, senderId, rawBody, invoice = null) {
+    const body = clean(rawBody, MESSAGE_MAX, { multiline: true });
+    if (body === '')
+        return 'Write something.';
+    if (!(await isParticipant(pool, threadId, senderId)))
+        return 'You are not in that conversation.';
+    const inserted = await pool.query(`with m as (
+       insert into messages (thread_id, sender_id, kind, body, invoice_id)
+       values ($1, $2, $3, $4, $5)
+       returning id, created_at
+     ), t as (
+       update threads set last_message_at = (select created_at from m) where id = $1
+     ), r as (
+       update thread_participants set last_read_at = (select created_at from m)
+        where thread_id = $1 and user_id = $2
+     )
+     select id, created_at from m`, [threadId, senderId, invoice === null ? 'text' : 'invoice', body, invoice?.id ?? null]);
+    const row = inserted.rows[0];
+    return { id: row.id, createdAt: row.created_at };
+}
+/** Everything the viewer is in, newest activity first. */
+export async function listThreads(pool, viewerId) {
+    const threads = await pool.query(`select t.id, t.subject, t.last_message_at, j.slug as job_slug, j.title as job_title,
+            (select count(*)::int from messages m
+              where m.thread_id = t.id and m.sender_id <> $1
+                and m.created_at > coalesce(me.last_read_at, 'epoch'::timestamptz)) as unread,
+            (select m.body from messages m where m.thread_id = t.id
+              order by m.created_at desc limit 1) as preview
+       from threads t
+       join thread_participants me on me.thread_id = t.id and me.user_id = $1
+       left join jobs j on j.id = t.job_id
+      order by t.last_message_at desc
+      limit 200`, [viewerId]);
+    if (threads.rows.length === 0)
+        return [];
+    const ids = threads.rows.map((row) => row.id);
+    const participants = await pool.query(`${PARTICIPANTS} where tp.thread_id = any($1::uuid[])`, [ids]);
+    const byThread = new Map();
+    for (const row of participants.rows) {
+        const list = byThread.get(row.thread_id) ?? [];
+        list.push(row);
+        byThread.set(row.thread_id, list);
+    }
+    return threads.rows.map((row) => ({
+        id: row.id,
+        subject: row.subject,
+        job: row.job_slug === null ? null : { slug: row.job_slug, title: row.job_title ?? row.job_slug },
+        with: otherParty(byThread.get(row.id) ?? [], viewerId),
+        lastMessageAt: row.last_message_at,
+        unread: row.unread,
+        preview: preview(row.preview ?? ''),
+    }));
+}
+/**
+ * One conversation, for a participant. Null for anybody else, and null rather
+ * than 403 so the existence of a conversation is not itself something a
+ * stranger can learn by guessing ids.
+ */
+export async function getThread(pool, threadId, viewerId) {
+    const participants = await pool.query(`${PARTICIPANTS} where tp.thread_id = $1`, [
+        threadId,
+    ]);
+    if (!participants.rows.some((row) => row.user_id === viewerId))
+        return null;
+    const head = await pool.query(`select t.id, t.subject, t.created_at, j.slug as job_slug, j.title as job_title
+       from threads t left join jobs j on j.id = t.job_id where t.id = $1`, [threadId]);
+    const row = head.rows[0];
+    if (row === undefined)
+        return null;
+    const messages = await pool.query(`select id, kind, body, invoice_id, created_at, sender_id
+       from messages where thread_id = $1 order by created_at asc limit 500`, [threadId]);
+    const byUser = new Map(participants.rows.map((p) => [p.user_id, p]));
+    return {
+        id: row.id,
+        subject: row.subject,
+        createdAt: row.created_at,
+        job: row.job_slug === null ? null : { slug: row.job_slug, title: row.job_title ?? row.job_slug },
+        with: otherParty(participants.rows, viewerId),
+        participants: participants.rows.map((p) => ({
+            userId: p.user_id,
+            name: personName(p),
+            orgId: p.org_id,
+        })),
+        messages: messages.rows.map((m) => {
+            const sender = byUser.get(m.sender_id);
+            return {
+                id: m.id,
+                kind: m.kind,
+                body: m.body,
+                invoiceId: m.invoice_id,
+                createdAt: m.created_at,
+                sender: {
+                    id: m.sender_id,
+                    name: sender === undefined ? 'Someone who left' : personName(sender),
+                    party: sender === undefined ? null : partyOf(sender),
+                },
+                mine: m.sender_id === viewerId,
+            };
+        }),
+    };
+}
+/** Opening a thread is reading it. */
+export async function markRead(pool, threadId, viewerId) {
+    await pool.query(`update thread_participants set last_read_at = now() where thread_id = $1 and user_id = $2`, [threadId, viewerId]);
+}
+/** Threads with something the viewer has not seen, for the nav. */
+export async function unreadThreads(pool, viewerId) {
+    const result = await pool.query(`select count(*)::int as count from thread_participants me
+      where me.user_id = $1
+        and exists (select 1 from messages m
+                     where m.thread_id = me.thread_id and m.sender_id <> $1
+                       and m.created_at > coalesce(me.last_read_at, 'epoch'::timestamptz))`, [viewerId]);
+    return result.rows[0]?.count ?? 0;
+}
+/**
+ * Tell the other participants there is something to read.
+ *
+ * One email per person per hour per thread, and none to anyone who has the
+ * thread open (their last read is newer than the message). The email says
+ * who wrote and that there is a message; it does not carry the body, because
+ * an inbox on this board is private and somebody else's mail server is not.
+ */
+export async function notifyParticipants(pool, options) {
+    if (options.mailer === null)
+        return 0;
+    const due = await pool.query(`${PARTICIPANTS}
+       join threads t on t.id = tp.thread_id
+      where tp.thread_id = $1 and tp.user_id <> $2
+        and (tp.notified_at is null or tp.notified_at < now() - make_interval(secs => $3))
+        and (tp.last_read_at is null or tp.last_read_at < t.last_message_at)`, [options.threadId, options.senderId, NOTIFY_GAP_MS / 1000]);
+    if (due.rows.length === 0)
+        return 0;
+    const sender = await pool.query(`${PARTICIPANTS} where tp.thread_id = $1 and tp.user_id = $2`, [options.threadId, options.senderId]);
+    const from = sender.rows[0];
+    const fromName = from === undefined ? 'Someone' : partyOf(from).name;
+    const subject = (await pool.query(`select subject from threads where id = $1`, [
+        options.threadId,
+    ])).rows[0]?.subject;
+    let sent = 0;
+    for (const row of due.rows) {
+        const ok = await options.mailer.send(inboxMessage({
+            to: row.email,
+            boardName: options.boardName,
+            from: fromName,
+            subject: subject ?? '',
+            url: `${options.publicUrl}/inbox/${options.threadId}`,
+            kind: options.kind,
+        }));
+        if (ok) {
+            sent += 1;
+            await pool.query(`update thread_participants set notified_at = now() where thread_id = $1 and user_id = $2`, [options.threadId, row.user_id]);
+        }
+    }
+    return sent;
+}
+/**
+ * Resolve who a new message is for from the slugs a URL or a body carries.
+ *
+ * Exactly one of the two, and it has to be somebody with a page: a candidate
+ * who published a resume, or an employer. Null means "no such person", and is
+ * the same null for a private resume as for a typo, on purpose.
+ */
+export async function counterpartyFrom(pool, input) {
+    const candidate = (input.candidate ?? '').trim();
+    const employer = (input.employer ?? '').trim();
+    if (candidate !== '') {
+        const result = await pool.query(`select user_id from resumes
+        where public_slug = $1 and visibility in ('link', 'public') limit 1`, [candidate]);
+        const userId = result.rows[0]?.user_id;
+        return userId === undefined ? null : { kind: 'candidate', userId };
+    }
+    if (employer !== '') {
+        const result = await pool.query(`select id from organisations where slug = $1`, [employer]);
+        const orgId = result.rows[0]?.id;
+        return orgId === undefined ? null : { kind: 'employer', orgId };
+    }
+    return null;
+}
+//# sourceMappingURL=inbox.js.map

package/dist/core/inbox.js.map

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

package/dist/core/invoices.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Invoices: a message with money attached.
+ *
+ * The payee writes one in a conversation they are in. The other side sees it
+ * there, presses Pay, and is sent to CoinPay to settle it in the coin the
+ * payee chose, straight to the payee's wallet. The board mints the payment
+ * under its own business key and names the payee's address as the payout, so
+ * at no point does money sit anywhere the board controls.
+ *
+ * A CoinPay payment is a quote that expires. The invoice does not: when a
+ * quote lapses unpaid, Pay mints a fresh one under the same invoice, and
+ * `status` only ever moves sent -> paid or sent -> cancelled. Payment is
+ * confirmed by webhook, and by asking CoinPay when the page is opened, so a
+ * lost webhook delays the answer rather than losing it.
+ */
+import type pg from 'pg';
+import { type CoinPayClient } from './coinpay.ts';
+export type InvoiceStatus = 'sent' | 'paid' | 'cancelled';
+export interface Invoice {
+    id: string;
+    threadId: string;
+    payee: {
+        id: string;
+        name: string;
+    };
+    amountUsd: string;
+    /** The chain, in CoinPay's spelling. */
+    currency: string;
+    walletAddress: string;
+    description: string;
+    status: InvoiceStatus;
+    payment: {
+        id: string;
+        address: string | null;
+        amountCrypto: string | null;
+        expiresAt: string | null;
+        /** Where to pay. */
+        url: string;
+    } | null;
+    paidAt: string | null;
+    paidBy: string | null;
+    txHash: string | null;
+    createdAt: string;
+}
+/** A dollar amount as typed: "120", "120.50", "$1,200". Null when it is not one. */
+export declare function parseAmount(value: unknown): string | null;
+/**
+ * Send one. Returns the invoice, or a sentence saying why not.
+ *
+ * The payee has to be in the conversation and has to have connected a CoinPay
+ * account with a wallet on the chain they chose; the address is copied onto
+ * the invoice at this moment and never read again, so what the payer pays to
+ * is what the payee had connected when they asked.
+ */
+export declare function sendInvoice(pool: pg.Pool, coinpay: CoinPayClient | null, input: {
+    threadId: string;
+    payeeId: string;
+    amount: unknown;
+    currency: unknown;
+    description: unknown;
+}): Promise<Invoice | string>;
+/** The invoices in a conversation, oldest first, for rendering beside messages. */
+export declare function listInvoicesIn(pool: pg.Pool, coinpay: CoinPayClient | null, threadId: string): Promise<Invoice[]>;
+/**
+ * Everything the viewer sent or can pay: their invoices, and the invoices in
+ * conversations they are in. Newest first.
+ */
+export declare function listInvoicesFor(pool: pg.Pool, coinpay: CoinPayClient | null, viewerId: string): Promise<Invoice[]>;
+/** One invoice, for a participant of its conversation. Null for anybody else. */
+export declare function getInvoice(pool: pg.Pool, coinpay: CoinPayClient | null, invoiceId: string, viewerId: string): Promise<Invoice | null>;
+/** The payee takes it back. Only while unpaid. */
+export declare function cancelInvoice(pool: pg.Pool, invoiceId: string, payeeId: string): Promise<boolean>;
+/**
+ * Get somewhere to pay. Returns the invoice with a live payment on it, or a
+ * sentence.
+ *
+ * Anyone in the conversation but the payee may pay. A payment still inside its
+ * quote window is reused; otherwise a new one is minted for the same invoice,
+ * and the id is remembered so the webhook can find its way back.
+ */
+export declare function requestPayment(pool: pg.Pool, coinpay: CoinPayClient | null, input: {
+    invoiceId: string;
+    payerId: string;
+    publicUrl: string;
+}): Promise<Invoice | string>;
+/**
+ * Ask CoinPay how the current payment is doing and record the answer.
+ *
+ * Paid is paid, whichever way the news arrives. A dead quote is cleared so the
+ * next Pay mints a fresh one. Anything in between, or CoinPay not answering,
+ * leaves the invoice as it was: this is a read that happens on page load, and
+ * a provider hiccup must not turn into a changed status.
+ */
+export declare function syncInvoice(pool: pg.Pool, coinpay: CoinPayClient | null, invoice: Invoice): Promise<Invoice>;
+/**
+ * Record a payment as settled. Idempotent: the webhook fires for `confirmed`
+ * and again for `forwarded`, and a poll may land between them.
+ */
+export declare function markPaid(pool: pg.Pool, input: {
+    paymentId: string;
+    txHash: string | null;
+    paidBy?: string | null;
+}): Promise<boolean>;
+/**
+ * A webhook from CoinPay, already verified by the caller.
+ *
+ * Only the two settlement events change anything. An expired quote is left
+ * to the next page load, which clears it the same way and does not depend on
+ * a delivery that may never come.
+ */
+export declare function applyWebhook(pool: pg.Pool, payload: Record<string, unknown>): Promise<'paid' | 'ignored' | 'unknown'>;