@krantho/persistence-postgres 0.0.0-stage → 1.0.1

package/dist/postgres-adapter.js

@@ -0,0 +1,327 @@
+import { randomUUID } from 'node:crypto';
+import { canonicalJson } from '@krantho/core';
+import { authoredOf, ContentWriteConflict, liveOnWrite, nextAuthored, publicationOfFile, resolveLiveVersion, sameAuthoredValues, storedStatus, } from '@krantho/persistence';
+import { runContentQuery } from './content-query.js';
+import { runMigrations } from './migration-runner.js';
+import { postgresMigrations } from './migrations/index.js';
+import { rowToContentDocument, rowToDocumentMeta } from './row-mapping.js';
+/**
+ * Status default used when a file declares none.
+ *
+ * A deployment sets it through `content.defaultStatus.filesystem` in the
+ * krantho configuration tree; the server passes the resolved value down. This
+ * literal is the standalone-library fallback and mirrors that tree's default.
+ */
+export const DEFAULT_POSTGRES_STATUS = {
+    filesystem: 'published',
+};
+export class PostgresAdapter {
+    sql;
+    defaultStatus;
+    defaultLocale;
+    initialization = null;
+    constructor(sql, options) {
+        this.sql = sql;
+        this.defaultLocale = options.defaultLocale;
+        this.defaultStatus = { ...DEFAULT_POSTGRES_STATUS, ...options.defaultStatus };
+    }
+    static async create(sql, options) {
+        const adapter = new PostgresAdapter(sql, options);
+        await adapter.ensureInitialized();
+        return adapter;
+    }
+    /**
+     * Run migrations once per instance. Concurrent callers share the in-flight
+     * run; a failed run is dropped so the next call retries it.
+     */
+    ensureInitialized() {
+        this.initialization ??= runMigrations(this.sql, postgresMigrations).then(() => undefined, (err) => {
+            this.initialization = null;
+            throw err;
+        });
+        return this.initialization;
+    }
+    // --- IContentLoader methods ---
+    async exists(slug) {
+        await this.ensureInitialized();
+        const rows = await this.sql `
+      SELECT COUNT(*) as count FROM content
+      WHERE slug = ${slug} AND is_current = TRUE AND deleted_at IS NULL`;
+        return parseInt(rows[0]?.count ?? '0', 10) > 0;
+    }
+    async read(slug) {
+        await this.ensureInitialized();
+        const rows = await this.sql `
+      SELECT * FROM content
+      WHERE slug = ${slug} AND is_current = TRUE AND deleted_at IS NULL
+      LIMIT 1`;
+        const row = rows[0];
+        if (!row)
+            throw new Error(`Content not found: ${slug}`);
+        const yamlLines = Object.entries(row.fields).map(([k, v]) => `${k}: ${JSON.stringify(v)}`);
+        return `---\n${yamlLines.join('\n')}\n---\n${row.body}`;
+    }
+    async getMetadata(slug) {
+        await this.ensureInitialized();
+        const rows = await this.sql `
+      SELECT * FROM content
+      WHERE slug = ${slug} AND is_current = TRUE AND deleted_at IS NULL
+      LIMIT 1`;
+        const row = rows[0];
+        if (!row)
+            throw new Error(`Content not found: ${slug}`);
+        return {
+            size: row.body.length + JSON.stringify(row.fields).length,
+            lastModified: new Date(row.created_at),
+        };
+    }
+    // --- IPersistenceAdapter methods ---
+    async listSlugs() {
+        await this.ensureInitialized();
+        const rows = await this.sql `
+      SELECT DISTINCT slug FROM content WHERE is_current = TRUE AND deleted_at IS NULL`;
+        return rows.map((r) => r.slug);
+    }
+    async writeContent(data, changedBy) {
+        await this.ensureInitialized();
+        await this.appendVersion(data.collection, data.slug, data.locale ?? this.defaultLocale, {
+            authored: authoredOf(data),
+            expectedVersion: data.expectedVersion,
+            fields: data.fields,
+            body: data.body,
+            html: data.html ?? '',
+            sections: data.sections ?? {},
+            source: 'api',
+            filePath: null,
+            changedBy: changedBy ?? null,
+            publication: data.publication,
+        });
+    }
+    async deleteContent(collection, slug, locale, changedBy) {
+        await this.ensureInitialized();
+        const loc = locale ?? this.defaultLocale;
+        const rows = await this.sql `
+      SELECT * FROM content
+      WHERE collection = ${collection} AND slug = ${slug} AND locale = ${loc}
+        AND is_current = TRUE AND deleted_at IS NULL
+      LIMIT 1`;
+        const row = rows[0];
+        if (!row)
+            return;
+        const maxRows = await this.sql `
+      SELECT MAX(version) as max_version FROM content
+      WHERE collection = ${collection} AND slug = ${slug} AND locale = ${row.locale}`;
+        const nextVersion = (maxRows[0]?.max_version ?? 0) + 1;
+        const now = new Date().toISOString();
+        await this.sql.begin(async (tx) => {
+            await tx.unsafe('UPDATE content SET is_current = FALSE WHERE collection = $1 AND slug = $2 AND locale = $3 AND is_current = TRUE', [collection, slug, row.locale]);
+            await tx.unsafe(`INSERT INTO content (id, collection, slug, locale, version, is_current, status, fields, body, html, sections, source, file_path, changed_by, deleted_at, created_at, live_version)
+         VALUES ($1, $2, $3, $4, $5, TRUE, 'deleted', '{}'::jsonb, '', '', '{}'::jsonb, 'api', NULL, $6, $7, $7, NULL)`, [randomUUID(), collection, slug, row.locale, nextVersion, changedBy ?? null, now]);
+        });
+    }
+    async getContent(collection, slug, locale) {
+        await this.ensureInitialized();
+        const loc = locale ?? this.defaultLocale;
+        const rows = await this.sql `
+      SELECT * FROM content
+      WHERE collection = ${collection} AND slug = ${slug} AND locale = ${loc}
+        AND is_current = TRUE AND deleted_at IS NULL
+      LIMIT 1`;
+        const row = rows[0];
+        return row ? rowToContentDocument(row) : null;
+    }
+    async getPublished(collection, slug, locale) {
+        await this.ensureInitialized();
+        const loc = locale ?? this.defaultLocale;
+        const rows = await this.sql `
+      SELECT live.* FROM content cur
+      JOIN content live ON live.collection = cur.collection AND live.slug = cur.slug
+        AND live.locale = cur.locale AND live.version = cur.live_version
+      WHERE cur.collection = ${collection} AND cur.slug = ${slug} AND cur.locale = ${loc}
+        AND cur.is_current = TRUE AND cur.deleted_at IS NULL
+      LIMIT 1`;
+        const row = rows[0];
+        return row ? rowToContentDocument(row) : null;
+    }
+    async query(spec) {
+        await this.ensureInitialized();
+        return runContentQuery(this.sql, spec);
+    }
+    async listVersions(collection, slug, locale) {
+        await this.ensureInitialized();
+        const loc = locale ?? this.defaultLocale;
+        const rows = await this.sql `
+      SELECT id, collection, slug, locale, version, is_current, status, source, file_path,
+        changed_by, deleted_at, created_at, live_version
+      FROM content
+      WHERE collection = ${collection} AND slug = ${slug} AND locale = ${loc}
+      ORDER BY version DESC`;
+        return rows.map(rowToDocumentMeta);
+    }
+    async getVersion(collection, slug, version, locale) {
+        await this.ensureInitialized();
+        const loc = locale ?? this.defaultLocale;
+        const rows = await this.sql `
+      SELECT * FROM content
+      WHERE collection = ${collection} AND slug = ${slug} AND locale = ${loc} AND version = ${version}
+      LIMIT 1`;
+        const row = rows[0];
+        return row ? rowToContentDocument(row) : null;
+    }
+    /**
+     * Import a filesystem content item — creates a new version if content changed.
+     * `modifiedAt` (ISO 8601) dates the version when the file last changed, such as
+     * its last git commit; without it the version is dated now.
+     */
+    async upsertFromFile(collection, slug, fields, body, html, sections, filePath, locale, modifiedAt, authored) {
+        await this.ensureInitialized();
+        const loc = locale ?? this.defaultLocale;
+        const status = typeof fields['status'] === 'string' ? fields['status'] : this.defaultStatus.filesystem;
+        // Check if content exists and is unchanged
+        const existing = await this.sql `
+      SELECT * FROM content
+      WHERE collection = ${collection} AND slug = ${slug} AND locale = ${loc}
+        AND is_current = TRUE AND deleted_at IS NULL
+      LIMIT 1`;
+        const row = existing[0];
+        if (row &&
+            canonicalJson(row.fields) === canonicalJson(fields) &&
+            row.body === body &&
+            sameAuthoredValues(row.authored, authored ?? {})) {
+            return; // No change — skip
+        }
+        await this.appendVersion(collection, slug, loc, {
+            fields,
+            body,
+            html,
+            sections,
+            source: 'filesystem',
+            filePath,
+            changedBy: null,
+            publication: authored ? authored.publication : publicationOfFile(status),
+            authored: authoredOf(authored ?? {}),
+            expectedVersion: authored?.expectedVersion,
+            createdAt: modifiedAt,
+        });
+    }
+    /** Restore content to a specific version — a save: a new current version from the old one, the live version kept */
+    async restoreVersion(collection, slug, version, changedBy, locale) {
+        await this.ensureInitialized();
+        const loc = locale ?? this.defaultLocale;
+        const rows = await this.sql `
+      SELECT * FROM content
+      WHERE collection = ${collection} AND slug = ${slug} AND locale = ${loc} AND version = ${version}
+      LIMIT 1`;
+        const target = rows[0];
+        if (!target)
+            return false;
+        await this.appendVersion(collection, slug, target.locale, {
+            authored: target.authored,
+            fields: target.fields,
+            body: target.body,
+            html: target.html,
+            sections: target.sections,
+            source: target.source,
+            filePath: target.file_path,
+            changedBy: changedBy ?? `restore:v${version}`,
+            publication: undefined,
+        });
+        return true;
+    }
+    // --- Runtime Schema methods ---
+    async getRuntimeSchema(collection) {
+        await this.ensureInitialized();
+        const rows = await this.sql `SELECT collection, fields, metadata_groups, created_at FROM collection_schemas
+      WHERE collection = ${collection} AND is_current = TRUE AND deleted_at IS NULL`;
+        const row = rows[0];
+        if (!row)
+            return null;
+        return {
+            collection: row.collection,
+            fields: row.fields,
+            metadata: row.metadata_groups,
+            updatedAt: row.created_at instanceof Date ? row.created_at.toISOString() : String(row.created_at),
+        };
+    }
+    async saveRuntimeSchema(collection, schema, changedBy) {
+        await this.ensureInitialized();
+        const current = await this.sql `
+      SELECT version FROM collection_schemas
+      WHERE collection = ${collection} AND is_current = TRUE`;
+        const nextVersion = current[0] ? current[0].version + 1 : 1;
+        const now = new Date().toISOString();
+        // See `appendVersion` for the JSONB binding explanation — `sql.json()`
+        // wraps the fields array as a JSONB parameter so the driver binds it
+        // as an object, not a JSON-text-wrapped-as-string.
+        await this.sql.begin(async (tx) => {
+            if (current[0]) {
+                await tx.unsafe('UPDATE collection_schemas SET is_current = FALSE WHERE collection = $1 AND is_current = TRUE', [collection]);
+            }
+            await tx.unsafe(`INSERT INTO collection_schemas (row_id, collection, version, is_current, fields, changed_by, created_at, metadata_groups)
+         VALUES ($1, $2, $3, TRUE, $4, $5, $6, $7)`, [
+                randomUUID(),
+                collection,
+                nextVersion,
+                this.sql.json(schema.fields),
+                changedBy ?? null,
+                now,
+                this.sql.json((schema.metadata ?? [])),
+            ]);
+        });
+    }
+    /** Close the database connection */
+    async close() {
+        await this.sql.end();
+    }
+    // --- Private helpers ---
+    /**
+     * Core append-only write: flip current, insert the new version. Its live
+     * version follows the write's publication (a save keeps it) and its stored
+     * status follows the live version.
+     */
+    async appendVersion(collection, slug, locale, data) {
+        const now = data.createdAt ?? new Date().toISOString();
+        // JSONB binding note: the postgres driver's `sql.json(value)` helper
+        // wraps an object as a JSONB parameter for `.unsafe()` calls. A previous
+        // implementation used `JSON.stringify(fields)` with a `::jsonb` cast,
+        // which double-encoded the value — JSONB stored the JSON text as a
+        // string literal, so every read returned the stringified text instead of
+        // the parsed object. Pass objects through `this.sql.json(...)` to bind
+        // correctly as JSONB without the redundant text→jsonb cast.
+        await this.sql.begin(async (tx) => {
+            await tx `SELECT pg_advisory_xact_lock(hashtextextended(${JSON.stringify([collection, slug, locale])}, 0))`;
+            const maxRows = await tx `
+      SELECT MAX(version) as max_version FROM content
+      WHERE collection = ${collection} AND slug = ${slug} AND locale = ${locale}`;
+            const nextVersion = (maxRows[0]?.max_version ?? 0) + 1;
+            if (data.expectedVersion !== undefined &&
+                data.expectedVersion !== (maxRows[0]?.max_version ?? 0)) {
+                throw new ContentWriteConflict(maxRows[0]?.max_version ?? 0, data.expectedVersion);
+            }
+            const previous = (await tx.unsafe('SELECT live_version, status, authored FROM content WHERE collection = $1 AND slug = $2 AND locale = $3 AND is_current = TRUE', [collection, slug, locale]));
+            const liveVersion = resolveLiveVersion(liveOnWrite(data.publication), nextVersion, previous[0]?.live_version ?? null);
+            const status = storedStatus(data.publication, liveVersion, previous[0]?.status);
+            await tx.unsafe('UPDATE content SET is_current = FALSE WHERE collection = $1 AND slug = $2 AND locale = $3 AND is_current = TRUE', [collection, slug, locale]);
+            await tx.unsafe(`INSERT INTO content (id, collection, slug, locale, version, is_current, status, fields, body, html, sections, source, file_path, changed_by, created_at, live_version, authored)
+         VALUES ($1, $2, $3, $4, $5, TRUE, $6, $7, $8, $9, $10, $11, $12, $13, $14, $15, $16)`, [
+                randomUUID(),
+                collection,
+                slug,
+                locale,
+                nextVersion,
+                status,
+                this.sql.json(data.fields),
+                data.body,
+                data.html,
+                this.sql.json(data.sections),
+                data.source,
+                data.filePath,
+                data.changedBy,
+                now,
+                liveVersion,
+                this.sql.json(nextAuthored(previous[0]?.authored ?? null, data.authored ?? {}, nextVersion)),
+            ]);
+        });
+    }
+}
+//# sourceMappingURL=postgres-adapter.js.map

package/dist/postgres-adapter.js.map

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

package/dist/postgres-checkpoints.d.ts

@@ -0,0 +1,20 @@
+import type { CheckpointInfo, CheckpointTrigger, ICheckpointAdapter } from '@krantho/persistence';
+import type { Sql } from 'postgres';
+/**
+ * Postgres checkpoint adapter.
+ *
+ * Checkpoints are lightweight timestamp markers. Creating a checkpoint
+ * records the current timestamp. Restoring a checkpoint rewinds all
+ * versioned tables to their state at that timestamp by flipping
+ * `is_current` flags.
+ */
+export declare class PostgresCheckpointAdapter implements ICheckpointAdapter {
+    private readonly sql;
+    constructor(sql: Sql);
+    createCheckpoint(name?: string, trigger?: CheckpointTrigger): Promise<CheckpointInfo>;
+    listCheckpoints(): Promise<CheckpointInfo[]>;
+    getCheckpoint(version: number): Promise<CheckpointInfo | null>;
+    restoreCheckpoint(version: number): Promise<CheckpointInfo>;
+    deleteCheckpoint(version: number): Promise<boolean>;
+}
+//# sourceMappingURL=postgres-checkpoints.d.ts.map

package/dist/postgres-checkpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-checkpoints.d.ts","sourceRoot":"","sources":["../src/postgres-checkpoints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AACjG,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAqBnC;;;;;;;GAOG;AACH,qBAAa,yBAA0B,YAAW,kBAAkB;IACtD,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,GAAG;IAE/B,gBAAgB,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC;IA4BrF,eAAe,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAM5C,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAO9D,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAmE3D,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAK1D"}

package/dist/postgres-checkpoints.js

@@ -0,0 +1,109 @@
+function rowToCheckpointInfo(row) {
+    return {
+        id: row.id,
+        version: row.version,
+        name: row.name,
+        trigger: row.trigger,
+        createdAt: row.created_at instanceof Date ? row.created_at.toISOString() : String(row.created_at),
+    };
+}
+/**
+ * Postgres checkpoint adapter.
+ *
+ * Checkpoints are lightweight timestamp markers. Creating a checkpoint
+ * records the current timestamp. Restoring a checkpoint rewinds all
+ * versioned tables to their state at that timestamp by flipping
+ * `is_current` flags.
+ */
+export class PostgresCheckpointAdapter {
+    sql;
+    constructor(sql) {
+        this.sql = sql;
+    }
+    async createCheckpoint(name, trigger) {
+        const now = new Date().toISOString();
+        const triggerValue = trigger ?? 'manual';
+        // Allocate next version number and insert checkpoint in a transaction
+        const result = await this.sql.begin(async (tx) => {
+            const versionRows = (await tx.unsafe('UPDATE checkpoint_counter SET next = next + 1 RETURNING next - 1 as version'));
+            const version = versionRows[0].version;
+            const insertRows = (await tx.unsafe('INSERT INTO checkpoints (version, name, trigger, created_at) VALUES ($1, $2, $3, $4) RETURNING id', [version, name ?? null, triggerValue, now]));
+            return { id: insertRows[0].id, version };
+        });
+        return {
+            id: result.id,
+            version: result.version,
+            name: name ?? null,
+            trigger: triggerValue,
+            createdAt: now,
+        };
+    }
+    async listCheckpoints() {
+        const rows = await this.sql `
+      SELECT * FROM checkpoints ORDER BY version DESC`;
+        return rows.map(rowToCheckpointInfo);
+    }
+    async getCheckpoint(version) {
+        const rows = await this.sql `
+      SELECT * FROM checkpoints WHERE version = ${version}`;
+        const row = rows[0];
+        return row ? rowToCheckpointInfo(row) : null;
+    }
+    async restoreCheckpoint(version) {
+        const checkpoint = await this.getCheckpoint(version);
+        if (!checkpoint) {
+            throw new Error(`Checkpoint version ${version} not found`);
+        }
+        // Create pre-restore checkpoint first
+        await this.createCheckpoint(`pre-restore-v${version}`, 'pre-restore');
+        const timestamp = checkpoint.createdAt;
+        // Restore all versioned tables to their state at checkpoint time
+        await this.sql.begin(async (tx) => {
+            // --- Content ---
+            // Clear all current flags
+            await tx.unsafe('UPDATE content SET is_current = FALSE WHERE is_current = TRUE');
+            // Re-activate the latest version of each entity that existed at checkpoint time
+            await tx.unsafe(`UPDATE content SET is_current = TRUE
+         WHERE id IN (
+           SELECT id FROM (
+             SELECT id, collection, slug, locale, created_at,
+               ROW_NUMBER() OVER (PARTITION BY collection, slug, locale ORDER BY version DESC) as rn
+             FROM content
+             WHERE created_at <= $1
+               AND (deleted_at IS NULL OR deleted_at > $1)
+           ) sub WHERE rn = 1
+         )`, [timestamp]);
+            // --- Collection schemas ---
+            await tx.unsafe('UPDATE collection_schemas SET is_current = FALSE WHERE is_current = TRUE');
+            await tx.unsafe(`UPDATE collection_schemas SET is_current = TRUE
+         WHERE row_id IN (
+           SELECT row_id FROM (
+             SELECT row_id, collection,
+               ROW_NUMBER() OVER (PARTITION BY collection ORDER BY version DESC) as rn
+             FROM collection_schemas
+             WHERE created_at <= $1
+               AND (deleted_at IS NULL OR deleted_at > $1)
+           ) sub WHERE rn = 1
+         )`, [timestamp]);
+            // --- Media ---
+            await tx.unsafe('UPDATE media SET is_current = FALSE WHERE is_current = TRUE');
+            await tx.unsafe(`UPDATE media SET is_current = TRUE
+         WHERE row_id IN (
+           SELECT row_id FROM (
+             SELECT row_id, id,
+               ROW_NUMBER() OVER (PARTITION BY id ORDER BY version DESC) as rn
+             FROM media
+             WHERE created_at <= $1
+               AND (deleted_at IS NULL OR deleted_at > $1)
+           ) sub WHERE rn = 1
+         )`, [timestamp]);
+        });
+        return checkpoint;
+    }
+    async deleteCheckpoint(version) {
+        const result = await this.sql `
+      DELETE FROM checkpoints WHERE version = ${version}`;
+        return result.count > 0;
+    }
+}
+//# sourceMappingURL=postgres-checkpoints.js.map

package/dist/postgres-checkpoints.js.map

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

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

@@ -0,0 +1,12 @@
+import type { ContentLock, ILockAdapter } from '@krantho/persistence';
+import type { Sql } from 'postgres';
+/** Postgres implementation of advisory content locking */
+export declare class PostgresLockAdapter implements ILockAdapter {
+    private readonly sql;
+    constructor(sql: Sql);
+    getLock(collection: string, slug: string, locale: string): Promise<ContentLock | null>;
+    acquireLock(collection: string, slug: string, locale: string, lockedBy: string, expiresAt: string): Promise<void>;
+    releaseLock(collection: string, slug: string, locale: string): Promise<void>;
+    listLocks(): Promise<ContentLock[]>;
+}
+//# sourceMappingURL=postgres-lock-adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-lock-adapter.d.ts","sourceRoot":"","sources":["../src/postgres-lock-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACrE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAWnC,0DAA0D;AAC1D,qBAAa,mBAAoB,YAAW,YAAY;IAC1C,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,GAAG;IAE/B,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IA6BtF,WAAW,CACf,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC;IAWV,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5E,SAAS,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;CAe1C"}

package/dist/postgres-lock-adapter.js

@@ -0,0 +1,62 @@
+/** Postgres implementation of advisory content locking */
+export class PostgresLockAdapter {
+    sql;
+    constructor(sql) {
+        this.sql = sql;
+    }
+    async getLock(collection, slug, locale) {
+        const rows = await this.sql `
+      SELECT * FROM content_locks
+      WHERE collection = ${collection} AND slug = ${slug} AND locale = ${locale}`;
+        const row = rows[0];
+        if (!row)
+            return null;
+        // Clean up expired locks
+        const expiresAt = row.expires_at instanceof Date ? row.expires_at : new Date(String(row.expires_at));
+        if (expiresAt <= new Date()) {
+            await this.sql `
+        DELETE FROM content_locks
+        WHERE collection = ${collection} AND slug = ${slug} AND locale = ${locale}`;
+            return null;
+        }
+        const lockedAt = row.locked_at instanceof Date ? row.locked_at : new Date(String(row.locked_at));
+        return {
+            collection: row.collection,
+            slug: row.slug,
+            locale: row.locale,
+            lockedBy: row.locked_by,
+            lockedAt: lockedAt.toISOString(),
+            expiresAt: expiresAt.toISOString(),
+        };
+    }
+    async acquireLock(collection, slug, locale, lockedBy, expiresAt) {
+        const now = new Date().toISOString();
+        await this.sql `
+      INSERT INTO content_locks (collection, slug, locale, locked_by, locked_at, expires_at)
+      VALUES (${collection}, ${slug}, ${locale}, ${lockedBy}, ${now}, ${expiresAt})
+      ON CONFLICT (collection, slug, locale) DO UPDATE SET
+        locked_by = EXCLUDED.locked_by,
+        locked_at = EXCLUDED.locked_at,
+        expires_at = EXCLUDED.expires_at`;
+    }
+    async releaseLock(collection, slug, locale) {
+        await this.sql `
+      DELETE FROM content_locks
+      WHERE collection = ${collection} AND slug = ${slug} AND locale = ${locale}`;
+    }
+    async listLocks() {
+        await this.sql `DELETE FROM content_locks WHERE expires_at <= now()`;
+        const rows = await this.sql `
+      SELECT * FROM content_locks ORDER BY collection, slug, locale`;
+        const iso = (value) => (value instanceof Date ? value : new Date(String(value))).toISOString();
+        return rows.map((row) => ({
+            collection: row.collection,
+            slug: row.slug,
+            locale: row.locale,
+            lockedBy: row.locked_by,
+            lockedAt: iso(row.locked_at),
+            expiresAt: iso(row.expires_at),
+        }));
+    }
+}
+//# sourceMappingURL=postgres-lock-adapter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-lock-adapter.js","sourceRoot":"","sources":["../src/postgres-lock-adapter.ts"],"names":[],"mappings":"AAYA,0DAA0D;AAC1D,MAAM,OAAO,mBAAmB;IACD;IAA7B,YAA6B,GAAQ;QAAR,QAAG,GAAH,GAAG,CAAK;IAAG,CAAC;IAEzC,KAAK,CAAC,OAAO,CAAC,UAAkB,EAAE,IAAY,EAAE,MAAc;QAC5D,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAAW;;2BAEf,UAAU,eAAe,IAAI,iBAAiB,MAAM,EAAE,CAAA;QAE7E,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;QACnB,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAA;QAErB,yBAAyB;QACzB,MAAM,SAAS,GACb,GAAG,CAAC,UAAU,YAAY,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAA;QACpF,IAAI,SAAS,IAAI,IAAI,IAAI,EAAE,EAAE,CAAC;YAC5B,MAAM,IAAI,CAAC,GAAG,CAAA;;6BAES,UAAU,eAAe,IAAI,iBAAiB,MAAM,EAAE,CAAA;YAC7E,OAAO,IAAI,CAAA;QACb,CAAC;QAED,MAAM,QAAQ,GAAG,GAAG,CAAC,SAAS,YAAY,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAA;QAChG,OAAO;YACL,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,QAAQ,EAAE,GAAG,CAAC,SAAS;YACvB,QAAQ,EAAE,QAAQ,CAAC,WAAW,EAAE;YAChC,SAAS,EAAE,SAAS,CAAC,WAAW,EAAE;SACnC,CAAA;IACH,CAAC;IAED,KAAK,CAAC,WAAW,CACf,UAAkB,EAClB,IAAY,EACZ,MAAc,EACd,QAAgB,EAChB,SAAiB;QAEjB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;QACpC,MAAM,IAAI,CAAC,GAAG,CAAA;;gBAEF,UAAU,KAAK,IAAI,KAAK,MAAM,KAAK,QAAQ,KAAK,GAAG,KAAK,SAAS;;;;yCAIxC,CAAA;IACvC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,UAAkB,EAAE,IAAY,EAAE,MAAc;QAChE,MAAM,IAAI,CAAC,GAAG,CAAA;;2BAES,UAAU,eAAe,IAAI,iBAAiB,MAAM,EAAE,CAAA;IAC/E,CAAC;IAED,KAAK,CAAC,SAAS;QACb,MAAM,IAAI,CAAC,GAAG,CAAA,qDAAqD,CAAA;QACnE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAAW;oEAC0B,CAAA;QAChE,MAAM,GAAG,GAAG,CAAC,KAAW,EAAU,EAAE,CAClC,CAAC,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAA;QACzE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACxB,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,QAAQ,EAAE,GAAG,CAAC,SAAS;YACvB,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC;YAC5B,SAAS,EAAE,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC;SAC/B,CAAC,CAAC,CAAA;IACL,CAAC;CACF"}

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

@@ -0,0 +1,28 @@
+import type { IMediaMetadataAdapter, MediaListOptions, MediaRecord, MediaRecordChanges, MediaStats, NewMediaRecord } from '@krantho/persistence';
+import type { Sql } from 'postgres';
+/**
+ * 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 declare class PostgresMediaAdapter implements IMediaMetadataAdapter {
+    private readonly sql;
+    constructor(sql: Sql);
+    insert(record: NewMediaRecord): Promise<MediaRecord>;
+    get(id: string): Promise<MediaRecord | null>;
+    list(options?: MediaListOptions | undefined): Promise<{
+        items: MediaRecord[];
+        total: number;
+    }>;
+    appendVersion(id: string, changes: MediaRecordChanges): Promise<MediaRecord | null>;
+    markDeleted(id: string): Promise<MediaRecord | null>;
+    stats(): Promise<MediaStats>;
+    listTags(): Promise<string[]>;
+    /** Insert the next version of `id` and make it current, inside `tx` */
+    private writeVersion;
+    /** WHERE clause for current records matching search, folder, and tag filters */
+    private buildFilter;
+}
+//# sourceMappingURL=postgres-media-adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-media-adapter.d.ts","sourceRoot":"","sources":["../src/postgres-media-adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,qBAAqB,EAGrB,gBAAgB,EAChB,WAAW,EACX,kBAAkB,EAClB,UAAU,EACV,cAAc,EACf,MAAM,sBAAsB,CAAA;AAE7B,OAAO,KAAK,EAAE,GAAG,EAAkB,MAAM,UAAU,CAAA;AA8BnD;;;;;;GAMG;AACH,qBAAa,oBAAqB,YAAW,qBAAqB;IACpD,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,GAAG;IAE/B,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC;IAQpD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAK5C,IAAI,CACR,OAAO,CAAC,EAAE,gBAAgB,GAAG,SAAS,GACrC,OAAO,CAAC;QAAE,KAAK,EAAE,WAAW,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAe7C,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAUnF,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAUpD,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC;IAW5B,QAAQ,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAOnC,uEAAuE;YACzD,YAAY;IAoC1B,gFAAgF;IAChF,OAAO,CAAC,WAAW;CA0BpB"}