@aotter/mantle-runtime 0.1.0-alpha.9 → 0.1.2-alpha.2

package/dist/infrastructure/persistence/DatabaseEntryRepository.js

@@ -1,18 +1,9 @@
-import { schemaIndexedFieldSql, } from "@aotter/mantle-spec";
+import { checkSchemaAdminUi, } from "@aotter/mantle-spec";
+import { EntryStatusConflict, EntryUniqueConflict, EntryVersionConflict, liftLocale, projectPublicEntry, } from "../../domain/model/EntryRow.js";
 import { clampLimit } from "../../domain/service/Pagination.js";
-import { EntryStatusConflict, EntryVersionConflict, liftLocale, projectPublicEntry, } from "../../domain/model/EntryRow.js";
-import { decodeEntrySortCursor, encodeEntrySortCursor, escapeLikeTerm, } from "./Pagination.js";
-/**
- * `EntryRepository` impl backed by `DatabaseDriver`. Adapters that
- * implement the SQLite-shaped `DatabaseDriver` contract get this
- * repository for free.
- *
- * `UPDATE … RETURNING` collapses the post-write SELECT to one round
- * trip on SQLite ≥ 3.35 / Postgres.
- *
- * Lifts `data.locale` to `EntryRow.locale` at the rowFromDb boundary
- * — see ADR-0010 + `domain/model/EntryRow.ts`.
- */
+import { decodeEntrySortCursor, encodeEntrySortCursor, escapeLikeTerm, PUBLISHED_PAGE_DATA_BUDGET, publishedPageLimit, } from "./Pagination.js";
+import { decodeField, encodeField, fieldColumn, fieldSql, isNullableJsonSchema, sqliteSchemaTable, } from "../storage/SqliteSchemaTables.js";
+/** SQLite/D1 repository where each Schema is one physical table. */
 export class DatabaseEntryRepository {
     db;
     schemasByName;
@@ -20,12 +11,41 @@ export class DatabaseEntryRepository {
         this.db = db;
         this.schemasByName = schemasByName;
     }
+    async readCreationStatistics(args) {
+        const { from, to, bucketMs } = args;
+        if (![from, to, bucketMs].every(Number.isSafeInteger) || from < 0 || to <= from ||
+            bucketMs <= 0 || to - from > 20 * 86_400_000 || Math.ceil((to - from) / bucketMs) > 480) {
+            throw new RangeError("Statistics require a positive window <= 20 days and <= 480 buckets.");
+        }
+        const table = this.table(args.collection);
+        const filter = checkSchemaAdminUi(table.schema).filter;
+        const subtypeField = filter ? requiredFieldSql(table.schema, filter.field) : null;
+        const subtype = filter && subtypeField
+            ? `CASE WHEN ${subtypeField} IN (${filter.values.map(() => "?").join(", ")}) THEN ${subtypeField} ELSE NULL END`
+            : "NULL";
+        const total = await this.db.prepare(`SELECT COUNT(*) AS count FROM ${table.table}`)
+            .first();
+        const rows = await this.db.prepare(`SELECT CAST(("_mantle_created_at" - ?) / ? AS INTEGER) AS bucket,
+      ${subtype} AS subtype, COUNT(*) AS count FROM ${table.table}
+      WHERE "_mantle_created_at" >= ? AND "_mantle_created_at" < ? GROUP BY bucket, subtype`)
+            .bind(from, bucketMs, ...(filter ? filter.values : []), from, to)
+            .all();
+        return { total: total?.count ?? 0, buckets: rows };
+    }
     async create(args) {
-        await this.db
-            .prepare(`INSERT INTO entries (id, collection, status, version, data, author_id, created_at, updated_at)
-         VALUES (?, ?, ?, 1, ?, ?, ?, ?)`)
-            .bind(args.id, args.collection, args.status, JSON.stringify(args.data), args.authorId, args.now, args.now)
-            .run();
+        const table = this.table(args.collection);
+        const columns = ["_mantle_id", "_mantle_status", "_mantle_version", "_mantle_author_id", "_mantle_created_at", "_mantle_updated_at", ...table.fields];
+        const values = [args.id, args.status, 1, args.authorId, args.now, args.now, ...this.encodedData(table, args.data)];
+        try {
+            await this.db.prepare(`INSERT INTO ${table.table} (${columns.map(quote).join(", ")}) VALUES (${columns.map(() => "?").join(", ")})`)
+                .bind(...values).run();
+        }
+        catch (error) {
+            if (isDriverUniqueConstraintError(error)) {
+                throw new EntryUniqueConflict(args.collection, args.data, error.message);
+            }
+            throw error;
+        }
         return {
             id: args.id,
             collection: args.collection,
@@ -38,408 +58,348 @@ export class DatabaseEntryRepository {
             updatedAt: args.now,
         };
     }
-    async get(id) {
-        const row = await this.db
-            .prepare(`SELECT id, collection, status, version, data, author_id, created_at, updated_at
-         FROM entries WHERE id = ?`)
-            .bind(id)
-            .first();
-        return row ? rowFromDb(row) : null;
+    async get(args) {
+        const table = this.table(args.collection);
+        const row = await this.db.prepare(`SELECT ${table.selectColumns} FROM ${table.table} WHERE "_mantle_id" = ?`)
+            .bind(args.id).first();
+        return row ? rowFromDb(table, row) : null;
     }
     async update(args) {
-        const newVersion = args.expectedVersion + 1;
-        const row = await this.db
-            .prepare(`UPDATE entries SET data = ?, version = ?, updated_at = ?
-         WHERE id = ? AND version = ?
-         RETURNING id, collection, status, version, data, author_id, created_at, updated_at`)
-            .bind(JSON.stringify(args.data), newVersion, args.now, args.id, args.expectedVersion)
-            .first();
+        const table = this.table(args.collection);
+        const version = args.expectedVersion + 1;
+        const assignments = [...table.fields.map((field) => `${quote(field)} = ?`), '"_mantle_version" = ?', '"_mantle_updated_at" = ?'];
+        let row = null;
+        try {
+            row = await this.db.prepare(`UPDATE ${table.table} SET ${assignments.join(", ")}
+        WHERE "_mantle_id" = ? AND "_mantle_version" = ? RETURNING ${table.selectColumns}`)
+                .bind(...this.encodedData(table, args.data), version, args.now, args.id, args.expectedVersion)
+                .first();
+        }
+        catch (error) {
+            if (isDriverUniqueConstraintError(error)) {
+                throw new EntryUniqueConflict(args.collection, args.data, error.message);
+            }
+            throw error;
+        }
         if (!row)
-            throw await this.versionConflict(args.id, args.expectedVersion);
-        return rowFromDb(row);
+            throw await this.versionConflict(table, args.id, args.expectedVersion);
+        return rowFromDb(table, row);
     }
     async delete(args) {
-        const parentMatches = `id = ? AND collection = ? AND status = ? AND version = ?`;
-        const parentSnapshot = [
-            args.id,
-            args.collection,
-            args.expectedStatus,
-            args.expectedVersion,
-        ];
-        const result = await this.db
-            .prepare(`DELETE FROM entries WHERE ${parentMatches}`)
-            .bind(...parentSnapshot)
-            .run();
+        const table = this.table(args.collection);
+        const result = await this.db.prepare(`DELETE FROM ${table.table} WHERE "_mantle_id" = ? AND "_mantle_status" = ? AND "_mantle_version" = ?`)
+            .bind(args.id, args.expectedStatus, args.expectedVersion).run();
         if (result.meta.changes > 0)
             return { removed: true };
-        const after = await this.db
-            .prepare(`SELECT collection, status, version FROM entries WHERE id = ?`)
-            .bind(args.id)
-            .first();
-        if (!after || after.collection !== args.collection)
+        const after = await this.db.prepare(`SELECT "_mantle_status" AS "status", "_mantle_version" AS "version" FROM ${table.table} WHERE "_mantle_id" = ?`)
+            .bind(args.id).first();
+        if (!after)
             return { removed: false };
-        if (after.version !== args.expectedVersion) {
+        if (after.version !== args.expectedVersion)
             throw new EntryVersionConflict(args.id, args.expectedVersion, after.version);
-        }
         throw new EntryStatusConflict(args.id, args.expectedStatus, after.status);
     }
     async transitionStatus(args) {
-        const { expectedStatus, expectedVersion } = args;
-        const guards = [];
+        const table = this.table(args.collection);
+        const conditions = ['"_mantle_id" = ?'];
         const binds = [args.to, args.now, args.id];
-        if (expectedStatus !== undefined) {
-            guards.push(" AND status = ?");
-            binds.push(expectedStatus);
+        if (args.expectedStatus !== undefined) {
+            conditions.push('"_mantle_status" = ?');
+            binds.push(args.expectedStatus);
         }
-        if (expectedVersion !== undefined) {
-            guards.push(" AND version = ?");
-            binds.push(expectedVersion);
+        if (args.expectedVersion !== undefined) {
+            conditions.push('"_mantle_version" = ?');
+            binds.push(args.expectedVersion);
         }
-        const row = await this.db
-            .prepare(`UPDATE entries SET status = ?, version = version + 1, updated_at = ?
-         WHERE id = ?${guards.join("")}
-         RETURNING id, collection, status, version, data, author_id, created_at, updated_at`)
-            .bind(...binds)
-            .first();
+        const row = await this.db.prepare(`UPDATE ${table.table} SET "_mantle_status" = ?, "_mantle_version" = "_mantle_version" + 1, "_mantle_updated_at" = ?
+      WHERE ${conditions.join(" AND ")} RETURNING ${table.selectColumns}`).bind(...binds).first();
         if (row)
-            return rowFromDb(row);
-        // Disambiguate version- vs. status-conflict from a single SELECT —
-        // splitting into two SELECTs leaves a TOCTOU window where a third
-        // concurrent writer between the two reads can flip which guard
-        // appears to have failed.
-        const after = await this.db
-            .prepare(`SELECT version, status FROM entries WHERE id = ?`)
-            .bind(args.id)
-            .first();
-        if (expectedVersion !== undefined && after && after.version !== expectedVersion) {
-            throw new EntryVersionConflict(args.id, expectedVersion, after.version);
+            return rowFromDb(table, row);
+        const after = await this.db.prepare(`SELECT "_mantle_status" AS "status", "_mantle_version" AS "version" FROM ${table.table} WHERE "_mantle_id" = ?`)
+            .bind(args.id).first();
+        if (args.expectedVersion !== undefined && after && after.version !== args.expectedVersion) {
+            throw new EntryVersionConflict(args.id, args.expectedVersion, after.version);
         }
-        throw new EntryStatusConflict(args.id, expectedStatus ?? args.to, after?.status ?? args.to);
+        throw new EntryStatusConflict(args.id, args.expectedStatus ?? args.to, after?.status ?? args.to);
     }
     async list(args) {
-        // Use the shared clamp so direct repo callers (tests, future
-        // adapters that bypass the use case) get the same default page
-        // size as ListEntriesUseCase — not a silently different 100.
+        const table = this.table(args.collection);
         const limit = clampLimit(args.limit);
         const sort = args.sort ?? { field: "updatedAt", direction: "desc" };
-        const schema = this.schemasByName.get(args.collection);
-        const sortSql = entrySortSql(schema, sort.field);
-        if (!sortSql)
-            throw new Error(`unavailable entry sort field: ${sort.field}`);
+        const sortSql = args.sort ? requiredFieldSql(table.schema, sort.field) : '"_mantle_updated_at"';
         const cursor = decodeEntrySortCursor(args.cursor, sort.field, sort.direction);
         const backward = args.cursorDirection === "backward" && cursor !== null;
-        const queryDirection = backward
-            ? (sort.direction === "asc" ? "DESC" : "ASC")
-            : sort.direction.toUpperCase();
-        // Fetch limit+1 to detect a next page without a second query —
-        // the extra row never reaches the caller.
-        const probe = limit + 1;
-        const conditions = ["collection = ?"];
-        const binds = [args.collection];
+        const direction = backward ? (sort.direction === "asc" ? "DESC" : "ASC") : sort.direction.toUpperCase();
+        const conditions = [];
+        const binds = [];
         if (args.status) {
-            conditions.push("status = ?");
+            conditions.push('"_mantle_status" = ?');
             binds.push(args.status);
         }
         if (args.search) {
             const term = escapeLikeTerm(args.search);
-            const searchConditions = ["id LIKE '%'||?||'%' ESCAPE '\\'"];
+            const search = ['"_mantle_id" LIKE \'%\'||?||\'%\' ESCAPE \'\\\''];
             binds.push(term);
             for (const field of args.searchFields ?? []) {
-                searchConditions.push("json_extract(data, ?) LIKE '%'||?||'%' ESCAPE '\\'");
-                binds.push(jsonPathForTopLevelField(field), term);
+                search.push(`${requiredFieldSql(table.schema, field)} LIKE '%'||?||'%' ESCAPE '\\'`);
+                binds.push(term);
             }
-            conditions.push(`(${searchConditions.join(" OR ")})`);
+            conditions.push(`(${search.join(" OR ")})`);
         }
         if (args.filter) {
-            const compiled = compileDataPredicates(schema, [{
-                    field: args.filter.field,
-                    kind: "equal",
-                    value: args.filter.value,
-                }]);
-            conditions.push(...compiled.conditions);
-            binds.push(...compiled.binds);
+            conditions.push(`${requiredFieldSql(table.schema, args.filter.field)} = ?`);
+            binds.push(encodeScalar(table.schema, args.filter.field, args.filter.value));
+        }
+        if (args.scope) {
+            conditions.push(`${requiredFieldSql(table.schema, args.scope.field)} = ?`);
+            binds.push(encodeScalar(table.schema, args.scope.field, args.scope.value));
         }
         if (cursor) {
-            const comparison = backward
-                ? (sort.direction === "asc" ? "<" : ">")
-                : (sort.direction === "asc" ? ">" : "<");
-            conditions.push(`(${sortSql}, id) ${comparison} (?, ?)`);
+            const comparison = backward ? (sort.direction === "asc" ? "<" : ">") : (sort.direction === "asc" ? ">" : "<");
+            conditions.push(`(${sortSql}, "_mantle_id") ${comparison} (?, ?)`);
             binds.push(...cursor);
         }
-        binds.push(probe);
-        const stmt = this.db
-            .prepare(`SELECT id, collection, status, version, data, author_id, created_at, updated_at
-         FROM entries WHERE ${conditions.join(" AND ")}
-         ORDER BY ${sortSql} ${queryDirection}, id ${queryDirection} LIMIT ?`)
-            .bind(...binds);
-        const rows = await stmt.all();
+        binds.push(limit + 1);
+        const rows = await this.db.prepare(`SELECT ${table.selectColumns} FROM ${table.table}
+      ${conditions.length ? `WHERE ${conditions.join(" AND ")}` : ""}
+      ORDER BY ${sortSql} ${direction}, "_mantle_id" ${direction} LIMIT ?`).bind(...binds).all();
         const hasMore = rows.length > limit;
         const page = [...(hasMore ? rows.slice(0, limit) : rows)];
         if (backward)
             page.reverse();
         const first = page[0];
-        const last = page[page.length - 1];
+        const last = page.at(-1);
         return {
-            rows: page.map(rowFromDb),
-            previousCursor: first && (backward ? hasMore : cursor !== null)
-                ? encodeEntrySortCursor(sort.field, sort.direction, entrySortValueFromDb(first, sort.field), first.id)
-                : undefined,
-            nextCursor: last && (backward ? cursor !== null : hasMore)
-                ? encodeEntrySortCursor(sort.field, sort.direction, entrySortValueFromDb(last, sort.field), last.id)
-                : undefined,
+            rows: page.map((row) => rowFromDb(table, row)),
+            previousCursor: first && (backward ? hasMore : cursor !== null) ? encodeEntrySortCursor(sort.field, sort.direction, sortValue(first, table.schema, sort.field), first._mantle_id) : undefined,
+            nextCursor: last && (backward ? cursor !== null : hasMore) ? encodeEntrySortCursor(sort.field, sort.direction, sortValue(last, table.schema, sort.field), last._mantle_id) : undefined,
         };
     }
     async findByDataField(args) {
-        return this.findOneByDataFields({
-            collection: args.collection,
-            status: args.status,
-            fields: { [args.field]: args.value },
-        });
+        return this.findOne({ ...args, fields: { [args.field]: args.value } });
     }
     async findByDataFields(args) {
-        return this.findOneByDataFields(args);
+        return this.findOne(args);
     }
-    async readById(id) {
-        const row = await this.get(id);
+    async readById(args) {
+        const row = await this.get(args);
         return row ? projectPublicEntry(row) : null;
     }
     async readBySlug(args) {
-        return this.readByDataField({
-            collection: args.collection,
-            field: "slug",
-            value: args.slug,
-            locale: args.locale,
-            status: args.status,
-        });
+        return this.readByDataField({ ...args, field: "slug", value: args.slug });
     }
     async readByDataField(args) {
-        const row = await this.findOneByDataFields({
-            collection: args.collection,
-            status: args.status,
-            fields: { [args.field]: args.value },
-            locale: args.locale,
-        });
+        const row = await this.findOne({ ...args, fields: { [args.field]: args.value } });
         return row ? projectPublicEntry(row) : null;
     }
     async readByDataFieldIn(args) {
         const values = [...new Set(args.values)];
-        if (values.length === 0)
+        if (!values.length)
             return [];
-        const entries = [];
-        for (let start = 0; start < values.length; start += ENTRY_READ_BATCH_SIZE) {
-            const chunk = values.slice(start, start + ENTRY_READ_BATCH_SIZE);
-            const conditions = ["collection = ?"];
-            const binds = [args.collection];
-            const schema = this.schemasByName.get(args.collection);
-            const compiled = compileDataPredicates(schema, [
-                { field: args.field, kind: "in", values: chunk },
-                ...localePredicates(args.locale),
-            ]);
-            conditions.push(...compiled.conditions);
-            binds.push(...compiled.binds);
-            if (args.status) {
-                conditions.push("status = ?");
-                binds.push(args.status);
-            }
-            const rows = await this.db
-                .prepare(`SELECT ${ENTRY_COLUMNS} FROM entries
-           WHERE ${conditions.join(" AND ")} ORDER BY updated_at DESC`)
-                .bind(...binds)
-                .all();
-            entries.push(...rows.map(rowFromDb).map(projectPublicEntry));
+        const table = this.table(args.collection);
+        const field = requiredFieldSql(table.schema, args.field);
+        const output = [];
+        for (let start = 0; start < values.length; start += 95) {
+            const chunk = values.slice(start, start + 95);
+            const conditions = [`${field} IN (${chunk.map(() => "?").join(", ")})`];
+            const binds = chunk.map((value) => encodeScalar(table.schema, args.field, value));
+            this.addReadConditions(table, conditions, binds, args);
+            const sql = args.latestPerValue
+                ? `SELECT ${table.selectColumns} FROM ${table.table} WHERE "_mantle_id" IN (SELECT "_mantle_id" FROM (
+            SELECT "_mantle_id", ROW_NUMBER() OVER (PARTITION BY ${field} ORDER BY "_mantle_updated_at" DESC, "_mantle_id" DESC) AS rank
+            FROM ${table.table} WHERE ${conditions.join(" AND ")}) WHERE rank = 1) ORDER BY "_mantle_updated_at" DESC, "_mantle_id" DESC`
+                : `SELECT ${table.selectColumns} FROM ${table.table} WHERE ${conditions.join(" AND ")} ORDER BY "_mantle_updated_at" DESC`;
+            const rows = await this.db.prepare(sql).bind(...binds).all();
+            output.push(...rows.map((row) => projectPublicEntry(rowFromDb(table, row))));
         }
-        entries.sort((a, b) => b.updatedAt - a.updatedAt);
-        return entries;
+        return output.sort((a, b) => b.updatedAt - a.updatedAt);
     }
-    async readPublished(args = {}) {
-        const conditions = ["status = 'published'"];
+    async readPublished(args) {
+        const table = this.table(args.collection);
+        const conditions = ['"_mantle_status" = \'published\''];
         const binds = [];
-        if (args.locale === null) {
-            conditions.push("entry_locale IS NULL");
-        }
-        else if (args.locale !== undefined) {
-            conditions.push("entry_locale = ?");
+        this.addLocaleCondition(table, conditions, binds, args.locale);
+        const limit = typeof args.limit === "number" && Number.isFinite(args.limit) && args.limit > 0 ? ` LIMIT ${Math.floor(args.limit)}` : "";
+        const rows = await this.db.prepare(`SELECT ${table.selectColumns} FROM ${table.table} WHERE ${conditions.join(" AND ")} ORDER BY "_mantle_updated_at" DESC${limit}`)
+            .bind(...binds).all();
+        return rows.map((row) => projectPublicEntry(rowFromDb(table, row)));
+    }
+    async readPublishedPage(args) {
+        const table = this.table(args.collection);
+        const limit = publishedPageLimit(args.limit);
+        const fields = args.dataFields
+            ? [...new Set([...args.dataFields.filter((field) => table.fields.includes(field)), ...(table.fields.includes("locale") ? ["locale"] : [])])]
+            : table.fields;
+        const columns = ['"_mantle_id"', '"_mantle_status"', '"_mantle_version"', '"_mantle_author_id"', '"_mantle_created_at"', '"_mantle_updated_at"', ...fields.map(quote)];
+        const conditions = ['"_mantle_status" = \'published\''];
+        const binds = [];
+        if (args.includeUnlocalized && typeof args.locale === "string") {
+            const locale = requiredFieldSql(table.schema, "locale");
+            conditions.push(`(${locale} = ? OR ${locale} IS NULL)`);
             binds.push(args.locale);
         }
-        if (args.collection) {
-            conditions.push("collection = ?");
-            binds.push(args.collection);
+        else {
+            this.addLocaleCondition(table, conditions, binds, args.locale);
         }
-        let sql = `SELECT ${ENTRY_COLUMNS} FROM entries ` +
-            `WHERE ${conditions.join(" AND ")} ORDER BY updated_at DESC`;
-        if (typeof args.limit === "number" &&
-            Number.isFinite(args.limit) &&
-            args.limit > 0) {
-            sql += ` LIMIT ${Math.floor(args.limit)}`;
+        const cursor = decodeEntrySortCursor(args.cursor, "updatedAt", "desc");
+        if (cursor) {
+            conditions.push('("_mantle_updated_at", "_mantle_id") < (?, ?)');
+            binds.push(...cursor);
         }
-        const rows = await this.db.prepare(sql).bind(...binds).all();
-        return rows.map(rowFromDb).map(projectPublicEntry);
+        const rowBytes = fields.length
+            ? fields.map((field) => `length(CAST(json_quote(${quote(field)}) AS BLOB)) + ${new TextEncoder().encode(field).byteLength + 3}`).join(" + ")
+            : "2";
+        const rows = await this.db.prepare(`WITH candidates AS (
+      SELECT ${columns.join(", ")} FROM ${table.table} WHERE ${conditions.join(" AND ")}
+      ORDER BY "_mantle_updated_at" DESC, "_mantle_id" DESC LIMIT ${limit + 1}
+    ), budget AS (
+      SELECT *, (${rowBytes}) AS "_row_bytes", LEAD("_mantle_id") OVER (ORDER BY "_mantle_updated_at" DESC, "_mantle_id" DESC) AS "_next_id",
+        SUM(${rowBytes}) OVER (ORDER BY "_mantle_updated_at" DESC, "_mantle_id" DESC) AS "_data_bytes" FROM candidates
+    ) SELECT ${columns.join(", ")}, "_next_id" FROM budget
+      WHERE "_data_bytes" = "_row_bytes" OR "_data_bytes" <= ${PUBLISHED_PAGE_DATA_BUDGET}
+      ORDER BY "_mantle_updated_at" DESC, "_mantle_id" DESC`)
+            .bind(...binds).all();
+        const page = rows.slice(0, limit);
+        const last = page.at(-1);
+        return {
+            rows: page.map((row) => projectPublicEntry(rowFromDb(table, row, args.dataFields))),
+            ...(last?._next_id != null ? { nextCursor: encodeEntrySortCursor("updatedAt", "desc", last._mantle_updated_at, last._mantle_id) } : {}),
+        };
     }
     async findManyByDataField(args) {
-        const conditions = ["collection = ?"];
-        const binds = [args.collection];
-        const compiled = compileDataPredicates(this.schemasByName.get(args.collection), [{ field: args.field, kind: "equal", value: args.value }]);
-        conditions.push(...compiled.conditions);
-        binds.push(...compiled.binds);
-        const limit = Number.isFinite(args.limit) && args.limit > 0
-            ? Math.floor(args.limit)
-            : 1;
-        const rows = await this.db
-            .prepare(`SELECT ${ENTRY_COLUMNS} FROM entries
-         WHERE ${conditions.join(" AND ")}
-         ORDER BY updated_at DESC, id DESC LIMIT ${limit}`)
-            .bind(...binds)
-            .all();
-        return rows.map(rowFromDb).map(projectPublicEntry);
+        const table = this.table(args.collection);
+        const field = requiredFieldSql(table.schema, args.field);
+        const limit = Number.isFinite(args.limit) && args.limit > 0 ? Math.floor(args.limit) : 1;
+        const rows = await this.db.prepare(`SELECT ${table.selectColumns} FROM ${table.table} WHERE ${field} = ? ORDER BY "_mantle_updated_at" DESC, "_mantle_id" DESC LIMIT ${limit}`)
+            .bind(encodeScalar(table.schema, args.field, args.value)).all();
+        return rows.map((row) => projectPublicEntry(rowFromDb(table, row)));
     }
-    async findOneByDataFields(args) {
-        const entries = Object.entries(args.fields);
-        if (entries.length === 0)
+    table(collection) {
+        const schema = this.schemasByName.get(collection);
+        if (!schema)
+            throw new Error(`unknown Schema table: ${collection}`);
+        return sqliteSchemaTable(schema);
+    }
+    encodedData(table, data) {
+        const properties = table.schema.spec.schema.properties ?? {};
+        const unknown = Object.keys(data).find((field) => !Object.hasOwn(properties, field));
+        if (unknown)
+            throw new Error(`Schema '${table.schema.metadata.name}' has no field '${unknown}'.`);
+        return table.fields.map((field) => encodeField(data[field], properties[field]));
+    }
+    async findOne(args) {
+        const table = this.table(args.collection);
+        const conditions = [];
+        const binds = [];
+        for (const [field, value] of Object.entries(args.fields)) {
+            conditions.push(`${requiredFieldSql(table.schema, field)} = ?`);
+            binds.push(encodeScalar(table.schema, field, value));
+        }
+        if (!conditions.length)
             return null;
-        const conditions = ["collection = ?"];
-        const binds = [args.collection];
-        const schema = this.schemasByName.get(args.collection);
         if (args.status) {
-            conditions.push("status = ?");
+            conditions.push('"_mantle_status" = ?');
             binds.push(args.status);
         }
-        const compiled = compileDataPredicates(schema, [
-            ...entries.map(([field, value]) => ({
-                field,
-                kind: "equal",
-                value,
-            })),
-            ...localePredicates(args.locale),
-        ]);
-        conditions.push(...compiled.conditions);
-        binds.push(...compiled.binds);
+        this.addLocaleCondition(table, conditions, binds, args.locale);
         if (args.excludeId) {
-            conditions.push("id <> ?");
+            conditions.push('"_mantle_id" <> ?');
             binds.push(args.excludeId);
         }
-        const row = await this.db
-            .prepare(`SELECT id, collection, status, version, data, author_id, created_at, updated_at
-         FROM entries
-         WHERE ${conditions.join(" AND ")}
-         ORDER BY updated_at DESC LIMIT 1`)
-            .bind(...binds)
-            .first();
-        return row ? rowFromDb(row) : null;
-    }
-    async versionConflict(id, expected) {
-        const after = await this.db
-            .prepare(`SELECT version FROM entries WHERE id = ?`)
-            .bind(id)
-            .first();
-        return new EntryVersionConflict(id, expected, after?.version ?? -1);
+        const row = await this.db.prepare(`SELECT ${table.selectColumns} FROM ${table.table} WHERE ${conditions.join(" AND ")} ORDER BY "_mantle_updated_at" DESC LIMIT 1`)
+            .bind(...binds).first();
+        return row ? rowFromDb(table, row) : null;
     }
-}
-const ENTRY_COLUMNS = "id, collection, status, version, data, author_id, created_at, updated_at";
-// D1 accepts at most 100 bound parameters. The worst fallback shape uses
-// five fixed binds (collection, two JSON paths, locale, status), leaving 95
-// values for the parent `IN` predicate.
-const ENTRY_READ_BATCH_SIZE = 95;
-function localePredicates(locale) {
-    if (locale === undefined)
-        return [];
-    return locale === null
-        ? [{ field: "locale", kind: "null" }]
-        : [{ field: "locale", kind: "equal", value: locale }];
-}
-function compileDataPredicates(schema, predicates) {
-    const conditions = [];
-    const binds = [];
-    const indexed = usableIndexedFields(schema, predicates);
-    for (const predicate of predicates) {
-        const generated = schema && indexed.has(predicate.field)
-            ? schemaIndexedFieldSql(schema, predicate.field)
-            : null;
-        const reference = generated ?? "json_extract(data, ?)";
-        if (!generated)
-            binds.push(jsonPathForTopLevelField(predicate.field));
-        if (predicate.kind === "null") {
-            conditions.push(`${reference} IS NULL`);
+    addReadConditions(table, conditions, binds, args) {
+        if (args.status) {
+            conditions.push('"_mantle_status" = ?');
+            binds.push(args.status);
         }
-        else if (predicate.kind === "in") {
-            conditions.push(`${reference} IN (${predicate.values.map(() => "?").join(", ")})`);
-            binds.push(...predicate.values);
+        this.addLocaleCondition(table, conditions, binds, args.locale);
+    }
+    addLocaleCondition(table, conditions, binds, locale) {
+        if (locale === undefined)
+            return;
+        const field = fieldSql(table.schema, "locale");
+        if (!field) {
+            if (locale !== null)
+                conditions.push("0 = 1");
+            return;
         }
+        if (locale === null)
+            conditions.push(`${field} IS NULL`);
         else {
-            conditions.push(`${reference} = ?`);
-            binds.push(predicate.value);
+            conditions.push(`${field} = ?`);
+            binds.push(locale);
         }
     }
-    return { conditions, binds };
+    async versionConflict(table, id, expected) {
+        const after = await this.db.prepare(`SELECT "_mantle_version" AS "version" FROM ${table.table} WHERE "_mantle_id" = ?`).bind(id).first();
+        return new EntryVersionConflict(id, expected, after?.version ?? -1);
+    }
 }
-function usableIndexedFields(schema, predicates) {
-    if (!schema)
-        return new Set();
-    const byField = new Map(predicates.map((predicate) => [predicate.field, predicate]));
-    const usable = new Set();
-    const declarations = [
-        ...(schema.spec.uniqueIndexes ?? []),
-        ...(schema.spec.indexes ?? []),
-    ];
-    for (const declaration of declarations) {
-        for (let index = 0; index < declaration.length; index += 1) {
-            const field = declaration[index];
-            const predicate = byField.get(field);
-            if (!predicate)
-                break;
-            if (index === 0 &&
-                (predicate.kind === "null" ||
-                    (predicate.kind === "equal" && predicate.value === null))) {
-                break;
-            }
-            usable.add(field);
-        }
+function rowFromDb(table, row, dataFields) {
+    const properties = table.schema.spec.schema.properties ?? {};
+    const data = {};
+    let locale;
+    for (const field of table.fields) {
+        if (!Object.hasOwn(row, field))
+            continue;
+        const value = decodeField(row[field], properties[field]);
+        if (field === "locale" && typeof value === "string")
+            locale = value;
+        if ((!dataFields || dataFields.includes(field)) && value !== undefined)
+            data[field] = value;
     }
-    return usable;
+    for (const field of dataFields ?? []) {
+        const property = properties[field];
+        if ((!property || isNullableJsonSchema(property)) && !Object.hasOwn(data, field))
+            data[field] = null;
+    }
+    return {
+        id: row._mantle_id,
+        collection: table.schema.metadata.name,
+        locale: locale ?? liftLocale(data),
+        status: row._mantle_status,
+        version: row._mantle_version,
+        data,
+        authorId: row._mantle_author_id,
+        createdAt: row._mantle_created_at,
+        updatedAt: row._mantle_updated_at,
+    };
 }
-function entrySortSql(schema, field) {
-    if (field === "id")
-        return "id";
-    if (field === "status")
-        return "status";
-    if (field === "updatedAt")
-        return "updated_at";
-    return schema ? schemaIndexedFieldSql(schema, field) : null;
+function requiredFieldSql(schema, field) {
+    const sql = fieldSql(schema, field);
+    if (!sql)
+        throw new Error(`Schema '${schema.metadata.name}' has no field '${field}'.`);
+    return sql;
 }
-function entrySortValueFromDb(row, field) {
-    if (field === "id")
-        return row.id;
-    if (field === "status")
-        return row.status;
-    if (field === "updatedAt")
-        return row.updated_at;
-    const value = JSON.parse(row.data)[field];
-    if (typeof value === "boolean")
-        return Number(value);
-    if (typeof value !== "string" && typeof value !== "number") {
+function encodeScalar(schema, field, value) {
+    const property = schema.spec.schema.properties?.[field];
+    return property ? encodeField(value, property) : value;
+}
+function sortValue(row, schema, field) {
+    const physical = fieldColumn(schema, field);
+    if (!physical)
+        throw new Error(`Schema '${schema.metadata.name}' has no field '${field}'.`);
+    const value = row[physical];
+    if (typeof value !== "string" && typeof value !== "number")
         throw new Error(`non-scalar sort value for ${field}`);
-    }
     return value;
 }
-function rowFromDb(row) {
-    const data = JSON.parse(row.data);
-    return {
-        id: row.id,
-        collection: row.collection,
-        locale: liftLocale(data),
-        status: row.status,
-        version: row.version,
-        data,
-        authorId: row.author_id,
-        createdAt: row.created_at,
-        updatedAt: row.updated_at,
-    };
+function quote(value) {
+    return `"${value.replace(/"/g, '""')}"`;
 }
-function jsonPathForTopLevelField(field) {
-    return `$."${field.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
+/** Compatibility helper now requires the Schema that owns the table. */
+export async function readEntryBySlug(db, schema, args) {
+    return new DatabaseEntryRepository(db, new Map([[schema.metadata.name, schema]])).readBySlug(args);
 }
-/** Public compatibility helper. Without a Schema map it intentionally uses
- * the safe JSON fallback; in-repo callers use `MantleRuntime.entries`. */
-export async function readEntryBySlug(db, args) {
-    return new DatabaseEntryRepository(db).readBySlug(args);
+function isDriverUniqueConstraintError(error) {
+    if (!(error instanceof Error))
+        return false;
+    const message = error.message || "";
+    return message.includes("UNIQUE constraint failed") || message.includes("unique constraint") ||
+        message.includes("duplicate key") || error.code === "SQLITE_CONSTRAINT_UNIQUE" ||
+        error.code === "23505";
 }
 //# sourceMappingURL=DatabaseEntryRepository.js.map