@htmless/core 0.1.0

package/dist/blocks/seed-core-blocks.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Upserts all 7 core block definitions into a space.
+ * Marks them builtIn=true so they cannot be accidentally deleted via the API.
+ */
+export declare function seedCoreBlocks(spaceId: string): Promise<void>;
+//# sourceMappingURL=seed-core-blocks.d.ts.map

package/dist/blocks/seed-core-blocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed-core-blocks.d.ts","sourceRoot":"","sources":["../../src/blocks/seed-core-blocks.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA6BnE"}

package/dist/blocks/seed-core-blocks.js

@@ -0,0 +1,37 @@
+import { prisma } from '../db.js';
+import { coreBlocks } from './core-blocks.js';
+/**
+ * Upserts all 7 core block definitions into a space.
+ * Marks them builtIn=true so they cannot be accidentally deleted via the API.
+ */
+export async function seedCoreBlocks(spaceId) {
+    for (const block of coreBlocks) {
+        await prisma.blockDefinition.upsert({
+            where: {
+                spaceId_key_version: {
+                    spaceId,
+                    key: block.key,
+                    version: '1.0.0',
+                },
+            },
+            update: {
+                title: block.title,
+                description: block.description,
+                icon: block.icon,
+                attributesSchema: JSON.parse(JSON.stringify(block.attributesSchema)),
+                builtIn: true,
+            },
+            create: {
+                spaceId,
+                key: block.key,
+                version: '1.0.0',
+                title: block.title,
+                description: block.description,
+                icon: block.icon,
+                attributesSchema: JSON.parse(JSON.stringify(block.attributesSchema)),
+                builtIn: true,
+            },
+        });
+    }
+}
+//# sourceMappingURL=seed-core-blocks.js.map

package/dist/blocks/seed-core-blocks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed-core-blocks.js","sourceRoot":"","sources":["../../src/blocks/seed-core-blocks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAe;IAClD,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;QAC/B,MAAM,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC;YAClC,KAAK,EAAE;gBACL,mBAAmB,EAAE;oBACnB,OAAO;oBACP,GAAG,EAAE,KAAK,CAAC,GAAG;oBACd,OAAO,EAAE,OAAO;iBACjB;aACF;YACD,MAAM,EAAE;gBACN,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,gBAAgB,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;gBACpE,OAAO,EAAE,IAAI;aACd;YACD,MAAM,EAAE;gBACN,OAAO;gBACP,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,OAAO,EAAE,OAAO;gBAChB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,gBAAgB,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;gBACpE,OAAO,EAAE,IAAI;aACd;SACF,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/blocks/validator.d.ts

@@ -0,0 +1,10 @@
+export interface BlockValidationError {
+    path: string;
+    message: string;
+}
+/**
+ * Validates a block tree against registered block definitions for a space.
+ * Returns an array of errors (empty = valid).
+ */
+export declare function validateBlockTree(blocks: unknown[], spaceId: string): Promise<BlockValidationError[]>;
+//# sourceMappingURL=validator.d.ts.map

package/dist/blocks/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/blocks/validator.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,OAAO,EAAE,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAkBjC"}

package/dist/blocks/validator.js

@@ -0,0 +1,111 @@
+import { prisma } from '../db.js';
+/**
+ * Validates a block tree against registered block definitions for a space.
+ * Returns an array of errors (empty = valid).
+ */
+export async function validateBlockTree(blocks, spaceId) {
+    // Load all block definitions for this space (keyed by latest version)
+    const definitions = await prisma.blockDefinition.findMany({
+        where: { spaceId },
+        orderBy: { version: 'desc' },
+    });
+    // Build a map of key -> latest definition
+    const defMap = new Map();
+    for (const def of definitions) {
+        if (!defMap.has(def.key)) {
+            defMap.set(def.key, def);
+        }
+    }
+    const errors = [];
+    validateNodes(blocks, defMap, errors, 'blocks');
+    return errors;
+}
+function validateNodes(nodes, defMap, errors, basePath) {
+    for (let i = 0; i < nodes.length; i++) {
+        const node = nodes[i];
+        const path = `${basePath}[${i}]`;
+        if (!node || typeof node !== 'object') {
+            errors.push({ path, message: 'Block must be an object' });
+            continue;
+        }
+        if (!node.typeKey || typeof node.typeKey !== 'string') {
+            errors.push({ path, message: 'Block must have a string "typeKey"' });
+            continue;
+        }
+        if (!node.attrs || typeof node.attrs !== 'object') {
+            errors.push({ path, message: 'Block must have an "attrs" object' });
+            continue;
+        }
+        const def = defMap.get(node.typeKey);
+        if (!def) {
+            errors.push({ path, message: `Unknown block type "${node.typeKey}"` });
+            continue;
+        }
+        // Validate attrs against attributesSchema
+        const schema = def.attributesSchema;
+        if (schema) {
+            validateAttrs(node.attrs, schema, errors, `${path}.attrs`);
+        }
+        // Recurse into children if present
+        if (node.children !== undefined) {
+            if (!Array.isArray(node.children)) {
+                errors.push({ path: `${path}.children`, message: 'Block children must be an array' });
+            }
+            else {
+                validateNodes(node.children, defMap, errors, `${path}.children`);
+            }
+        }
+    }
+}
+function validateAttrs(attrs, schema, errors, basePath) {
+    // Check required
+    if (schema.required) {
+        for (const key of schema.required) {
+            if (attrs[key] === undefined || attrs[key] === null) {
+                errors.push({ path: `${basePath}.${key}`, message: `"${key}" is required` });
+            }
+        }
+    }
+    // Check properties
+    if (schema.properties) {
+        for (const [key, propSchema] of Object.entries(schema.properties)) {
+            const value = attrs[key];
+            if (value === undefined || value === null)
+                continue;
+            validateValue(value, propSchema, errors, `${basePath}.${key}`);
+        }
+    }
+}
+function validateValue(value, schema, errors, path) {
+    // Type check
+    if (schema.type) {
+        const actualType = Array.isArray(value) ? 'array' : typeof value;
+        const expectedType = schema.type === 'integer' ? 'number' : schema.type;
+        if (actualType !== expectedType) {
+            errors.push({ path, message: `Expected ${schema.type}, got ${actualType}` });
+            return;
+        }
+        if (schema.type === 'integer' && !Number.isInteger(value)) {
+            errors.push({ path, message: 'Expected an integer' });
+            return;
+        }
+    }
+    // Enum check
+    if (schema.enum && !schema.enum.includes(value)) {
+        errors.push({ path, message: `Must be one of: ${schema.enum.join(', ')}` });
+    }
+    // Range checks
+    if (schema.minimum !== undefined && typeof value === 'number' && value < schema.minimum) {
+        errors.push({ path, message: `Must be >= ${schema.minimum}` });
+    }
+    if (schema.maximum !== undefined && typeof value === 'number' && value > schema.maximum) {
+        errors.push({ path, message: `Must be <= ${schema.maximum}` });
+    }
+    // Array items check
+    if (schema.type === 'array' && Array.isArray(value) && schema.items) {
+        for (let i = 0; i < value.length; i++) {
+            validateValue(value[i], schema.items, errors, `${path}[${i}]`);
+        }
+    }
+}
+//# sourceMappingURL=validator.js.map

package/dist/blocks/validator.js.map

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

package/dist/cache/cdn-purge.d.ts

@@ -0,0 +1,41 @@
+export interface CDNProvider {
+    /** Purge edge cache by Surrogate-Key / cache tags. */
+    purgeByTags(tags: string[]): Promise<void>;
+    /** Purge edge cache by exact URLs. */
+    purgeByUrl(urls: string[]): Promise<void>;
+    /** Nuclear: purge the entire edge cache. */
+    purgeAll(): Promise<void>;
+}
+export declare class FastlyCDNProvider implements CDNProvider {
+    private readonly apiToken;
+    private readonly serviceId;
+    constructor();
+    purgeByTags(tags: string[]): Promise<void>;
+    purgeByUrl(urls: string[]): Promise<void>;
+    purgeAll(): Promise<void>;
+}
+export declare class CloudflareCDNProvider implements CDNProvider {
+    private readonly apiToken;
+    private readonly zoneId;
+    constructor();
+    purgeByTags(tags: string[]): Promise<void>;
+    purgeByUrl(urls: string[]): Promise<void>;
+    purgeAll(): Promise<void>;
+}
+export declare class NullCDNProvider implements CDNProvider {
+    purgeByTags(_tags: string[]): Promise<void>;
+    purgeByUrl(_urls: string[]): Promise<void>;
+    purgeAll(): Promise<void>;
+}
+/**
+ * Get the configured CDN provider based on the CDN_PROVIDER env var.
+ * Defaults to NullCDNProvider when no CDN is configured.
+ *
+ * Supported values: 'fastly', 'cloudflare'
+ */
+export declare function getCDNProvider(): CDNProvider;
+/**
+ * Reset the cached provider (useful for testing or config reload).
+ */
+export declare function resetCDNProvider(): void;
+//# sourceMappingURL=cdn-purge.d.ts.map

package/dist/cache/cdn-purge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdn-purge.d.ts","sourceRoot":"","sources":["../../src/cache/cdn-purge.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,sCAAsC;IACtC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,4CAA4C;IAC5C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAID,qBAAa,iBAAkB,YAAW,WAAW;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;;IAgB7B,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB1C,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBzC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAahC;AAID,qBAAa,qBAAsB,YAAW,WAAW;IACvD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;;IAgB1B,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB1C,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BzC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAchC;AAID,qBAAa,eAAgB,YAAW,WAAW;IAC3C,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAGhC;AAMD;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAkB5C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}

package/dist/cache/cdn-purge.js

@@ -0,0 +1,180 @@
+// ─── CDN Purge Integration ──────────────────────────────────────────
+// Provider-based CDN cache purge. Supports Fastly, Cloudflare, or a
+// null provider (default when no CDN is configured).
+// ─── Fastly CDN Provider ────────────────────────────────────────────
+export class FastlyCDNProvider {
+    apiToken;
+    serviceId;
+    constructor() {
+        const apiToken = process.env.FASTLY_API_TOKEN;
+        const serviceId = process.env.FASTLY_SERVICE_ID;
+        if (!apiToken || !serviceId) {
+            throw new Error('FastlyCDNProvider requires FASTLY_API_TOKEN and FASTLY_SERVICE_ID environment variables');
+        }
+        this.apiToken = apiToken;
+        this.serviceId = serviceId;
+    }
+    async purgeByTags(tags) {
+        if (tags.length === 0)
+            return;
+        // Fastly supports purging by Surrogate-Key header (space-separated tags)
+        // POST /service/{service_id}/purge
+        try {
+            await fetch(`https://api.fastly.com/service/${this.serviceId}/purge`, {
+                method: 'POST',
+                headers: {
+                    'Fastly-Key': this.apiToken,
+                    'Surrogate-Key': tags.join(' '),
+                    'Accept': 'application/json',
+                },
+            });
+        }
+        catch (err) {
+            console.error('[CDN:Fastly] purgeByTags failed:', err);
+        }
+    }
+    async purgeByUrl(urls) {
+        if (urls.length === 0)
+            return;
+        // Fastly purges individual URLs via PURGE method
+        try {
+            await Promise.all(urls.map((url) => fetch(url, {
+                method: 'PURGE',
+                headers: {
+                    'Fastly-Key': this.apiToken,
+                },
+            })));
+        }
+        catch (err) {
+            console.error('[CDN:Fastly] purgeByUrl failed:', err);
+        }
+    }
+    async purgeAll() {
+        try {
+            await fetch(`https://api.fastly.com/service/${this.serviceId}/purge_all`, {
+                method: 'POST',
+                headers: {
+                    'Fastly-Key': this.apiToken,
+                    'Accept': 'application/json',
+                },
+            });
+        }
+        catch (err) {
+            console.error('[CDN:Fastly] purgeAll failed:', err);
+        }
+    }
+}
+// ─── Cloudflare CDN Provider ────────────────────────────────────────
+export class CloudflareCDNProvider {
+    apiToken;
+    zoneId;
+    constructor() {
+        const apiToken = process.env.CF_API_TOKEN;
+        const zoneId = process.env.CF_ZONE_ID;
+        if (!apiToken || !zoneId) {
+            throw new Error('CloudflareCDNProvider requires CF_API_TOKEN and CF_ZONE_ID environment variables');
+        }
+        this.apiToken = apiToken;
+        this.zoneId = zoneId;
+    }
+    async purgeByTags(tags) {
+        if (tags.length === 0)
+            return;
+        // Cloudflare Enterprise supports Cache-Tag purge
+        // POST /zones/{zone_id}/purge_cache
+        try {
+            await fetch(`https://api.cloudflare.com/client/v4/zones/${this.zoneId}/purge_cache`, {
+                method: 'POST',
+                headers: {
+                    'Authorization': `Bearer ${this.apiToken}`,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({ tags }),
+            });
+        }
+        catch (err) {
+            console.error('[CDN:Cloudflare] purgeByTags failed:', err);
+        }
+    }
+    async purgeByUrl(urls) {
+        if (urls.length === 0)
+            return;
+        try {
+            // Cloudflare supports up to 30 URLs per request
+            const chunks = [];
+            for (let i = 0; i < urls.length; i += 30) {
+                chunks.push(urls.slice(i, i + 30));
+            }
+            await Promise.all(chunks.map((chunk) => fetch(`https://api.cloudflare.com/client/v4/zones/${this.zoneId}/purge_cache`, {
+                method: 'POST',
+                headers: {
+                    'Authorization': `Bearer ${this.apiToken}`,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({ files: chunk }),
+            })));
+        }
+        catch (err) {
+            console.error('[CDN:Cloudflare] purgeByUrl failed:', err);
+        }
+    }
+    async purgeAll() {
+        try {
+            await fetch(`https://api.cloudflare.com/client/v4/zones/${this.zoneId}/purge_cache`, {
+                method: 'POST',
+                headers: {
+                    'Authorization': `Bearer ${this.apiToken}`,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({ purge_everything: true }),
+            });
+        }
+        catch (err) {
+            console.error('[CDN:Cloudflare] purgeAll failed:', err);
+        }
+    }
+}
+// ─── Null CDN Provider ──────────────────────────────────────────────
+export class NullCDNProvider {
+    async purgeByTags(_tags) {
+        // No CDN configured — nothing to purge
+    }
+    async purgeByUrl(_urls) {
+        // No CDN configured — nothing to purge
+    }
+    async purgeAll() {
+        // No CDN configured — nothing to purge
+    }
+}
+// ─── Factory ────────────────────────────────────────────────────────
+let _provider;
+/**
+ * Get the configured CDN provider based on the CDN_PROVIDER env var.
+ * Defaults to NullCDNProvider when no CDN is configured.
+ *
+ * Supported values: 'fastly', 'cloudflare'
+ */
+export function getCDNProvider() {
+    if (_provider)
+        return _provider;
+    const providerName = (process.env.CDN_PROVIDER ?? '').toLowerCase();
+    switch (providerName) {
+        case 'fastly':
+            _provider = new FastlyCDNProvider();
+            break;
+        case 'cloudflare':
+            _provider = new CloudflareCDNProvider();
+            break;
+        default:
+            _provider = new NullCDNProvider();
+            break;
+    }
+    return _provider;
+}
+/**
+ * Reset the cached provider (useful for testing or config reload).
+ */
+export function resetCDNProvider() {
+    _provider = undefined;
+}
+//# sourceMappingURL=cdn-purge.js.map

package/dist/cache/cdn-purge.js.map

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

package/dist/cache/observability.d.ts

@@ -0,0 +1,36 @@
+export interface CacheStats {
+    hits: number;
+    misses: number;
+    evictions: number;
+    size: number;
+    hitRate: number;
+}
+export interface CacheTagInfo {
+    tag: string;
+    keyCount: number;
+}
+/**
+ * Record a cache hit. Call this from the CDA response flow
+ * when a Redis cache lookup succeeds.
+ */
+export declare function trackCacheHit(): Promise<void>;
+/**
+ * Record a cache miss. Call this from the CDA response flow
+ * when a Redis cache lookup returns null.
+ */
+export declare function trackCacheMiss(): Promise<void>;
+/**
+ * Retrieve aggregated cache statistics from Redis INFO and custom counters.
+ */
+export declare function getCacheStats(): Promise<CacheStats>;
+/**
+ * List cache keys matching a glob pattern using SCAN (non-blocking).
+ * Limits results to 1000 keys to prevent unbounded responses.
+ */
+export declare function getCacheKeys(pattern: string): Promise<string[]>;
+/**
+ * List all Surrogate-Key / cache tags for a space with key counts.
+ * Tags are stored in Redis sets with the pattern `cache-tag:{tag}`.
+ */
+export declare function getCacheTags(spaceId: string): Promise<CacheTagInfo[]>;
+//# sourceMappingURL=observability.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../../src/cache/observability.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AASD;;;GAGG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAMnD;AAED;;;GAGG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAMpD;AAID;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC,CA8BzD;AAID;;;GAGG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAiBrE;AAID;;;GAGG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAiB3E"}

package/dist/cache/observability.js

@@ -0,0 +1,110 @@
+// ─── Cache Observability & Metrics ──────────────────────────────────
+// Provides cache hit/miss statistics, key listing, and tag inspection
+// by reading from Redis INFO + custom counters.
+import { redis } from '../redis.js';
+// ─── Counter Keys ───────────────────────────────────────────────────
+const COUNTER_HITS = 'cache-stats:hits';
+const COUNTER_MISSES = 'cache-stats:misses';
+// ─── Tracking ───────────────────────────────────────────────────────
+/**
+ * Record a cache hit. Call this from the CDA response flow
+ * when a Redis cache lookup succeeds.
+ */
+export async function trackCacheHit() {
+    try {
+        await redis.incr(COUNTER_HITS);
+    }
+    catch {
+        // Non-critical — swallow Redis errors
+    }
+}
+/**
+ * Record a cache miss. Call this from the CDA response flow
+ * when a Redis cache lookup returns null.
+ */
+export async function trackCacheMiss() {
+    try {
+        await redis.incr(COUNTER_MISSES);
+    }
+    catch {
+        // Non-critical — swallow Redis errors
+    }
+}
+// ─── Stats ──────────────────────────────────────────────────────────
+/**
+ * Retrieve aggregated cache statistics from Redis INFO and custom counters.
+ */
+export async function getCacheStats() {
+    try {
+        const [hitsStr, missesStr, infoRaw] = await Promise.all([
+            redis.get(COUNTER_HITS),
+            redis.get(COUNTER_MISSES),
+            redis.info('stats'),
+        ]);
+        const hits = parseInt(hitsStr ?? '0', 10);
+        const misses = parseInt(missesStr ?? '0', 10);
+        const total = hits + misses;
+        const hitRate = total > 0 ? hits / total : 0;
+        // Parse evictions from Redis INFO stats section
+        const evictedMatch = infoRaw.match(/evicted_keys:(\d+)/);
+        const evictions = evictedMatch ? parseInt(evictedMatch[1], 10) : 0;
+        // Parse dbsize for total key count
+        const dbSize = await redis.dbsize();
+        return {
+            hits,
+            misses,
+            evictions,
+            size: dbSize,
+            hitRate: Math.round(hitRate * 10000) / 10000, // 4 decimal places
+        };
+    }
+    catch {
+        return { hits: 0, misses: 0, evictions: 0, size: 0, hitRate: 0 };
+    }
+}
+// ─── Key Inspection ─────────────────────────────────────────────────
+/**
+ * List cache keys matching a glob pattern using SCAN (non-blocking).
+ * Limits results to 1000 keys to prevent unbounded responses.
+ */
+export async function getCacheKeys(pattern) {
+    const keys = [];
+    const MAX_KEYS = 1000;
+    try {
+        let cursor = '0';
+        do {
+            const [nextCursor, batch] = await redis.scan(cursor, 'MATCH', pattern, 'COUNT', 200);
+            cursor = nextCursor;
+            keys.push(...batch);
+            if (keys.length >= MAX_KEYS)
+                break;
+        } while (cursor !== '0');
+    }
+    catch {
+        // Swallow — return whatever we collected
+    }
+    return keys.slice(0, MAX_KEYS);
+}
+// ─── Tag Inspection ─────────────────────────────────────────────────
+/**
+ * List all Surrogate-Key / cache tags for a space with key counts.
+ * Tags are stored in Redis sets with the pattern `cache-tag:{tag}`.
+ */
+export async function getCacheTags(spaceId) {
+    const tagKeys = await getCacheKeys(`cache-tag:${spaceId}:*`);
+    const tags = [];
+    for (const tagKey of tagKeys) {
+        try {
+            const keyCount = await redis.scard(tagKey);
+            // Extract the tag name from the Redis key: "cache-tag:spaceId:tagName" -> "tagName"
+            const parts = tagKey.split(':');
+            const tag = parts.slice(2).join(':');
+            tags.push({ tag, keyCount });
+        }
+        catch {
+            // Skip broken tags
+        }
+    }
+    return tags.sort((a, b) => b.keyCount - a.keyCount);
+}
+//# sourceMappingURL=observability.js.map

package/dist/cache/observability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.js","sourceRoot":"","sources":["../../src/cache/observability.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,sEAAsE;AACtE,gDAAgD;AAEhD,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAiBpC,uEAAuE;AAEvE,MAAM,YAAY,GAAG,kBAAkB,CAAC;AACxC,MAAM,cAAc,GAAG,oBAAoB,CAAC;AAE5C,uEAAuE;AAEvE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,sCAAsC;IACxC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,sCAAsC;IACxC,CAAC;AACH,CAAC;AAED,uEAAuE;AAEvE;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,IAAI,CAAC;QACH,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACtD,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC;YACvB,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC;SACpB,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;QAC9C,MAAM,KAAK,GAAG,IAAI,GAAG,MAAM,CAAC;QAC5B,MAAM,OAAO,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAE7C,gDAAgD;QAChD,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACzD,MAAM,SAAS,GAAG,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAEnE,mCAAmC;QACnC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,EAAE,CAAC;QAEpC,OAAO;YACL,IAAI;YACJ,MAAM;YACN,SAAS;YACT,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,GAAG,KAAK,EAAE,mBAAmB;SAClE,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IACnE,CAAC;AACH,CAAC;AAED,uEAAuE;AAEvE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAe;IAChD,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC;IAEtB,IAAI,CAAC;QACH,IAAI,MAAM,GAAG,GAAG,CAAC;QACjB,GAAG,CAAC;YACF,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;YACrF,MAAM,GAAG,UAAU,CAAC;YACpB,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;YACpB,IAAI,IAAI,CAAC,MAAM,IAAI,QAAQ;gBAAE,MAAM;QACrC,CAAC,QAAQ,MAAM,KAAK,GAAG,EAAE;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,yCAAyC;IAC3C,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;AACjC,CAAC;AAED,uEAAuE;AAEvE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAe;IAChD,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,aAAa,OAAO,IAAI,CAAC,CAAC;IAC7D,MAAM,IAAI,GAAmB,EAAE,CAAC;IAEhC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC3C,oFAAoF;YACpF,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAChC,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACrC,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,mBAAmB;QACrB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;AACtD,CAAC"}

package/dist/cache/tags.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Associate a cache key with one or more tags.
+ * Tags are stored as Redis sets: `cache-tag:{tag}` -> set of cache keys.
+ * Each association is given the same TTL as the cache key itself (or 1 hour
+ * as a fallback) so that stale tag associations self-clean.
+ */
+export declare function addCacheTag(key: string, tags: string[]): Promise<void>;
+/**
+ * Delete all cache keys associated with a tag, then remove the tag set itself.
+ * Returns the number of cache keys that were deleted.
+ */
+export declare function invalidateByTag(tag: string): Promise<number>;
+/**
+ * Invalidate multiple tags at once. Returns total number of cache keys deleted.
+ */
+export declare function invalidateByTags(tags: string[]): Promise<number>;
+/**
+ * Purge both Redis cache and CDN edge caches for the given tags.
+ * Calls invalidateByTag for each tag, then delegates to the configured
+ * CDN provider to purge edge caches.
+ */
+export declare function purgeCDN(tags: string[]): Promise<void>;
+/**
+ * Build standard Surrogate-Key tags for a CDA response.
+ * Used by the CDA content endpoints to register tags after caching.
+ */
+export declare function buildSurrogateKeyTags(spaceId: string, contentTypeKey: string, entryId?: string): string[];
+//# sourceMappingURL=tags.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../../src/cache/tags.ts"],"names":[],"mappings":"AAWA;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB5E;AAID;;;GAGG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAqBlE;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAMtE;AAID;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAO5D;AAID;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,EAAE,CAWV"}