@krantho/persistence 0.0.0-stage → 1.0.0

package/dist/live-version.js

@@ -0,0 +1,74 @@
+/**
+ * Live-version rules shared by the adapters.
+ *
+ * A document has a current version (its newest row, what Studio edits) and
+ * at most one live version (what visitors see). Every appended row records
+ * `live_version`: the document's live version as of that row, or null when
+ * nothing is live. Only publishing changes what visitors see — a save appends
+ * a new current version and keeps the live one — and a document's publication
+ * state is read from its live version alone (see {@link statusOf}).
+ */
+/** What a write does to the live version: publishing makes the new row live, unpublishing and archiving take the document offline, a save keeps it */
+export function liveOnWrite(publication) {
+    if (publication === 'publish')
+        return 'self';
+    if (publication === 'unpublish' || publication === 'archive')
+        return 'clear';
+    return 'keep';
+}
+/** The publication a file import makes: the file's status says whether the document is live */
+export function publicationOfFile(status) {
+    if (status === 'published')
+        return 'publish';
+    return status === 'archived' ? 'archive' : 'unpublish';
+}
+/** The live version an appended row records */
+export function resolveLiveVersion(directive, version, previous) {
+    if (directive === 'self')
+        return version;
+    if (directive === 'clear')
+        return null;
+    return previous;
+}
+/**
+ * The status an appended row stores, consistent with how it is read: archived
+ * when archived (a save keeps an archived document archived), published while
+ * a version is live, draft otherwise.
+ */
+export function storedStatus(publication, liveVersion, previousStatus) {
+    if (publication === 'archive')
+        return 'archived';
+    if (liveVersion !== null)
+        return 'published';
+    if (publication === undefined && previousStatus === 'archived')
+        return 'archived';
+    return 'draft';
+}
+/**
+ * A row's publication state: a tombstone is deleted and an archived document
+ * archived; otherwise published while a version is live, draft when none is.
+ * Rows written before saves kept the live version read correctly too.
+ */
+export function statusOf(stored, liveVersion) {
+    if (stored === 'deleted')
+        return 'deleted';
+    if (liveVersion !== null)
+        return 'published';
+    return stored === 'archived' ? 'archived' : 'draft';
+}
+/** Whether visitors see a document's current version — after a save, true only where saves are live (no history) */
+export function currentIsLive(meta) {
+    return meta.liveVersion !== null && meta.liveVersion === meta.version;
+}
+/**
+ * The SQL condition that selects current rows by publication state, the same
+ * on SQLite and Postgres (columns `status` and `live_version`).
+ */
+export function statusCondition(status) {
+    if (status === 'published')
+        return 'live_version IS NOT NULL';
+    if (status === 'archived')
+        return "live_version IS NULL AND status = 'archived'";
+    return "live_version IS NULL AND status NOT IN ('archived', 'deleted')";
+}
+//# sourceMappingURL=live-version.js.map

package/dist/live-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-version.js","sourceRoot":"","sources":["../src/live-version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAUH,sJAAsJ;AACtJ,MAAM,UAAU,WAAW,CAAC,WAAoC;IAC9D,IAAI,WAAW,KAAK,SAAS;QAAE,OAAO,MAAM,CAAA;IAC5C,IAAI,WAAW,KAAK,WAAW,IAAI,WAAW,KAAK,SAAS;QAAE,OAAO,OAAO,CAAA;IAC5E,OAAO,MAAM,CAAA;AACf,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,IAAI,MAAM,KAAK,WAAW;QAAE,OAAO,SAAS,CAAA;IAC5C,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAA;AACxD,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,kBAAkB,CAChC,SAAwB,EACxB,OAAe,EACf,QAAuB;IAEvB,IAAI,SAAS,KAAK,MAAM;QAAE,OAAO,OAAO,CAAA;IACxC,IAAI,SAAS,KAAK,OAAO;QAAE,OAAO,IAAI,CAAA;IACtC,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC1B,WAAoC,EACpC,WAA0B,EAC1B,cAAkC;IAElC,IAAI,WAAW,KAAK,SAAS;QAAE,OAAO,UAAU,CAAA;IAChD,IAAI,WAAW,KAAK,IAAI;QAAE,OAAO,WAAW,CAAA;IAC5C,IAAI,WAAW,KAAK,SAAS,IAAI,cAAc,KAAK,UAAU;QAAE,OAAO,UAAU,CAAA;IACjF,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAc,EAAE,WAA0B;IACjE,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IAC1C,IAAI,WAAW,KAAK,IAAI;QAAE,OAAO,WAAW,CAAA;IAC5C,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAA;AACrD,CAAC;AAED,oHAAoH;AACpH,MAAM,UAAU,aAAa,CAAC,IAAqD;IACjF,OAAO,IAAI,CAAC,WAAW,KAAK,IAAI,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI,CAAC,OAAO,CAAA;AACvE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,MAA0C;IACxE,IAAI,MAAM,KAAK,WAAW;QAAE,OAAO,0BAA0B,CAAA;IAC7D,IAAI,MAAM,KAAK,UAAU;QAAE,OAAO,8CAA8C,CAAA;IAChF,OAAO,gEAAgE,CAAA;AACzE,CAAC"}

package/dist/migration-utils.d.ts

@@ -0,0 +1,35 @@
+import type { AppliedMigration, ContentManifest } from './migrations.js';
+/** Minimal migration identity — version + name, shared by all adapters */
+export interface MigrationIdentity {
+    version: number;
+    name: string;
+}
+/**
+ * Verify that already-applied migrations have not been modified.
+ * Requires a checksum function injected by the caller (since node:crypto
+ * is not available in the interface package).
+ */
+export declare function validateChecksums(migrations: readonly MigrationIdentity[], appliedMap: Map<number, {
+    checksum: string;
+}>, computeChecksum: (migration: MigrationIdentity) => string): void;
+/**
+ * Determine the current schema version from applied and newly-applied migrations.
+ */
+export declare function resolveCurrentVersion(appliedVersions: Iterable<number>, newlyApplied: readonly AppliedMigration[]): number;
+/**
+ * Format a migration failure error message.
+ */
+export declare function migrationFailedMessage(version: number, name: string, err: unknown): string;
+/** Content migration decision */
+export type MigrationDecision = {
+    action: 'skip';
+    reason: string;
+} | {
+    action: 'full-import';
+} | {
+    action: 'migrate';
+    repoVersion: number;
+};
+/** Determine what content migration action to take */
+export declare function decideMigration(repoManifest: ContentManifest | null, dbVersion: number | null): MigrationDecision;
+//# sourceMappingURL=migration-utils.d.ts.map

package/dist/migration-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-utils.d.ts","sourceRoot":"","sources":["../src/migration-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAExE,0EAA0E;AAC1E,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,SAAS,iBAAiB,EAAE,EACxC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,EAC7C,eAAe,EAAE,CAAC,SAAS,EAAE,iBAAiB,KAAK,MAAM,GACxD,IAAI,CAcN;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,EACjC,YAAY,EAAE,SAAS,gBAAgB,EAAE,GACxC,MAAM,CAGR;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM,CAM1F;AAED,iCAAiC;AACjC,MAAM,MAAM,iBAAiB,GACzB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,MAAM,EAAE,aAAa,CAAA;CAAE,GACzB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAA;AAE9C,sDAAsD;AACtD,wBAAgB,eAAe,CAC7B,YAAY,EAAE,eAAe,GAAG,IAAI,EACpC,SAAS,EAAE,MAAM,GAAG,IAAI,GACvB,iBAAiB,CAiBnB"}

package/dist/migration-utils.js

@@ -0,0 +1,50 @@
+/**
+ * Verify that already-applied migrations have not been modified.
+ * Requires a checksum function injected by the caller (since node:crypto
+ * is not available in the interface package).
+ */
+export function validateChecksums(migrations, appliedMap, computeChecksum) {
+    for (const migration of migrations) {
+        const existing = appliedMap.get(migration.version);
+        if (!existing)
+            continue;
+        const expectedChecksum = computeChecksum(migration);
+        if (existing.checksum !== expectedChecksum) {
+            throw new Error(`Migration V${migration.version} (${migration.name}) checksum mismatch. ` +
+                `Expected ${expectedChecksum}, found ${existing.checksum}. ` +
+                `Applied migrations must not be modified.`);
+        }
+    }
+}
+/**
+ * Determine the current schema version from applied and newly-applied migrations.
+ */
+export function resolveCurrentVersion(appliedVersions, newlyApplied) {
+    const allVersions = [...appliedVersions, ...newlyApplied.map((m) => m.version)];
+    return allVersions.length > 0 ? Math.max(...allVersions) : 0;
+}
+/**
+ * Format a migration failure error message.
+ */
+export function migrationFailedMessage(version, name, err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return (`Migration V${version} (${name}) failed: ${message}. ` +
+        `Database has been rolled back to the state before this migration.`);
+}
+/** Determine what content migration action to take */
+export function decideMigration(repoManifest, dbVersion) {
+    if (!repoManifest) {
+        return { action: 'skip', reason: 'No content manifest found in repo' };
+    }
+    if (dbVersion === null) {
+        return { action: 'full-import' };
+    }
+    if (dbVersion >= repoManifest.version) {
+        return {
+            action: 'skip',
+            reason: `DB version ${dbVersion} >= repo version ${repoManifest.version}`,
+        };
+    }
+    return { action: 'migrate', repoVersion: repoManifest.version };
+}
+//# sourceMappingURL=migration-utils.js.map

package/dist/migration-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-utils.js","sourceRoot":"","sources":["../src/migration-utils.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,UAAwC,EACxC,UAA6C,EAC7C,eAAyD;IAEzD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;QAClD,IAAI,CAAC,QAAQ;YAAE,SAAQ;QAEvB,MAAM,gBAAgB,GAAG,eAAe,CAAC,SAAS,CAAC,CAAA;QACnD,IAAI,QAAQ,CAAC,QAAQ,KAAK,gBAAgB,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CACb,cAAc,SAAS,CAAC,OAAO,KAAK,SAAS,CAAC,IAAI,uBAAuB;gBACvE,YAAY,gBAAgB,WAAW,QAAQ,CAAC,QAAQ,IAAI;gBAC5D,0CAA0C,CAC7C,CAAA;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,eAAiC,EACjC,YAAyC;IAEzC,MAAM,WAAW,GAAG,CAAC,GAAG,eAAe,EAAE,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAA;IAC/E,OAAO,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAC9D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAe,EAAE,IAAY,EAAE,GAAY;IAChF,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IAChE,OAAO,CACL,cAAc,OAAO,KAAK,IAAI,aAAa,OAAO,IAAI;QACtD,mEAAmE,CACpE,CAAA;AACH,CAAC;AAQD,sDAAsD;AACtD,MAAM,UAAU,eAAe,CAC7B,YAAoC,EACpC,SAAwB;IAExB,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,mCAAmC,EAAE,CAAA;IACxE,CAAC;IAED,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACvB,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAA;IAClC,CAAC;IAED,IAAI,SAAS,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC;QACtC,OAAO;YACL,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,cAAc,SAAS,oBAAoB,YAAY,CAAC,OAAO,EAAE;SAC1E,CAAA;IACH,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,CAAC,OAAO,EAAE,CAAA;AACjE,CAAC"}

package/dist/migrations.d.ts

@@ -0,0 +1,119 @@
+/** A single numbered database migration */
+export interface Migration {
+    /** Monotonic version number: 1, 2, 3, ... */
+    version: number;
+    /** Human-readable name: 'initial_tables', 'add_locale_column' */
+    name: string;
+    /** Apply the migration. Must be idempotent within its transaction. */
+    apply: MigrationApplyFn;
+}
+/**
+ * SQLite migrations receive a better-sqlite3 Database.
+ * Postgres migrations receive a postgres.js Sql within a transaction.
+ * Each adapter defines its own concrete type — this is the generic shape.
+ */
+export type MigrationApplyFn = (db: unknown) => void | Promise<void>;
+/** Record of an applied migration stored in schema_migrations */
+export interface AppliedMigration {
+    version: number;
+    name: string;
+    checksum: string;
+    appliedAt: string;
+}
+/** Result of running the migration process */
+export interface MigrationResult {
+    /** Migrations that were applied in this run */
+    applied: AppliedMigration[];
+    /** Current schema version after migration */
+    currentVersion: number;
+}
+/** Trigger that caused a checkpoint to be created */
+export type CheckpointTrigger = 'manual' | 'pre-migration' | 'pre-restore' | 'pre-import';
+/** Metadata for a checkpoint (lightweight timestamp marker) */
+export interface CheckpointInfo {
+    id: number;
+    version: number;
+    name: string | null;
+    trigger: CheckpointTrigger;
+    createdAt: string;
+}
+/** Interface for checkpoint operations — point-in-time restore via is_current flags */
+export interface ICheckpointAdapter {
+    /** Create a checkpoint (records timestamp, no data copying) */
+    createCheckpoint(name?: string | undefined, trigger?: CheckpointTrigger | undefined): Promise<CheckpointInfo>;
+    /** List all checkpoints (newest first) */
+    listCheckpoints(): Promise<CheckpointInfo[]>;
+    /** Get a single checkpoint by version */
+    getCheckpoint(version: number): Promise<CheckpointInfo | null>;
+    /** Restore to a checkpoint (rewinds is_current flags to checkpoint time) */
+    restoreCheckpoint(version: number): Promise<CheckpointInfo>;
+    /** Delete a checkpoint */
+    deleteCheckpoint(version: number): Promise<boolean>;
+}
+/** Content manifest file format (content/manifest.json) */
+export interface ContentManifest {
+    version: number;
+    /** The git commit the content was built from, when the build knew it */
+    commit?: string | undefined;
+    generatedAt: string;
+    files: Record<string, {
+        checksum: string;
+        size: number;
+    }>;
+}
+/** Record of an imported content manifest version */
+export interface ContentManifestRecord {
+    id: number;
+    repoVersion: number;
+    /** The git commit the imported content came from: the baseline a pull of production's edits starts at */
+    repoCommit: string | null;
+    importedAt: string;
+    /** Each file's checksum as the database last took it from the repository, by path */
+    fileChecksums: Record<string, string>;
+}
+/** A content migration conflict */
+export interface ContentConflict {
+    id: number;
+    migrationId: number;
+    collection: string;
+    slug: string;
+    locale: string;
+    repoChecksum: string;
+    dbChecksum: string;
+    resolved: boolean;
+    resolvedAt: string | null;
+    resolution: 'keep_db' | 'use_repo' | 'merged' | null;
+}
+/** Resolution for a content conflict */
+export type ConflictResolution = 'keep_db' | 'use_repo';
+/** Interface for content migration operations */
+export interface IContentMigrationAdapter {
+    /** Get the current content manifest version from DB */
+    getContentManifestVersion(): Promise<number | null>;
+    /** Get the latest content manifest record */
+    getContentManifest(): Promise<ContentManifestRecord | null>;
+    /** Save a new content manifest record */
+    saveContentManifest(manifest: ContentManifestRecord): Promise<void>;
+    /** List unresolved content migration conflicts */
+    listConflicts(): Promise<ContentConflict[]>;
+    /** Resolve a content migration conflict */
+    resolveConflict(conflictId: number, resolution: ConflictResolution): Promise<boolean>;
+    /** Record a content migration conflict */
+    recordConflict(conflict: Omit<ContentConflict, 'id' | 'resolved' | 'resolvedAt' | 'resolution'>): Promise<void>;
+}
+/** Migration status returned by the API */
+export interface MigrationStatus {
+    /** Current physical schema version */
+    schemaVersion: number;
+    /** Whether checkpoint system is available */
+    checkpointEnabled: boolean;
+    /** Whether content migration system is available */
+    contentMigrationEnabled: boolean;
+    /** Content manifest version in repo (null if no manifest) */
+    repoContentVersion: number | null;
+    /** Content manifest version in DB (null if never imported) */
+    dbContentVersion: number | null;
+    /** Number of unresolved content conflicts */
+    unresolvedConflicts: number;
+}
+//# sourceMappingURL=migrations.d.ts.map

package/dist/migrations.d.ts.map

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

package/dist/migrations.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=migrations.js.map

package/dist/migrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.js","sourceRoot":"","sources":["../src/migrations.ts"],"names":[],"mappings":""}

package/dist/page-cache.d.ts

@@ -0,0 +1,77 @@
+/**
+ * The shared page cache store — rendered pages and fetch results kept in the
+ * site's own database, so every instance of a multi-instance site reads and
+ * invalidates one cache.
+ *
+ * Timestamps are epoch milliseconds from the store's clock: the store stamps an
+ * entry's `lastModified` on `set` and a tag's mark on `markTags` from the same
+ * clock (the database server's clock on Postgres), so instances with skewed
+ * clocks still compare one entry against one mark consistently.
+ */
+/**
+ * A value the page cache stores: JSON data whose leaves may be binary.
+ *
+ * Binary leaves (`Uint8Array`, including Node `Buffer`) are stored base64-encoded
+ * inside an object `{ "__kranthoBytes": "<base64>" }` and come back as
+ * `Uint8Array`; that key is reserved. Object members that are `undefined` are
+ * dropped, as in JSON. Maps, Dates and class instances are not values — the
+ * caller converts them before `set`.
+ */
+export type PageCacheValue = null | boolean | number | string | Uint8Array | readonly PageCacheValue[] | {
+    readonly [key: string]: PageCacheValue | undefined;
+};
+/** One cached entry as the store returns it */
+export interface PageCacheEntry {
+    /** The value handed to `set`, binary leaves restored as `Uint8Array` */
+    value: PageCacheValue;
+    /** The entry's tags as of its last `set` (deduplicated, in first-seen order) */
+    tags: string[];
+    /** When the entry was last written, epoch milliseconds on the store's clock */
+    lastModified: number;
+}
+/**
+ * What marks on a set of tags mean for an entry written at a given time.
+ * `expired` — a tag was expired at or after that time: the entry must not be served.
+ * `stale` — a tag was marked stale (and none expired) at or after that time: the
+ * entry may be served while it is refreshed. `fresh` — no mark since.
+ */
+export type PageCacheTagState = 'fresh' | 'stale' | 'expired';
+/** How `markTags` marks its tags */
+export interface PageCacheMarkOptions {
+    /**
+     * `true` expires the tags now (entries written up to now are not served) and
+     * marks them stale; `false` only marks them stale now. A mark never moves a
+     * tag's timestamps backwards, and a stale mark never clears an earlier expiry.
+     */
+    expire: boolean;
+}
+/**
+ * Shared page cache persistence: entries by key, and the latest stale and expire
+ * mark per tag. Every write is safe under concurrent instances — `set` is an
+ * upsert and `markTags` is idempotent and monotonic.
+ */
+export interface IPageCacheStore {
+    /** Read an entry by key, or null when none is stored */
+    get(key: string): Promise<PageCacheEntry | null>;
+    /**
+     * Write an entry (upsert). Replaces the value and the tags of an existing entry
+     * — tags are never appended — and stamps `lastModified` with the store's clock.
+     */
+    set(key: string, value: PageCacheValue, tags: readonly string[]): Promise<void>;
+    /**
+     * Whether any of `tags` was expired or marked stale at or after `since` (epoch
+     * milliseconds, normally an entry's `lastModified`). Tags never marked are fresh.
+     */
+    tagsRevalidatedSince(tags: readonly string[], since: number): Promise<PageCacheTagState>;
+    /** Mark tags stale, or expired, as of now on the store's clock */
+    markTags(tags: readonly string[], options: PageCacheMarkOptions): Promise<void>;
+    /** How many entries (pages and data) carry any of `tags` */
+    countTagged(tags: readonly string[]): Promise<number>;
+}
+/** Unique tags in first-seen order */
+export declare function uniquePageCacheTags(tags: readonly string[]): string[];
+/** Serialise a page cache value to text, binary leaves as base64 (see `PageCacheValue`) */
+export declare function encodePageCacheValue(value: PageCacheValue): string;
+/** Parse text written by `encodePageCacheValue`, restoring binary leaves as `Uint8Array` */
+export declare function decodePageCacheValue(text: string): PageCacheValue;
+//# sourceMappingURL=page-cache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"page-cache.d.ts","sourceRoot":"","sources":["../src/page-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GACtB,IAAI,GACJ,OAAO,GACP,MAAM,GACN,MAAM,GACN,UAAU,GACV,SAAS,cAAc,EAAE,GACzB;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAA;CAAE,CAAA;AAE1D,+CAA+C;AAC/C,MAAM,WAAW,cAAc;IAC7B,wEAAwE;IACxE,KAAK,EAAE,cAAc,CAAA;IACrB,gFAAgF;IAChF,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,+EAA+E;IAC/E,YAAY,EAAE,MAAM,CAAA;CACrB;AAED;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAA;AAE7D,oCAAoC;AACpC,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,MAAM,EAAE,OAAO,CAAA;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,wDAAwD;IACxD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAA;IAChD;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/E;;;OAGG;IACH,oBAAoB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAA;IACxF,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/E,4DAA4D;IAC5D,WAAW,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CACtD;AAKD,sCAAsC;AACtC,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAErE;AAED,2FAA2F;AAC3F,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAElE;AAED,4FAA4F;AAC5F,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAKjE"}

package/dist/page-cache.js

@@ -0,0 +1,65 @@
+/**
+ * The shared page cache store — rendered pages and fetch results kept in the
+ * site's own database, so every instance of a multi-instance site reads and
+ * invalidates one cache.
+ *
+ * Timestamps are epoch milliseconds from the store's clock: the store stamps an
+ * entry's `lastModified` on `set` and a tag's mark on `markTags` from the same
+ * clock (the database server's clock on Postgres), so instances with skewed
+ * clocks still compare one entry against one mark consistently.
+ */
+const BYTES_KEY = '__kranthoBytes';
+const BASE64_CHUNK = 0x8000;
+/** Unique tags in first-seen order */
+export function uniquePageCacheTags(tags) {
+    return [...new Set(tags)];
+}
+/** Serialise a page cache value to text, binary leaves as base64 (see `PageCacheValue`) */
+export function encodePageCacheValue(value) {
+    return JSON.stringify(toJsonValue(value));
+}
+/** Parse text written by `encodePageCacheValue`, restoring binary leaves as `Uint8Array` */
+export function decodePageCacheValue(text) {
+    return JSON.parse(text, (_key, value) => {
+        if (!isBytesMarker(value))
+            return value;
+        return base64ToBytes(value[BYTES_KEY]);
+    });
+}
+/** Replace binary leaves with base64 markers (before JSON.stringify, which would call `Buffer#toJSON`) */
+function toJsonValue(value) {
+    if (value instanceof Uint8Array)
+        return { [BYTES_KEY]: bytesToBase64(value) };
+    if (Array.isArray(value))
+        return value.map((item) => toJsonValue(item));
+    if (value === null || typeof value !== 'object')
+        return value;
+    const out = {};
+    for (const [key, member] of Object.entries(value)) {
+        if (member !== undefined)
+            out[key] = toJsonValue(member);
+    }
+    return out;
+}
+function isBytesMarker(value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    const keys = Object.keys(value);
+    const encoded = value[BYTES_KEY];
+    return keys.length === 1 && keys[0] === BYTES_KEY && typeof encoded === 'string';
+}
+function bytesToBase64(bytes) {
+    let binary = '';
+    for (let i = 0; i < bytes.length; i += BASE64_CHUNK) {
+        binary += String.fromCharCode(...bytes.subarray(i, i + BASE64_CHUNK));
+    }
+    return btoa(binary);
+}
+function base64ToBytes(text) {
+    const binary = atob(text);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++)
+        bytes[i] = binary.charCodeAt(i);
+    return bytes;
+}
+//# sourceMappingURL=page-cache.js.map

package/dist/page-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-cache.js","sourceRoot":"","sources":["../src/page-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAwEH,MAAM,SAAS,GAAG,gBAAgB,CAAA;AAClC,MAAM,YAAY,GAAG,MAAM,CAAA;AAE3B,sCAAsC;AACtC,MAAM,UAAU,mBAAmB,CAAC,IAAuB;IACzD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAA;AAC3B,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,oBAAoB,CAAC,KAAqB;IACxD,OAAO,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAA;AAC3C,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,KAAc,EAAE,EAAE;QAC/C,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAA;QACvC,OAAO,aAAa,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAA;IACxC,CAAC,CAAmB,CAAA;AACtB,CAAC;AAED,0GAA0G;AAC1G,SAAS,WAAW,CAAC,KAAiC;IACpD,IAAI,KAAK,YAAY,UAAU;QAAE,OAAO,EAAE,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE,CAAA;IAC7E,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAoB,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAA;IACvF,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IAC7D,MAAM,GAAG,GAA4B,EAAE,CAAA;IACvC,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAClD,IAAI,MAAM,KAAK,SAAS;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,CAAA;IAC1D,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IACrF,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC/B,MAAM,OAAO,GAAI,KAAiC,CAAC,SAAS,CAAC,CAAA;IAC7D,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,OAAO,OAAO,KAAK,QAAQ,CAAA;AAClF,CAAC;AAED,SAAS,aAAa,CAAC,KAAiB;IACtC,IAAI,MAAM,GAAG,EAAE,CAAA;IACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,YAAY,EAAE,CAAC;QACpD,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC,CAAC,CAAA;IACvE,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAA;AACrB,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAA;IACzB,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;IACvE,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/repository-content.d.ts

@@ -0,0 +1,45 @@
+import type { ContentContract, RepositoryDocument } from '@krantho/core';
+import type { ContentDocument } from './index.js';
+export type { RepositoryBasis, RepositoryDocument } from '@krantho/core';
+/** Current-content export is not a history archive or an impersonation of its author. */
+export declare function repositoryDocument(document: ContentDocument, checksum: string): RepositoryDocument;
+/**
+ * Markdown with YAML frontmatter, readable and diffable: block style, plain
+ * keys (quoted when YAML would read them as something else), every one-line
+ * string double-quoted so a date, a number-like slug or "no" reads back as the
+ * string it was, and multi-line text as a block literal.
+ */
+export declare function repositoryMarkdown(document: RepositoryDocument): string;
+/** What a repository file holds for a document */
+export interface RepositoryFileInput {
+    fields: Record<string, unknown>;
+    body: string;
+    metadata: Record<string, unknown>;
+    defaults: readonly unknown[];
+    /** Written as the file's `status`, which the import reads: published, draft or archived */
+    status: string;
+    /** Written only for a locale other than the site's default */
+    locale?: string | undefined;
+    /** The order of the author fields in the frontmatter (the schema's declared order); others follow */
+    fieldOrder?: readonly string[] | undefined;
+}
+/**
+ * A document as a content file in a project's repository: the fields the author wrote, in the
+ * schema's order, then `status`, `locale` when it is not the default, and the metadata and
+ * defaults blocks when there are any. It leaves out what the file's place and the active contract
+ * already say (identity, contract, basis), so a diff against the file an editor changed shows
+ * the change, not a new layout. Strings are plain where YAML reads them back as strings and
+ * single-quoted where it would not, the way people write them.
+ */
+export declare function repositoryFile(input: RepositoryFileInput): string;
+/** Files keep ordinary author fields in frontmatter; reserved keys carry the envelope. */
+export declare function repositoryFrontmatter(data: Record<string, unknown>): {
+    fields: Record<string, unknown>;
+    metadata: unknown;
+    contract: unknown;
+    defaults: unknown;
+    identity: unknown;
+    basis: unknown;
+};
+export declare function contractReferenceMatches(reference: unknown, contract: ContentContract): boolean;
+//# sourceMappingURL=repository-content.d.ts.map

package/dist/repository-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository-content.d.ts","sourceRoot":"","sources":["../src/repository-content.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAExE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAExE,yFAAyF;AACzF,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,MAAM,GACf,kBAAkB,CAcpB;AAoBD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,CAQvE;AAED,kDAAkD;AAClD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAA;IAC5B,2FAA2F;IAC3F,MAAM,EAAE,MAAM,CAAA;IACd,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,qGAAqG;IACrG,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;CAC3C;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAoBjE;AAYD,0FAA0F;AAC1F,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACpE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,QAAQ,EAAE,OAAO,CAAA;IACjB,QAAQ,EAAE,OAAO,CAAA;IACjB,QAAQ,EAAE,OAAO,CAAA;IACjB,QAAQ,EAAE,OAAO,CAAA;IACjB,KAAK,EAAE,OAAO,CAAA;CACf,CASA;AAED,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAK/F"}

package/dist/repository-content.js

@@ -0,0 +1,94 @@
+import { Document, visit } from 'yaml';
+/** Current-content export is not a history archive or an impersonation of its author. */
+export function repositoryDocument(document, checksum) {
+    return {
+        identity: {
+            collection: document.meta.collection,
+            slug: document.meta.slug,
+            locale: document.meta.locale,
+        },
+        contract: document.contract,
+        fields: document.fields,
+        metadata: document.metadata,
+        defaults: document.defaults,
+        body: document.body,
+        basis: { version: document.meta.version, checksum },
+    };
+}
+/** YAML frontmatter in block style, multi-line strings as block literals, `undefined` values left out */
+function frontmatterYaml(data, parse, write) {
+    const yaml = new Document(Object.fromEntries(Object.entries(data).filter(([, value]) => value !== undefined)), parse);
+    visit(yaml, {
+        Scalar(_, node) {
+            if (typeof node.value === 'string' && node.value.includes('\n'))
+                node.type = 'BLOCK_LITERAL';
+        },
+    });
+    return yaml.toString({ defaultKeyType: 'PLAIN', lineWidth: 0, ...write });
+}
+/**
+ * Markdown with YAML frontmatter, readable and diffable: block style, plain
+ * keys (quoted when YAML would read them as something else), every one-line
+ * string double-quoted so a date, a number-like slug or "no" reads back as the
+ * string it was, and multi-line text as a block literal.
+ */
+export function repositoryMarkdown(document) {
+    const { fields, body, ...envelope } = document;
+    const frontmatter = frontmatterYaml({ ...fields, ...envelope }, {}, { defaultStringType: 'QUOTE_DOUBLE' });
+    return `---\n${frontmatter}---\n${body}`;
+}
+/**
+ * A document as a content file in a project's repository: the fields the author wrote, in the
+ * schema's order, then `status`, `locale` when it is not the default, and the metadata and
+ * defaults blocks when there are any. It leaves out what the file's place and the active contract
+ * already say (identity, contract, basis), so a diff against the file an editor changed shows
+ * the change, not a new layout. Strings are plain where YAML reads them back as strings and
+ * single-quoted where it would not, the way people write them.
+ */
+export function repositoryFile(input) {
+    const order = input.fieldOrder ?? [];
+    const names = [
+        ...order.filter((name) => name in input.fields),
+        ...Object.keys(input.fields).filter((name) => !order.includes(name)),
+    ];
+    const data = Object.fromEntries(names.map((name) => [name, input.fields[name]]));
+    data['status'] = input.status;
+    if (input.locale !== undefined)
+        data['locale'] = input.locale;
+    if (Object.keys(input.metadata).length > 0)
+        data['metadata'] = input.metadata;
+    if (input.defaults.length > 0)
+        data['defaults'] = input.defaults;
+    // YAML 1.1 rules: gray-matter reads files with them, so a date or `yes` is quoted to stay a string
+    const frontmatter = frontmatterYaml(data, { version: '1.1' }, { defaultStringType: 'PLAIN', singleQuote: true });
+    return `---\n${frontmatter}---\n${input.body}`;
+}
+const ENVELOPE_KEYS = new Set([
+    'identity',
+    'contract',
+    'metadata',
+    'defaults',
+    'basis',
+    'locale',
+    'status',
+]);
+/** Files keep ordinary author fields in frontmatter; reserved keys carry the envelope. */
+export function repositoryFrontmatter(data) {
+    return {
+        fields: Object.fromEntries(Object.entries(data).filter(([key]) => !ENVELOPE_KEYS.has(key))),
+        metadata: data['metadata'] === undefined ? {} : data['metadata'],
+        contract: data['contract'],
+        defaults: data['defaults'] ?? [],
+        identity: data['identity'],
+        basis: data['basis'],
+    };
+}
+export function contractReferenceMatches(reference, contract) {
+    if (reference === undefined || reference === null)
+        return true;
+    if (typeof reference !== 'object' || Array.isArray(reference))
+        return false;
+    const ref = reference;
+    return ref['id'] === contract.id && ref['revision'] === contract.revision;
+}
+//# sourceMappingURL=repository-content.js.map

package/dist/repository-content.js.map

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

package/dist/sort-columns.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The ORDER BY whitelist shared by every SQL adapter.
+ *
+ * A sort field arrives from a query string, so it can never be interpolated
+ * into SQL unchecked. Columns named here are emitted literally; anything else
+ * falls back to each adapter's JSON extraction expression, and only when it
+ * matches {@link SORT_FIELD_PATTERN}. Both adapters read these values from here
+ * so the two whitelists cannot drift apart.
+ */
+export declare const DIRECT_SORT_COLUMNS: readonly ["slug", "status", "locale", "created_at"];
+/** A column of the content table that may be sorted on directly */
+export type DirectSortColumn = (typeof DIRECT_SORT_COLUMNS)[number];
+/** Characters allowed in a content field name used as a sort key */
+export declare const SORT_FIELD_PATTERN: RegExp;
+/** Whether a sort field names a content table column that can be sorted directly */
+export declare function isDirectSortColumn(field: string): field is DirectSortColumn;
+/** Whether a sort field is safe to interpolate into a JSON extraction expression */
+export declare function isSafeSortField(field: string): boolean;
+//# sourceMappingURL=sort-columns.d.ts.map

package/dist/sort-columns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort-columns.d.ts","sourceRoot":"","sources":["../src/sort-columns.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,qDAAsD,CAAA;AAEtF,mEAAmE;AACnE,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEnE,oEAAoE;AACpE,eAAO,MAAM,kBAAkB,QAAa,CAAA;AAE5C,oFAAoF;AACpF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,gBAAgB,CAE3E;AAED,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEtD"}