@cogitator-ai/channels 0.9.3 → 0.10.0

package/dist/feeds/publish-store.js

@@ -0,0 +1,345 @@
+import { mkdir, readdir, readFile, rm } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { createIfMissing, fromJson, SerialQueue, TABLE_NAME, writeFileAtomic, } from './storage.js';
+/** Whether a job still has a feed to publish to. */
+export function isPending(job) {
+    return job.deliveries.some((delivery) => delivery.status === 'pending');
+}
+/** When the job's next pending delivery is due, or `undefined` when it is done. */
+export function nextDueAt(job) {
+    const due = job.deliveries
+        .filter((delivery) => delivery.status === 'pending')
+        .map((delivery) => delivery.nextAttemptAt);
+    return due.length > 0 ? Math.min(...due) : undefined;
+}
+/** A job as JSON: attachment bytes become base64. */
+export function encodeJob(job) {
+    return JSON.stringify(job, (_key, value) => value instanceof Uint8Array ? { __bytes: Buffer.from(value).toString('base64') } : value);
+}
+/** A job back from `encodeJob`. */
+export function decodeJob(json) {
+    const text = typeof json === 'string' ? json : JSON.stringify(json);
+    return JSON.parse(text, (_key, value) => typeof value === 'object' &&
+        value !== null &&
+        '__bytes' in value &&
+        typeof value.__bytes === 'string'
+        ? new Uint8Array(Buffer.from(value.__bytes, 'base64'))
+        : value);
+}
+const copyOf = (job) => decodeJob(encodeJob(job));
+/** Claims held by one process, for the in-memory and file stores. */
+class LocalClaims {
+    now;
+    claims = new Map();
+    constructor(now) {
+        this.now = now;
+    }
+    held(id) {
+        return (this.claims.get(id)?.until ?? 0) > this.now();
+    }
+    holds(id, owner) {
+        const claim = this.claims.get(id);
+        return claim?.owner === owner && claim.until > this.now();
+    }
+    take(id, claim) {
+        this.claims.set(id, { owner: claim.owner, until: this.now() + claim.ttl });
+    }
+    release(id, owner) {
+        if (this.claims.get(id)?.owner === owner)
+            this.claims.delete(id);
+    }
+    drop(id) {
+        this.claims.delete(id);
+    }
+}
+/** Jobs in memory, for tests and a publisher that needs no restart safety. */
+export class MemoryPublishStore {
+    jobs = new Map();
+    claims;
+    constructor(now = Date.now) {
+        this.claims = new LocalClaims(now);
+    }
+    async add(job) {
+        const existing = job.key
+            ? [...this.jobs.values()].find((candidate) => candidate.key === job.key)
+            : undefined;
+        if (existing)
+            return copyOf(existing);
+        this.jobs.set(job.id, copyOf(job));
+        return copyOf(job);
+    }
+    async get(id) {
+        const job = this.jobs.get(id);
+        return job ? copyOf(job) : undefined;
+    }
+    async claimNext(now, claim) {
+        const [next] = [...this.jobs.values()]
+            .filter((job) => !this.claims.held(job.id) && (nextDueAt(job) ?? Infinity) <= now)
+            .sort((a, b) => (nextDueAt(a) ?? 0) - (nextDueAt(b) ?? 0));
+        if (!next)
+            return undefined;
+        this.claims.take(next.id, claim);
+        return copyOf(next);
+    }
+    async claim(id, claim) {
+        if (!this.jobs.has(id) || this.claims.held(id))
+            return false;
+        this.claims.take(id, claim);
+        return true;
+    }
+    async extend(id, claim) {
+        if (!this.claims.holds(id, claim.owner))
+            return false;
+        this.claims.take(id, claim);
+        return true;
+    }
+    async save(job, owner) {
+        if (!this.claims.holds(job.id, owner))
+            return false;
+        this.jobs.set(job.id, copyOf(job));
+        return true;
+    }
+    async release(id, owner) {
+        this.claims.release(id, owner);
+    }
+    async list(filter = {}) {
+        return [...this.jobs.values()]
+            .filter((job) => filter.pending === undefined || isPending(job) === filter.pending)
+            .sort((a, b) => a.createdAt - b.createdAt)
+            .map(copyOf);
+    }
+    async remove(id) {
+        if (this.claims.held(id))
+            return false;
+        return this.jobs.delete(id);
+    }
+}
+/**
+ * Jobs as one JSON file each, written atomically, for a single publishing
+ * process: claims live in that process. Several workers need
+ * `PostgresPublishStore`.
+ */
+export class FilePublishStore {
+    directory;
+    queue = new SerialQueue();
+    claims;
+    constructor(options = {}, now = Date.now) {
+        this.directory = options.directory ?? join(homedir(), '.cogitator', 'feed-jobs');
+        this.claims = new LocalClaims(now);
+    }
+    async add(job) {
+        return this.queue.run(async () => {
+            if (job.key) {
+                const existing = (await this.readAll()).find((candidate) => candidate.key === job.key);
+                if (existing)
+                    return existing;
+            }
+            await this.write(job);
+            return copyOf(job);
+        });
+    }
+    async get(id) {
+        return this.queue.run(() => this.read(id));
+    }
+    async claimNext(now, claim) {
+        return this.queue.run(async () => {
+            const [next] = (await this.readAll())
+                .filter((job) => !this.claims.held(job.id) && (nextDueAt(job) ?? Infinity) <= now)
+                .sort((a, b) => (nextDueAt(a) ?? 0) - (nextDueAt(b) ?? 0));
+            if (next)
+                this.claims.take(next.id, claim);
+            return next;
+        });
+    }
+    async claim(id, claim) {
+        return this.queue.run(async () => {
+            if (this.claims.held(id) || !(await this.read(id)))
+                return false;
+            this.claims.take(id, claim);
+            return true;
+        });
+    }
+    async extend(id, claim) {
+        return this.queue.run(async () => {
+            if (!this.claims.holds(id, claim.owner))
+                return false;
+            this.claims.take(id, claim);
+            return true;
+        });
+    }
+    async save(job, owner) {
+        return this.queue.run(async () => {
+            if (!this.claims.holds(job.id, owner))
+                return false;
+            await this.write(job);
+            return true;
+        });
+    }
+    async release(id, owner) {
+        await this.queue.run(async () => this.claims.release(id, owner));
+    }
+    async list(filter = {}) {
+        return this.queue.run(async () => (await this.readAll())
+            .filter((job) => filter.pending === undefined || isPending(job) === filter.pending)
+            .sort((a, b) => a.createdAt - b.createdAt));
+    }
+    async remove(id) {
+        return this.queue.run(async () => {
+            if (this.claims.held(id) || !(await this.read(id)))
+                return false;
+            await rm(this.fileOf(id), { force: true });
+            this.claims.drop(id);
+            return true;
+        });
+    }
+    fileOf(id) {
+        return join(this.directory, `${id.replace(/[^\w-]/g, '_')}.json`);
+    }
+    async write(job) {
+        await writeFileAtomic(this.fileOf(job.id), encodeJob(job));
+    }
+    async read(id) {
+        try {
+            return decodeJob(await readFile(this.fileOf(id), 'utf-8'));
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return undefined;
+            throw error;
+        }
+    }
+    async readAll() {
+        await mkdir(this.directory, { recursive: true });
+        const jobs = [];
+        for (const name of await readdir(this.directory)) {
+            if (!name.endsWith('.json'))
+                continue;
+            try {
+                jobs.push(decodeJob(await readFile(join(this.directory, name), 'utf-8')));
+            }
+            catch {
+                console.warn(`[feeds] Skipping unreadable job file ${join(this.directory, name)}`);
+            }
+        }
+        return jobs;
+    }
+}
+/**
+ * Jobs in a Postgres table. Claims are leases on the database clock, taken
+ * with `FOR UPDATE SKIP LOCKED`, so several publishing workers split the due
+ * jobs between them, and a worker saves a job only while its lease holds.
+ */
+export class PostgresPublishStore {
+    client;
+    table;
+    ready;
+    constructor(options) {
+        const table = options.table ?? 'cogitator_feed_jobs';
+        if (!TABLE_NAME.test(table))
+            throw new Error(`Invalid feed job table name: ${table}`);
+        this.client = options.client;
+        this.table = table;
+    }
+    async add(job) {
+        await this.ensureTable();
+        const { rows } = await this.client.query(`INSERT INTO ${this.table} (id, key, next_due_at, created_at, data)
+       VALUES ($1, $2, $3, $4, $5::jsonb)
+       ON CONFLICT DO NOTHING
+       RETURNING data`, [job.id, job.key ?? null, nextDueAt(job) ?? null, job.createdAt, encodeJob(job)]);
+        if (rows[0])
+            return decodeJob(fromJson(rows[0].data));
+        const existing = job.key
+            ? await this.client.query(`SELECT data FROM ${this.table} WHERE key = $1`, [job.key])
+            : await this.client.query(`SELECT data FROM ${this.table} WHERE id = $1`, [job.id]);
+        if (!existing.rows[0])
+            throw new Error(`Could not add feed job ${job.id}`);
+        return decodeJob(fromJson(existing.rows[0].data));
+    }
+    async get(id) {
+        await this.ensureTable();
+        const { rows } = await this.client.query(`SELECT data FROM ${this.table} WHERE id = $1`, [id]);
+        return rows[0] ? decodeJob(fromJson(rows[0].data)) : undefined;
+    }
+    async claimNext(now, claim) {
+        await this.ensureTable();
+        const { rows } = await this.client.query(`UPDATE ${this.table}
+          SET claimed_until = now() + $2::double precision * interval '1 millisecond',
+              claimed_by = $3
+        WHERE id = (
+          SELECT id FROM ${this.table}
+           WHERE next_due_at IS NOT NULL AND next_due_at <= $1
+             AND (claimed_until IS NULL OR claimed_until < now())
+           ORDER BY next_due_at
+           LIMIT 1
+           FOR UPDATE SKIP LOCKED)
+        RETURNING data`, [now, claim.ttl, claim.owner]);
+        return rows[0] ? decodeJob(fromJson(rows[0].data)) : undefined;
+    }
+    async claim(id, claim) {
+        await this.ensureTable();
+        const { rows } = await this.client.query(`UPDATE ${this.table}
+          SET claimed_until = now() + $2::double precision * interval '1 millisecond',
+              claimed_by = $3
+        WHERE id = $1 AND (claimed_until IS NULL OR claimed_until < now())
+        RETURNING id`, [id, claim.ttl, claim.owner]);
+        return rows.length > 0;
+    }
+    async extend(id, claim) {
+        await this.ensureTable();
+        const { rows } = await this.client.query(`UPDATE ${this.table}
+          SET claimed_until = now() + $2::double precision * interval '1 millisecond'
+        WHERE id = $1 AND claimed_by = $3 AND claimed_until > now()
+        RETURNING id`, [id, claim.ttl, claim.owner]);
+        return rows.length > 0;
+    }
+    async save(job, owner) {
+        await this.ensureTable();
+        const { rows } = await this.client.query(`UPDATE ${this.table} SET data = $2::jsonb, next_due_at = $3
+        WHERE id = $1 AND claimed_by = $4 AND claimed_until > now()
+        RETURNING id`, [job.id, encodeJob(job), nextDueAt(job) ?? null, owner]);
+        return rows.length > 0;
+    }
+    async release(id, owner) {
+        await this.ensureTable();
+        await this.client.query(`UPDATE ${this.table} SET claimed_until = NULL, claimed_by = NULL
+        WHERE id = $1 AND claimed_by = $2`, [id, owner]);
+    }
+    async list(filter = {}) {
+        await this.ensureTable();
+        const where = filter.pending === undefined
+            ? ''
+            : filter.pending
+                ? 'WHERE next_due_at IS NOT NULL'
+                : 'WHERE next_due_at IS NULL';
+        const { rows } = await this.client.query(`SELECT data FROM ${this.table} ${where} ORDER BY created_at`);
+        return rows.map((row) => decodeJob(fromJson(row.data)));
+    }
+    async remove(id) {
+        await this.ensureTable();
+        const { rows } = await this.client.query(`DELETE FROM ${this.table}
+        WHERE id = $1 AND (claimed_until IS NULL OR claimed_until < now())
+        RETURNING id`, [id]);
+        return rows.length > 0;
+    }
+    ensureTable() {
+        this.ready ??= (async () => {
+            await createIfMissing(this.client, `CREATE TABLE IF NOT EXISTS ${this.table} (
+           id text PRIMARY KEY,
+           key text UNIQUE,
+           next_due_at bigint,
+           created_at bigint NOT NULL,
+           claimed_until timestamptz,
+           claimed_by text,
+           data jsonb NOT NULL
+         )`);
+            const index = `${this.table.replace('.', '_')}_due_idx`;
+            await createIfMissing(this.client, `CREATE INDEX IF NOT EXISTS ${index} ON ${this.table} (next_due_at) WHERE next_due_at IS NOT NULL`);
+        })().catch((error) => {
+            this.ready = undefined;
+            throw error;
+        });
+        return this.ready;
+    }
+}
+//# sourceMappingURL=publish-store.js.map

package/dist/feeds/publish-store.js.map

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

package/dist/feeds/publisher.d.ts

@@ -0,0 +1,118 @@
+import type { FeedChannel, FeedPost, PublishedPost } from '@cogitator-ai/types';
+import { type PublishJob, type PublishStore } from './publish-store.js';
+export interface FeedRetryOptions {
+    /** Attempts per feed before it fails for good (default 5). */
+    maxAttempts?: number;
+    /** The wait before the second attempt, doubled for each one after, in ms (default 60 000). */
+    baseDelay?: number;
+    /** The longest wait between attempts, in ms (default one hour). */
+    maxDelay?: number;
+}
+export interface FeedPublishedEvent {
+    job: PublishJob;
+    feed: string;
+    post: PublishedPost;
+}
+export interface FeedFailedEvent {
+    job: PublishJob;
+    feed: string;
+    error: Error;
+    /** Whether the feed gave up: no attempt follows. */
+    final: boolean;
+}
+export interface FeedPublisherOptions {
+    feeds: FeedChannel[];
+    /** Where jobs are kept (default in memory: scheduled and retried posts do not survive a restart). */
+    store?: PublishStore;
+    retry?: FeedRetryOptions;
+    /** How often a started publisher looks for due jobs, in ms (default 15 000). */
+    pollInterval?: number;
+    /**
+     * How long a claim on a job lasts, in ms (default five minutes). The
+     * publisher extends it every third of that while it works on the job, so
+     * this is how soon another worker takes over a job whose worker died.
+     */
+    claimTtl?: number;
+    /**
+     * A text longer than a feed takes: `truncate` (default) cuts it at a word
+     * with an ellipsis for that feed, `fail` fails that feed.
+     */
+    overflow?: 'truncate' | 'fail';
+    /** Goes through every step but publishing. Dry runs keep their keys apart from real ones. */
+    dryRun?: boolean;
+    onPublished?: (event: FeedPublishedEvent) => void | Promise<void>;
+    onFailed?: (event: FeedFailedEvent) => void | Promise<void>;
+    /** The clock, for tests. */
+    now?: () => number;
+}
+export interface PublishOptions {
+    /** The feeds to publish to, by type (default every feed of the publisher). */
+    feeds?: string[];
+    /** Publishing twice with the same key publishes once: the second call returns the first job. */
+    key?: string;
+    /** When to publish. A time in the future schedules the post. */
+    publishAt?: Date | number;
+}
+export interface PublishOutcome {
+    job: PublishJob;
+    /** Whether the post waits for its time, or for another attempt, rather than being done. */
+    pending: boolean;
+    /** Whether a job with the same key existed, which is what `job` is. */
+    duplicate: boolean;
+}
+/**
+ * Publishes posts to several feeds: now or at a time, each feed tried and
+ * retried on its own, each outcome saved as soon as it is known. Each
+ * delivery keeps the feed's idempotency key from before its first attempt,
+ * so an attempt after a crash or a lost answer finds the post instead of
+ * publishing it twice, and a key makes the whole publication idempotent.
+ */
+export declare class FeedPublisher {
+    private readonly options;
+    private readonly feeds;
+    private readonly store;
+    private readonly retry;
+    private readonly pollInterval;
+    private readonly claimTtl;
+    private readonly now;
+    private readonly owner;
+    private timer?;
+    private ticking?;
+    private stopping;
+    private readonly connected;
+    constructor(options: FeedPublisherOptions);
+    /** Publishes `post` now, or schedules it with `publishAt`. */
+    publish(post: FeedPost, options?: PublishOptions): Promise<PublishOutcome>;
+    /** Looks for due jobs every `pollInterval` until `stop()`: scheduled posts and retries. */
+    start(): void;
+    /** Stops looking for due jobs, letting the job being published finish, and waits for it. */
+    stop(): Promise<void>;
+    /**
+     * Publishes the jobs that are due now, one at a time, so a claim is taken
+     * only when the job is about to be published. `start()` does this on a timer.
+     */
+    tick(): Promise<void>;
+    get(id: string): Promise<PublishJob | undefined>;
+    list(filter?: {
+        pending?: boolean;
+    }): Promise<PublishJob[]>;
+    /** Drops a job before it is published, `false` when it is missing or being published. */
+    cancel(id: string): Promise<boolean>;
+    /**
+     * Connects feeds that will publish later, so a feed that keeps a token
+     * renews it until then instead of finding it expired when the post is due.
+     * A feed that cannot connect now is tried again the next time.
+     */
+    private connect;
+    private claimOf;
+    /** Publishes a job this publisher claimed, extending the claim while it works, then releases it. */
+    private run;
+    private process;
+    /** Saves the job while the claim holds, `false` when another worker took it over. */
+    private save;
+    private attempt;
+    private send;
+    private backoff;
+    private notify;
+}
+//# sourceMappingURL=publisher.d.ts.map

package/dist/feeds/publisher.d.ts.map

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