@plumix/core 0.1.0

package/dist/rest/schemas.js

@@ -0,0 +1,72 @@
+import * as v from "valibot";
+const MAX_PER_PAGE = 100;
+const DEFAULT_PER_PAGE = 20;
+// Path params only. Entry types and taxonomies share the top-level
+// `{collection}` rest_base namespace. Pagination is read from the query string
+// directly (see `readPagination`) so the surface doesn't depend on per-adapter
+// query coercion.
+export const collectionParamsSchema = v.object({ collection: v.string() });
+export const collectionItemParamsSchema = v.object({
+    collection: v.string(),
+    id: v.string(),
+});
+// The output schemas ARE the public allowlist (default-deny): only these
+// fields can ever leave the surface, and they double as the documented
+// response shapes in the generated OpenAPI spec.
+export const publicAuthorSchema = v.object({
+    id: v.number(),
+    name: v.nullable(v.string()),
+    avatarUrl: v.nullable(v.string()),
+});
+// Compact term shape, used both as a top-level resource and embedded on entries.
+export const publicTermSchema = v.object({
+    id: v.number(),
+    name: v.string(),
+    slug: v.string(),
+});
+export const publicEntrySchema = v.object({
+    id: v.number(),
+    type: v.string(),
+    slug: v.string(),
+    title: v.string(),
+    excerpt: v.nullable(v.string()),
+    content: v.unknown(),
+    status: v.string(),
+    publishedAt: v.nullable(v.date()),
+    createdAt: v.date(),
+    updatedAt: v.date(),
+    author: v.nullable(publicAuthorSchema),
+    // Associations are embedded, never nested as their own sub-resource.
+    terms: v.record(v.string(), v.array(publicTermSchema)),
+    // Only meta fields whitelisted with `showInApi` reach this map (default-deny).
+    meta: v.record(v.string(), v.unknown()),
+});
+function listEnvelopeSchema(item) {
+    return v.object({
+        data: v.array(item),
+        meta: v.object({ page: v.number(), per_page: v.number() }),
+        links: v.object({
+            self: v.string(),
+            next: v.optional(v.string()),
+            prev: v.optional(v.string()),
+        }),
+    });
+}
+export const entriesListEnvelopeSchema = listEnvelopeSchema(publicEntrySchema);
+export const termsListEnvelopeSchema = listEnvelopeSchema(publicTermSchema);
+export function readPagination(url) {
+    const page = clampInt(url.searchParams.get("page"), 1, 1, Number.MAX_SAFE_INTEGER);
+    const perPage = clampInt(url.searchParams.get("per_page"), DEFAULT_PER_PAGE, 1, MAX_PER_PAGE);
+    return { page, perPage, offset: (page - 1) * perPage };
+}
+// Non-integer or out-of-range values fall back / clamp rather than erroring —
+// pagination params are ergonomic hints, not a place to 400 a content read.
+function clampInt(raw, fallback, min, max) {
+    if (raw === null)
+        return fallback;
+    const n = Number(raw);
+    if (!Number.isInteger(n))
+        return fallback;
+    return Math.min(max, Math.max(min, n));
+}
+//# sourceMappingURL=schemas.js.map

package/dist/rest/schemas.js.map

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

package/dist/rest/terms-resource.d.ts

@@ -0,0 +1,22 @@
+import type { AppContext } from "../context/app.js";
+import type { RegisteredTermTaxonomy } from "../plugin/manifest.js";
+import type { RestErrors } from "./errors.js";
+import type { PublicTerm } from "./schemas.js";
+export declare function listTermsEnvelope(context: AppContext, taxonomy: RegisteredTermTaxonomy, url: URL): Promise<{
+    data: {
+        id: number;
+        name: string;
+        slug: string;
+    }[];
+    meta: {
+        page: number;
+        per_page: number;
+    };
+    links: {
+        prev?: string | undefined;
+        next?: string | undefined;
+        self: string;
+    };
+}>;
+export declare function getTermItem(context: AppContext, taxonomy: RegisteredTermTaxonomy, id: number, errors: RestErrors): Promise<PublicTerm>;
+//# sourceMappingURL=terms-resource.d.ts.map

package/dist/rest/terms-resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terms-resource.d.ts","sourceRoot":"","sources":["../../src/rest/terms-resource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAqB/C,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,sBAAsB,EAChC,GAAG,EAAE,GAAG;;;;;;;;;;;;;;;GAYT;AAGD,wBAAsB,WAAW,CAC/B,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,sBAAsB,EAChC,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,UAAU,CAAC,CAYrB"}

package/dist/rest/terms-resource.js

@@ -0,0 +1,44 @@
+import { TermReadError } from "../terms/errors.js";
+import { getTerm, listTerms } from "../terms/read-service.js";
+import { listEnvelope } from "./envelope.js";
+import { projectTerm } from "./projection.js";
+import { readPagination } from "./schemas.js";
+// The public gate lives in `resolvePublicTaxonomy` (the dispatcher), not in the
+// term service — `term:<taxonomy>:read` is granted to subscriber for every
+// taxonomy, public or not. Only route public taxonomies here.
+//
+// Term reads hide existence the same way entry reads do: a missing term, an
+// unreadable taxonomy, or a wrong-taxonomy lookup all collapse to 404.
+function termNotFound(error, errors) {
+    if (error instanceof TermReadError) {
+        return errors.NOT_FOUND({ data: { kind: "term" } });
+    }
+    return error;
+}
+// A paginated envelope of a public taxonomy's terms.
+export async function listTermsEnvelope(context, taxonomy, url) {
+    const { page, perPage, offset } = readPagination(url);
+    const fetched = await listTerms(context, {
+        taxonomy: taxonomy.name,
+        limit: perPage + 1,
+        offset,
+    });
+    const hasNext = fetched.length > perPage;
+    const rows = hasNext ? fetched.slice(0, perPage) : fetched;
+    return listEnvelope(rows.map(projectTerm), { url, page, perPage, hasNext });
+}
+// One term. A term in another taxonomy is hidden (404) rather than revealed.
+export async function getTermItem(context, taxonomy, id, errors) {
+    let term;
+    try {
+        term = await getTerm(context, { id });
+    }
+    catch (error) {
+        throw termNotFound(error, errors);
+    }
+    if (term.taxonomy !== taxonomy.name) {
+        throw errors.NOT_FOUND({ data: { kind: "term" } });
+    }
+    return projectTerm(term);
+}
+//# sourceMappingURL=terms-resource.js.map

package/dist/rest/terms-resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terms-resource.js","sourceRoot":"","sources":["../../src/rest/terms-resource.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,gFAAgF;AAChF,2EAA2E;AAC3E,8DAA8D;AAC9D,EAAE;AACF,4EAA4E;AAC5E,uEAAuE;AACvE,SAAS,YAAY,CAAC,KAAc,EAAE,MAAkB;IACtD,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;QACnC,OAAO,MAAM,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,qDAAqD;AACrD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAmB,EACnB,QAAgC,EAChC,GAAQ;IAER,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,OAAO,EAAE;QACvC,QAAQ,EAAE,QAAQ,CAAC,IAAI;QACvB,KAAK,EAAE,OAAO,GAAG,CAAC;QAClB,MAAM;KACP,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC;IACzC,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAE3D,OAAO,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AAC9E,CAAC;AAED,6EAA6E;AAC7E,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAmB,EACnB,QAAgC,EAChC,EAAU,EACV,MAAkB;IAElB,IAAI,IAAyC,CAAC;IAC9C,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,IAAI,EAAE,CAAC;QACpC,MAAM,MAAM,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC"}

package/dist/revisions/errors.d.ts

@@ -0,0 +1,6 @@
+export declare class RevisionRepositoryError extends Error {
+    readonly code: "insert_returned_no_row";
+    private constructor();
+    static insertReturnedNoRow(): RevisionRepositoryError;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/revisions/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/revisions/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,uBAAwB,SAAQ,KAAK;IAKhD,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IAExC,OAAO;IAKP,MAAM,CAAC,mBAAmB,IAAI,uBAAuB;CAMtD"}

package/dist/revisions/errors.js

@@ -0,0 +1,14 @@
+export class RevisionRepositoryError extends Error {
+    static {
+        RevisionRepositoryError.prototype.name = "RevisionRepositoryError";
+    }
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+    }
+    static insertReturnedNoRow() {
+        return new RevisionRepositoryError("insert_returned_no_row", "snapshotAsRevision: insert into entries returned no row — driver likely rejected the row but did not raise.");
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/revisions/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/revisions/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAChD;QACE,uBAAuB,CAAC,SAAS,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACrE,CAAC;IAEQ,IAAI,CAA2B;IAExC,YAAoB,IAA8B,EAAE,OAAe;QACjE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,mBAAmB;QACxB,OAAO,IAAI,uBAAuB,CAChC,wBAAwB,EACxB,6GAA6G,CAC9G,CAAC;IACJ,CAAC;CACF"}

package/dist/revisions/repository.d.ts

@@ -0,0 +1,55 @@
+import type { Db } from "../context/app.js";
+import type { Entry, EntryContent } from "../db/schema/entries.js";
+interface SnapshotInput {
+    readonly entry: Entry;
+    readonly authorId: number;
+}
+export declare function snapshotAsRevision(db: Db, input: SnapshotInput): Promise<Entry>;
+interface ListRevisionsInput {
+    readonly entryId: number;
+    readonly limit: number;
+    readonly cursor?: string | null;
+}
+interface ListRevisionsPage {
+    readonly revisions: readonly Entry[];
+    readonly nextCursor: string | null;
+}
+export declare function listRevisions(db: Db, input: ListRevisionsInput): Promise<ListRevisionsPage>;
+export declare function getRevision(db: Db, input: {
+    readonly revisionId: number;
+}): Promise<Entry | undefined>;
+interface UpsertAutosaveInput {
+    readonly entry: Entry;
+    readonly authorId: number;
+    readonly patch: {
+        readonly title: string;
+        readonly content: EntryContent | null;
+        readonly excerpt: string | null;
+        readonly meta: Readonly<Record<string, unknown>>;
+    };
+}
+export declare function upsertAutosave(db: Db, input: UpsertAutosaveInput): Promise<Entry>;
+interface AutosavePairInput {
+    readonly entryId: number;
+    readonly authorId: number;
+}
+export declare function getAutosave(db: Db, input: AutosavePairInput): Promise<Entry | undefined>;
+export declare function deleteAutosave(db: Db, input: AutosavePairInput): Promise<boolean>;
+interface ListActiveAutosavesInput {
+    readonly entryId: number;
+    readonly notOlderThan: Date;
+    readonly excludeAuthorId: number;
+}
+export declare function listActiveAutosaves(db: Db, input: ListActiveAutosavesInput): Promise<readonly Entry[]>;
+interface SetRevisionMessageInput {
+    readonly revisionId: number;
+    readonly message: string | null;
+}
+export declare function setRevisionMessage(db: Db, input: SetRevisionMessageInput): Promise<Entry | undefined>;
+interface PruneInput {
+    readonly entryId: number;
+    readonly maxRevisions: number;
+}
+export declare function pruneOldRevisions(db: Db, input: PruneInput): Promise<number>;
+export {};
+//# sourceMappingURL=repository.d.ts.map

package/dist/revisions/repository.d.ts.map

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

package/dist/revisions/repository.js

@@ -0,0 +1,212 @@
+import { and, desc, eq, gte, inArray, like, lt, ne } from "drizzle-orm";
+import { isUniqueConstraintError } from "../db/errors.js";
+import { entries } from "../db/schema/entries.js";
+import { RevisionRepositoryError } from "./errors.js";
+import { AUTOSAVE_TYPE, buildAutosaveSlug, buildRevisionSlug, REVISION_TYPE, } from "./slug-codec.js";
+import { encodeSnapshotEnvelope, REVISION_MESSAGE_META_KEY, } from "./snapshot-envelope.js";
+// 21 chars × 64-char alphabet = 126 bits of entropy — collision-
+// resistant under the `(type, slug)` unique index. URL-safe.
+const NANOID_ALPHABET = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ_-";
+function generateNanoid(length = 21) {
+    // crypto.getRandomValues so an attacker who learns one revision slug
+    // can't predict the next one (Math.random is seeded predictably).
+    const bytes = new Uint8Array(length);
+    globalThis.crypto.getRandomValues(bytes);
+    let out = "";
+    for (const byte of bytes) {
+        out += NANOID_ALPHABET.charAt(byte & 63);
+    }
+    return out;
+}
+// Stores the live slug + parentId in `meta.__plumix_snapshot` so a
+// future "restore" slice can rehydrate without an extra round-trip.
+// Retries once ONLY on a unique-index collision (nanoid coincidence);
+// any other insert failure bubbles up unchanged so we don't mask
+// schema/FK/NOT NULL bugs as "retry candidates".
+export async function snapshotAsRevision(db, input) {
+    const { entry, authorId } = input;
+    const meta = {
+        ...entry.meta,
+        ...encodeSnapshotEnvelope({ slug: entry.slug, parentId: entry.parentId }),
+    };
+    async function attempt() {
+        const [row] = await db
+            .insert(entries)
+            .values({
+            type: REVISION_TYPE,
+            parentId: null,
+            title: entry.title,
+            slug: buildRevisionSlug({
+                entryId: entry.id,
+                nanoid: generateNanoid(),
+            }),
+            content: entry.content,
+            excerpt: entry.excerpt,
+            status: entry.status,
+            authorId,
+            sortOrder: 0,
+            meta,
+            publishedAt: entry.publishedAt,
+        })
+            .returning();
+        if (!row)
+            throw RevisionRepositoryError.insertReturnedNoRow();
+        return row;
+    }
+    try {
+        return await attempt();
+    }
+    catch (err) {
+        if (!isUniqueConstraintError(err))
+            throw err;
+        return attempt();
+    }
+}
+function decodeCursor(raw) {
+    if (!raw)
+        return null;
+    const id = Number.parseInt(raw, 10);
+    return Number.isInteger(id) && id > 0 ? id : null;
+}
+// Slug shape is `revision:<entryId>:<nanoid>`; the `<entryId>:`
+// segment + leading-anchor `LIKE` gives a deterministic per-entry
+// predicate at the SQL layer. Without this, a JS-level filter after
+// a `type='revision'` query would silently lose rows for any entry
+// other than the most-recently-written one (limit window saturates
+// on noisy neighbours).
+function entryRevisionPrefix(entryId) {
+    return `revision:${String(entryId)}:%`;
+}
+export async function listRevisions(db, input) {
+    const cursor = decodeCursor(input.cursor);
+    const baseFilter = and(eq(entries.type, REVISION_TYPE), like(entries.slug, entryRevisionPrefix(input.entryId)));
+    const rows = await db.query.entries.findMany({
+        where: cursor ? and(baseFilter, lt(entries.id, cursor)) : baseFilter,
+        orderBy: [desc(entries.id)],
+        limit: input.limit + 1,
+    });
+    const trimmed = rows.slice(0, input.limit);
+    const hasMore = rows.length > input.limit;
+    const last = trimmed.at(-1);
+    return {
+        revisions: trimmed,
+        nextCursor: hasMore && last ? String(last.id) : null,
+    };
+}
+export async function getRevision(db, input) {
+    const row = await db.query.entries.findFirst({
+        where: and(eq(entries.id, input.revisionId), eq(entries.type, REVISION_TYPE)),
+    });
+    return row;
+}
+// Writes the per-user pending edit, inserting on first call and
+// upserting on subsequent ones. Returns the post-write row so callers
+// can read back `updatedAt` (used as the optimistic-concurrency token
+// for the next save). `meta.__plumix_snapshot` stays load-bearing —
+// the publish path reads it to recover the live slug + parentId.
+export async function upsertAutosave(db, input) {
+    const { entry, authorId, patch } = input;
+    const meta = {
+        ...patch.meta,
+        ...encodeSnapshotEnvelope({ slug: entry.slug, parentId: entry.parentId }),
+    };
+    const slug = buildAutosaveSlug({ entryId: entry.id, authorId });
+    const [row] = await db
+        .insert(entries)
+        .values({
+        type: AUTOSAVE_TYPE,
+        parentId: null,
+        title: patch.title,
+        slug,
+        content: patch.content,
+        excerpt: patch.excerpt,
+        status: entry.status,
+        authorId,
+        sortOrder: 0,
+        meta,
+        publishedAt: entry.publishedAt,
+    })
+        .onConflictDoUpdate({
+        target: [entries.type, entries.slug],
+        // The autosave row's identity (type / slug / authorId) is
+        // fixed by the deterministic-slug contract; only the editable
+        // fields + the snapshot envelope can change. `excluded.*`
+        // references the conflicting insert's values per SQLite's
+        // upsert dialect.
+        set: {
+            title: patch.title,
+            content: patch.content,
+            excerpt: patch.excerpt,
+            meta,
+            updatedAt: new Date(),
+        },
+    })
+        .returning();
+    if (!row)
+        throw RevisionRepositoryError.insertReturnedNoRow();
+    return row;
+}
+export async function getAutosave(db, input) {
+    return db.query.entries.findFirst({
+        where: and(eq(entries.type, AUTOSAVE_TYPE), eq(entries.slug, buildAutosaveSlug(input))),
+    });
+}
+export async function deleteAutosave(db, input) {
+    const result = await db
+        .delete(entries)
+        .where(and(eq(entries.type, AUTOSAVE_TYPE), eq(entries.slug, buildAutosaveSlug(input))))
+        .returning({ id: entries.id });
+    return result.length > 0;
+}
+// Slug shape is `autosave:<entryId>:<authorId>`; the leading-anchor
+// `LIKE` scopes the query to one entry without a JOIN. Same pattern
+// as `listRevisions`.
+function entryAutosavePrefix(entryId) {
+    return `autosave:${String(entryId)}:%`;
+}
+// Returns the autosave rows currently active on `entryId` — i.e.
+// touched within `notOlderThan` and not authored by the caller. The
+// RPC layer joins users on top for the wire surface; this returns
+// the raw rows so the join policy can change without touching the
+// repository.
+export async function listActiveAutosaves(db, input) {
+    return db.query.entries.findMany({
+        where: and(eq(entries.type, AUTOSAVE_TYPE), like(entries.slug, entryAutosavePrefix(input.entryId)), gte(entries.updatedAt, input.notOlderThan), ne(entries.authorId, input.excludeAuthorId)),
+        orderBy: [desc(entries.updatedAt)],
+    });
+}
+// Patches the revision row's `meta.__plumix_revision_message`. Returns
+// the updated row, or `undefined` if `revisionId` doesn't exist.
+export async function setRevisionMessage(db, input) {
+    const current = await getRevision(db, { revisionId: input.revisionId });
+    if (!current)
+        return undefined;
+    const nextMeta = { ...current.meta };
+    if (input.message === null) {
+        delete nextMeta[REVISION_MESSAGE_META_KEY];
+    }
+    else {
+        nextMeta[REVISION_MESSAGE_META_KEY] = input.message;
+    }
+    const [row] = await db
+        .update(entries)
+        .set({ meta: nextMeta })
+        .where(eq(entries.id, input.revisionId))
+        .returning();
+    return row;
+}
+// Deletes the oldest revisions for `entryId` past `maxRevisions`.
+// Returns the count actually pruned (0 when under the cap).
+export async function pruneOldRevisions(db, input) {
+    const revisions = await db.query.entries.findMany({
+        where: and(eq(entries.type, REVISION_TYPE), like(entries.slug, entryRevisionPrefix(input.entryId))),
+        orderBy: [desc(entries.id)],
+        columns: { id: true },
+    });
+    const excess = revisions.slice(input.maxRevisions);
+    if (excess.length === 0)
+        return 0;
+    await db.delete(entries).where(inArray(entries.id, excess.map((r) => r.id)));
+    return excess.length;
+}
+//# sourceMappingURL=repository.js.map

package/dist/revisions/repository.js.map

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

package/dist/revisions/slug-codec.d.ts

@@ -0,0 +1,19 @@
+export declare const REVISION_TYPE = "revision";
+interface DecodedRevisionSlug {
+    readonly entryId: number;
+    readonly nanoid: string;
+}
+export declare function buildRevisionSlug(parts: DecodedRevisionSlug): string;
+export declare function decodeRevisionSlug(slug: string): DecodedRevisionSlug | undefined;
+export declare function isRevisionType(type: unknown): type is typeof REVISION_TYPE;
+export declare const AUTOSAVE_TYPE = "autosave";
+interface DecodedAutosaveSlug {
+    readonly entryId: number;
+    readonly authorId: number;
+}
+export declare function buildAutosaveSlug(parts: DecodedAutosaveSlug): string;
+export declare function decodeAutosaveSlug(slug: string): DecodedAutosaveSlug | undefined;
+export declare function isAutosaveType(type: unknown): type is typeof AUTOSAVE_TYPE;
+export declare function isReservedType(type: unknown): boolean;
+export {};
+//# sourceMappingURL=slug-codec.d.ts.map

package/dist/revisions/slug-codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug-codec.d.ts","sourceRoot":"","sources":["../../src/revisions/slug-codec.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,aAAa,aAAa,CAAC;AAIxC,UAAU,mBAAmB;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAEpE;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,GACX,mBAAmB,GAAG,SAAS,CAQjC;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,OAAO,aAAa,CAE1E;AAOD,eAAO,MAAM,aAAa,aAAa,CAAC;AAIxC,UAAU,mBAAmB;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAEpE;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,GACX,mBAAmB,GAAG,SAAS,CAUjC;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,OAAO,aAAa,CAE1E;AAOD,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAErD"}

package/dist/revisions/slug-codec.js

@@ -0,0 +1,61 @@
+// Revision rows reuse the `entries` table with reserved `type='revision'`
+// and a `revision:<entryId>:<nanoid>` slug — the `<entryId>` segment
+// lets the repository scope queries without a JOIN, the `<nanoid>`
+// segment dodges the `(type, slug)` unique index.
+export const REVISION_TYPE = "revision";
+const REVISION_SLUG_PATTERN = /^revision:(\d+):([^:]+)$/;
+export function buildRevisionSlug(parts) {
+    return `revision:${String(parts.entryId)}:${parts.nanoid}`;
+}
+export function decodeRevisionSlug(slug) {
+    const match = REVISION_SLUG_PATTERN.exec(slug);
+    if (!match)
+        return undefined;
+    const [, entryIdRaw, nanoid] = match;
+    if (!entryIdRaw || !nanoid)
+        return undefined;
+    const entryId = Number.parseInt(entryIdRaw, 10);
+    if (!Number.isInteger(entryId) || entryId <= 0)
+        return undefined;
+    return { entryId, nanoid };
+}
+export function isRevisionType(type) {
+    return type === REVISION_TYPE;
+}
+// Per-user pending edit on a published entry. Same table as the live
+// row + revision row, distinguished by `type='autosave'` and a slug of
+// `autosave:<entryId>:<authorId>`. The deterministic shape lets the
+// existing `UNIQUE (type, slug)` index enforce one autosave per
+// (entry, user) — no separate dedup query at write time.
+export const AUTOSAVE_TYPE = "autosave";
+const AUTOSAVE_SLUG_PATTERN = /^autosave:(\d+):(\d+)$/;
+export function buildAutosaveSlug(parts) {
+    return `autosave:${String(parts.entryId)}:${String(parts.authorId)}`;
+}
+export function decodeAutosaveSlug(slug) {
+    const match = AUTOSAVE_SLUG_PATTERN.exec(slug);
+    if (!match)
+        return undefined;
+    const [, entryIdRaw, authorIdRaw] = match;
+    if (!entryIdRaw || !authorIdRaw)
+        return undefined;
+    const entryId = Number.parseInt(entryIdRaw, 10);
+    const authorId = Number.parseInt(authorIdRaw, 10);
+    if (!Number.isInteger(entryId) || entryId <= 0)
+        return undefined;
+    if (!Number.isInteger(authorId) || authorId <= 0)
+        return undefined;
+    return { entryId, authorId };
+}
+export function isAutosaveType(type) {
+    return type === AUTOSAVE_TYPE;
+}
+// Reserved-type guard for entry CRUD: both revision and autosave rows
+// live in the same table as public entries but are off-limits to
+// callers — they're written by framework code only. Use this at every
+// write surface (`entry.create`, `entry.update`) to reject the type
+// before it can land in the database.
+export function isReservedType(type) {
+    return isRevisionType(type) || isAutosaveType(type);
+}
+//# sourceMappingURL=slug-codec.js.map

package/dist/revisions/slug-codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug-codec.js","sourceRoot":"","sources":["../../src/revisions/slug-codec.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,qEAAqE;AACrE,mEAAmE;AACnE,kDAAkD;AAClD,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAC;AAExC,MAAM,qBAAqB,GAAG,0BAA0B,CAAC;AAOzD,MAAM,UAAU,iBAAiB,CAAC,KAA0B;IAC1D,OAAO,YAAY,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,IAAY;IAEZ,MAAM,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC;IACrC,IAAI,CAAC,UAAU,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC7C,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACjE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAa;IAC1C,OAAO,IAAI,KAAK,aAAa,CAAC;AAChC,CAAC;AAED,qEAAqE;AACrE,uEAAuE;AACvE,oEAAoE;AACpE,gEAAgE;AAChE,yDAAyD;AACzD,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAC;AAExC,MAAM,qBAAqB,GAAG,wBAAwB,CAAC;AAOvD,MAAM,UAAU,iBAAiB,CAAC,KAA0B;IAC1D,OAAO,YAAY,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,IAAY;IAEZ,MAAM,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,CAAC,EAAE,UAAU,EAAE,WAAW,CAAC,GAAG,KAAK,CAAC;IAC1C,IAAI,CAAC,UAAU,IAAI,CAAC,WAAW;QAAE,OAAO,SAAS,CAAC;IAClD,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAClD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACjE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,QAAQ,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACnE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAa;IAC1C,OAAO,IAAI,KAAK,aAAa,CAAC;AAChC,CAAC;AAED,sEAAsE;AACtE,iEAAiE;AACjE,sEAAsE;AACtE,oEAAoE;AACpE,sCAAsC;AACtC,MAAM,UAAU,cAAc,CAAC,IAAa;IAC1C,OAAO,cAAc,CAAC,IAAI,CAAC,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;AACtD,CAAC"}

package/dist/revisions/snapshot-envelope.d.ts

@@ -0,0 +1,20 @@
+export declare const SNAPSHOT_META_KEY = "__plumix_snapshot";
+export declare const REVISION_MESSAGE_META_KEY = "__plumix_revision_message";
+export declare const REVISION_MESSAGE_MAX_LENGTH = 280;
+interface SnapshotEnvelope {
+    readonly slug: string;
+    readonly parentId: number | null;
+}
+export declare function encodeSnapshotEnvelope(envelope: SnapshotEnvelope): {
+    readonly [SNAPSHOT_META_KEY]: SnapshotEnvelope;
+};
+export declare function decodeSnapshotEnvelope(meta: Readonly<Record<string, unknown>>): SnapshotEnvelope | undefined;
+/**
+ * Drop the framework-reserved `__plumix_*` keys (snapshot envelope, revision
+ * message) so an autosave's meta matches the live row's user-meta shape —
+ * used when overlaying an autosave onto a row for preview render.
+ */
+export declare function stripReservedMeta(meta: Readonly<Record<string, unknown>>): Record<string, unknown>;
+export declare function decodeRevisionMessage(meta: Readonly<Record<string, unknown>>): string | null;
+export {};
+//# sourceMappingURL=snapshot-envelope.d.ts.map

package/dist/revisions/snapshot-envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-envelope.d.ts","sourceRoot":"","sources":["../../src/revisions/snapshot-envelope.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AAKrD,eAAO,MAAM,yBAAyB,8BAA8B,CAAC;AAIrE,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAE/C,UAAU,gBAAgB;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,gBAAgB,GAAG;IAClE,QAAQ,CAAC,CAAC,iBAAiB,CAAC,EAAE,gBAAgB,CAAC;CAChD,CAEA;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACtC,gBAAgB,GAAG,SAAS,CAO9B;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACtC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMzB;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACtC,MAAM,GAAG,IAAI,CAOf"}

package/dist/revisions/snapshot-envelope.js

@@ -0,0 +1,44 @@
+// The `__plumix_*` meta-key namespace is reserved for framework use —
+// plugin / theme code must not author keys under it, and meta-box
+// fields cannot use this prefix.
+const RESERVED_META_PREFIX = "__plumix_";
+export const SNAPSHOT_META_KEY = "__plumix_snapshot";
+// Author-supplied label for a revision (Builder.io's "Comment" icon).
+// Lives under a separate envelope key so it can be patched in isolation
+// — no need to round-trip the whole snapshot envelope on every edit.
+export const REVISION_MESSAGE_META_KEY = "__plumix_revision_message";
+// Soft cap on author-typed labels. Long enough for one sentence, short
+// enough to render inline without truncating the row UI.
+export const REVISION_MESSAGE_MAX_LENGTH = 280;
+export function encodeSnapshotEnvelope(envelope) {
+    return { [SNAPSHOT_META_KEY]: envelope };
+}
+export function decodeSnapshotEnvelope(meta) {
+    const raw = meta[SNAPSHOT_META_KEY];
+    if (typeof raw !== "object" || raw === null)
+        return undefined;
+    const { slug, parentId } = raw;
+    if (typeof slug !== "string" || slug.length === 0)
+        return undefined;
+    if (parentId !== null && typeof parentId !== "number")
+        return undefined;
+    return { slug, parentId };
+}
+/**
+ * Drop the framework-reserved `__plumix_*` keys (snapshot envelope, revision
+ * message) so an autosave's meta matches the live row's user-meta shape —
+ * used when overlaying an autosave onto a row for preview render.
+ */
+export function stripReservedMeta(meta) {
+    return Object.fromEntries(Object.entries(meta).filter(([key]) => !key.startsWith(RESERVED_META_PREFIX)));
+}
+export function decodeRevisionMessage(meta) {
+    const raw = meta[REVISION_MESSAGE_META_KEY];
+    // Treat both missing and empty string as "no message" so callers
+    // get a stable `null | string` discriminator without an empty-string
+    // edge case downstream.
+    if (typeof raw !== "string" || raw.length === 0)
+        return null;
+    return raw;
+}
+//# sourceMappingURL=snapshot-envelope.js.map

package/dist/revisions/snapshot-envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-envelope.js","sourceRoot":"","sources":["../../src/revisions/snapshot-envelope.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,kEAAkE;AAClE,iCAAiC;AACjC,MAAM,oBAAoB,GAAG,WAAW,CAAC;AAEzC,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,CAAC;AAErD,sEAAsE;AACtE,wEAAwE;AACxE,qEAAqE;AACrE,MAAM,CAAC,MAAM,yBAAyB,GAAG,2BAA2B,CAAC;AAErE,uEAAuE;AACvE,yDAAyD;AACzD,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAG,CAAC;AAO/C,MAAM,UAAU,sBAAsB,CAAC,QAA0B;IAG/D,OAAO,EAAE,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,IAAuC;IAEvC,MAAM,GAAG,GAAG,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACpC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC9D,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,GAA6C,CAAC;IACzE,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACpE,IAAI,QAAQ,KAAK,IAAI,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACxE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAC5B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAuC;IAEvC,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,CACzB,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,oBAAoB,CAAC,CACjD,CACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,IAAuC;IAEvC,MAAM,GAAG,GAAG,IAAI,CAAC,yBAAyB,CAAC,CAAC;IAC5C,iEAAiE;IACjE,qEAAqE;IACrE,wBAAwB;IACxB,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7D,OAAO,GAAG,CAAC;AACb,CAAC"}