@kywi-software/core 0.1.0

package/dist/versioning/__tests__/version-management.test.js

@@ -0,0 +1,197 @@
+import { describe, it, expect, vi } from 'vitest';
+import { deleteVersion, clearVersionHistory, clearOldVersions, computeChangeset, getChangesetBetweenVersions, } from '../version-management.js';
+// ── Helpers ────────────────────────────────────────────────────────────────────
+function makeVersion(id, contentId, version, snapshot = {}) {
+    return { id, contentId, version, snapshot, siteId: 'site-1', changeNote: null, status: 'draft', createdBy: null, createdAt: new Date() };
+}
+function buildDb(versions) {
+    return {
+        delete: vi.fn((_table) => ({
+            where: vi.fn((_cond) => ({
+                returning: vi.fn((_shape) => {
+                    // Naive: return all (real DB would filter by condition)
+                    return Promise.resolve(versions.map(v => ({ id: v.id })));
+                }),
+            })),
+        })),
+        select: vi.fn((_shape) => ({
+            from: vi.fn((_table) => ({
+                where: vi.fn((_cond) => ({
+                    orderBy: vi.fn((_ord) => ({
+                        limit: vi.fn((_n) => Promise.resolve(versions)),
+                    })),
+                })),
+            })),
+        })),
+    };
+}
+// ── computeChangeset ───────────────────────────────────────────────────────────
+describe('computeChangeset', () => {
+    it('returns empty array for identical snapshots', () => {
+        const snap = { title: 'Hello', body: 'World', count: 42 };
+        expect(computeChangeset(snap, snap)).toEqual([]);
+    });
+    it('detects changed field', () => {
+        const old = { title: 'Old title' };
+        const next = { title: 'New title' };
+        const result = computeChangeset(old, next);
+        expect(result).toHaveLength(1);
+        expect(result[0]).toEqual({ field: 'title', oldValue: 'Old title', newValue: 'New title' });
+    });
+    it('detects added field (oldValue is undefined)', () => {
+        const old = { title: 'Hello' };
+        const next = { title: 'Hello', newField: 'added' };
+        const result = computeChangeset(old, next);
+        expect(result).toHaveLength(1);
+        expect(result[0]).toEqual({ field: 'newField', oldValue: undefined, newValue: 'added' });
+    });
+    it('detects removed field (newValue is undefined)', () => {
+        const old = { title: 'Hello', removed: 'gone' };
+        const next = { title: 'Hello' };
+        const result = computeChangeset(old, next);
+        expect(result).toHaveLength(1);
+        expect(result[0]).toEqual({ field: 'removed', oldValue: 'gone', newValue: undefined });
+    });
+    it('detects multiple changed fields', () => {
+        const old = { a: 1, b: 2, c: 3 };
+        const next = { a: 1, b: 99, c: 100 };
+        const result = computeChangeset(old, next);
+        expect(result).toHaveLength(2);
+        const fields = result.map(r => r.field).sort();
+        expect(fields).toEqual(['b', 'c']);
+    });
+    it('uses JSON.stringify comparison so deep objects work', () => {
+        const old = { meta: { foo: 1 } };
+        const same = { meta: { foo: 1 } };
+        expect(computeChangeset(old, same)).toHaveLength(0);
+        const changed = { meta: { foo: 2 } };
+        expect(computeChangeset(old, changed)).toHaveLength(1);
+    });
+    it('returns empty for empty snapshots', () => {
+        expect(computeChangeset({}, {})).toEqual([]);
+    });
+});
+// ── deleteVersion ──────────────────────────────────────────────────────────────
+describe('deleteVersion', () => {
+    it('returns true when a version is deleted', async () => {
+        const versions = [makeVersion('v1', 'c1', 1)];
+        const db = buildDb(versions);
+        const result = await deleteVersion(db, 'v1');
+        expect(result).toBe(true);
+    });
+    it('returns false when no version is found', async () => {
+        const db = buildDb([]);
+        db.delete.mockReturnValue({
+            where: vi.fn(() => ({
+                returning: vi.fn(() => Promise.resolve([])),
+            })),
+        });
+        const result = await deleteVersion(db, 'nonexistent');
+        expect(result).toBe(false);
+    });
+});
+// ── clearVersionHistory ────────────────────────────────────────────────────────
+describe('clearVersionHistory', () => {
+    it('deletes all versions and returns count', async () => {
+        const versions = [
+            makeVersion('v1', 'c1', 1),
+            makeVersion('v2', 'c1', 2),
+            makeVersion('v3', 'c1', 3),
+        ];
+        const db = buildDb(versions);
+        const count = await clearVersionHistory(db, 'c1');
+        expect(count).toBe(3);
+    });
+    it('returns 0 when no versions exist', async () => {
+        const db = buildDb([]);
+        db.delete.mockReturnValue({
+            where: vi.fn(() => ({
+                returning: vi.fn(() => Promise.resolve([])),
+            })),
+        });
+        const count = await clearVersionHistory(db, 'c1');
+        expect(count).toBe(0);
+    });
+});
+// ── clearOldVersions ───────────────────────────────────────────────────────────
+describe('clearOldVersions', () => {
+    it('returns 0 when no versions exist', async () => {
+        const db = buildDb([]);
+        db.select.mockReturnValue({
+            from: vi.fn(() => ({
+                where: vi.fn(() => ({
+                    orderBy: vi.fn(() => ({
+                        limit: vi.fn(() => Promise.resolve([])),
+                    })),
+                })),
+            })),
+        });
+        const count = await clearOldVersions(db, 'c1', 3);
+        expect(count).toBe(0);
+    });
+    it('keeps N most recent versions and returns deleted count', async () => {
+        // Simulate: 5 versions exist, keep 2 → 3 deleted
+        const allVersions = [
+            makeVersion('v5', 'c1', 5),
+            makeVersion('v4', 'c1', 4),
+            makeVersion('v3', 'c1', 3),
+            makeVersion('v2', 'c1', 2),
+            makeVersion('v1', 'c1', 1),
+        ];
+        const toKeep = allVersions.slice(0, 2); // most recent 2
+        const toDelete = allVersions.slice(2); // 3 older ones
+        const db = {
+            select: vi.fn(() => ({
+                from: vi.fn(() => ({
+                    where: vi.fn(() => ({
+                        orderBy: vi.fn(() => ({
+                            limit: vi.fn(() => Promise.resolve(toKeep.map(v => ({ id: v.id })))),
+                        })),
+                    })),
+                })),
+            })),
+            delete: vi.fn(() => ({
+                where: vi.fn(() => ({
+                    returning: vi.fn(() => Promise.resolve(toDelete.map(v => ({ id: v.id })))),
+                })),
+            })),
+        };
+        const count = await clearOldVersions(db, 'c1', 2);
+        expect(count).toBe(3);
+    });
+});
+// ── getChangesetBetweenVersions ────────────────────────────────────────────────
+describe('getChangesetBetweenVersions', () => {
+    it('returns empty array when versions not found', async () => {
+        const db = {
+            select: vi.fn(() => ({
+                from: vi.fn(() => ({
+                    where: vi.fn(() => ({
+                        orderBy: vi.fn(() => Promise.resolve([])),
+                    })),
+                })),
+            })),
+        };
+        const result = await getChangesetBetweenVersions(db, 'c1', 1, 2);
+        expect(result).toEqual([]);
+    });
+    it('computes changeset between two fetched version snapshots', async () => {
+        const versions = [
+            makeVersion('v1', 'c1', 1, { title: 'Old', body: 'Same' }),
+            makeVersion('v2', 'c1', 2, { title: 'New', body: 'Same' }),
+        ];
+        const db = {
+            select: vi.fn(() => ({
+                from: vi.fn(() => ({
+                    where: vi.fn(() => ({
+                        orderBy: vi.fn(() => Promise.resolve(versions.map(v => ({ version: v.version, snapshot: v.snapshot })))),
+                    })),
+                })),
+            })),
+        };
+        const result = await getChangesetBetweenVersions(db, 'c1', 1, 2);
+        expect(result).toHaveLength(1);
+        expect(result[0]).toEqual({ field: 'title', oldValue: 'Old', newValue: 'New' });
+    });
+});
+//# sourceMappingURL=version-management.test.js.map

package/dist/versioning/__tests__/version-management.test.js.map

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

package/dist/versioning/index.d.ts

@@ -0,0 +1,5 @@
+export * from './state-machine.js';
+export { publishScheduledContent, unpublishExpiredContent, runScheduler, startScheduler } from './scheduler.js';
+export type { SchedulerHandle } from './scheduler.js';
+export * from './version-management.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/versioning/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/versioning/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC/G,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AACrD,cAAc,yBAAyB,CAAA"}

package/dist/versioning/index.js

@@ -0,0 +1,4 @@
+export * from './state-machine.js';
+export { publishScheduledContent, unpublishExpiredContent, runScheduler, startScheduler } from './scheduler.js';
+export * from './version-management.js';
+//# sourceMappingURL=index.js.map

package/dist/versioning/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/versioning/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAE/G,cAAc,yBAAyB,CAAA"}

package/dist/versioning/scheduler.d.ts

@@ -0,0 +1,47 @@
+import type { KywiDb } from '../db/client.js';
+/**
+ * Auto-publish approved content.
+ * Content in 'approved' status that hasn't been published yet gets published.
+ * Intended to be called periodically by a cron/background job.
+ */
+export declare function publishScheduledContent(db: KywiDb): Promise<number>;
+/**
+ * Archive published content that has passed its expiresAt date.
+ */
+export declare function unpublishExpiredContent(db: KywiDb): Promise<number>;
+/**
+ * Publish changesets whose scheduledPublishAt has passed and status is still 'open'.
+ * Returns the number of changesets published.
+ */
+export declare function publishScheduledChangesets(db: KywiDb): Promise<number>;
+/**
+ * W7: Reset featured status on content-category assignments whose
+ * featuredUntil date has passed.
+ */
+export declare function resetExpiredFeatured(db: KywiDb): Promise<number>;
+/**
+ * Run publishing, expiration, and featured-reset checks. Returns counts.
+ */
+export declare function runScheduler(db: KywiDb): Promise<{
+    published: number;
+    expired: number;
+    changesets: number;
+    featuredReset: number;
+}>;
+export interface SchedulerHandle {
+    /** Stop the interval runner. */
+    stop(): void;
+}
+/**
+ * Start an in-process interval runner that calls {@link runScheduler} every
+ * `intervalSeconds`. Overlapping runs are prevented (a slow sweep skips the next
+ * tick rather than piling up) and the timer is `unref()`d so it never keeps a
+ * process alive on its own. Errors route to `onError` (default: warn) so one
+ * failed sweep never crashes the host process. Returns a handle whose `stop()`
+ * clears the interval.
+ */
+export declare function startScheduler(db: KywiDb, opts: {
+    intervalSeconds: number;
+    onError?: (err: unknown) => void;
+}): SchedulerHandle;
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/versioning/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/versioning/scheduler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAG7C;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAczE;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAWzE;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiB5E;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAWtE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC,CAMzI;AAED,MAAM,WAAW,eAAe;IAC9B,gCAAgC;IAChC,IAAI,IAAI,IAAI,CAAA;CACb;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,EAAE,EAAE,MAAM,EACV,IAAI,EAAE;IAAE,eAAe,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAA;CAAE,GAClE,eAAe,CAqBjB"}

package/dist/versioning/scheduler.js

@@ -0,0 +1,96 @@
+import { eq, and, or, sql, isNull } from 'drizzle-orm';
+import { kywiContent, kywiChangesets, kywiContentCategories } from '../schema/base.js';
+import { publishChangeset } from '../db/changeset-queries.js';
+/**
+ * Auto-publish approved content.
+ * Content in 'approved' status that hasn't been published yet gets published.
+ * Intended to be called periodically by a cron/background job.
+ */
+export async function publishScheduledContent(db) {
+    const rows = await db
+        .update(kywiContent)
+        .set({ status: 'published', publishedAt: new Date(), updatedAt: new Date() })
+        .where(and(eq(kywiContent.status, 'approved'), sql `${kywiContent.deletedAt} IS NULL`, or(isNull(kywiContent.publishedAt), sql `${kywiContent.publishedAt} <= NOW()`)))
+        .returning({ id: kywiContent.id });
+    return rows.length;
+}
+/**
+ * Archive published content that has passed its expiresAt date.
+ */
+export async function unpublishExpiredContent(db) {
+    const rows = await db
+        .update(kywiContent)
+        .set({ status: 'archived', updatedAt: new Date() })
+        .where(and(eq(kywiContent.status, 'published'), sql `${kywiContent.expiresAt} IS NOT NULL`, sql `${kywiContent.expiresAt} <= NOW()`))
+        .returning({ id: kywiContent.id });
+    return rows.length;
+}
+/**
+ * Publish changesets whose scheduledPublishAt has passed and status is still 'open'.
+ * Returns the number of changesets published.
+ */
+export async function publishScheduledChangesets(db) {
+    const now = new Date();
+    const rows = await db
+        .select({ id: kywiChangesets.id })
+        .from(kywiChangesets)
+        .where(and(eq(kywiChangesets.status, 'open'), sql `${kywiChangesets.scheduledPublishAt} IS NOT NULL`, sql `${kywiChangesets.scheduledPublishAt} <= NOW()`));
+    let count = 0;
+    for (const row of rows) {
+        await publishChangeset(db, row.id, 'scheduler');
+        count++;
+    }
+    return count;
+}
+/**
+ * W7: Reset featured status on content-category assignments whose
+ * featuredUntil date has passed.
+ */
+export async function resetExpiredFeatured(db) {
+    const rows = await db
+        .update(kywiContentCategories)
+        .set({ isFeatured: false })
+        .where(and(eq(kywiContentCategories.isFeatured, true), sql `${kywiContentCategories.featuredUntil} IS NOT NULL`, sql `${kywiContentCategories.featuredUntil} <= NOW()`))
+        .returning({ contentId: kywiContentCategories.contentId });
+    return rows.length;
+}
+/**
+ * Run publishing, expiration, and featured-reset checks. Returns counts.
+ */
+export async function runScheduler(db) {
+    const published = await publishScheduledContent(db);
+    const expired = await unpublishExpiredContent(db);
+    const changesets = await publishScheduledChangesets(db);
+    const featuredReset = await resetExpiredFeatured(db);
+    return { published, expired, changesets, featuredReset };
+}
+/**
+ * Start an in-process interval runner that calls {@link runScheduler} every
+ * `intervalSeconds`. Overlapping runs are prevented (a slow sweep skips the next
+ * tick rather than piling up) and the timer is `unref()`d so it never keeps a
+ * process alive on its own. Errors route to `onError` (default: warn) so one
+ * failed sweep never crashes the host process. Returns a handle whose `stop()`
+ * clears the interval.
+ */
+export function startScheduler(db, opts) {
+    const ms = Math.max(1, opts.intervalSeconds) * 1000;
+    const onError = opts.onError ?? ((err) => console.warn('[kywi:scheduler] sweep failed:', err));
+    let running = false;
+    const timer = setInterval(() => {
+        if (running)
+            return;
+        running = true;
+        void runScheduler(db)
+            .catch(onError)
+            .finally(() => {
+            running = false;
+        });
+    }, ms);
+    // Do not hold the event loop open for the scheduler alone.
+    if (typeof timer.unref === 'function') {
+        ;
+        timer.unref();
+    }
+    return { stop: () => clearInterval(timer) };
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/versioning/scheduler.js.map

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

package/dist/versioning/state-machine.d.ts

@@ -0,0 +1,5 @@
+export type ContentStatus = 'draft' | 'pending' | 'approved' | 'published' | 'archived';
+export declare const ALL_STATUSES: ContentStatus[];
+export declare function canTransition(role: string, from: string, to: string): boolean;
+export declare function getValidTransitions(role: string, from: string): ContentStatus[];
+//# sourceMappingURL=state-machine.d.ts.map

package/dist/versioning/state-machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine.d.ts","sourceRoot":"","sources":["../../src/versioning/state-machine.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,CAAA;AAEvF,eAAO,MAAM,YAAY,EAAE,aAAa,EAA8D,CAAA;AA0BtG,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAM7E;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAI/E"}

package/dist/versioning/state-machine.js

@@ -0,0 +1,38 @@
+export const ALL_STATUSES = ['draft', 'pending', 'approved', 'published', 'archived'];
+const AUTHOR_TRANSITIONS = {
+    draft: ['pending'],
+};
+const EDITOR_TRANSITIONS = {
+    draft: ['pending', 'approved', 'published'],
+    pending: ['draft', 'approved', 'published'],
+    approved: ['published'],
+};
+function getTransitionsForRole(role) {
+    switch (role) {
+        case 'superAdmin':
+        case 'siteAdmin':
+            return 'any';
+        case 'editor':
+            return EDITOR_TRANSITIONS;
+        case 'author':
+            return AUTHOR_TRANSITIONS;
+        default:
+            return {};
+    }
+}
+export function canTransition(role, from, to) {
+    if (from === to)
+        return false;
+    const transitions = getTransitionsForRole(role);
+    if (transitions === 'any')
+        return ALL_STATUSES.includes(to);
+    const allowed = transitions[from];
+    return allowed ? allowed.includes(to) : false;
+}
+export function getValidTransitions(role, from) {
+    const transitions = getTransitionsForRole(role);
+    if (transitions === 'any')
+        return ALL_STATUSES.filter(s => s !== from);
+    return transitions[from] ?? [];
+}
+//# sourceMappingURL=state-machine.js.map

package/dist/versioning/state-machine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine.js","sourceRoot":"","sources":["../../src/versioning/state-machine.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,YAAY,GAAoB,CAAC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,CAAC,CAAA;AAEtG,MAAM,kBAAkB,GAAoC;IAC1D,KAAK,EAAE,CAAC,SAAS,CAAC;CACnB,CAAA;AAED,MAAM,kBAAkB,GAAoC;IAC1D,KAAK,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,WAAW,CAAC;IAC3C,OAAO,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,WAAW,CAAC;IAC3C,QAAQ,EAAE,CAAC,WAAW,CAAC;CACxB,CAAA;AAED,SAAS,qBAAqB,CAAC,IAAY;IACzC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,YAAY,CAAC;QAClB,KAAK,WAAW;YACd,OAAO,KAAK,CAAA;QACd,KAAK,QAAQ;YACX,OAAO,kBAAkB,CAAA;QAC3B,KAAK,QAAQ;YACX,OAAO,kBAAkB,CAAA;QAC3B;YACE,OAAO,EAAE,CAAA;IACb,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,IAAY,EAAE,EAAU;IAClE,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,KAAK,CAAA;IAC7B,MAAM,WAAW,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAA;IAC/C,IAAI,WAAW,KAAK,KAAK;QAAE,OAAO,YAAY,CAAC,QAAQ,CAAC,EAAmB,CAAC,CAAA;IAC5E,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,CAAA;IACjC,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAmB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;AAChE,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,IAAY;IAC5D,MAAM,WAAW,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAA;IAC/C,IAAI,WAAW,KAAK,KAAK;QAAE,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAA;IACtE,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,CAAA;AAChC,CAAC"}

package/dist/versioning/version-management.d.ts

@@ -0,0 +1,33 @@
+import type { KywiDb } from '../db/client.js';
+/**
+ * Delete a single version by ID.
+ * Returns true if a row was deleted.
+ */
+export declare function deleteVersion(db: KywiDb, versionId: string): Promise<boolean>;
+/**
+ * Delete ALL versions for a content item.
+ * Returns the number of rows deleted.
+ */
+export declare function clearVersionHistory(db: KywiDb, contentId: string): Promise<number>;
+/**
+ * Keep the N most recent versions for a content item and delete the rest.
+ * Returns the number of rows deleted.
+ */
+export declare function clearOldVersions(db: KywiDb, contentId: string, keepCount: number): Promise<number>;
+export interface Changeset {
+    field: string;
+    oldValue: unknown;
+    newValue: unknown;
+}
+/**
+ * Compare two version snapshots and return a list of changed fields.
+ * Fields that are identical (by JSON.stringify comparison) are omitted.
+ * Fields present only in `newSnapshot` appear with oldValue = undefined.
+ * Fields present only in `oldSnapshot` appear with newValue = undefined.
+ */
+export declare function computeChangeset(oldSnapshot: Record<string, unknown>, newSnapshot: Record<string, unknown>): Changeset[];
+/**
+ * Fetch two version snapshots by version number and compute the changeset between them.
+ */
+export declare function getChangesetBetweenVersions(db: KywiDb, contentId: string, fromVersion: number, toVersion: number): Promise<Changeset[]>;
+//# sourceMappingURL=version-management.d.ts.map

package/dist/versioning/version-management.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-management.d.ts","sourceRoot":"","sources":["../../src/versioning/version-management.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAE7C;;;GAGG;AACH,wBAAsB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAMnF;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMxF;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,CAyBjB;AAID,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,OAAO,CAAA;IACjB,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,SAAS,EAAE,CAab;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,SAAS,EAAE,CAAC,CAgBtB"}

package/dist/versioning/version-management.js

@@ -0,0 +1,80 @@
+import { eq, and, asc, sql } from 'drizzle-orm';
+import { kywiContentVersions } from '../schema/base.js';
+/**
+ * Delete a single version by ID.
+ * Returns true if a row was deleted.
+ */
+export async function deleteVersion(db, versionId) {
+    const [row] = await db
+        .delete(kywiContentVersions)
+        .where(eq(kywiContentVersions.id, versionId))
+        .returning({ id: kywiContentVersions.id });
+    return row !== undefined;
+}
+/**
+ * Delete ALL versions for a content item.
+ * Returns the number of rows deleted.
+ */
+export async function clearVersionHistory(db, contentId) {
+    const rows = await db
+        .delete(kywiContentVersions)
+        .where(eq(kywiContentVersions.contentId, contentId))
+        .returning({ id: kywiContentVersions.id });
+    return rows.length;
+}
+/**
+ * Keep the N most recent versions for a content item and delete the rest.
+ * Returns the number of rows deleted.
+ */
+export async function clearOldVersions(db, contentId, keepCount) {
+    // Find the IDs of the N most recent versions to keep
+    const toKeep = await db
+        .select({ id: kywiContentVersions.id })
+        .from(kywiContentVersions)
+        .where(eq(kywiContentVersions.contentId, contentId))
+        .orderBy(sql `${kywiContentVersions.version} DESC`)
+        .limit(keepCount);
+    if (toKeep.length === 0)
+        return 0;
+    const keepIds = toKeep.map(r => r.id);
+    // Delete everything for this content except the rows we want to keep
+    const deleted = await db
+        .delete(kywiContentVersions)
+        .where(and(eq(kywiContentVersions.contentId, contentId), sql `${kywiContentVersions.id} NOT IN (${sql.join(keepIds.map(id => sql `${id}`), sql `, `)})`))
+        .returning({ id: kywiContentVersions.id });
+    return deleted.length;
+}
+/**
+ * Compare two version snapshots and return a list of changed fields.
+ * Fields that are identical (by JSON.stringify comparison) are omitted.
+ * Fields present only in `newSnapshot` appear with oldValue = undefined.
+ * Fields present only in `oldSnapshot` appear with newValue = undefined.
+ */
+export function computeChangeset(oldSnapshot, newSnapshot) {
+    const changes = [];
+    const allKeys = new Set([...Object.keys(oldSnapshot), ...Object.keys(newSnapshot)]);
+    for (const field of allKeys) {
+        const oldValue = oldSnapshot[field];
+        const newValue = newSnapshot[field];
+        if (JSON.stringify(oldValue) !== JSON.stringify(newValue)) {
+            changes.push({ field, oldValue, newValue });
+        }
+    }
+    return changes;
+}
+/**
+ * Fetch two version snapshots by version number and compute the changeset between them.
+ */
+export async function getChangesetBetweenVersions(db, contentId, fromVersion, toVersion) {
+    const rows = await db
+        .select({ version: kywiContentVersions.version, snapshot: kywiContentVersions.snapshot })
+        .from(kywiContentVersions)
+        .where(eq(kywiContentVersions.contentId, contentId))
+        .orderBy(asc(kywiContentVersions.version));
+    const fromRow = rows.find(r => r.version === fromVersion);
+    const toRow = rows.find(r => r.version === toVersion);
+    if (!fromRow || !toRow)
+        return [];
+    return computeChangeset(fromRow.snapshot, toRow.snapshot);
+}
+//# sourceMappingURL=version-management.js.map

package/dist/versioning/version-management.js.map

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