@murumets-ee/content 0.1.2 → 0.1.4

package/dist/blocks/index.d.ts

@@ -0,0 +1,187 @@
+import { B as BlockDefinition } from '../types-BYeiE1ie.js';
+import * as _murumets_ee_entity from '@murumets-ee/entity';
+
+declare const CodeBlock: BlockDefinition<{
+    readonly code: _murumets_ee_entity.TextField & {
+        readonly required: true;
+    };
+    readonly language: _murumets_ee_entity.SelectField & {
+        options: readonly ["javascript", "typescript", "python", "html", "css", "json", "bash", "sql", "other"];
+    } & Omit<Partial<_murumets_ee_entity.SelectField>, "options">;
+}>;
+
+declare const CTABlock: BlockDefinition<{
+    readonly heading: _murumets_ee_entity.TextField & {
+        readonly required: true;
+        readonly translatable: true;
+    };
+    readonly description: _murumets_ee_entity.TextField & {
+        readonly translatable: true;
+    };
+    readonly buttonText: _murumets_ee_entity.TextField & {
+        readonly required: true;
+        readonly translatable: true;
+    };
+    readonly buttonLink: _murumets_ee_entity.TextField & {
+        readonly required: true;
+    };
+}>;
+
+declare const GalleryBlock: BlockDefinition<{
+    readonly images: _murumets_ee_entity.ReferenceField & {
+        cardinality: "many";
+    } & Partial<Omit<_murumets_ee_entity.ReferenceField, "entity" | "cardinality">>;
+    readonly columns: _murumets_ee_entity.SelectField & {
+        options: readonly ["2", "3", "4"];
+    } & Omit<Partial<_murumets_ee_entity.SelectField>, "options">;
+}>;
+
+declare const HeroBlock: BlockDefinition<{
+    readonly heading: _murumets_ee_entity.TextField & {
+        readonly required: true;
+        readonly translatable: true;
+    };
+    readonly subheading: _murumets_ee_entity.TextField & {
+        readonly translatable: true;
+    };
+    readonly background: _murumets_ee_entity.MediaField & {
+        readonly accept: ["image/*"];
+    };
+    readonly alignment: _murumets_ee_entity.SelectField & {
+        options: readonly ["left", "center", "right"];
+    } & Omit<Partial<_murumets_ee_entity.SelectField>, "options">;
+}>;
+
+declare const ImageBlock: BlockDefinition<{
+    readonly image: _murumets_ee_entity.MediaField & {
+        readonly accept: ["image/*"];
+        readonly required: true;
+    };
+    readonly alt: _murumets_ee_entity.TextField & {
+        readonly translatable: true;
+    };
+    readonly caption: _murumets_ee_entity.TextField & {
+        readonly translatable: true;
+    };
+}>;
+
+declare const QuoteBlock: BlockDefinition<{
+    readonly quote: _murumets_ee_entity.TextField & {
+        readonly required: true;
+        readonly translatable: true;
+    };
+    readonly attribution: _murumets_ee_entity.TextField & {
+        readonly translatable: true;
+    };
+}>;
+
+declare const RichTextBlock: BlockDefinition<{
+    readonly content: _murumets_ee_entity.RichTextField & {
+        readonly translatable: true;
+    };
+}>;
+
+declare const VideoBlock: BlockDefinition<{
+    readonly url: _murumets_ee_entity.TextField & {
+        readonly required: true;
+    };
+    readonly poster: _murumets_ee_entity.MediaField & {
+        readonly accept: ["image/*"];
+    };
+    readonly caption: _murumets_ee_entity.TextField & {
+        readonly translatable: true;
+    };
+}>;
+
+/**
+ * All common blocks shipped with the toolkit.
+ * Use as-is or pick individual blocks from the named exports.
+ *
+ * @example
+ * import { commonBlocks } from '@murumets-ee/content/blocks'
+ * const Page = defineEntity({
+ *   name: 'page',
+ *   fields: {
+ *     layout: field.blocks({ blocks: [...commonBlocks] }),
+ *   },
+ * })
+ */
+declare const commonBlocks: readonly [BlockDefinition<{
+    readonly content: _murumets_ee_entity.RichTextField & {
+        readonly translatable: true;
+    };
+}>, BlockDefinition<{
+    readonly image: _murumets_ee_entity.MediaField & {
+        readonly accept: ["image/*"];
+        readonly required: true;
+    };
+    readonly alt: _murumets_ee_entity.TextField & {
+        readonly translatable: true;
+    };
+    readonly caption: _murumets_ee_entity.TextField & {
+        readonly translatable: true;
+    };
+}>, BlockDefinition<{
+    readonly heading: _murumets_ee_entity.TextField & {
+        readonly required: true;
+        readonly translatable: true;
+    };
+    readonly subheading: _murumets_ee_entity.TextField & {
+        readonly translatable: true;
+    };
+    readonly background: _murumets_ee_entity.MediaField & {
+        readonly accept: ["image/*"];
+    };
+    readonly alignment: _murumets_ee_entity.SelectField & {
+        options: readonly ["left", "center", "right"];
+    } & Omit<Partial<_murumets_ee_entity.SelectField>, "options">;
+}>, BlockDefinition<{
+    readonly images: _murumets_ee_entity.ReferenceField & {
+        cardinality: "many";
+    } & Partial<Omit<_murumets_ee_entity.ReferenceField, "entity" | "cardinality">>;
+    readonly columns: _murumets_ee_entity.SelectField & {
+        options: readonly ["2", "3", "4"];
+    } & Omit<Partial<_murumets_ee_entity.SelectField>, "options">;
+}>, BlockDefinition<{
+    readonly heading: _murumets_ee_entity.TextField & {
+        readonly required: true;
+        readonly translatable: true;
+    };
+    readonly description: _murumets_ee_entity.TextField & {
+        readonly translatable: true;
+    };
+    readonly buttonText: _murumets_ee_entity.TextField & {
+        readonly required: true;
+        readonly translatable: true;
+    };
+    readonly buttonLink: _murumets_ee_entity.TextField & {
+        readonly required: true;
+    };
+}>, BlockDefinition<{
+    readonly url: _murumets_ee_entity.TextField & {
+        readonly required: true;
+    };
+    readonly poster: _murumets_ee_entity.MediaField & {
+        readonly accept: ["image/*"];
+    };
+    readonly caption: _murumets_ee_entity.TextField & {
+        readonly translatable: true;
+    };
+}>, BlockDefinition<{
+    readonly quote: _murumets_ee_entity.TextField & {
+        readonly required: true;
+        readonly translatable: true;
+    };
+    readonly attribution: _murumets_ee_entity.TextField & {
+        readonly translatable: true;
+    };
+}>, BlockDefinition<{
+    readonly code: _murumets_ee_entity.TextField & {
+        readonly required: true;
+    };
+    readonly language: _murumets_ee_entity.SelectField & {
+        options: readonly ["javascript", "typescript", "python", "html", "css", "json", "bash", "sql", "other"];
+    } & Omit<Partial<_murumets_ee_entity.SelectField>, "options">;
+}>];
+
+export { CTABlock, CodeBlock, GalleryBlock, HeroBlock, ImageBlock, QuoteBlock, RichTextBlock, VideoBlock, commonBlocks };

package/dist/client.d.ts

@@ -0,0 +1,215 @@
+import { Logger } from '@murumets-ee/core';
+import { Entity, FieldToTS, FieldConfig } from '@murumets-ee/entity';
+import { FindManyOptions } from '@murumets-ee/entity/admin';
+import { PostgresJsDatabase } from 'drizzle-orm/postgres-js';
+import { F as FieldDiff } from './types-Cr0ifLn_.js';
+import { V as VersionEntry, D as DraftEntry, T as TranslationStatus, a as TranslationReport, L as LocalePublishStatus } from './types-BYeiE1ie.js';
+
+/**
+ * ContentClient — wraps AdminClient with version history and translation status.
+ *
+ * Usage:
+ *   import { createContentClient } from '@murumets-ee/content/client'
+ *   const pages = createContentClient(Page)
+ *   await pages.create({ title: 'Hello', layout: [...] })
+ */
+
+/** Value type that any entity field can hold */
+type EntityFieldValue = FieldToTS<FieldConfig> | null | undefined;
+interface ContentClientConfig {
+    entity: Entity;
+    db: PostgresJsDatabase;
+    logger?: Logger;
+}
+declare class ContentClient {
+    private entity;
+    private db;
+    private logger?;
+    private admin;
+    private versionableOptions;
+    constructor(config: ContentClientConfig);
+    private getAdmin;
+    create(data: Record<string, EntityFieldValue>): Promise<{
+        id: string;
+    } & {} & {
+        [x: string]: string | number | boolean | Date | Record<string, unknown> | Record<string, unknown>[] | {
+            [key: string]: unknown;
+            _block: string;
+            _id: string;
+        }[] | null | undefined;
+    }>;
+    findById(id: string, options?: {
+        locale?: string;
+    }): Promise<({
+        id: string;
+    } & {} & {
+        [x: string]: string | number | boolean | Date | Record<string, unknown> | Record<string, unknown>[] | {
+            [key: string]: unknown;
+            _block: string;
+            _id: string;
+        }[] | null | undefined;
+    }) | null>;
+    findMany(options?: FindManyOptions): Promise<({
+        id: string;
+    } & {} & {
+        [x: string]: string | number | boolean | Date | Record<string, unknown> | Record<string, unknown>[] | {
+            [key: string]: unknown;
+            _block: string;
+            _id: string;
+        }[] | null | undefined;
+    })[]>;
+    update(id: string, data: Record<string, EntityFieldValue>): Promise<{
+        id: string;
+    } & {} & {
+        [x: string]: string | number | boolean | Date | Record<string, unknown> | Record<string, unknown>[] | {
+            [key: string]: unknown;
+            _block: string;
+            _id: string;
+        }[] | null | undefined;
+    }>;
+    delete(id: string): Promise<void>;
+    saveTranslation(entityId: string, locale: string, translations: Record<string, unknown>): Promise<void>;
+    deleteTranslation(entityId: string, locale?: string): Promise<void>;
+    /**
+     * Copy layout from one locale to another (for localized: true blocks).
+     */
+    copyLayout(entityId: string, options: {
+        from: string;
+        to: string | string[];
+    }): Promise<void>;
+    /**
+     * List versions for an entity (newest first), filtered by locale.
+     * Uses '_' as the locale value for default-locale snapshots.
+     */
+    getVersions(entityId: string, options?: {
+        limit?: number;
+        offset?: number;
+        locale?: string;
+    }): Promise<VersionEntry[]>;
+    /**
+     * Get a specific version snapshot.
+     */
+    getVersion(entityId: string, version: number, locale?: string): Promise<VersionEntry | null>;
+    /**
+     * Compare two versions and return field-level diff.
+     *
+     * Returns structured diffs with word-level segments for text fields
+     * and structural block diffs for blocks fields.
+     */
+    compareVersions(entityId: string, v1: number, v2: number, locale?: string): Promise<{
+        diffs: FieldDiff[];
+        fromVersion: VersionEntry;
+        toVersion: VersionEntry;
+    } | null>;
+    /**
+     * Compare the current draft with the live entity (or a specific version).
+     * Returns field-level diffs between the current published data and the draft.
+     */
+    compareDraftWithCurrent(entityId: string, locale?: string): Promise<{
+        diffs: FieldDiff[];
+        current: Record<string, unknown>;
+        draft: DraftEntry;
+    } | null>;
+    /**
+     * Restore an entity to a previous version.
+     */
+    restoreVersion(entityId: string, version: number): Promise<{
+        id: string;
+    } & {} & {
+        [x: string]: string | number | boolean | Date | Record<string, unknown> | Record<string, unknown>[] | {
+            [key: string]: unknown;
+            _block: string;
+            _id: string;
+        }[] | null | undefined;
+    }>;
+    /**
+     * Enforce maxPerDoc retention by deleting oldest versions for a locale.
+     */
+    pruneVersions(entityId: string, locale?: string): Promise<void>;
+    /**
+     * Get translation status for an entity — per-locale completion report.
+     */
+    getTranslationStatus(entityId: string): Promise<TranslationStatus>;
+    /**
+     * Get translation status for multiple entities in a single query.
+     * Returns a map of entityId → TranslationStatus (O(1) DB roundtrips).
+     */
+    getTranslationStatusBatch(entityIds: string[]): Promise<Map<string, TranslationStatus>>;
+    /**
+     * Get translation report across all entities of this type.
+     */
+    getTranslationReport(options?: {
+        locale?: string;
+    }): Promise<TranslationReport>;
+    /**
+     * Get per-locale publish status for an entity.
+     * Returns status for all non-default locales that have explicit overrides.
+     * Missing locale = inherits base entity status.
+     */
+    getLocaleStatus(entityId: string): Promise<LocalePublishStatus[]>;
+    /**
+     * Set per-locale publish status. Upserts into locale_status table.
+     * When locale === defaultLocale, updates the base entity status instead.
+     */
+    setLocaleStatus(entityId: string, locale: string, status: 'draft' | 'published'): Promise<void>;
+    /**
+     * Get per-locale publish status for multiple entities in a single query.
+     * Returns a map of entityId → locale → LocalePublishStatus.
+     */
+    getLocaleStatusBatch(entityIds: string[]): Promise<Map<string, Record<string, LocalePublishStatus>>>;
+    /**
+     * Save (upsert) a draft for an entity+locale.
+     * One draft per entity+locale — overwrites any existing draft.
+     */
+    saveDraft(entityId: string, data: Record<string, unknown>, locale?: string, user?: {
+        id: string;
+        name?: string;
+    }): Promise<DraftEntry>;
+    /**
+     * Get the draft for an entity+locale, or null if none exists.
+     */
+    getDraft(entityId: string, locale?: string): Promise<DraftEntry | null>;
+    /**
+     * Delete (discard) a draft for an entity+locale.
+     */
+    deleteDraft(entityId: string, locale?: string): Promise<boolean>;
+    /**
+     * Publish a draft: apply draft data to the live entity, then delete the draft.
+     * Runs in a transaction to ensure atomicity.
+     */
+    publishDraft(entityId: string, locale?: string, user?: {
+        id: string;
+        name?: string;
+    }): Promise<Record<string, unknown>>;
+    /**
+     * Quick existence check for list badges — does a draft exist?
+     */
+    hasDraft(entityId: string, locale?: string): Promise<boolean>;
+    /**
+     * Check draft existence for multiple entities in one query.
+     * Returns a set of entity IDs that have drafts.
+     */
+    hasDraftBatch(entityIds: string[], locale?: string): Promise<Set<string>>;
+    /**
+     * Create a version snapshot for an entity after an external update.
+     * Use this when the update was performed by AdminClient directly
+     * (e.g., the admin API handler) rather than through ContentClient.update().
+     *
+     * @param locale - The locale being edited. Use undefined or '_' for the default locale.
+     * @param user - The user who made the change (id + name for display).
+     */
+    createVersionSnapshot(entityId: string, currentData: Record<string, unknown>, previousData?: Record<string, unknown> | null, locale?: string, user?: {
+        id: string;
+        name?: string;
+    }): Promise<void>;
+    private saveVersionSnapshot;
+    private toDraftEntry;
+    private calculateDelta;
+}
+/**
+ * Factory — creates a ContentClient for an entity.
+ * Must be called after createApp().
+ */
+declare function createContentClient(entity: Entity): Promise<ContentClient>;
+
+export { ContentClient, type ContentClientConfig, createContentClient };

package/dist/index.d.ts

@@ -0,0 +1,142 @@
+import { Behavior, NumberField, DateField, SelectField, TextField, FieldConfig } from '@murumets-ee/entity';
+import { b as VersionableOptions, B as BlockDefinition } from './types-BYeiE1ie.js';
+export { C as ContentConfig, D as DraftEntry, I as InferBlockData, c as InferBlocksUnion, d as LocaleConfig, e as LockInfo, f as TranslationFieldStatus, a as TranslationReport, T as TranslationStatus, V as VersionEntry } from './types-BYeiE1ie.js';
+import { B as BlockDiffEntry, F as FieldDiff, D as DiffSegment } from './types-Cr0ifLn_.js';
+export { a as BlockDiffStatus, P as PropDiff } from './types-Cr0ifLn_.js';
+
+/**
+ * Versionable behavior — full version history with snapshots.
+ *
+ * Extends the concept of revisionable() (which only tracks a counter)
+ * with actual version snapshots stored in {entity}_versions table.
+ *
+ * The behavior itself adds fields + hooks for version tracking.
+ * Actual snapshot persistence happens in ContentClient (which has DB access).
+ *
+ * Options:
+ * - maxPerDoc: Maximum versions kept per document (default: 50)
+ * - autosave: Enable smart autosave (default: false)
+ */
+
+type VersionableFields = {
+    _version: NumberField & {
+        required: true;
+    };
+    _versionedAt: DateField;
+};
+declare function versionable(options?: VersionableOptions): Behavior<VersionableFields>;
+/**
+ * Extract versionable options from an entity's behaviors
+ */
+declare function getVersionableOptions(behaviors?: Behavior[]): Required<VersionableOptions> | null;
+
+/**
+ * Workflowable behavior — editorial workflow with approval gates.
+ *
+ * Adds workflow status tracking fields to an entity. Works alongside
+ * `publishable()` — the workflow status tracks the editorial pipeline,
+ * while publishable's `status` remains the public-facing state.
+ *
+ * Key invariant: `status` can only transition to 'published' when
+ * `_workflowStatus === 'approved'` (unless the user has direct `publish`
+ * permission, which bypasses the workflow).
+ *
+ * Workflow states:
+ * - draft → in_review (submit for review, requires 'update')
+ * - in_review → approved (approve, requires 'publish')
+ * - in_review → rejected (reject with note, requires 'publish')
+ * - approved → published (publish, requires 'publish')
+ * - rejected → in_review (resubmit, requires 'update')
+ * - published → draft (unpublish, requires 'publish')
+ */
+
+declare const WORKFLOW_STATES: readonly ["draft", "in_review", "approved", "rejected", "published"];
+type WorkflowState = (typeof WORKFLOW_STATES)[number];
+type WorkflowableFields = {
+    _workflowStatus: SelectField & {
+        required: true;
+    };
+    _workflowAssignee: TextField;
+    _workflowNote: TextField;
+    _workflowUpdatedAt: DateField;
+};
+declare function workflowable(): Behavior<WorkflowableFields>;
+
+/**
+ * Block definition API
+ *
+ * defineBlock() creates a reusable content block with typed fields.
+ * Uses `const F` generic to preserve literal field types for inference.
+ *
+ * Blocks are NOT entities — they lack independent identity, CRUD, and access control.
+ * They exist only as embedded data within a parent entity's blocks field.
+ *
+ * @example
+ * const HeroBlock = defineBlock({
+ *   slug: 'hero',
+ *   label: 'Hero Section',
+ *   fields: {
+ *     heading: field.text({ required: true, translatable: true }),
+ *     background: field.media({ accept: ['image/*'] }),
+ *   },
+ * })
+ */
+
+declare function defineBlock<const F extends Record<string, FieldConfig>>(definition: {
+    slug: string;
+    label: string;
+    fields: F;
+}): BlockDefinition<F>;
+
+/**
+ * Structural diff for Puck block arrays.
+ *
+ * Blocks are identified by `_id`. The algorithm detects:
+ * - Added blocks (new _id in target)
+ * - Removed blocks (missing _id in target)
+ * - Moved blocks (same _id, different position)
+ * - Changed blocks (same _id, different prop values)
+ * - Unchanged blocks
+ */
+
+/**
+ * Compute structural diff between two block arrays.
+ *
+ * Each block is identified by its `_id` field. Position changes,
+ * additions, removals, and prop-level changes are all detected.
+ */
+declare function diffBlocks(fromBlocks: unknown[], toBlocks: unknown[]): BlockDiffEntry[];
+
+/**
+ * Field-level diff — dispatches to the appropriate diff strategy per field type.
+ */
+
+/**
+ * Compute diff for a single field, using the field's type to determine
+ * the best diff strategy.
+ */
+declare function diffField(fieldName: string, from: unknown, to: unknown, fieldConfig?: FieldConfig): FieldDiff | null;
+/**
+ * Diff all fields between two version snapshots.
+ * Pass fieldConfigs to get type-aware diffs; without them, types are inferred.
+ */
+declare function diffFields(from: Record<string, unknown>, to: Record<string, unknown>, fieldConfigs?: Record<string, FieldConfig>): FieldDiff[];
+/** Diff two string values and return segments (used by block-diff for string props). */
+declare function diffStringValues(from: unknown, to: unknown): DiffSegment[] | undefined;
+
+/**
+ * Word-level text diff using a simplified Myers algorithm.
+ *
+ * Splits text into words (preserving whitespace), computes the longest common
+ * subsequence, and returns an array of diff segments.
+ */
+
+/**
+ * Compute word-level diff between two strings.
+ *
+ * Uses a simple LCS (dynamic programming) approach which is fine for
+ * the text sizes we deal with (entity field values, not source code).
+ */
+declare function diffText(from: string, to: string): DiffSegment[];
+
+export { BlockDefinition, BlockDiffEntry, DiffSegment, FieldDiff, VersionableOptions, WORKFLOW_STATES, type WorkflowState, type WorkflowableFields, defineBlock, diffBlocks, diffField, diffFields, diffStringValues, diffText, getVersionableOptions, versionable, workflowable };

package/dist/lock-service.d.ts

@@ -0,0 +1,61 @@
+import { PostgresJsDatabase } from 'drizzle-orm/postgres-js';
+import { e as LockInfo } from './types-BYeiE1ie.js';
+import '@murumets-ee/entity';
+
+/**
+ * Content lock service — pessimistic locking for entity editing.
+ *
+ * Prevents concurrent edit conflicts by allowing only one editor at a time
+ * per entity+locale combination. Locks expire after 5 minutes and must
+ * be renewed via heartbeat.
+ */
+
+interface LockServiceConfig {
+    db: PostgresJsDatabase;
+}
+declare class LockService {
+    private db;
+    constructor(config: LockServiceConfig);
+    private getTable;
+    /**
+     * Acquire a lock on an entity+locale.
+     *
+     * - Deletes expired locks first
+     * - Attempts INSERT; on conflict checks if same user (re-entrant → renew)
+     * - Returns { acquired: true } or { acquired: false, lock: LockInfo }
+     */
+    acquireLock(entityType: string, entityId: string, locale: string, user: {
+        id: string;
+        name?: string;
+    }): Promise<{
+        acquired: true;
+    } | {
+        acquired: false;
+        lock: LockInfo;
+    }>;
+    /**
+     * Renew an existing lock (heartbeat).
+     * Only succeeds if the caller holds the lock and it hasn't expired.
+     */
+    renewLock(entityType: string, entityId: string, locale: string, userId: string): Promise<boolean>;
+    /**
+     * Release a lock. Only the lock holder can release their own lock.
+     */
+    releaseLock(entityType: string, entityId: string, locale: string, userId: string): Promise<boolean>;
+    /**
+     * Force-release a lock regardless of who holds it.
+     * Admin-only operation — must be audit-logged by the caller.
+     */
+    forceReleaseLock(entityType: string, entityId: string, locale: string): Promise<boolean>;
+    /**
+     * Get the current lock for an entity+locale.
+     * Returns null if no lock or lock has expired.
+     */
+    getLock(entityType: string, entityId: string, locale: string): Promise<LockInfo | null>;
+}
+/**
+ * Factory — creates a LockService using the app's DB connection.
+ */
+declare function createLockService(): Promise<LockService>;
+
+export { LockService, type LockServiceConfig, createLockService };

package/dist/plugin.d.ts

@@ -0,0 +1,33 @@
+import { Plugin } from '@murumets-ee/core';
+import { C as ContentConfig } from './types-BYeiE1ie.js';
+import '@murumets-ee/entity';
+
+/**
+ * Content plugin — registers locale configuration and version schemas.
+ *
+ * Usage:
+ *   import { content } from '@murumets-ee/content/plugin'
+ *
+ *   export default defineConfig({
+ *     plugins: [
+ *       content({
+ *         locales: [
+ *           { code: 'en', label: 'English' },
+ *           { code: 'de', label: 'German' },
+ *         ],
+ *         defaultLocale: 'en',
+ *       }),
+ *     ],
+ *   })
+ */
+
+/**
+ * Get the content configuration. Throws if plugin not initialized.
+ */
+declare function getContentConfig(): ContentConfig;
+/**
+ * Content plugin factory.
+ */
+declare function content(config: ContentConfig): Plugin;
+
+export { content, getContentConfig };

package/dist/query-client.d.ts

@@ -0,0 +1,67 @@
+import { Logger } from '@murumets-ee/core';
+import { Entity } from '@murumets-ee/entity';
+import { FindByIdOptions, FindManyOptions, CountOptions } from '@murumets-ee/entity/query';
+import { PostgresJsDatabase } from 'drizzle-orm/postgres-js';
+
+/**
+ * ContentQueryClient — read-only content queries, safe for client bundles.
+ *
+ * Usage:
+ *   import { createContentQueryClient } from '@murumets-ee/content/query'
+ *   const pages = createContentQueryClient(Page)
+ *   const page = await pages.findBySlug('about', { locale: 'de' })
+ */
+
+interface ContentQueryClientConfig {
+    entity: Entity;
+    db: PostgresJsDatabase;
+    logger?: Logger;
+}
+declare class ContentQueryClient {
+    private entity;
+    private db;
+    private logger?;
+    private query;
+    constructor(config: ContentQueryClientConfig);
+    private getQuery;
+    findById(id: string, options?: FindByIdOptions): Promise<({
+        id: string;
+    } & {} & {
+        [x: string]: string | number | boolean | Record<string, unknown> | Date | Record<string, unknown>[] | {
+            [key: string]: unknown;
+            _block: string;
+            _id: string;
+        }[] | null | undefined;
+    }) | null>;
+    /**
+     * Find entity by slug — convenience for slug-based lookups.
+     */
+    findBySlug(slug: string, options?: {
+        locale?: string;
+    }): Promise<({
+        id: string;
+    } & {} & {
+        [x: string]: string | number | boolean | Record<string, unknown> | Date | Record<string, unknown>[] | {
+            [key: string]: unknown;
+            _block: string;
+            _id: string;
+        }[] | null | undefined;
+    }) | null>;
+    findMany(options?: FindManyOptions): Promise<({
+        id: string;
+    } & {} & {
+        [x: string]: string | number | boolean | Record<string, unknown> | Date | Record<string, unknown>[] | {
+            [key: string]: unknown;
+            _block: string;
+            _id: string;
+        }[] | null | undefined;
+    })[]>;
+    count(options?: CountOptions): Promise<number>;
+}
+/**
+ * Factory — creates a ContentQueryClient for an entity.
+ * Must be called after createApp().
+ */
+declare function createContentQueryClient(entity: Entity): Promise<ContentQueryClient>;
+
+export { ContentQueryClient, type ContentQueryClientConfig, createContentQueryClient };

package/dist/types-BYeiE1ie.d.ts

@@ -0,0 +1,99 @@
+import { FieldConfig, InferEntityDTO } from '@murumets-ee/entity';
+
+/**
+ * Content package types
+ */
+
+/**
+ * A block definition — describes a reusable content block's data shape.
+ *
+ * @typeParam F - The literal field map, inferred from the call site.
+ */
+interface BlockDefinition<F extends Record<string, FieldConfig> = Record<string, FieldConfig>> {
+    slug: string;
+    label: string;
+    fields: F;
+}
+/**
+ * Infer the data shape of a single block definition.
+ * Produces `{ _block: 'hero'; _id: string; heading: string; ... }`
+ */
+type InferBlockData<B extends BlockDefinition> = B extends BlockDefinition<infer F> ? {
+    _block: B['slug'];
+    _id: string;
+} & Omit<InferEntityDTO<F>, 'id'> : never;
+/**
+ * Infer a discriminated union from a tuple of block definitions.
+ *
+ * @example
+ * type Layout = InferBlocksUnion<typeof [HeroBlock, RichTextBlock]>
+ * // = { _block: 'hero'; ... } | { _block: 'richtext'; ... }
+ */
+type InferBlocksUnion<T extends readonly BlockDefinition[]> = {
+    [K in keyof T]: T[K] extends BlockDefinition ? InferBlockData<T[K]> : never;
+}[number];
+interface LocaleConfig {
+    code: string;
+    label: string;
+}
+interface ContentConfig {
+    locales: LocaleConfig[];
+    defaultLocale: string;
+}
+interface VersionableOptions {
+    /** Maximum versions kept per document. Default: 50 */
+    maxPerDoc?: number;
+    /** Enable autosave (single mutable autosave version). Default: false */
+    autosave?: boolean;
+}
+interface VersionEntry {
+    id: string;
+    entityId: string;
+    version: number;
+    locale: string;
+    data: Record<string, unknown>;
+    delta: Record<string, unknown> | null;
+    status: string | null;
+    createdBy: string | null;
+    createdByName: string | null;
+    createdAt: Date | string;
+    isAutosave: boolean;
+}
+interface TranslationFieldStatus {
+    complete: boolean;
+    total: number;
+    translated: number;
+    missing: string[];
+}
+interface TranslationStatus {
+    [locale: string]: TranslationFieldStatus;
+}
+interface TranslationReport {
+    total: number;
+    complete: number;
+    partial: number;
+    missing: number;
+}
+interface LocalePublishStatus {
+    locale: string;
+    status: 'draft' | 'published';
+    publishedAt: Date | string | null;
+}
+interface DraftEntry {
+    id: string;
+    entityId: string;
+    locale: string;
+    data: Record<string, unknown>;
+    createdBy: string;
+    createdByName: string | null;
+    createdAt: Date | string;
+    updatedAt: Date | string;
+}
+interface LockInfo {
+    lockedBy: string;
+    lockedByName: string | null;
+    lockedAt: Date | string;
+    expiresAt: Date | string;
+}
+
+export type { BlockDefinition as B, ContentConfig as C, DraftEntry as D, InferBlockData as I, LocalePublishStatus as L, TranslationStatus as T, VersionEntry as V, TranslationReport as a, VersionableOptions as b, InferBlocksUnion as c, LocaleConfig as d, LockInfo as e, TranslationFieldStatus as f };

package/dist/types-Cr0ifLn_.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Diff result types for version comparison.
+ */
+/** A segment within a word-level text diff. */
+interface DiffSegment {
+    type: 'equal' | 'add' | 'remove';
+    value: string;
+}
+/** Diff result for a single scalar field. */
+interface FieldDiff {
+    field: string;
+    type: 'text' | 'number' | 'boolean' | 'date' | 'select' | 'media' | 'richtext' | 'json' | 'blocks' | 'unknown';
+    from: unknown;
+    to: unknown;
+    /** Word-level diff segments (present for text/richtext/slug fields). */
+    segments?: DiffSegment[];
+    /** Block-level structural diff (present for blocks fields). */
+    blockDiffs?: BlockDiffEntry[];
+}
+/** Status of a single block within a structural diff. */
+type BlockDiffStatus = 'added' | 'removed' | 'moved' | 'changed' | 'unchanged';
+/** Diff result for a single block within a blocks field. */
+interface BlockDiffEntry {
+    blockId: string;
+    blockType: string;
+    status: BlockDiffStatus;
+    fromIndex?: number;
+    toIndex?: number;
+    /** Per-prop diffs for changed blocks. */
+    propDiffs?: PropDiff[];
+}
+/** Diff for a single prop within a changed block. */
+interface PropDiff {
+    field: string;
+    from: unknown;
+    to: unknown;
+    /** Word-level segments for string props. */
+    segments?: DiffSegment[];
+}
+
+export type { BlockDiffEntry as B, DiffSegment as D, FieldDiff as F, PropDiff as P, BlockDiffStatus as a };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@murumets-ee/content",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "license": "Elastic-2.0",
   "type": "module",
   "exports": {
@@ -36,10 +36,10 @@
     "drizzle-orm": "^0.45.1",
     "server-only": "^0.0.1",
     "zod": "^3.24.1",
-    "@murumets-ee/core": "0.1.3",
-    "@murumets-ee/logging": "0.1.3",
-    "@murumets-ee/db": "0.1.2",
-    "@murumets-ee/entity": "0.1.2"
+    "@murumets-ee/db": "0.1.4",
+    "@murumets-ee/entity": "0.1.4",
+    "@murumets-ee/core": "0.1.5",
+    "@murumets-ee/logging": "0.1.5"
   },
   "devDependencies": {
     "@types/node": "^22.10.5",