@htmless/core 0.1.0

package/dist/cli/index.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,11 @@
+export declare const config: {
+    readonly port: number;
+    readonly nodeEnv: string;
+    readonly databaseUrl: string;
+    readonly redisUrl: string;
+    readonly jwtSecret: string;
+    readonly jwtExpiresIn: "24h";
+    readonly apiTokenPrefix: "hle_";
+    readonly previewTokenPrefix: "hlp_";
+};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM;;;;;;;;;CAST,CAAC"}

package/dist/config.js

@@ -0,0 +1,11 @@
+export const config = {
+    port: parseInt(process.env.PORT || '3000', 10),
+    nodeEnv: process.env.NODE_ENV || 'development',
+    databaseUrl: process.env.DATABASE_URL,
+    redisUrl: process.env.REDIS_URL || 'redis://localhost:6379',
+    jwtSecret: process.env.JWT_SECRET || 'dev-secret-change-in-production-please',
+    jwtExpiresIn: '24h',
+    apiTokenPrefix: 'hle_',
+    previewTokenPrefix: 'hlp_',
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,MAAM,EAAE,EAAE,CAAC;IAC9C,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,aAAa;IAC9C,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,YAAa;IACtC,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,wBAAwB;IAC3D,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,wCAAwC;IAC7E,YAAY,EAAE,KAAK;IACnB,cAAc,EAAE,MAAM;IACtB,kBAAkB,EAAE,MAAM;CAClB,CAAC"}

package/dist/content/advanced-query.d.ts

@@ -0,0 +1,37 @@
+export interface FilterCondition {
+    field: string;
+    operator: string;
+    value: unknown;
+}
+export interface SortDirective {
+    field: string;
+    direction: 'asc' | 'desc';
+}
+/**
+ * Parse query params into FilterCondition[].
+ *
+ * Supported formats:
+ *   ?filter[field]=value              → implicit $eq
+ *   ?filter[field][$gt]=value         → explicit operator
+ */
+export declare function parseFilters(query: Record<string, string>): FilterCondition[];
+/**
+ * Parse sort query param into SortDirective[].
+ *
+ *   ?sort=field       → ascending
+ *   ?sort=-field      → descending
+ *   ?sort=a,-b        → multiple
+ */
+export declare function parseSortDirectives(sortParam: string | undefined): SortDirective[];
+/**
+ * Apply all filter conditions to a data record.
+ * Returns true if the record passes ALL conditions (AND logic).
+ */
+export declare function applyFilters(conditions: FilterCondition[], data: Record<string, unknown>): boolean;
+/**
+ * Sort an array of items by their data fields according to sort directives.
+ */
+export declare function applySorting<T extends {
+    data: Record<string, unknown>;
+}>(items: T[], directives: SortDirective[]): T[];
+//# sourceMappingURL=advanced-query.d.ts.map

package/dist/content/advanced-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced-query.d.ts","sourceRoot":"","sources":["../../src/content/advanced-query.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC;CAC3B;AAcD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,eAAe,EAAE,CAiC7E;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,EAAE,CAUlF;AAwDD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,eAAe,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAElG;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,EACtE,KAAK,EAAE,CAAC,EAAE,EACV,UAAU,EAAE,aAAa,EAAE,GAC1B,CAAC,EAAE,CAqBL"}

package/dist/content/advanced-query.js

@@ -0,0 +1,162 @@
+// ─── Advanced CDA Filtering & Sorting ───────────────────────────────
+const SUPPORTED_OPERATORS = new Set([
+    '$eq',
+    '$ne',
+    '$gt',
+    '$gte',
+    '$lt',
+    '$lte',
+    '$contains',
+    '$startsWith',
+    '$in',
+]);
+/**
+ * Parse query params into FilterCondition[].
+ *
+ * Supported formats:
+ *   ?filter[field]=value              → implicit $eq
+ *   ?filter[field][$gt]=value         → explicit operator
+ */
+export function parseFilters(query) {
+    const conditions = [];
+    for (const [key, raw] of Object.entries(query)) {
+        // Match filter[field] or filter[field][$op]
+        const match = key.match(/^filter\[([^\]]+)\](?:\[(\$[^\]]+)\])?$/);
+        if (!match)
+            continue;
+        const field = match[1];
+        const operator = match[2] ?? '$eq';
+        if (!SUPPORTED_OPERATORS.has(operator))
+            continue;
+        let value = raw;
+        // Attempt to parse JSON-like values
+        if (raw === 'true')
+            value = true;
+        else if (raw === 'false')
+            value = false;
+        else if (raw === 'null')
+            value = null;
+        else if (/^-?\d+(\.\d+)?$/.test(raw))
+            value = Number(raw);
+        else if (operator === '$in') {
+            // $in expects comma-separated values
+            value = raw.split(',').map((v) => {
+                const trimmed = v.trim();
+                if (/^-?\d+(\.\d+)?$/.test(trimmed))
+                    return Number(trimmed);
+                return trimmed;
+            });
+        }
+        conditions.push({ field, operator, value });
+    }
+    return conditions;
+}
+/**
+ * Parse sort query param into SortDirective[].
+ *
+ *   ?sort=field       → ascending
+ *   ?sort=-field      → descending
+ *   ?sort=a,-b        → multiple
+ */
+export function parseSortDirectives(sortParam) {
+    if (!sortParam || sortParam.trim().length === 0)
+        return [];
+    return sortParam.split(',').map((s) => {
+        const trimmed = s.trim();
+        if (trimmed.startsWith('-')) {
+            return { field: trimmed.slice(1), direction: 'desc' };
+        }
+        return { field: trimmed, direction: 'asc' };
+    });
+}
+/**
+ * Evaluate a single filter condition against a data record.
+ */
+function evaluateCondition(data, condition) {
+    const { field, operator, value } = condition;
+    // Support nested field access via dot notation
+    const fieldValue = getNestedValue(data, field);
+    switch (operator) {
+        case '$eq':
+            return fieldValue === value;
+        case '$ne':
+            return fieldValue !== value;
+        case '$gt':
+            return typeof fieldValue === 'number' && typeof value === 'number'
+                ? fieldValue > value
+                : String(fieldValue) > String(value);
+        case '$gte':
+            return typeof fieldValue === 'number' && typeof value === 'number'
+                ? fieldValue >= value
+                : String(fieldValue) >= String(value);
+        case '$lt':
+            return typeof fieldValue === 'number' && typeof value === 'number'
+                ? fieldValue < value
+                : String(fieldValue) < String(value);
+        case '$lte':
+            return typeof fieldValue === 'number' && typeof value === 'number'
+                ? fieldValue <= value
+                : String(fieldValue) <= String(value);
+        case '$contains':
+            return typeof fieldValue === 'string' && typeof value === 'string'
+                ? fieldValue.includes(value)
+                : false;
+        case '$startsWith':
+            return typeof fieldValue === 'string' && typeof value === 'string'
+                ? fieldValue.startsWith(value)
+                : false;
+        case '$in':
+            return Array.isArray(value) ? value.includes(fieldValue) : false;
+        default:
+            return true;
+    }
+}
+/**
+ * Apply all filter conditions to a data record.
+ * Returns true if the record passes ALL conditions (AND logic).
+ */
+export function applyFilters(conditions, data) {
+    return conditions.every((cond) => evaluateCondition(data, cond));
+}
+/**
+ * Sort an array of items by their data fields according to sort directives.
+ */
+export function applySorting(items, directives) {
+    if (directives.length === 0)
+        return items;
+    return [...items].sort((a, b) => {
+        for (const { field, direction } of directives) {
+            const aVal = getNestedValue(a.data, field);
+            const bVal = getNestedValue(b.data, field);
+            let cmp = 0;
+            if (aVal == null && bVal == null)
+                cmp = 0;
+            else if (aVal == null)
+                cmp = -1;
+            else if (bVal == null)
+                cmp = 1;
+            else if (typeof aVal === 'number' && typeof bVal === 'number')
+                cmp = aVal - bVal;
+            else
+                cmp = String(aVal).localeCompare(String(bVal));
+            if (cmp !== 0) {
+                return direction === 'desc' ? -cmp : cmp;
+            }
+        }
+        return 0;
+    });
+}
+/**
+ * Get a nested value from an object using dot notation.
+ */
+function getNestedValue(obj, path) {
+    const parts = path.split('.');
+    let current = obj;
+    for (const part of parts) {
+        if (current == null || typeof current !== 'object')
+            return undefined;
+        current = current[part];
+    }
+    return current;
+}
+//# sourceMappingURL=advanced-query.js.map

package/dist/content/advanced-query.js.map

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

package/dist/content/cache.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Build a cache key following the format:
+ *   cda:${spaceId}:${contentTypeKey}:${slug || 'list'}:${queryHash}
+ */
+export declare function buildCacheKey(spaceId: string, contentTypeKey: string, slugOrList: string, queryHash: string): string;
+/**
+ * Get a cached response string from Redis.
+ */
+export declare function getCachedResponse(key: string): Promise<string | null>;
+/**
+ * Set a cached response string in Redis with a TTL.
+ */
+export declare function setCachedResponse(key: string, data: string, ttlSeconds: number): Promise<void>;
+/**
+ * Invalidate all cache keys that match a specific entry.
+ * Uses SCAN to avoid blocking Redis on large key spaces.
+ */
+export declare function invalidateByEntry(spaceId: string, entryId: string): Promise<void>;
+/**
+ * Invalidate all cache keys for a content type within a space.
+ */
+export declare function invalidateByType(spaceId: string, contentTypeKey: string): Promise<void>;
+/**
+ * Nuclear option: invalidate every CDA cache key for a space.
+ */
+export declare function invalidateBySpace(spaceId: string): Promise<void>;
+//# sourceMappingURL=cache.d.ts.map

package/dist/content/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/content/cache.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,MAAM,CAER;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAO3E;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASvF;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtE"}

package/dist/content/cache.js

@@ -0,0 +1,100 @@
+// ─── Redis CDA Response Cache ───────────────────────────────────────
+import { redis } from '../redis.js';
+const KEY_PREFIX = 'cda';
+/**
+ * Build a cache key following the format:
+ *   cda:${spaceId}:${contentTypeKey}:${slug || 'list'}:${queryHash}
+ */
+export function buildCacheKey(spaceId, contentTypeKey, slugOrList, queryHash) {
+    return `${KEY_PREFIX}:${spaceId}:${contentTypeKey}:${slugOrList}:${queryHash}`;
+}
+/**
+ * Get a cached response string from Redis.
+ */
+export async function getCachedResponse(key) {
+    try {
+        return await redis.get(key);
+    }
+    catch {
+        // Redis failure should never break the read path
+        return null;
+    }
+}
+/**
+ * Set a cached response string in Redis with a TTL.
+ */
+export async function setCachedResponse(key, data, ttlSeconds) {
+    try {
+        await redis.set(key, data, 'EX', ttlSeconds);
+    }
+    catch {
+        // Swallow — cache miss is acceptable
+    }
+}
+/**
+ * Invalidate all cache keys that match a specific entry.
+ * Uses SCAN to avoid blocking Redis on large key spaces.
+ */
+export async function invalidateByEntry(spaceId, entryId) {
+    // Entry-level keys are hard to track exactly, so we scan for the entry in
+    // pattern-matched keys. Since the entry ID isn't embedded in the cache key
+    // format, we invalidate the whole space's CDA cache to be safe.
+    // For entry-level precision, we would need a secondary index mapping
+    // entryId → cache keys. The space-level sweep is acceptable for now.
+    await invalidateByPattern(`${KEY_PREFIX}:${spaceId}:*`);
+    // Also clean up any per-entry cached single-item responses
+    void purgeKeysByTag(spaceId, entryId);
+}
+/**
+ * Invalidate all cache keys for a content type within a space.
+ */
+export async function invalidateByType(spaceId, contentTypeKey) {
+    await invalidateByPattern(`${KEY_PREFIX}:${spaceId}:${contentTypeKey}:*`);
+}
+/**
+ * Nuclear option: invalidate every CDA cache key for a space.
+ */
+export async function invalidateBySpace(spaceId) {
+    await invalidateByPattern(`${KEY_PREFIX}:${spaceId}:*`);
+}
+// ── Internal helpers ────────────────────────────────────────────────
+/**
+ * SCAN + DEL for keys matching a glob pattern.
+ * Uses SCAN to avoid blocking.
+ */
+async function invalidateByPattern(pattern) {
+    try {
+        let cursor = '0';
+        do {
+            const [nextCursor, keys] = await redis.scan(cursor, 'MATCH', pattern, 'COUNT', 200);
+            cursor = nextCursor;
+            if (keys.length > 0) {
+                await redis.del(...keys);
+            }
+        } while (cursor !== '0');
+    }
+    catch {
+        // Redis failure should not propagate to callers
+    }
+}
+/**
+ * Best-effort tag-based purge. We maintain a Redis set per entry that
+ * records which cache keys reference it. On invalidation we delete those
+ * keys and the set itself.
+ */
+async function purgeKeysByTag(spaceId, entryId) {
+    const tagKey = `cda-tag:${spaceId}:entry:${entryId}`;
+    try {
+        const keys = await redis.smembers(tagKey);
+        if (keys.length > 0) {
+            await redis.del(...keys, tagKey);
+        }
+        else {
+            await redis.del(tagKey);
+        }
+    }
+    catch {
+        // non-critical
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/content/cache.js.map

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

package/dist/content/diff.d.ts

@@ -0,0 +1,13 @@
+export interface DiffResult {
+    path: string;
+    type: 'added' | 'removed' | 'changed';
+    oldValue?: unknown;
+    newValue?: unknown;
+}
+/**
+ * Deep recursive diff of two JSON objects.
+ * Returns an array of DiffResult entries describing every difference
+ * between versionA and versionB.
+ */
+export declare function diffVersions(versionA: Record<string, unknown>, versionB: Record<string, unknown>): DiffResult[];
+//# sourceMappingURL=diff.d.ts.map

package/dist/content/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/content/diff.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,UAAU,EAAE,CAId"}

package/dist/content/diff.js

@@ -0,0 +1,80 @@
+// ─── Content Version Diff Engine ─────────────────────────────────────
+/**
+ * Deep recursive diff of two JSON objects.
+ * Returns an array of DiffResult entries describing every difference
+ * between versionA and versionB.
+ */
+export function diffVersions(versionA, versionB) {
+    const results = [];
+    diffRecursive(versionA, versionB, '', results);
+    return results;
+}
+function diffRecursive(a, b, path, results) {
+    // Identical values (strict equality covers primitives and same references)
+    if (a === b)
+        return;
+    // Both null/undefined — already covered by ===, but be explicit
+    if (a === null && b === null)
+        return;
+    if (a === undefined && b === undefined)
+        return;
+    // One is null/undefined and the other is not
+    if (a == null && b != null) {
+        results.push({ path: path || '(root)', type: 'added', newValue: b });
+        return;
+    }
+    if (a != null && b == null) {
+        results.push({ path: path || '(root)', type: 'removed', oldValue: a });
+        return;
+    }
+    const typeA = Array.isArray(a) ? 'array' : typeof a;
+    const typeB = Array.isArray(b) ? 'array' : typeof b;
+    // Different types — treat as changed
+    if (typeA !== typeB) {
+        results.push({ path: path || '(root)', type: 'changed', oldValue: a, newValue: b });
+        return;
+    }
+    // Both arrays
+    if (typeA === 'array') {
+        const arrA = a;
+        const arrB = b;
+        const maxLen = Math.max(arrA.length, arrB.length);
+        for (let i = 0; i < maxLen; i++) {
+            const itemPath = path ? `${path}[${i}]` : `[${i}]`;
+            if (i >= arrA.length) {
+                results.push({ path: itemPath, type: 'added', newValue: arrB[i] });
+            }
+            else if (i >= arrB.length) {
+                results.push({ path: itemPath, type: 'removed', oldValue: arrA[i] });
+            }
+            else {
+                diffRecursive(arrA[i], arrB[i], itemPath, results);
+            }
+        }
+        return;
+    }
+    // Both objects
+    if (typeA === 'object') {
+        const objA = a;
+        const objB = b;
+        const allKeys = new Set([...Object.keys(objA), ...Object.keys(objB)]);
+        for (const key of allKeys) {
+            const childPath = path ? `${path}.${key}` : key;
+            if (!(key in objA)) {
+                results.push({ path: childPath, type: 'added', newValue: objB[key] });
+            }
+            else if (!(key in objB)) {
+                results.push({ path: childPath, type: 'removed', oldValue: objA[key] });
+            }
+            else {
+                diffRecursive(objA[key], objB[key], childPath, results);
+            }
+        }
+        return;
+    }
+    // Primitives (string, number, boolean) — different values
+    if (a !== b) {
+        results.push({ path: path || '(root)', type: 'changed', oldValue: a, newValue: b });
+    }
+}
+//# sourceMappingURL=diff.js.map

package/dist/content/diff.js.map

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

package/dist/content/localization.d.ts

@@ -0,0 +1,13 @@
+import type { Field } from '@prisma/client';
+/**
+ * Resolve localized field values for a specific locale.
+ *
+ * For localized fields, entry data stores:
+ *   { "title": { "en": "Hello", "es": "Hola" }, "body": "Not localized" }
+ *
+ * This function extracts the value for the requested locale (with fallback
+ * to the default locale), and returns a flat object:
+ *   { "title": "Hello", "body": "Not localized" }
+ */
+export declare function resolveLocale(data: Record<string, unknown>, fields: Field[], locale: string, defaultLocale: string): Record<string, unknown>;
+//# sourceMappingURL=localization.d.ts.map

package/dist/content/localization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localization.d.ts","sourceRoot":"","sources":["../../src/content/localization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,KAAK,EAAE,EACf,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,GACpB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiCzB"}

package/dist/content/localization.js

@@ -0,0 +1,42 @@
+/**
+ * Resolve localized field values for a specific locale.
+ *
+ * For localized fields, entry data stores:
+ *   { "title": { "en": "Hello", "es": "Hola" }, "body": "Not localized" }
+ *
+ * This function extracts the value for the requested locale (with fallback
+ * to the default locale), and returns a flat object:
+ *   { "title": "Hello", "body": "Not localized" }
+ */
+export function resolveLocale(data, fields, locale, defaultLocale) {
+    const localizedKeys = new Set(fields.filter((f) => f.localized).map((f) => f.key));
+    const resolved = {};
+    for (const [key, value] of Object.entries(data)) {
+        if (!localizedKeys.has(key)) {
+            // Non-localized field — pass through as-is
+            resolved[key] = value;
+            continue;
+        }
+        // Localized field — value should be an object keyed by locale code
+        if (value !== null && typeof value === 'object' && !Array.isArray(value)) {
+            const localeMap = value;
+            if (locale in localeMap) {
+                resolved[key] = localeMap[locale];
+            }
+            else if (defaultLocale in localeMap) {
+                resolved[key] = localeMap[defaultLocale];
+            }
+            else {
+                // Return first available locale value as last-resort fallback
+                const keys = Object.keys(localeMap);
+                resolved[key] = keys.length > 0 ? localeMap[keys[0]] : null;
+            }
+        }
+        else {
+            // Data not in expected locale-map format — pass through as-is
+            resolved[key] = value;
+        }
+    }
+    return resolved;
+}
+//# sourceMappingURL=localization.js.map

package/dist/content/localization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localization.js","sourceRoot":"","sources":["../../src/content/localization.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAC3B,IAA6B,EAC7B,MAAe,EACf,MAAc,EACd,aAAqB;IAErB,MAAM,aAAa,GAAG,IAAI,GAAG,CAC3B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CACpD,CAAC;IAEF,MAAM,QAAQ,GAA4B,EAAE,CAAC;IAE7C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,2CAA2C;YAC3C,QAAQ,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACtB,SAAS;QACX,CAAC;QAED,mEAAmE;QACnE,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzE,MAAM,SAAS,GAAG,KAAgC,CAAC;YACnD,IAAI,MAAM,IAAI,SAAS,EAAE,CAAC;gBACxB,QAAQ,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;YACpC,CAAC;iBAAM,IAAI,aAAa,IAAI,SAAS,EAAE,CAAC;gBACtC,QAAQ,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,aAAa,CAAC,CAAC;YAC3C,CAAC;iBAAM,CAAC;gBACN,8DAA8D;gBAC9D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACpC,QAAQ,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC9D,CAAC;QACH,CAAC;aAAM,CAAC;YACN,8DAA8D;YAC9D,QAAQ,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACxB,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/content/materializer.d.ts

@@ -0,0 +1,26 @@
+import type { Field } from '@prisma/client';
+/**
+ * Materialize an entry into the `published_documents` read-model table.
+ * Called immediately after a successful publish transaction.
+ *
+ * Loads the entry with its published version and content type, resolves
+ * all reference/media fields by batch-loading referenced entries, then
+ * upserts into `published_documents` with the fully resolved JSON.
+ */
+export declare function materializeEntry(entryId: string): Promise<void>;
+/**
+ * Remove an entry from the published_documents table.
+ * Called after unpublishing an entry.
+ */
+export declare function dematerializeEntry(entryId: string): Promise<void>;
+/**
+ * Batch-resolve reference and media fields in the data object.
+ *
+ * 1. Scans the field definitions for reference/media types
+ * 2. Collects all referenced entry IDs and asset IDs from the data
+ * 3. Batch loads referenced entries (from published_documents) in ONE query
+ * 4. Batch loads referenced assets in ONE query
+ * 5. Replaces IDs with resolved objects and returns the enriched data
+ */
+export declare function batchResolveReferences(data: Record<string, unknown>, fields: Field[], spaceId: string): Promise<Record<string, unknown>>;
+//# sourceMappingURL=materializer.d.ts.map

package/dist/content/materializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"materializer.d.ts","sourceRoot":"","sources":["../../src/content/materializer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAU,MAAM,gBAAgB,CAAC;AAEpD;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA4CrE;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIvE;AAED;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,KAAK,EAAE,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA4GlC"}