@krantho/persistence-postgres 0.0.0-stage → 1.0.0

package/dist/postgres-media-adapter.js

@@ -0,0 +1,167 @@
+import { randomUUID } from 'node:crypto';
+import { escapeSqlLikePattern } from '@krantho/persistence';
+const CURRENT = 'is_current AND deleted_at IS NULL';
+/**
+ * Postgres implementation of IMediaMetadataAdapter.
+ *
+ * Append-only: every change inserts a new version row and flips
+ * `is_current` inside one transaction; `UNIQUE (id, version)` rejects a
+ * concurrent duplicate. A delete appends a tombstone with `deleted_at` set.
+ */
+export class PostgresMediaAdapter {
+    sql;
+    constructor(sql) {
+        this.sql = sql;
+    }
+    async insert(record) {
+        const { id, ...data } = record;
+        return this.sql.begin(async (tx) => {
+            await this.writeVersion(tx, id, data, null);
+            return requireCurrent(tx, id);
+        });
+    }
+    async get(id) {
+        const row = await currentRow(this.sql, id);
+        return row ? rowToRecord(row) : null;
+    }
+    async list(options) {
+        const { where, params } = this.buildFilter(options);
+        const limit = `$${params.length + 1}`;
+        const offset = `$${params.length + 2}`;
+        const rows = (await this.sql.unsafe(`SELECT * FROM media ${where} ORDER BY created_at DESC LIMIT ${limit} OFFSET ${offset}`, [...params, options?.limit ?? null, options?.offset ?? 0]));
+        const count = (await this.sql.unsafe(`SELECT COUNT(*)::int AS count FROM media ${where}`, params));
+        return { items: rows.map(rowToRecord), total: count[0]?.count ?? 0 };
+    }
+    async appendVersion(id, changes) {
+        return this.sql.begin(async (tx) => {
+            const current = await currentRow(tx, id);
+            if (!current)
+                return null;
+            const { id: _id, createdAt: _createdAt, ...data } = rowToRecord(current);
+            await this.writeVersion(tx, id, { ...data, ...changes }, null);
+            return requireCurrent(tx, id);
+        });
+    }
+    async markDeleted(id) {
+        return this.sql.begin(async (tx) => {
+            const current = await currentRow(tx, id);
+            if (!current)
+                return null;
+            const superseded = rowToRecord(current);
+            await this.writeVersion(tx, id, tombstone(superseded), new Date().toISOString());
+            return superseded;
+        });
+    }
+    async stats() {
+        const [totals] = (await this.sql.unsafe(`SELECT COUNT(*)::int AS items, COALESCE(SUM(size), 0)::bigint AS size FROM media WHERE ${CURRENT}`));
+        const folders = (await this.sql.unsafe(`SELECT folder, COUNT(*)::int AS count FROM media WHERE ${CURRENT} AND folder IS NOT NULL GROUP BY folder`));
+        const byFolder = Object.fromEntries(folders.map((row) => [row.folder, row.count]));
+        return { totalItems: totals?.items ?? 0, totalSize: Number(totals?.size ?? 0), byFolder };
+    }
+    async listTags() {
+        const rows = (await this.sql.unsafe(`SELECT DISTINCT jsonb_array_elements_text(tags) AS tag FROM media WHERE ${CURRENT}`));
+        return rows.map((row) => row.tag).sort();
+    }
+    /** Insert the next version of `id` and make it current, inside `tx` */
+    async writeVersion(tx, id, data, deletedAt) {
+        const max = (await tx.unsafe('SELECT MAX(version) AS max_version FROM media WHERE id = $1', [
+            id,
+        ]));
+        const nextVersion = (max[0]?.max_version ?? 0) + 1;
+        await tx.unsafe('UPDATE media SET is_current = FALSE WHERE id = $1 AND is_current', [id]);
+        await tx.unsafe(`INSERT INTO media (row_id, id, version, is_current, filename, storage_key, url, alt_text, mime_type, size, width, height, folder, tags, crop, hotspot, deleted_at, created_at)
+       VALUES ($1, $2, $3, TRUE, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13, $14, $15, $16, $17)`, [
+            randomUUID(),
+            id,
+            nextVersion,
+            data.filename,
+            data.storageKey,
+            data.url,
+            data.altText,
+            data.mimeType,
+            data.size,
+            data.width,
+            data.height,
+            data.folder,
+            this.sql.json(data.tags),
+            data.crop ? this.sql.json({ ...data.crop }) : null,
+            data.hotspot ? this.sql.json({ ...data.hotspot }) : null,
+            deletedAt,
+            deletedAt ?? new Date().toISOString(),
+        ]);
+    }
+    /** WHERE clause for current records matching search, folder, and tag filters */
+    buildFilter(options) {
+        const conditions = [CURRENT];
+        const params = [];
+        if (options?.search) {
+            params.push(`%${escapeSqlLikePattern(options.search)}%`);
+            conditions.push(`filename ILIKE $${params.length} ESCAPE '\\'`);
+        }
+        if (options?.folder !== undefined) {
+            if (options.folder === '') {
+                conditions.push('folder IS NULL');
+            }
+            else {
+                params.push(options.folder);
+                conditions.push(`folder = $${params.length}`);
+            }
+        }
+        if (options?.tag) {
+            params.push(this.sql.json([options.tag]));
+            conditions.push(`tags @> $${params.length}`);
+        }
+        return { where: `WHERE ${conditions.join(' AND ')}`, params };
+    }
+}
+async function currentRow(sql, id) {
+    const rows = (await sql.unsafe(`SELECT * FROM media WHERE id = $1 AND ${CURRENT}`, [
+        id,
+    ]));
+    return rows[0];
+}
+async function requireCurrent(tx, id) {
+    const row = await currentRow(tx, id);
+    if (!row)
+        throw new Error(`Media item ${id} not found after write`);
+    return rowToRecord(row);
+}
+/** The tombstone version that replaces a deleted record */
+function tombstone(record) {
+    return {
+        filename: record.filename,
+        storageKey: record.storageKey,
+        url: record.url,
+        altText: '',
+        mimeType: record.mimeType,
+        size: 0,
+        width: null,
+        height: null,
+        folder: null,
+        tags: [],
+        crop: null,
+        hotspot: null,
+    };
+}
+function toTags(value) {
+    return Array.isArray(value) ? value.filter((tag) => typeof tag === 'string') : [];
+}
+function rowToRecord(row) {
+    return {
+        id: row.id,
+        filename: row.filename,
+        storageKey: row.storage_key,
+        url: row.url,
+        altText: row.alt_text,
+        mimeType: row.mime_type,
+        size: row.size,
+        width: row.width,
+        height: row.height,
+        folder: row.folder,
+        tags: toTags(row.tags),
+        crop: row.crop,
+        hotspot: row.hotspot,
+        createdAt: row.created_at.toISOString(),
+    };
+}
+//# sourceMappingURL=postgres-media-adapter.js.map

package/dist/postgres-media-adapter.js.map

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

package/dist/postgres-media-folder-adapter.d.ts

@@ -0,0 +1,12 @@
+import type { IMediaFolderStorage, MediaFolder } from '@krantho/persistence';
+import type { Sql } from 'postgres';
+/** Postgres implementation of IMediaFolderStorage, over the `media_folders` table (v007) */
+export declare class PostgresMediaFolderAdapter implements IMediaFolderStorage {
+    private readonly sql;
+    constructor(sql: Sql);
+    listFolders(): Promise<MediaFolder[]>;
+    createFolder(name: string, parentId?: string | null): Promise<MediaFolder>;
+    renameFolder(id: string, name: string): Promise<MediaFolder | null>;
+    deleteFolder(id: string): Promise<void>;
+}
+//# sourceMappingURL=postgres-media-folder-adapter.d.ts.map

package/dist/postgres-media-folder-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-media-folder-adapter.d.ts","sourceRoot":"","sources":["../src/postgres-media-folder-adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAC5E,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AASnC,4FAA4F;AAC5F,qBAAa,0BAA2B,YAAW,mBAAmB;IACxD,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,GAAG;IAE/B,WAAW,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAOrC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC;IAkB1E,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAOnE,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAc9C"}

package/dist/postgres-media-folder-adapter.js

@@ -0,0 +1,60 @@
+import { randomUUID } from 'node:crypto';
+/** Postgres implementation of IMediaFolderStorage, over the `media_folders` table (v007) */
+export class PostgresMediaFolderAdapter {
+    sql;
+    constructor(sql) {
+        this.sql = sql;
+    }
+    async listFolders() {
+        // Byte-order collation, matching SQLite's BINARY ordering
+        const rows = await this.sql `
+      SELECT * FROM media_folders ORDER BY name COLLATE "C"`;
+        return rows.map(rowToFolder);
+    }
+    async createFolder(name, parentId) {
+        if (parentId) {
+            const parent = await this.sql `SELECT id FROM media_folders WHERE id = ${parentId}`;
+            if (parent.length === 0)
+                throw new Error(`Parent folder "${parentId}" not found`);
+        }
+        const folder = {
+            id: randomUUID(),
+            name: name.trim(),
+            parentId: parentId ?? null,
+            createdAt: new Date().toISOString(),
+        };
+        await this.sql `
+      INSERT INTO media_folders (id, name, parent_id, created_at)
+      VALUES (${folder.id}, ${folder.name}, ${folder.parentId}, ${folder.createdAt})`;
+        return folder;
+    }
+    async renameFolder(id, name) {
+        const rows = await this.sql `
+      UPDATE media_folders SET name = ${name.trim()} WHERE id = ${id} RETURNING *`;
+        const row = rows[0];
+        return row ? rowToFolder(row) : null;
+    }
+    async deleteFolder(id) {
+        const existing = await this.sql `SELECT id FROM media_folders WHERE id = ${id}`;
+        if (existing.length === 0)
+            throw new Error(`Folder "${id}" not found`);
+        const child = await this.sql `SELECT id FROM media_folders WHERE parent_id = ${id} LIMIT 1`;
+        if (child.length > 0)
+            throw new Error('Cannot delete folder: has child folders');
+        const media = await this.sql `
+      SELECT id FROM media
+      WHERE folder = ${id} AND is_current AND deleted_at IS NULL LIMIT 1`;
+        if (media.length > 0)
+            throw new Error('Cannot delete folder: contains media items');
+        await this.sql `DELETE FROM media_folders WHERE id = ${id}`;
+    }
+}
+function rowToFolder(row) {
+    return {
+        id: row.id,
+        name: row.name,
+        parentId: row.parent_id,
+        createdAt: row.created_at.toISOString(),
+    };
+}
+//# sourceMappingURL=postgres-media-folder-adapter.js.map

package/dist/postgres-media-folder-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-media-folder-adapter.js","sourceRoot":"","sources":["../src/postgres-media-folder-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAWxC,4FAA4F;AAC5F,MAAM,OAAO,0BAA0B;IACR;IAA7B,YAA6B,GAAQ;QAAR,QAAG,GAAH,GAAG,CAAK;IAAG,CAAC;IAEzC,KAAK,CAAC,WAAW;QACf,0DAA0D;QAC1D,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAAa;4DACgB,CAAA;QACxD,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;IAC9B,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,IAAY,EAAE,QAAwB;QACvD,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAA,2CAA2C,QAAQ,EAAE,CAAA;YAClF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,QAAQ,aAAa,CAAC,CAAA;QACnF,CAAC;QAED,MAAM,MAAM,GAAgB;YAC1B,EAAE,EAAE,UAAU,EAAE;YAChB,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;YACjB,QAAQ,EAAE,QAAQ,IAAI,IAAI;YAC1B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAA;QACD,MAAM,IAAI,CAAC,GAAG,CAAA;;gBAEF,MAAM,CAAC,EAAE,KAAK,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC,SAAS,GAAG,CAAA;QACjF,OAAO,MAAM,CAAA;IACf,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,EAAU,EAAE,IAAY;QACzC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAAa;wCACJ,IAAI,CAAC,IAAI,EAAE,eAAe,EAAE,cAAc,CAAA;QAC9E,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;QACnB,OAAO,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IACtC,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,EAAU;QAC3B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAA,2CAA2C,EAAE,EAAE,CAAA;QAC9E,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,WAAW,EAAE,aAAa,CAAC,CAAA;QAEtE,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,GAAG,CAAA,kDAAkD,EAAE,UAAU,CAAA;QAC1F,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAA;QAEhF,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,GAAG,CAAA;;uBAET,EAAE,gDAAgD,CAAA;QACrE,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAA;QAEnF,MAAM,IAAI,CAAC,GAAG,CAAA,wCAAwC,EAAE,EAAE,CAAA;IAC5D,CAAC;CACF;AAED,SAAS,WAAW,CAAC,GAAc;IACjC,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,QAAQ,EAAE,GAAG,CAAC,SAAS;QACvB,SAAS,EAAE,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE;KACxC,CAAA;AACH,CAAC"}

package/dist/postgres-page-cache-store.d.ts

@@ -0,0 +1,23 @@
+import type { IPageCacheStore, PageCacheEntry, PageCacheMarkOptions, PageCacheTagState, PageCacheValue } from '@krantho/persistence';
+import type { Sql } from 'postgres';
+/**
+ * Postgres implementation of `IPageCacheStore`, shared by every instance of a
+ * site. Timestamps come from the database clock (`clock_timestamp()`), so an
+ * entry written on one instance and a mark made on another compare on one clock.
+ */
+export declare class PostgresPageCacheStore implements IPageCacheStore {
+    private readonly sql;
+    constructor(sql: Sql);
+    get(key: string): Promise<PageCacheEntry | null>;
+    set(key: string, value: PageCacheValue, tags: readonly string[]): Promise<void>;
+    tagsRevalidatedSince(tags: readonly string[], since: number): Promise<PageCacheTagState>;
+    /**
+     * One statement: atomic, and each tag's timestamps only ever move forward
+     * (`GREATEST` ignores NULL, so a stale mark keeps an earlier expiry). Tags are
+     * upserted in sorted order so concurrent marks lock rows in one order and
+     * cannot deadlock.
+     */
+    markTags(tags: readonly string[], options: PageCacheMarkOptions): Promise<void>;
+    countTagged(tags: readonly string[]): Promise<number>;
+}
+//# sourceMappingURL=postgres-page-cache-store.d.ts.map

package/dist/postgres-page-cache-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-page-cache-store.d.ts","sourceRoot":"","sources":["../src/postgres-page-cache-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACf,MAAM,sBAAsB,CAAA;AAM7B,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAanC;;;;GAIG;AACH,qBAAa,sBAAuB,YAAW,eAAe;IAChD,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,GAAG;IAE/B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAYhD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAe/E,oBAAoB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAa9F;;;;;OAKG;IACG,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAa/E,WAAW,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CAO5D"}

package/dist/postgres-page-cache-store.js

@@ -0,0 +1,80 @@
+import { decodePageCacheValue, encodePageCacheValue, uniquePageCacheTags, } from '@krantho/persistence';
+/**
+ * Postgres implementation of `IPageCacheStore`, shared by every instance of a
+ * site. Timestamps come from the database clock (`clock_timestamp()`), so an
+ * entry written on one instance and a mark made on another compare on one clock.
+ */
+export class PostgresPageCacheStore {
+    sql;
+    constructor(sql) {
+        this.sql = sql;
+    }
+    async get(key) {
+        const rows = await this.sql `
+      SELECT value, tags, last_modified FROM page_cache_entries WHERE key = ${key}`;
+        const row = rows[0];
+        if (!row)
+            return null;
+        return {
+            value: decodePageCacheValue(row.value),
+            tags: row.tags,
+            lastModified: Number(row.last_modified),
+        };
+    }
+    async set(key, value, tags) {
+        await this.sql `
+      INSERT INTO page_cache_entries (key, value, tags, last_modified)
+      VALUES (
+        ${key},
+        ${encodePageCacheValue(value)},
+        ${this.sql.array(uniquePageCacheTags(tags))}::text[],
+        floor(extract(epoch FROM clock_timestamp()) * 1000)::bigint
+      )
+      ON CONFLICT (key) DO UPDATE SET
+        value = EXCLUDED.value,
+        tags = EXCLUDED.tags,
+        last_modified = EXCLUDED.last_modified`;
+    }
+    async tagsRevalidatedSince(tags, since) {
+        if (tags.length === 0)
+            return 'fresh';
+        const rows = await this.sql `
+      SELECT
+        COALESCE(bool_or(expired_at >= ${Math.floor(since)}::bigint), false) AS expired,
+        COALESCE(bool_or(stale_at >= ${Math.floor(since)}::bigint), false) AS stale
+      FROM page_cache_tags
+      WHERE tag = ANY(${this.sql.array(uniquePageCacheTags(tags))}::text[])`;
+        const row = rows[0];
+        if (row?.expired)
+            return 'expired';
+        return row?.stale ? 'stale' : 'fresh';
+    }
+    /**
+     * One statement: atomic, and each tag's timestamps only ever move forward
+     * (`GREATEST` ignores NULL, so a stale mark keeps an earlier expiry). Tags are
+     * upserted in sorted order so concurrent marks lock rows in one order and
+     * cannot deadlock.
+     */
+    async markTags(tags, options) {
+        if (tags.length === 0)
+            return;
+        await this.sql `
+      WITH clock AS (SELECT floor(extract(epoch FROM clock_timestamp()) * 1000)::bigint AS ms)
+      INSERT INTO page_cache_tags (tag, stale_at, expired_at)
+      SELECT t, clock.ms, CASE WHEN ${options.expire}::boolean THEN clock.ms END
+      FROM unnest(${this.sql.array(uniquePageCacheTags(tags).sort())}::text[]) AS t, clock
+      ORDER BY t
+      ON CONFLICT (tag) DO UPDATE SET
+        stale_at = GREATEST(page_cache_tags.stale_at, EXCLUDED.stale_at),
+        expired_at = GREATEST(page_cache_tags.expired_at, EXCLUDED.expired_at)`;
+    }
+    async countTagged(tags) {
+        if (tags.length === 0)
+            return 0;
+        const rows = await this.sql `
+      SELECT COUNT(*) AS count FROM page_cache_entries
+      WHERE tags && ${this.sql.array(uniquePageCacheTags(tags))}::text[]`;
+        return Number(rows[0]?.count ?? 0);
+    }
+}
+//# sourceMappingURL=postgres-page-cache-store.js.map

package/dist/postgres-page-cache-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-page-cache-store.js","sourceRoot":"","sources":["../src/postgres-page-cache-store.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,sBAAsB,CAAA;AAc7B;;;;GAIG;AACH,MAAM,OAAO,sBAAsB;IACJ;IAA7B,YAA6B,GAAQ;QAAR,QAAG,GAAH,GAAG,CAAK;IAAG,CAAC;IAEzC,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAAY;8EACmC,GAAG,EAAE,CAAA;QAC/E,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;QACnB,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAA;QACrB,OAAO;YACL,KAAK,EAAE,oBAAoB,CAAC,GAAG,CAAC,KAAK,CAAC;YACtC,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC;SACxC,CAAA;IACH,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAqB,EAAE,IAAuB;QACnE,MAAM,IAAI,CAAC,GAAG,CAAA;;;UAGR,GAAG;UACH,oBAAoB,CAAC,KAAK,CAAC;UAC3B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;;;;;;+CAMJ,CAAA;IAC7C,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,IAAuB,EAAE,KAAa;QAC/D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,OAAO,CAAA;QACrC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAAe;;yCAEL,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;uCACnB,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;;wBAEhC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,WAAW,CAAA;QACxE,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;QACnB,IAAI,GAAG,EAAE,OAAO;YAAE,OAAO,SAAS,CAAA;QAClC,OAAO,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAA;IACvC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CAAC,IAAuB,EAAE,OAA6B;QACnE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAM;QAC7B,MAAM,IAAI,CAAC,GAAG,CAAA;;;sCAGoB,OAAO,CAAC,MAAM;oBAChC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;;;;+EAIW,CAAA;IAC7E,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,IAAuB;QACvC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAA;QAC/B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAAqB;;sBAE9B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,UAAU,CAAA;QACrE,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC,CAAA;IACpC,CAAC;CACF"}

package/dist/postgres-retention-adapter.d.ts

@@ -0,0 +1,14 @@
+import type { IRetentionAdapter, PurgeResult } from '@krantho/persistence';
+import type { Sql } from 'postgres';
+/** Postgres implementation of version retention/purge */
+export declare class PostgresRetentionAdapter implements IRetentionAdapter {
+    private readonly sql;
+    constructor(sql: Sql);
+    purgeVersions(maxVersionsPerItem: number): Promise<PurgeResult[]>;
+    countVersions(): Promise<{
+        total: number;
+        current: number;
+        historical: number;
+    }>;
+}
+//# sourceMappingURL=postgres-retention-adapter.d.ts.map

package/dist/postgres-retention-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-retention-adapter.d.ts","sourceRoot":"","sources":["../src/postgres-retention-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAC1E,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AASnC,yDAAyD;AACzD,qBAAa,wBAAyB,YAAW,iBAAiB;IACpD,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,GAAG;IAE/B,aAAa,CAAC,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAkDjE,aAAa,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CAevF"}

package/dist/postgres-retention-adapter.js

@@ -0,0 +1,61 @@
+/** Postgres implementation of version retention/purge */
+export class PostgresRetentionAdapter {
+    sql;
+    constructor(sql) {
+        this.sql = sql;
+    }
+    async purgeVersions(maxVersionsPerItem) {
+        if (maxVersionsPerItem < 1) {
+            throw new Error('maxVersionsPerItem must be at least 1');
+        }
+        // Find items with more versions than the limit
+        const groups = await this.sql `
+      SELECT collection, slug, locale, COUNT(*) as version_count
+      FROM content
+      WHERE deleted_at IS NULL
+      GROUP BY collection, slug, locale
+      HAVING COUNT(*) > ${maxVersionsPerItem}`;
+        const results = [];
+        for (const group of groups) {
+            const versionCount = parseInt(group.version_count, 10);
+            const toPurge = versionCount - maxVersionsPerItem;
+            // Delete oldest non-current versions, never the one that is live. When the
+            // live version is among the oldest, fewer rows go and the document stays
+            // over the limit until later versions age out.
+            const deleted = await this.sql.unsafe(`DELETE FROM content WHERE id IN (
+          SELECT id FROM content
+          WHERE collection = $1 AND slug = $2 AND locale = $3 AND is_current = FALSE
+            AND version IS DISTINCT FROM (
+              SELECT live_version FROM content
+              WHERE collection = $1 AND slug = $2 AND locale = $3 AND is_current = TRUE
+            )
+          ORDER BY version ASC
+          LIMIT $4
+        )`, [group.collection, group.slug, group.locale, toPurge]);
+            const changes = deleted.count;
+            if (changes > 0) {
+                results.push({
+                    collection: group.collection,
+                    slug: group.slug,
+                    purged: changes,
+                    retained: versionCount - changes,
+                });
+            }
+        }
+        return results;
+    }
+    async countVersions() {
+        const totalRows = await this.sql `
+      SELECT COUNT(*) as count FROM content WHERE deleted_at IS NULL`;
+        const currentRows = await this.sql `
+      SELECT COUNT(*) as count FROM content WHERE is_current = TRUE AND deleted_at IS NULL`;
+        const total = parseInt(totalRows[0]?.count ?? '0', 10);
+        const current = parseInt(currentRows[0]?.count ?? '0', 10);
+        return {
+            total,
+            current,
+            historical: total - current,
+        };
+    }
+}
+//# sourceMappingURL=postgres-retention-adapter.js.map

package/dist/postgres-retention-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-retention-adapter.js","sourceRoot":"","sources":["../src/postgres-retention-adapter.ts"],"names":[],"mappings":"AAUA,yDAAyD;AACzD,MAAM,OAAO,wBAAwB;IACN;IAA7B,YAA6B,GAAQ;QAAR,QAAG,GAAH,GAAG,CAAK;IAAG,CAAC;IAEzC,KAAK,CAAC,aAAa,CAAC,kBAA0B;QAC5C,IAAI,kBAAkB,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAA;QAC1D,CAAC;QAED,+CAA+C;QAC/C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAgB;;;;;0BAKvB,kBAAkB,EAAE,CAAA;QAE1C,MAAM,OAAO,GAAkB,EAAE,CAAA;QAEjC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,YAAY,GAAG,QAAQ,CAAC,KAAK,CAAC,aAAa,EAAE,EAAE,CAAC,CAAA;YACtD,MAAM,OAAO,GAAG,YAAY,GAAG,kBAAkB,CAAA;YAEjD,2EAA2E;YAC3E,yEAAyE;YACzE,+CAA+C;YAC/C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,CACnC;;;;;;;;;UASE,EACF,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CACtD,CAAA;YAED,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAA;YAC7B,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;gBAChB,OAAO,CAAC,IAAI,CAAC;oBACX,UAAU,EAAE,KAAK,CAAC,UAAU;oBAC5B,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,MAAM,EAAE,OAAO;oBACf,QAAQ,EAAE,YAAY,GAAG,OAAO;iBACjC,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,GAAG,CAAqB;qEACY,CAAA;QACjE,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,GAAG,CAAqB;2FACgC,CAAA;QAEvF,MAAM,KAAK,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,GAAG,EAAE,EAAE,CAAC,CAAA;QACtD,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,GAAG,EAAE,EAAE,CAAC,CAAA;QAE1D,OAAO;YACL,KAAK;YACL,OAAO;YACP,UAAU,EAAE,KAAK,GAAG,OAAO;SAC5B,CAAA;IACH,CAAC;CACF"}

package/dist/postgres-seo-config-adapter.d.ts

@@ -0,0 +1,14 @@
+import type { ISeoConfigAdapter, SeoConfig, SeoConfigScope } from '@krantho/persistence';
+import type { Sql } from 'postgres';
+/** Postgres implementation of ISeoConfigAdapter */
+export declare class PostgresSeoConfigAdapter implements ISeoConfigAdapter {
+    private readonly sql;
+    constructor(sql: Sql);
+    getConfig(id: string): Promise<SeoConfig | null>;
+    saveConfig(config: Omit<SeoConfig, 'createdAt' | 'updatedAt'>): Promise<void>;
+    deleteConfig(id: string): Promise<void>;
+    listConfigs(scope?: SeoConfigScope): Promise<SeoConfig[]>;
+    listConfigsByPrefix(prefix: string): Promise<SeoConfig[]>;
+    deleteAllConfigs(): Promise<number>;
+}
+//# sourceMappingURL=postgres-seo-config-adapter.d.ts.map

package/dist/postgres-seo-config-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-seo-config-adapter.d.ts","sourceRoot":"","sources":["../src/postgres-seo-config-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAGxF,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAsBnC,mDAAmD;AACnD,qBAAa,wBAAyB,YAAW,iBAAiB;IACpD,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,GAAG;IAE/B,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAOhD,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,WAAW,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB7E,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC,WAAW,CAAC,KAAK,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAUzD,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAQzD,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;CAI1C"}

package/dist/postgres-seo-config-adapter.js

@@ -0,0 +1,59 @@
+import { escapeSqlLikePattern } from '@krantho/persistence';
+function toSeoConfig(row) {
+    return {
+        id: row.id,
+        scope: row.scope,
+        config: row.config,
+        createdAt: row.created_at instanceof Date ? row.created_at.toISOString() : String(row.created_at),
+        updatedAt: row.updated_at instanceof Date ? row.updated_at.toISOString() : String(row.updated_at),
+    };
+}
+/** Postgres implementation of ISeoConfigAdapter */
+export class PostgresSeoConfigAdapter {
+    sql;
+    constructor(sql) {
+        this.sql = sql;
+    }
+    async getConfig(id) {
+        const rows = await this.sql `
+      SELECT * FROM seo_config WHERE id = ${id}`;
+        const row = rows[0];
+        return row ? toSeoConfig(row) : null;
+    }
+    async saveConfig(config) {
+        if (config.scope === 'document' || config.id.startsWith('doc:')) {
+            throw new Error('Document SEO belongs in versioned document metadata');
+        }
+        // Bind the object with sql.json: JSON.stringify plus a ::jsonb cast is
+        // encoded again by the driver and stores the JSON text as a string
+        await this.sql.unsafe(`INSERT INTO seo_config (id, scope, config, updated_at)
+       VALUES ($1, $2, $3, NOW())
+       ON CONFLICT (id) DO UPDATE SET
+         scope = EXCLUDED.scope,
+         config = EXCLUDED.config,
+         updated_at = NOW()`, [config.id, config.scope, this.sql.json(config.config)]);
+    }
+    async deleteConfig(id) {
+        await this.sql `DELETE FROM seo_config WHERE id = ${id}`;
+    }
+    async listConfigs(scope) {
+        const rows = scope
+            ? await this.sql `
+          SELECT * FROM seo_config WHERE scope = ${scope} ORDER BY id`
+            : await this.sql `
+          SELECT * FROM seo_config ORDER BY id`;
+        return rows.map(toSeoConfig);
+    }
+    async listConfigsByPrefix(prefix) {
+        const escaped = escapeSqlLikePattern(prefix);
+        const pattern = `${escaped}%`;
+        const rows = await this.sql `
+      SELECT * FROM seo_config WHERE id LIKE ${pattern} ESCAPE '\\' ORDER BY id`;
+        return rows.map(toSeoConfig);
+    }
+    async deleteAllConfigs() {
+        const result = await this.sql `DELETE FROM seo_config`;
+        return result.count;
+    }
+}
+//# sourceMappingURL=postgres-seo-config-adapter.js.map

package/dist/postgres-seo-config-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-seo-config-adapter.js","sourceRoot":"","sources":["../src/postgres-seo-config-adapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAY3D,SAAS,WAAW,CAAC,GAAiB;IACpC,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,KAAK,EAAE,GAAG,CAAC,KAAuB;QAClC,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,SAAS,EACP,GAAG,CAAC,UAAU,YAAY,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC;QACxF,SAAS,EACP,GAAG,CAAC,UAAU,YAAY,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC;KACzF,CAAA;AACH,CAAC;AAED,mDAAmD;AACnD,MAAM,OAAO,wBAAwB;IACN;IAA7B,YAA6B,GAAQ;QAAR,QAAG,GAAH,GAAG,CAAK;IAAG,CAAC;IAEzC,KAAK,CAAC,SAAS,CAAC,EAAU;QACxB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAAgB;4CACH,EAAE,EAAE,CAAA;QAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;QACnB,OAAO,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IACtC,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAkD;QACjE,IAAI,MAAM,CAAC,KAAK,KAAK,UAAU,IAAI,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAChE,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAA;QACxE,CAAC;QACD,uEAAuE;QACvE,mEAAmE;QACnE,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,CACnB;;;;;4BAKsB,EACtB,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,MAAe,CAAC,CAAC,CACjE,CAAA;IACH,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,EAAU;QAC3B,MAAM,IAAI,CAAC,GAAG,CAAA,qCAAqC,EAAE,EAAE,CAAA;IACzD,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,KAAsB;QACtC,MAAM,IAAI,GAAG,KAAK;YAChB,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,CAAgB;mDACa,KAAK,cAAc;YAChE,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,CAAgB;+CACS,CAAA;QAE3C,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;IAC9B,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,MAAc;QACtC,MAAM,OAAO,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAA;QAC5C,MAAM,OAAO,GAAG,GAAG,OAAO,GAAG,CAAA;QAC7B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAAgB;+CACA,OAAO,0BAA0B,CAAA;QAC5E,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;IAC9B,CAAC;IAED,KAAK,CAAC,gBAAgB;QACpB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAA,wBAAwB,CAAA;QACrD,OAAO,MAAM,CAAC,KAAK,CAAA;IACrB,CAAC;CACF"}

package/dist/postgres-site-settings-adapter.d.ts

@@ -0,0 +1,11 @@
+import type { ISiteSettingsAdapter } from '@krantho/persistence';
+import type { Sql } from 'postgres';
+/** Postgres implementation of runtime site settings */
+export declare class PostgresSiteSettingsAdapter implements ISiteSettingsAdapter {
+    private readonly sql;
+    constructor(sql: Sql);
+    getSetting(key: string): Promise<string | null>;
+    setSetting(key: string, value: string): Promise<void>;
+    getAllSettings(): Promise<Record<string, string>>;
+}
+//# sourceMappingURL=postgres-site-settings-adapter.d.ts.map

package/dist/postgres-site-settings-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-site-settings-adapter.d.ts","sourceRoot":"","sources":["../src/postgres-site-settings-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAChE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAEnC,uDAAuD;AACvD,qBAAa,2BAA4B,YAAW,oBAAoB;IAC1D,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,GAAG;IAE/B,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAM/C,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASrD,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CASxD"}

package/dist/postgres-site-settings-adapter.js

@@ -0,0 +1,30 @@
+/** Postgres implementation of runtime site settings */
+export class PostgresSiteSettingsAdapter {
+    sql;
+    constructor(sql) {
+        this.sql = sql;
+    }
+    async getSetting(key) {
+        const rows = await this.sql `
+      SELECT value FROM site_settings WHERE key = ${key}`;
+        return rows[0]?.value ?? null;
+    }
+    async setSetting(key, value) {
+        await this.sql `
+      INSERT INTO site_settings (key, value, updated_at)
+      VALUES (${key}, ${value}, NOW())
+      ON CONFLICT (key) DO UPDATE SET
+        value = EXCLUDED.value,
+        updated_at = NOW()`;
+    }
+    async getAllSettings() {
+        const rows = await this.sql `
+      SELECT key, value FROM site_settings`;
+        const result = {};
+        for (const row of rows) {
+            result[row.key] = row.value;
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=postgres-site-settings-adapter.js.map

package/dist/postgres-site-settings-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-site-settings-adapter.js","sourceRoot":"","sources":["../src/postgres-site-settings-adapter.ts"],"names":[],"mappings":"AAGA,uDAAuD;AACvD,MAAM,OAAO,2BAA2B;IACT;IAA7B,YAA6B,GAAQ;QAAR,QAAG,GAAH,GAAG,CAAK;IAAG,CAAC;IAEzC,KAAK,CAAC,UAAU,CAAC,GAAW;QAC1B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAAqB;oDACA,GAAG,EAAE,CAAA;QACrD,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,IAAI,CAAA;IAC/B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,GAAW,EAAE,KAAa;QACzC,MAAM,IAAI,CAAC,GAAG,CAAA;;gBAEF,GAAG,KAAK,KAAK;;;2BAGF,CAAA;IACzB,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAAkC;2CACtB,CAAA;QACvC,MAAM,MAAM,GAA2B,EAAE,CAAA;QACzC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,KAAK,CAAA;QAC7B,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;CACF"}

package/dist/postgres-webhook-delivery-adapter.d.ts

@@ -0,0 +1,27 @@
+import type { IWebhookDeliveryAdapter, NewWebhookDelivery, StoredWebhookDelivery, WebhookDeliveryRecord } from '@krantho/persistence';
+import type { Sql } from 'postgres';
+/** Postgres implementation of webhook delivery log */
+export declare class PostgresWebhookDeliveryAdapter implements IWebhookDeliveryAdapter {
+    private readonly sql;
+    constructor(sql: Sql);
+    listDeliveries(options: {
+        limit: number;
+        offset: number;
+        status?: 'pending' | 'delivered' | 'failed' | undefined;
+    }): Promise<{
+        deliveries: WebhookDeliveryRecord[];
+        total: number;
+    }>;
+    getDelivery(id: number): Promise<StoredWebhookDelivery | null>;
+    requeueDelivery(id: number, dueAt: Date): Promise<WebhookDeliveryRecord | null>;
+    logDelivery(delivery: NewWebhookDelivery): Promise<number>;
+    markDelivered(id: number, status: number): Promise<void>;
+    markFailed(id: number, status: number, nextRetryAt: Date): Promise<void>;
+    claimDueDeliveries(options: {
+        urls: readonly string[];
+        now: Date;
+        leaseUntil: Date;
+        limit: number;
+    }): Promise<StoredWebhookDelivery[]>;
+}
+//# sourceMappingURL=postgres-webhook-delivery-adapter.d.ts.map

package/dist/postgres-webhook-delivery-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-webhook-delivery-adapter.d.ts","sourceRoot":"","sources":["../src/postgres-webhook-delivery-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,sBAAsB,CAAA;AAE7B,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAsCnC,sDAAsD;AACtD,qBAAa,8BAA+B,YAAW,uBAAuB;IAChE,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,GAAG;IAE/B,cAAc,CAAC,OAAO,EAAE;QAC5B,KAAK,EAAE,MAAM,CAAA;QACb,MAAM,EAAE,MAAM,CAAA;QACd,MAAM,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAA;KACxD,GAAG,OAAO,CAAC;QAAE,UAAU,EAAE,qBAAqB,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAwB7D,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAQ9D,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAU/E,WAAW,CAAC,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAY1D,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxD,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxE,kBAAkB,CAAC,OAAO,EAAE;QAChC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;QACvB,GAAG,EAAE,IAAI,CAAA;QACT,UAAU,EAAE,IAAI,CAAA;QAChB,KAAK,EAAE,MAAM,CAAA;KACd,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;CAkBrC"}