@beechcms/core 0.4.0-preview.9 → 0.4.1

package/dist/observability/activity-logger.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Activity Logger contract.
+ *
+ * Records side-effect events ("a user did X to entity Y") for the audit trail
+ * displayed in the dashboard's settings activity tab and the recent activity
+ * feed. The interface is intentionally framework-agnostic so it can be
+ * fulfilled in production by a D1-backed implementation, in tests by an
+ * in-memory implementation, and in the future by remote sinks.
+ *
+ * @module @beechcms/core/observability/activity-logger
+ */
+export type ActivityAction = 'create' | 'update' | 'delete' | 'upload';
+export type EntityType = 'content' | 'media';
+/**
+ * Identifies the human (or machine) actor that triggered the event.
+ *
+ * The actor MUST be assembled by the caller (typically a Hono handler that has
+ * already authenticated the request). The logger never reaches into a
+ * framework-specific context to discover who is acting — this avoids hidden
+ * coupling and lets the same logger run inside CLI scripts and background
+ * jobs.
+ */
+export interface ActivityActor {
+    id: string;
+    email: string;
+    name?: string | null;
+}
+export interface ActivityLogEntry {
+    action: ActivityAction;
+    entityType: EntityType;
+    entityId: string;
+    entitySlug?: string;
+    details?: Record<string, unknown>;
+    actor: ActivityActor;
+}
+export interface IActivityLogger {
+    /**
+     * Persist a single activity entry.
+     *
+     * Implementations decide whether to fire-and-forget (Cloudflare
+     * `executionCtx.waitUntil`) or to wait inline (test environments).
+     * In either case the call MUST NOT throw to the caller: logging is
+     * observability, never a hard dependency of the request being served.
+     * Internal errors must be swallowed and logged via `console.error` so the
+     * mainline response path is never disturbed by audit-trail failures.
+     */
+    log(entry: ActivityLogEntry): Promise<void> | void;
+}
+//# sourceMappingURL=activity-logger.d.ts.map

package/dist/observability/activity-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-logger.d.ts","sourceRoot":"","sources":["../../src/observability/activity-logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAA;AACtE,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,OAAO,CAAA;AAE5C;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,cAAc,CAAA;IACtB,UAAU,EAAE,UAAU,CAAA;IACtB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,KAAK,EAAE,aAAa,CAAA;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B;;;;;;;;;OASG;IACH,GAAG,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;CACnD"}

package/dist/observability/activity-logger.js

@@ -0,0 +1,12 @@
+/**
+ * Activity Logger contract.
+ *
+ * Records side-effect events ("a user did X to entity Y") for the audit trail
+ * displayed in the dashboard's settings activity tab and the recent activity
+ * feed. The interface is intentionally framework-agnostic so it can be
+ * fulfilled in production by a D1-backed implementation, in tests by an
+ * in-memory implementation, and in the future by remote sinks.
+ *
+ * @module @beechcms/core/observability/activity-logger
+ */
+export {};

package/dist/observability/analytics.repository.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Metric tracked by the analytics table. Today only request counts and
+ * unique-visitor counts are recorded; new metric names should be appended
+ * to this union and to the implementation's switch statement.
+ */
+export type AnalyticsMetric = 'requests' | 'visitors';
+/**
+ * Read/write contract for the analytics counters that power the dashboard
+ * widgets (per-day request totals, sparklines, system health proxy).
+ *
+ * Implementations must use idempotent upserts so the recording middleware
+ * can be invoked once per request without producing duplicates when the
+ * same day/seed/metric tuple is touched repeatedly.
+ */
+export interface IAnalyticsRepository {
+    /**
+     * Upserts a request counter for the given seed at the current day bucket.
+     * The day bucket (Unix timestamp truncated to midnight UTC) is computed
+     * internally from the implementation's clock so callers never need to
+     * pass a timestamp. Implementations must use INSERT ... ON CONFLICT DO
+     * UPDATE to remain idempotent under concurrent calls within the same day.
+     */
+    recordRequest(seedSlug: string): Promise<void>;
+    /**
+     * Returns the total count for the given metric since sinceTimestamp.
+     * Used by the stats handler for total request counts and visitor counts.
+     * The aggregation sums the stored counter values, not row counts.
+     */
+    sumByMetric(metric: AnalyticsMetric, seedSlug: string, sinceTimestamp: number): Promise<number>;
+    /**
+     * Returns a map of date strings (YYYY-MM-DD) to request counts since
+     * sinceTimestamp, suitable for chart rendering without further
+     * transformation by the caller.
+     */
+    groupByMetric(seedSlug: string, sinceTimestamp: number): Promise<Record<string, number>>;
+}
+//# sourceMappingURL=analytics.repository.d.ts.map

package/dist/observability/analytics.repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.repository.d.ts","sourceRoot":"","sources":["../../src/observability/analytics.repository.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,UAAU,CAAA;AAErD;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;OAMG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE9C;;;;OAIG;IACH,WAAW,CACT,MAAM,EAAE,eAAe,EACvB,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,MAAM,CAAC,CAAA;IAElB;;;;OAIG;IACH,aAAa,CACX,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CACnC"}

package/dist/observability/analytics.repository.js

@@ -0,0 +1 @@
+export {};

package/dist/rate-limit/rate-limiter.d.ts

@@ -0,0 +1,13 @@
+export interface RateLimitResult {
+    isAllowed: boolean;
+    retryAfterSeconds?: number;
+}
+export interface IRateLimiter {
+    /**
+     * Checks whether the given key is within the rate limit.
+     * The key should combine the client IP address and an endpoint-specific prefix
+     * to prevent one endpoint's limit from being shared with another.
+     */
+    checkLimit(key: string): Promise<RateLimitResult>;
+}
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/rate-limit/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/rate-limit/rate-limiter.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,OAAO,CAAA;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;CAClD"}

package/dist/rate-limit/rate-limiter.js

@@ -0,0 +1 @@
+export {};

package/dist/search/search.repository.d.ts

@@ -0,0 +1,45 @@
+import type { Seed } from '../types.js';
+export interface SearchQueryOptions {
+    queryText: string;
+    schemaSlug: string | null;
+    statusFilter: string | null;
+    limit: number;
+    cursor: string | null;
+}
+export interface SearchResultRow {
+    entryId: string;
+    schemaSlug: string;
+    slug: string | null;
+    status: string;
+    title: string | null;
+    excerpt: string;
+    rank: number;
+}
+export interface SearchCountResult {
+    total: number;
+}
+/**
+ * Read-only contract for the global FTS5 search route.
+ *
+ * Implementations encapsulate the UNION ALL query that fans out across all
+ * `fts_<seed>` virtual tables. The route handler stays free of D1 and only
+ * shapes the final response.
+ */
+export interface ISearchRepository {
+    /**
+     * Executes a UNION ALL full-text search across all FTS-enabled seed tables.
+     * Returns at most options.limit + 1 rows so the caller can detect hasMore
+     * without a separate count query for the cursor case.
+     * Implementations must propagate the EMPTY_QUERY error thrown by
+     * buildFtsQuery so the route handler can return an empty result set rather
+     * than a 500.
+     */
+    search(options: SearchQueryOptions, seeds: Seed[]): Promise<SearchResultRow[]>;
+    /**
+     * Runs the count variant of the FTS query to support the `total` field in
+     * the search response. Called in parallel with search() by the route handler
+     * with the same filter inputs but without limit/cursor.
+     */
+    count(options: Omit<SearchQueryOptions, 'limit' | 'cursor'>, seeds: Seed[]): Promise<SearchCountResult>;
+}
+//# sourceMappingURL=search.repository.d.ts.map

package/dist/search/search.repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.repository.d.ts","sourceRoot":"","sources":["../../src/search/search.repository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAEvC,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;;OAOG;IACH,MAAM,CAAC,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAA;IAE9E;;;;OAIG;IACH,KAAK,CACH,OAAO,EAAE,IAAI,CAAC,kBAAkB,EAAE,OAAO,GAAG,QAAQ,CAAC,EACrD,KAAK,EAAE,IAAI,EAAE,GACZ,OAAO,CAAC,iBAAiB,CAAC,CAAA;CAC9B"}

package/dist/search/search.repository.js

@@ -0,0 +1 @@
+export {};

package/dist/seed-registry.d.ts

@@ -0,0 +1,49 @@
+import type { Seed } from './types.js';
+export interface ISeedRegistry {
+    /**
+     * Returns all seeds as a flat array, preserving insertion order.
+     * Decouples callers from the internal storage shape so the registry
+     * implementation can change without touching every route handler.
+     */
+    all(): Seed[];
+    /**
+     * Returns the seed with the given slug, or null if not found.
+     * Provides a single lookup point that can be overridden in tests
+     * without rebuilding the full registry object.
+     */
+    get(slug: string): Seed | null;
+    /**
+     * Returns seeds that are visible in the dashboard sidebar.
+     * A seed is visible when dashboard.hidden is not explicitly true.
+     * Eliminates the seeds.filter(s => !s.dashboard?.hidden) pattern
+     * that would otherwise be duplicated across route handlers.
+     */
+    visibleInDashboard(): Seed[];
+    /**
+     * Returns seeds that have allowPublicRead enabled.
+     * Eliminates the seeds.filter(s => s.allowPublicRead) pattern.
+     */
+    publicReadable(): Seed[];
+    /**
+     * Returns seeds that have the draft workflow enabled.
+     * Eliminates the seeds.filter(s => s.allowDrafts) pattern.
+     */
+    draftEnabled(): Seed[];
+}
+export declare class SeedRegistry implements ISeedRegistry {
+    private readonly seedMap;
+    private readonly orderedSeeds;
+    constructor(seeds: Seed[]);
+    all(): Seed[];
+    get(slug: string): Seed | null;
+    visibleInDashboard(): Seed[];
+    publicReadable(): Seed[];
+    draftEnabled(): Seed[];
+}
+/**
+ * Named subclass of SeedRegistry for use in test suites.
+ * Gives tests a semantic name without requiring any dependency on factory.ts.
+ */
+export declare class InMemorySeedRegistry extends SeedRegistry {
+}
+//# sourceMappingURL=seed-registry.d.ts.map

package/dist/seed-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed-registry.d.ts","sourceRoot":"","sources":["../src/seed-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAEtC,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,GAAG,IAAI,IAAI,EAAE,CAAA;IAEb;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAA;IAE9B;;;;;OAKG;IACH,kBAAkB,IAAI,IAAI,EAAE,CAAA;IAE5B;;;OAGG;IACH,cAAc,IAAI,IAAI,EAAE,CAAA;IAExB;;;OAGG;IACH,YAAY,IAAI,IAAI,EAAE,CAAA;CACvB;AAED,qBAAa,YAAa,YAAW,aAAa;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAC3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAQ;gBAEzB,KAAK,EAAE,IAAI,EAAE;IAKzB,GAAG,IAAI,IAAI,EAAE;IAIb,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAI9B,kBAAkB,IAAI,IAAI,EAAE;IAI5B,cAAc,IAAI,IAAI,EAAE;IAIxB,YAAY,IAAI,IAAI,EAAE;CAGvB;AAED;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,YAAY;CAAG"}

package/dist/seed-registry.js

@@ -0,0 +1,29 @@
+export class SeedRegistry {
+    seedMap;
+    orderedSeeds;
+    constructor(seeds) {
+        this.orderedSeeds = seeds;
+        this.seedMap = new Map(seeds.map(seed => [seed.slug, seed]));
+    }
+    all() {
+        return this.orderedSeeds;
+    }
+    get(slug) {
+        return this.seedMap.get(slug) ?? null;
+    }
+    visibleInDashboard() {
+        return this.orderedSeeds.filter(seed => seed.dashboard?.hidden !== true);
+    }
+    publicReadable() {
+        return this.orderedSeeds.filter(seed => seed.allowPublicRead === true);
+    }
+    draftEnabled() {
+        return this.orderedSeeds.filter(seed => seed.allowDrafts === true);
+    }
+}
+/**
+ * Named subclass of SeedRegistry for use in test suites.
+ * Gives tests a semantic name without requiring any dependency on factory.ts.
+ */
+export class InMemorySeedRegistry extends SeedRegistry {
+}

package/dist/storage.d.ts

@@ -0,0 +1,72 @@
+/**
+ * BeechBucket - S3-like interface for object storage in BeechCMS.
+ *
+ * This interface abstracts the underlying storage provider (R2, S3, or Local)
+ * allowing the application to scale without being tied to a specific vendor.
+ */
+export interface PutBucketOptions {
+    contentType?: string;
+    metadata?: Record<string, string>;
+}
+export interface GetBucketResult {
+    body: ReadableStream | ArrayBuffer;
+    contentType?: string;
+    size: number;
+    metadata?: Record<string, string>;
+}
+export interface BeechBucket {
+    /**
+     * Uploads an object to the bucket.
+     * @param key The unique key (path) for the object.
+     * @param body The data to store.
+     * @param options Optional metadata like content type.
+     */
+    put(key: string, body: ArrayBuffer | Uint8Array | ReadableStream, options?: PutBucketOptions): Promise<void>;
+    /**
+     * Retrieves an object from the bucket.
+     * @param key The unique key for the object.
+     * @returns The object data and metadata, or null if not found.
+     */
+    get(key: string): Promise<GetBucketResult | null>;
+    /**
+     * Deletes an object from the bucket.
+     * @param key The unique key for the object.
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Retrieves metadata for an object without downloading its content.
+     * @param key The unique key for the object.
+     */
+    head(key: string): Promise<{
+        size: number;
+        contentType?: string;
+        metadata?: Record<string, string>;
+    } | null>;
+    /**
+     * Returns a publicly accessible URL for the given key.
+     * The implementation decides if this is a direct vendor URL (CDN)
+     * or a proxied URL through the Beech API.
+     * @param key The unique key for the object.
+     */
+    getUrl(key: string): string;
+    /**
+     * Calculates the total size of all objects in the bucket.
+     * Warning: This may be an expensive operation on some providers.
+     */
+    getTotalSize(): Promise<number>;
+    /**
+     * Lists objects in the bucket.
+     */
+    list(options?: {
+        prefix?: string;
+        limit?: number;
+        cursor?: string;
+    }): Promise<{
+        objects: Array<{
+            key: string;
+            size: number;
+        }>;
+        cursor?: string;
+    }>;
+}
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,cAAc,GAAG,WAAW,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,UAAU,GAAG,cAAc,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7G;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAElD;;;OAGG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC;;;OAGG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IAE7G;;;;;OAKG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAE5B;;;OAGG;IACH,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAEhC;;OAEG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnJ"}

package/dist/storage.js

@@ -0,0 +1 @@
+export {};

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-export type BranchType = 'text' | 'number' | 'boolean' | 'json' | 'date' | 'richtext' | 'file';
+export type BranchType = 'text' | 'number' | 'boolean' | 'json' | 'date' | 'richtext' | 'file' | 'tags';
 /** Branch: definizione di una proprietà. alias = nome colonna SQL. */
 export interface Branch {
     /** Alias human-readable, usato nel payload API e come nome colonna SQL nella tabella dedicata */
@@ -96,8 +96,8 @@ export interface Seed {
     /** Optional dashboard-specific UI config. Ignored by the Botanical Engine. */
     dashboard?: DashboardSeedConfig;
 }
-export type FilterOperator = 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'contains' | 'is_empty' | 'is_not_empty';
-export type FilterType = 'text' | 'number' | 'date' | 'boolean' | 'tags' | 'select' | 'system';
+export type FilterOperator = 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte' | 'contains' | 'not_contains' | 'starts_with' | 'ends_with' | 'is_empty' | 'is_not_empty' | 'in' | 'not_in' | 'has_tag' | 'has_any_tag' | 'has_all_tags';
+export type FilterType = 'text' | 'number' | 'date' | 'boolean' | 'tags' | 'select' | 'system' | 'json';
 export interface FilterCondition {
     op: FilterOperator;
     value: string | number | boolean | null;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,CAAA;AAE9F,sEAAsE;AACtE,MAAM,WAAW,MAAM;IACrB,iGAAiG;IACjG,KAAK,EAAE,MAAM,CAAA;IACb,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,sBAAsB;IACtB,IAAI,EAAE,UAAU,CAAA;IAChB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,YAAY,CAAA;IAC3E;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,+EAA+E;IAC/E,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,mCAAmC;IACnC,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B;;;OAGG;IACH,QAAQ,CAAC,EAAE;QACT,yDAAyD;QACzD,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAA;QACtC,0EAA0E;QAC1E,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAA;QACzC,yEAAyE;QACzE,MAAM,CAAC,EAAE,OAAO,CAAA;QAChB,mFAAmF;QACnF,MAAM,CAAC,EAAE,OAAO,CAAA;QAChB,wFAAwF;QACxF,IAAI,CAAC,EAAE,OAAO,CAAA;QACd,wEAAwE;QACxE,MAAM,CAAC,EAAE,OAAO,CAAA;KACjB,CAAA;CACF;AAED,6GAA6G;AAC7G,MAAM,WAAW,mBAAmB;IAClC,sFAAsF;IACtF,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mDAAmD;IACnD,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,gEAAgE;IAChE,QAAQ,CAAC,EAAE;QACT,MAAM,CAAC,EAAE,OAAO,CAAA;QAChB,MAAM,CAAC,EAAE,OAAO,CAAA;QAChB,MAAM,CAAC,EAAE,OAAO,CAAA;QAChB,UAAU,CAAC,EAAE,OAAO,CAAA;KACrB,CAAA;CACF;AAED,6DAA6D;AAC7D,MAAM,WAAW,IAAI;IACnB,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAA;IACZ,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,oFAAoF;IACpF,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,2FAA2F;IAC3F,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,8FAA8F;IAC9F,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB;;;OAGG;IACH,gBAAgB,EAAE,MAAM,CAAA;IACxB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,mBAAmB,CAAA;CAChC;AAID,MAAM,MAAM,cAAc,GACtB,IAAI,GACJ,IAAI,GACJ,KAAK,GACL,IAAI,GACJ,KAAK,GACL,UAAU,GACV,UAAU,GACV,cAAc,CAAA;AAElB,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAE9F,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,cAAc,CAAA;IAClB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAA;CACxC;AAED,MAAM,WAAW,WAAW;IAC1B,wFAAwF;IACxF,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,UAAU,CAAA;IAChB,UAAU,EAAE,eAAe,EAAE,CAAA;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,WAAW,EAAE,CAAA;IACvB,OAAO,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,KAAK,GAAG,MAAM,CAAA;KAAE,CAAA;IACjD,UAAU,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;IAC9C,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,EAAE,CAAA;CAC/C"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/validation.d.ts

@@ -21,18 +21,18 @@ export interface ValidateSeedPayloadResult {
     hasAnyValidField: boolean;
 }
 /**
- * Foundation comune per validazione e sanitizzazione payload schema-driven.
- * Usata da Public API e riusabile nel Botanical Engine.
+ * Common foundation for schema-driven validation and sanitization of payloads.
+ * Used by the Public API and reusable in the Botanical Engine.
  *
- * Ordine di esecuzione obbligatorio al momento della scrittura:
+ * Mandatory execution order at the time of writing:
  *   validate raw → hash (privacy policy) → store
- * L'hashing avviene DOPO la validazione, non prima.
- * Questo garantisce che il valore validato sia il valore raw originale,
- * non il digest — evitando false failure su campi con formato (es. email).
+ * Hashing occurs AFTER validation, not before.
+ * This ensures that the validated value is the original raw value,
+ * not the digest — avoiding false failures on fields with formats (e.g., email).
  */
 export declare function validateAndSanitizeSeedPayload(seed: Seed, payload: Record<string, unknown>, options?: ValidateSeedPayloadOptions): ValidateSeedPayloadResult;
 /**
- * Valida status content supportati dal CMS.
+ * Validates content status supported by the CMS.
  */
 export declare function isValidContentStatus(value: unknown): value is 'draft' | 'review' | 'published';
 /**

package/dist/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAU,IAAI,EAAE,MAAM,YAAY,CAAA;AAG9C,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAA;IAC/B,2BAA2B,CAAC,EAAE,OAAO,CAAA;IACrC,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,OAAO,EAAE,gBAAgB,EAAE,CAAA;IAC3B,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,qBAAqB,EAAE,MAAM,EAAE,CAAA;IAC/B,gBAAgB,EAAE,OAAO,CAAA;CAC1B;AAufD;;;;;;;;;GASG;AACH,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,GAAE,0BAA+B,GACvC,yBAAyB,CA6G3B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,GAAG,QAAQ,GAAG,WAAW,CAE9F;AAED;;;;;GAKG"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAU,IAAI,EAAE,MAAM,YAAY,CAAA;AAG9C,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAA;IAC/B,2BAA2B,CAAC,EAAE,OAAO,CAAA;IACrC,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,OAAO,EAAE,gBAAgB,EAAE,CAAA;IAC3B,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,qBAAqB,EAAE,MAAM,EAAE,CAAA;IAC/B,gBAAgB,EAAE,OAAO,CAAA;CAC1B;AA6fD;;;;;;;;;GASG;AACH,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,GAAE,0BAA+B,GACvC,yBAAyB,CA6G3B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,GAAG,QAAQ,GAAG,WAAW,CAE9F;AAED;;;;;GAKG"}

package/dist/validation.js

@@ -278,7 +278,8 @@ function buildBranchSchema(branch, options) {
                 .refine((value) => isIsoDateString(value), { message: 'Expected date(ISO)' });
             return nullable ? z.union([schema, nullable]) : schema;
         }
-        case 'json': {
+        case 'json':
+        case 'tags': {
             const schema = jsonObjectOrArraySchema;
             return nullable ? z.union([schema, nullable]) : schema;
         }
@@ -316,6 +317,8 @@ function buildBranchSchema(branch, options) {
                 .pipe(z.url());
             return nullable ? z.union([schema, nullable]) : schema;
         }
+        default:
+            throw new Error(`Unhandled branch type: ${branch.type}`);
     }
 }
 const compiledSchemaCache = new Map();
@@ -422,7 +425,8 @@ function validateBranchValue(branch, alias, rawValue, options) {
             }
             return { ok: true, value };
         }
-        case 'json': {
+        case 'json':
+        case 'tags': {
             const isValidJsonLike = (typeof rawValue === 'object' && rawValue !== null) || Array.isArray(rawValue);
             if (!isValidJsonLike || typeof rawValue === 'string') {
                 return { ok: false, detail: makeDetail(alias, 'object|array', rawValue) };
@@ -443,17 +447,19 @@ function validateBranchValue(branch, alias, rawValue, options) {
             }
             return { ok: true, value: singleUrl };
         }
+        default:
+            throw new Error(`Unhandled branch type: ${branch.type}`);
     }
 }
 /**
- * Foundation comune per validazione e sanitizzazione payload schema-driven.
- * Usata da Public API e riusabile nel Botanical Engine.
+ * Common foundation for schema-driven validation and sanitization of payloads.
+ * Used by the Public API and reusable in the Botanical Engine.
  *
- * Ordine di esecuzione obbligatorio al momento della scrittura:
+ * Mandatory execution order at the time of writing:
  *   validate raw → hash (privacy policy) → store
- * L'hashing avviene DOPO la validazione, non prima.
- * Questo garantisce che il valore validato sia il valore raw originale,
- * non il digest — evitando false failure su campi con formato (es. email).
+ * Hashing occurs AFTER validation, not before.
+ * This ensures that the validated value is the original raw value,
+ * not the digest — avoiding false failures on fields with formats (e.g., email).
  */
 export function validateAndSanitizeSeedPayload(seed, payload, options = {}) {
     const normalizedOptions = {
@@ -558,7 +564,7 @@ export function validateAndSanitizeSeedPayload(seed, payload, options = {}) {
     };
 }
 /**
- * Valida status content supportati dal CMS.
+ * Validates content status supported by the CMS.
  */
 export function isValidContentStatus(value) {
     return statusSchema.safeParse(value).success;

package/dist/widget/widget.repository.d.ts

@@ -0,0 +1,113 @@
+import type { Seed } from '../types.js';
+/**
+ * Discriminated union describing the aggregate to compute over a content table.
+ *
+ * The widget routes accept this shape from the dashboard. Implementations are
+ * responsible for translating each variant into a safe SQL expression and must
+ * never interpolate the column or value fields without prior validation.
+ */
+export type AggregateFormula = {
+    op: 'count';
+} | {
+    op: 'sum';
+    column: string;
+} | {
+    op: 'avg';
+    column: string;
+} | {
+    op: 'min';
+    column: string;
+} | {
+    op: 'max';
+    column: string;
+} | {
+    op: 'countWhere';
+    column: string;
+    value: unknown;
+} | {
+    op: 'percentageOf';
+    numeratorColumn: string;
+    denominatorColumn: string;
+};
+/**
+ * Time range applied as a WHERE filter for widget queries.
+ *
+ * "all" means no temporal restriction. The other values bracket the most recent
+ * 7 days, 1 month, and 1 year respectively, anchored on `created_at`.
+ */
+export type TimeWindow = 'week' | 'month' | 'year' | 'all';
+export interface LeaderboardEntry {
+    id: string;
+    label: string;
+    score: number | string;
+}
+export interface LeaderboardOptions {
+    scoreColumn: string;
+    limit: number;
+    orderDirection: 'ASC' | 'DESC';
+}
+export interface TimeseriesPoint {
+    label: string;
+    value: number;
+}
+export interface WidgetListFilter {
+    column: string;
+    op: string;
+    value: unknown;
+}
+export interface WidgetListOptions {
+    limit: number;
+    offset: number;
+    search?: string;
+    filters?: WidgetListFilter[];
+    orderByColumn?: string;
+    orderDirection?: 'ASC' | 'DESC';
+}
+export interface WidgetListResult {
+    entries: Array<Record<string, unknown>>;
+    totalCount: number;
+}
+export interface GrowthResult {
+    currentValue: number;
+    previousValue: number;
+}
+/**
+ * Read-only data access contract for widget routes.
+ *
+ * Implementations must validate every column alias derived from user input
+ * against the seed before composing SQL, and must bind every user-supplied
+ * value via parameterised statements. SQL keywords (ORDER direction, aggregate
+ * function names) must be selected via hardcoded branches, never interpolated.
+ */
+export interface IWidgetRepository {
+    /**
+     * Returns the formula result for the given time window. Always returns a
+     * number; implementations must return 0 when the query produces no rows.
+     */
+    aggregate(seed: Seed, formula: AggregateFormula, window: TimeWindow): Promise<number>;
+    /**
+     * Evaluates the formula twice — once for the current window period and once
+     * for the equivalent previous period — to support trend calculations.
+     * Implementations must return { currentValue: 0, previousValue: 0 } on
+     * empty results.
+     */
+    growth(seed: Seed, formula: AggregateFormula, window: TimeWindow): Promise<GrowthResult>;
+    /**
+     * Returns entries sorted by scoreColumn, excluding nulls. label resolves
+     * from seed.displayNameAlias; falls back to id when not set.
+     */
+    leaderboard(seed: Seed, options: LeaderboardOptions): Promise<LeaderboardEntry[]>;
+    /**
+     * Paginated read of content entries. Filters and search are applied
+     * server-side. The caller is responsible for deserialising branch values
+     * from the raw Record.
+     */
+    list(seed: Seed, options: WidgetListOptions): Promise<WidgetListResult>;
+    /**
+     * Groups entries by a date bucket derived from groupColumn and aggregates
+     * the formula. Days with no entries are omitted (no zero-fill). Points are
+     * ordered ascending by label.
+     */
+    timeseries(seed: Seed, formula: AggregateFormula, window: TimeWindow, groupColumn: string): Promise<TimeseriesPoint[]>;
+}
+//# sourceMappingURL=widget.repository.d.ts.map

package/dist/widget/widget.repository.d.ts.map

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

package/dist/widget/widget.repository.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beechcms/core",
-  "version": "0.4.0-preview.9",
+  "version": "0.4.1",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -18,18 +18,24 @@
     "build": "tsc",
     "dev": "tsc -w --preserveWatchOutput",
     "lint": "eslint .",
-    "type-check": "tsc --noEmit"
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^3.2.4",
+    "vitest": "^3.2.4"
   },
   "dependencies": {
     "@tiptap/core": "^3.22.3",
     "@tiptap/extension-highlight": "^3.22.3",
     "@tiptap/extension-image": "^3.22.3",
     "@tiptap/extension-link": "^3.22.3",
+    "@tiptap/extension-mathematics": "^3.22.3",
     "@tiptap/extension-subscript": "^3.22.3",
     "@tiptap/extension-superscript": "^3.22.3",
     "@tiptap/extension-table": "^3.22.3",
     "@tiptap/extension-text-align": "^3.22.3",
-    "@tiptap/extension-mathematics": "^3.22.3",
     "@tiptap/html": "^3.22.3",
     "@tiptap/starter-kit": "^3.22.3",
     "katex": "^0.16.11",