@cogenta/core 0.1.0

package/dist/migrations/migrator.d.ts

@@ -0,0 +1,18 @@
+import { type DatabaseHandle } from '../db/index.js';
+import { type Logger } from '../logger/index.js';
+import type { Migration, MigrationOutcome, MigrationStatus, RollbackOptions, RunOptions } from './types.js';
+export interface MigratorOptions {
+    readonly db: DatabaseHandle;
+    readonly migrations: readonly Migration[];
+    readonly logger?: Logger;
+    /** A lock older than this is assumed to belong to a process that died. */
+    readonly staleLockMs?: number;
+    readonly now?: () => number;
+}
+export interface Migrator {
+    status(): Promise<MigrationStatus[]>;
+    up(options?: RunOptions): Promise<MigrationOutcome[]>;
+    down(options?: RollbackOptions): Promise<MigrationOutcome[]>;
+}
+export declare function createMigrator(options: MigratorOptions): Migrator;
+//# sourceMappingURL=migrator.d.ts.map

package/dist/migrations/migrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrator.d.ts","sourceRoot":"","sources":["../../src/migrations/migrator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,cAAc,EAAqC,MAAM,gBAAgB,CAAA;AAEvF,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAC9D,OAAO,KAAK,EACV,SAAS,EACT,gBAAgB,EAEhB,eAAe,EACf,eAAe,EACf,UAAU,EACX,MAAM,YAAY,CAAA;AAOnB,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAA;IAC3B,QAAQ,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,CAAA;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,0EAA0E;IAC1E,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAAA;IACpC,EAAE,CAAC,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAA;IACrD,IAAI,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAA;CAC7D;AAqBD,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,QAAQ,CAgQjE"}

package/dist/migrations/migrator.js

@@ -0,0 +1,247 @@
+import process from 'node:process';
+import { identifier, sql } from '../db/index.js';
+import { CogentaError } from '../errors/index.js';
+import { createLogger } from '../logger/index.js';
+const TABLE = 'cogenta_migrations';
+const LOCK_TABLE = 'cogenta_migrations_lock';
+const LOCK_ROW = 1;
+const DEFAULT_STALE_LOCK_MS = 15 * 60 * 1000;
+function sorted(migrations) {
+    return [...migrations].sort((a, b) => a.id.localeCompare(b.id));
+}
+function assertUniqueIds(migrations) {
+    const seen = new Set();
+    for (const migration of migrations) {
+        if (seen.has(migration.id)) {
+            throw new CogentaError({
+                code: 'MIGRATION_FAILED',
+                message: `Two migrations share the id "${migration.id}".`,
+                hint: 'Migration ids must be unique and are never renumbered once applied.',
+                details: { id: migration.id },
+            });
+        }
+        seen.add(migration.id);
+    }
+}
+export function createMigrator(options) {
+    const { db, migrations } = options;
+    const logger = (options.logger ?? createLogger()).child({ component: 'migrator' });
+    const now = options.now ?? Date.now;
+    const staleLockMs = options.staleLockMs ?? DEFAULT_STALE_LOCK_MS;
+    const owner = `${process.pid}@${new Date(now()).toISOString()}`;
+    assertUniqueIds(migrations);
+    const ordered = sorted(migrations);
+    const table = identifier(TABLE, db.dialect);
+    const lockTable = identifier(LOCK_TABLE, db.dialect);
+    async function ensureTables() {
+        // Portable on purpose: varchar keys stay under the MySQL index length limit
+        // in utf8mb4, and timestamps are ISO strings so the three dialects cannot
+        // disagree about time zones in the one table that records history.
+        await db.query(sql `
+      create table if not exists ${table} (
+        id varchar(255) not null primary key,
+        name varchar(255) not null,
+        checksum varchar(64),
+        applied_at varchar(32) not null,
+        duration_ms integer not null
+      )`);
+        await db.query(sql `
+      create table if not exists ${lockTable} (
+        id integer not null primary key,
+        acquired_at varchar(32) not null,
+        owner varchar(255) not null
+      )`);
+    }
+    async function appliedRecords() {
+        const result = await db.query(sql `select id, name, checksum, applied_at, duration_ms from ${table} order by id`);
+        return new Map(result.rows.map((row) => [
+            row.id,
+            {
+                id: row.id,
+                name: row.name,
+                checksum: row.checksum,
+                appliedAt: row.applied_at,
+                durationMs: Number(row.duration_ms),
+            },
+        ]));
+    }
+    /**
+     * Takes an exclusive lock so two deployments cannot migrate at once.
+     *
+     * The primary key does the work: whoever inserts the row first wins, and the
+     * loser gets a conflict rather than a half-applied schema. A lock older than
+     * `staleLockMs` belonged to a process that died, and is taken over.
+     */
+    async function acquireLock() {
+        const cutoff = new Date(now() - staleLockMs).toISOString();
+        await db.query(sql `delete from ${lockTable} where id = ${LOCK_ROW} and acquired_at < ${cutoff}`);
+        try {
+            await db.query(sql `insert into ${lockTable} (id, acquired_at, owner)
+            values (${LOCK_ROW}, ${new Date(now()).toISOString()}, ${owner})`);
+        }
+        catch (error) {
+            throw new CogentaError({
+                code: 'MIGRATION_LOCKED',
+                message: 'Another process is already running migrations on this database.',
+                hint: `Wait for it to finish. If a previous run crashed, the lock is released automatically after ${Math.round(staleLockMs / 60000)} minutes, or you can delete the row from ${LOCK_TABLE}.`,
+                cause: error,
+            });
+        }
+    }
+    async function releaseLock() {
+        await db.query(sql `delete from ${lockTable} where id = ${LOCK_ROW} and owner = ${owner}`);
+    }
+    function assertAllowed(pending, run) {
+        const destructive = pending.filter((migration) => migration.destructive === true);
+        if (destructive.length === 0)
+            return;
+        if (run.confirmDestructive !== true || run.backupVerified !== true) {
+            throw new CogentaError({
+                code: 'MIGRATION_DESTRUCTIVE',
+                message: `This run includes ${destructive.length} destructive migration(s): ${destructive
+                    .map((migration) => migration.id)
+                    .join(', ')}.`,
+                hint: 'A destructive migration removes or rewrites data that its down() cannot restore. Take a backup, verify it restores, then re-run confirming both.',
+                details: {
+                    migrations: destructive.map((migration) => ({
+                        id: migration.id,
+                        impact: migration.impact ?? 'not documented',
+                    })),
+                },
+            });
+        }
+    }
+    /**
+     * Runs one direction of one migration, in a transaction where the database
+     * has transactional DDL.
+     *
+     * **MySQL does not.** A `CREATE TABLE` commits implicitly, so a migration that
+     * fails halfway leaves the schema partly changed and no rollback happens. The
+     * engine cannot fix that; it records the failure loudly so the operator knows
+     * the schema is in between two states rather than believing it rolled back.
+     */
+    async function runOne(migration, direction) {
+        const startedAt = now();
+        const name = migration.name ?? migration.id;
+        const transactionalDdl = db.dialect !== 'mysql';
+        const body = async (tx) => {
+            if (direction === 'up') {
+                await migration.up(tx);
+                await tx.query(sql `insert into ${table} (id, name, checksum, applied_at, duration_ms)
+              values (${migration.id}, ${name}, ${migration.checksum ?? null},
+                      ${new Date(now()).toISOString()}, ${now() - startedAt})`);
+            }
+            else {
+                await migration.down(tx);
+                await tx.query(sql `delete from ${table} where id = ${migration.id}`);
+            }
+        };
+        try {
+            if (transactionalDdl) {
+                await db.transaction(body, { immediate: true });
+            }
+            else {
+                await body(db);
+            }
+        }
+        catch (error) {
+            throw new CogentaError({
+                code: 'MIGRATION_FAILED',
+                message: `Migration "${migration.id}" failed going ${direction}: ${error instanceof Error ? error.message : String(error)}`,
+                hint: transactionalDdl
+                    ? 'The transaction was rolled back, so the schema is unchanged. Fix the migration and run again.'
+                    : 'MySQL commits DDL implicitly, so this migration may be half applied. Inspect the schema before running again — the engine cannot roll it back for you.',
+                cause: error,
+                details: { id: migration.id, direction, rolledBack: transactionalDdl },
+            });
+        }
+        const durationMs = now() - startedAt;
+        logger.info(`migration ${direction}`, { id: migration.id, name, durationMs });
+        return { id: migration.id, name, direction, durationMs };
+    }
+    return {
+        status: async () => {
+            await ensureTables();
+            const applied = await appliedRecords();
+            return ordered.map((migration) => {
+                const record = applied.get(migration.id);
+                return {
+                    id: migration.id,
+                    name: migration.name ?? migration.id,
+                    applied: record !== undefined,
+                    appliedAt: record?.appliedAt,
+                    durationMs: record?.durationMs,
+                    checksumMismatch: record !== undefined &&
+                        record.checksum !== null &&
+                        migration.checksum !== undefined &&
+                        record.checksum !== migration.checksum,
+                    destructive: migration.destructive === true,
+                    impact: migration.impact,
+                };
+            });
+        },
+        up: async (run = {}) => {
+            await ensureTables();
+            await acquireLock();
+            try {
+                const applied = await appliedRecords();
+                for (const migration of ordered) {
+                    const record = applied.get(migration.id);
+                    if (record !== undefined &&
+                        record.checksum !== null &&
+                        migration.checksum !== undefined &&
+                        record.checksum !== migration.checksum) {
+                        throw new CogentaError({
+                            code: 'MIGRATION_CHECKSUM_MISMATCH',
+                            message: `Migration "${migration.id}" changed after it was applied here.`,
+                            hint: 'Never edit an applied migration: environments that ran the two versions now differ in ways nothing records. Write a new migration instead.',
+                            details: { id: migration.id },
+                        });
+                    }
+                }
+                let pending = ordered.filter((migration) => !applied.has(migration.id));
+                if (run.to !== undefined) {
+                    const limit = pending.findIndex((migration) => migration.id === run.to);
+                    if (limit === -1 && !applied.has(run.to)) {
+                        throw new CogentaError({
+                            code: 'MIGRATION_FAILED',
+                            message: `No migration with id "${run.to}".`,
+                            hint: 'Check the id against `cogenta migrate status`.',
+                        });
+                    }
+                    pending = limit === -1 ? [] : pending.slice(0, limit + 1);
+                }
+                assertAllowed(pending, run);
+                const outcomes = [];
+                for (const migration of pending)
+                    outcomes.push(await runOne(migration, 'up'));
+                return outcomes;
+            }
+            finally {
+                await releaseLock();
+            }
+        },
+        down: async (run = {}) => {
+            await ensureTables();
+            await acquireLock();
+            try {
+                const applied = await appliedRecords();
+                const reversible = ordered.filter((migration) => applied.has(migration.id)).reverse();
+                let target = reversible.slice(0, run.steps ?? 1);
+                if (run.to !== undefined) {
+                    const limit = reversible.findIndex((migration) => migration.id === run.to);
+                    target = limit === -1 ? [] : reversible.slice(0, limit + 1);
+                }
+                assertAllowed(target, run);
+                const outcomes = [];
+                for (const migration of target)
+                    outcomes.push(await runOne(migration, 'down'));
+                return outcomes;
+            }
+            finally {
+                await releaseLock();
+            }
+        },
+    };
+}
+//# sourceMappingURL=migrator.js.map

package/dist/migrations/migrator.js.map

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

package/dist/migrations/types.d.ts

@@ -0,0 +1,63 @@
+import type { SqlExecutor } from '../db/index.js';
+export interface Migration {
+    /** Sortable and stable, e.g. `0001_create_content`. Never renumbered. */
+    readonly id: string;
+    readonly name?: string;
+    /**
+     * Hash of the source this migration came from. When it is present, changing
+     * an already-applied migration is detected and refused: two environments that
+     * ran different SQL under the same id is the worst state to debug.
+     */
+    readonly checksum?: string;
+    /**
+     * Removes or rewrites existing data in a way `down` cannot restore. Requires
+     * an explicit confirmation and a verified backup before it will run.
+     */
+    readonly destructive?: boolean;
+    /** What this does to existing data, in one sentence, for the operator. */
+    readonly impact?: string;
+    readonly estimatedDurationMs?: number;
+    up(tx: SqlExecutor): Promise<void>;
+    /**
+     * Required, not optional. AGENTS.md says migrations are always reversible, and
+     * a type that allows an irreversible one makes that rule a suggestion.
+     */
+    down(tx: SqlExecutor): Promise<void>;
+}
+export interface MigrationStatus {
+    readonly id: string;
+    readonly name: string;
+    readonly applied: boolean;
+    readonly appliedAt: string | undefined;
+    readonly durationMs: number | undefined;
+    /** The migration changed after it was applied here. */
+    readonly checksumMismatch: boolean;
+    readonly destructive: boolean;
+    readonly impact: string | undefined;
+}
+export interface MigrationRecord {
+    readonly id: string;
+    readonly name: string;
+    readonly checksum: string | null;
+    readonly appliedAt: string;
+    readonly durationMs: number;
+}
+export interface RunOptions {
+    /** Stop after this migration, inclusive. */
+    readonly to?: string;
+    /** The operator has read the impact of every destructive migration. */
+    readonly confirmDestructive?: boolean;
+    /** A backup was taken **and verified**. Required alongside the confirmation. */
+    readonly backupVerified?: boolean;
+}
+export interface RollbackOptions extends RunOptions {
+    /** How many applied migrations to revert. Defaults to one. */
+    readonly steps?: number;
+}
+export interface MigrationOutcome {
+    readonly id: string;
+    readonly name: string;
+    readonly direction: 'up' | 'down';
+    readonly durationMs: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/migrations/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAEjD,MAAM,WAAW,SAAS;IACxB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAA;IAC9B,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAErC,EAAE,CAAC,EAAE,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAClC;;;OAGG;IACH,IAAI,CAAC,EAAE,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACrC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;IACvC,uDAAuD;IACvD,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAA;IAClC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;CACpC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,UAAU;IACzB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAA;IACpB,uEAAuE;IACvE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAA;IACrC,gFAAgF;IAChF,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAA;CAClC;AAED,MAAM,WAAW,eAAgB,SAAQ,UAAU;IACjD,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,IAAI,GAAG,MAAM,CAAA;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B"}

package/dist/migrations/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/migrations/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/migrations/types.ts"],"names":[],"mappings":""}

package/dist/queue/bullmq.d.ts

@@ -0,0 +1,119 @@
+import type { Driver } from '../drivers/index.js';
+import { type Logger } from '../logger/index.js';
+import type { QueueConfig, QueueDriver, QueueDriverOptions } from './types.js';
+/**
+ * Only what this driver calls, described structurally.
+ *
+ * Importing bullmq's own types would put `bullmq` in the published type
+ * declarations, and it is an *optional* peer: a site running the database queue
+ * must not be asked to install it — nor to install `ioredis` behind it — just to
+ * typecheck (rule R1).
+ */
+interface BullmqConnectionLike {
+    readonly url: string;
+    readonly retryStrategy?: () => null;
+}
+/**
+ * The raw client bullmq keeps for its own connection. It is a documented escape
+ * hatch on the Redis backend, and the only way to store the one thing bullmq has
+ * no state for: a cancelled job.
+ */
+interface BullmqRedisLike {
+    ping(): Promise<string>;
+    hset(key: string, field: string, value: string): Promise<number>;
+    hget(key: string, field: string): Promise<string | null>;
+}
+interface BullmqBackendLike {
+    readonly client: Promise<BullmqRedisLike>;
+}
+interface BullmqAddOptionsLike {
+    readonly jobId?: string;
+    readonly delay?: number;
+    readonly priority?: number;
+    readonly attempts?: number;
+    readonly backoff?: {
+        readonly type: string;
+        readonly delay: number;
+    };
+}
+interface BullmqJobLike {
+    readonly id?: string | undefined;
+    readonly name: string;
+    readonly data: unknown;
+    readonly attemptsMade: number;
+    readonly failedReason?: string | undefined;
+    readonly timestamp: number;
+    readonly delay: number;
+    readonly opts: {
+        readonly attempts?: number | undefined;
+    };
+    getState(): Promise<string>;
+    moveToCompleted(returnValue: unknown, token: string, fetchNext?: boolean): Promise<unknown>;
+    moveToFailed(error: Error, token: string, fetchNext?: boolean): Promise<unknown>;
+    remove(): Promise<void>;
+}
+interface BullmqQueueLike {
+    add(name: string, data: unknown, options?: BullmqAddOptionsLike): Promise<BullmqJobLike>;
+    getJob(id: string): Promise<BullmqJobLike | undefined>;
+    getBackend(): BullmqBackendLike;
+    close(): Promise<void>;
+}
+interface BullmqWorkerLike {
+    getNextJob(token: string, options?: {
+        block?: boolean;
+    }): Promise<BullmqJobLike | undefined>;
+    startStalledCheckTimer(): Promise<void>;
+    close(force?: boolean): Promise<void>;
+}
+interface BullmqQueueOptionsLike {
+    readonly connection: BullmqConnectionLike;
+    readonly prefix?: string;
+}
+interface BullmqWorkerOptionsLike extends BullmqQueueOptionsLike {
+    readonly autorun: false;
+    readonly lockDuration: number;
+    readonly stalledInterval: number;
+    readonly skipLockRenewal: true;
+}
+export interface BullmqModule {
+    Queue: new (name: string, options: BullmqQueueOptionsLike) => BullmqQueueLike;
+    Worker: new (name: string, processor: null, options: BullmqWorkerOptionsLike) => BullmqWorkerLike;
+}
+/**
+ * Loads bullmq if the host application installed it. Absent is a normal
+ * outcome, not an error: it is what makes a site without Redis fall back to the
+ * database queue instead of failing to boot.
+ */
+export declare function loadBullmqModule(): Promise<BullmqModule | null>;
+export interface BullmqQueueOptions extends QueueDriverOptions {
+    readonly module: BullmqModule;
+    readonly url: string;
+    /**
+     * Namespace for every Redis key this driver writes. A Redis instance is often
+     * shared; two Cogenta sites on one server must not drain each other's jobs.
+     */
+    readonly prefix?: string;
+    /** Base delay of the exponential retry backoff. */
+    readonly backoffMs?: number;
+    /**
+     * How often a worker looks for jobs whose owner died. bullmq needs two passes
+     * separated by this interval before it returns such a job to the queue.
+     */
+    readonly stalledIntervalMs?: number;
+    readonly logger?: Logger;
+}
+/**
+ * The optimal job queue: Redis, driven through bullmq.
+ *
+ * Jobs are fetched by hand rather than by a bullmq `Worker` loop, because
+ * `QueueDriver.tick()` is the contract both drivers answer to — a site on shared
+ * hosting drives it from cron, and the same call has to mean the same thing
+ * here. bullmq documents this as the manual-fetching pattern, and it keeps the
+ * atomic claim (the L0 acceptance criterion) inside Redis where it belongs.
+ */
+export declare function createBullmqQueue(options: BullmqQueueOptions): QueueDriver;
+export interface BullmqQueueDriverOptions extends Omit<BullmqQueueOptions, 'module' | 'url'> {
+}
+export declare function bullmqQueueDriver(options?: BullmqQueueDriverOptions): Driver<QueueDriver, QueueConfig>;
+export {};
+//# sourceMappingURL=bullmq.d.ts.map

package/dist/queue/bullmq.d.ts.map

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