@kywi-software/core 0.1.0

package/dist/experiments/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/experiments/schema.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2B1B,CAAA;AAIF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWjC,CAAA;AAOF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWpC,CAAA;AAKF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWpC,CAAA;AAIF,MAAM,MAAM,aAAa,GAAG,OAAO,eAAe,CAAC,YAAY,CAAA;AAC/D,MAAM,MAAM,gBAAgB,GAAG,OAAO,eAAe,CAAC,YAAY,CAAA;AAClE,MAAM,MAAM,oBAAoB,GAAG,OAAO,sBAAsB,CAAC,YAAY,CAAA;AAC7E,MAAM,MAAM,uBAAuB,GAAG,OAAO,sBAAsB,CAAC,YAAY,CAAA;AAChF,MAAM,MAAM,uBAAuB,GAAG,OAAO,yBAAyB,CAAC,YAAY,CAAA;AACnF,MAAM,MAAM,uBAAuB,GAAG,OAAO,yBAAyB,CAAC,YAAY,CAAA"}

package/dist/experiments/schema.js

@@ -0,0 +1,75 @@
+import { pgTable, uuid, text, integer, boolean, timestamp, jsonb, index, uniqueIndex, } from 'drizzle-orm/pg-core';
+import { kywiSites } from '../schema/base.js';
+// ── Experiments ──────────────────────────────────────────────────────────────
+export const kywiExperiments = pgTable('kywi_experiments', {
+    id: uuid('id').primaryKey().defaultRandom(),
+    siteId: uuid('site_id').notNull().references(() => kywiSites.id),
+    name: text('name').notNull(),
+    hypothesis: text('hypothesis'),
+    status: text('status', {
+        enum: ['draft', 'running', 'paused', 'completed'],
+    }).notNull().default('draft'),
+    goalType: text('goal_type', {
+        enum: ['pageview', 'form_submit', 'custom'],
+    }).notNull().default('custom'),
+    goalConfig: jsonb('goal_config').notNull(),
+    targetType: text('target_type', {
+        enum: ['page', 'container'],
+    }).notNull().default('page'),
+    contentId: uuid('content_id'),
+    containerId: text('container_id'),
+    winnerVariantId: uuid('winner_variant_id'),
+    startedAt: timestamp('started_at', { withTimezone: true }),
+    pausedAt: timestamp('paused_at', { withTimezone: true }),
+    completedAt: timestamp('completed_at', { withTimezone: true }),
+    createdBy: uuid('created_by'),
+    createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
+    updatedAt: timestamp('updated_at', { withTimezone: true }).notNull().defaultNow(),
+}, (t) => [
+    index('kywi_experiments_site_idx').on(t.siteId),
+    index('kywi_experiments_status_idx').on(t.status),
+]);
+// ── Experiment Variants ──────────────────────────────────────────────────────
+export const kywiExperimentVariants = pgTable('kywi_experiment_variants', {
+    id: uuid('id').primaryKey().defaultRandom(),
+    experimentId: uuid('experiment_id').notNull().references(() => kywiExperiments.id, { onDelete: 'cascade' }),
+    name: text('name').notNull(),
+    trafficSplit: integer('traffic_split').notNull(),
+    isControl: boolean('is_control').notNull().default(false),
+    variantKey: text('variant_key'),
+    sortOrder: integer('sort_order').notNull().default(0),
+    createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
+}, (t) => [
+    index('kywi_experiment_variants_experiment_idx').on(t.experimentId),
+]);
+// ── Assignments ──────────────────────────────────────────────────────────────
+// One row per (experiment, visitor). Sticky by construction — the row records
+// the deterministic bucketing result so results de-dupe on unique visitors.
+// `exposedAt` is set when the variant is actually rendered/seen.
+export const kywiExperimentAssignments = pgTable('kywi_experiment_assignments', {
+    id: uuid('id').primaryKey().defaultRandom(),
+    experimentId: uuid('experiment_id').notNull().references(() => kywiExperiments.id, { onDelete: 'cascade' }),
+    variantId: uuid('variant_id').notNull(),
+    siteId: uuid('site_id').notNull(),
+    visitorId: text('visitor_id').notNull(),
+    assignedAt: timestamp('assigned_at', { withTimezone: true }).notNull().defaultNow(),
+    exposedAt: timestamp('exposed_at', { withTimezone: true }),
+}, (t) => [
+    uniqueIndex('kywi_experiment_assignments_exp_visitor_uniq').on(t.experimentId, t.visitorId),
+    index('kywi_experiment_assignments_exp_variant_idx').on(t.experimentId, t.variantId),
+]);
+// ── Conversions ──────────────────────────────────────────────────────────────
+// Append-only conversion event log. Results count DISTINCT visitors per variant.
+export const kywiExperimentConversions = pgTable('kywi_experiment_conversions', {
+    id: uuid('id').primaryKey().defaultRandom(),
+    experimentId: uuid('experiment_id').notNull().references(() => kywiExperiments.id, { onDelete: 'cascade' }),
+    variantId: uuid('variant_id').notNull(),
+    siteId: uuid('site_id').notNull(),
+    visitorId: text('visitor_id').notNull(),
+    goalType: text('goal_type').notNull(),
+    metadata: jsonb('metadata'),
+    occurredAt: timestamp('occurred_at', { withTimezone: true }).notNull().defaultNow(),
+}, (t) => [
+    index('kywi_experiment_conversions_exp_variant_idx').on(t.experimentId, t.variantId),
+]);
+//# sourceMappingURL=schema.js.map

package/dist/experiments/schema.js.map

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

package/dist/experiments/types.d.ts

@@ -0,0 +1,96 @@
+export type ExperimentStatus = 'draft' | 'running' | 'paused' | 'completed';
+/** How a conversion is recognised for this experiment. */
+export type ExperimentGoalType = 'pageview' | 'form_submit' | 'custom';
+/** Whether the experiment swaps a whole page layout or a single container. */
+export type ExperimentTargetType = 'page' | 'container';
+export interface ExperimentGoalConfig {
+    /** pageview goal: visiting this path (glob-free prefix/exact) counts as a conversion. */
+    url?: string;
+    /** form_submit goal: submitting the form with this id counts as a conversion. */
+    formId?: string;
+    /** custom goal: a `kywi.track(eventName)` call counts as a conversion. */
+    eventName?: string;
+}
+export interface ExperimentVariant {
+    id: string;
+    experimentId: string;
+    name: string;
+    /** Integer percentage 0–100. All variants of an experiment must sum to 100. */
+    trafficSplit: number;
+    /** The baseline arm. Uplift/significance are measured relative to it. */
+    isControl: boolean;
+    /** Optional key linking this arm to a layout variant / pageVariant slot. */
+    variantKey: string | null;
+    sortOrder: number;
+}
+export interface Experiment {
+    id: string;
+    siteId: string;
+    name: string;
+    hypothesis: string | null;
+    status: ExperimentStatus;
+    goalType: ExperimentGoalType;
+    goalConfig: ExperimentGoalConfig;
+    targetType: ExperimentTargetType;
+    /** Content node hosting the experiment (page-level or container host). */
+    contentId: string | null;
+    /** variantContainer node id within the layout (container-level experiments). */
+    containerId: string | null;
+    /** Declared winner variant id; set when the experiment is completed. */
+    winnerVariantId: string | null;
+    startedAt: Date | null;
+    pausedAt: Date | null;
+    completedAt: Date | null;
+    createdBy: string | null;
+    createdAt: Date;
+    updatedAt: Date;
+    variants: ExperimentVariant[];
+}
+/**
+ * A deliberately simple significance signal — NOT a full stats suite.
+ *   not_enough_data — below the minimum sample threshold on either arm
+ *   not_significant — enough data, but the two-proportion z-test is < 95%
+ *   significant     — the arm beats control at ≥ 95% confidence
+ */
+export type SignificanceLabel = 'not_enough_data' | 'not_significant' | 'significant';
+export interface VariantResult {
+    variantId: string;
+    name: string;
+    isControl: boolean;
+    trafficSplit: number;
+    exposures: number;
+    conversions: number;
+    /** conversions / exposures, in the range 0–1 (0 when no exposures). */
+    conversionRate: number;
+    /** Relative lift vs the control arm's rate (fraction); null for control / n/a. */
+    uplift: number | null;
+    significance: SignificanceLabel;
+    /** True for the declared or leading arm (see ExperimentResults). */
+    isWinner: boolean;
+}
+export interface ExperimentResults {
+    experimentId: string;
+    status: ExperimentStatus;
+    totalExposures: number;
+    totalConversions: number;
+    variants: VariantResult[];
+    /** Declared winner (from the experiment record), if completed. */
+    winnerVariantId: string | null;
+    /** Best-performing arm by conversion rate (computed), if any exposures. */
+    leadingVariantId: string | null;
+}
+export interface AssignmentResult {
+    experimentId: string;
+    variantId: string;
+    variantKey: string | null;
+    /** True when the assignment came from a locked winner rather than bucketing. */
+    fromWinner: boolean;
+}
+/** A conversion signal reported by the client, resolved server-side against goals. */
+export interface ConversionSignal {
+    type: ExperimentGoalType;
+    url?: string;
+    formId?: string;
+    eventName?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/experiments/types.d.ts.map

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

package/dist/experiments/types.js

@@ -0,0 +1,8 @@
+// A/B Experiments — shared domain types.
+//
+// Experiments sit on top of the layout variant machinery: an experiment drives
+// which variant of a `variantContainer` (or page-level variant) renders for a
+// given visitor. Assignment is deterministic per visitor (hash bucketing), so
+// results stay stable across requests without any per-visitor storage lookup.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/experiments/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/experiments/types.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,+EAA+E;AAC/E,8EAA8E;AAC9E,8EAA8E;AAC9E,8EAA8E"}

package/dist/feeds/__tests__/aggregate.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=aggregate.test.d.ts.map

package/dist/feeds/__tests__/aggregate.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate.test.d.ts","sourceRoot":"","sources":["../../../src/feeds/__tests__/aggregate.test.ts"],"names":[],"mappings":""}

package/dist/feeds/__tests__/aggregate.test.js

@@ -0,0 +1,83 @@
+import { describe, it, expect } from 'vitest';
+import { aggregateFeedResults } from '../aggregate.js';
+function makeFeed(items) {
+    return { items, total: items.length, page: 1, pageSize: items.length, totalPages: 1 };
+}
+describe('aggregateFeedResults', () => {
+    it('returns zero count and empty groupings for an empty feed', () => {
+        const result = aggregateFeedResults(makeFeed([]));
+        expect(result.count).toBe(0);
+        expect(result.byStatus).toEqual({});
+        expect(result.byContentType).toEqual({});
+        expect(result.dateRange).toEqual({ earliest: null, latest: null });
+    });
+    it('counts total items correctly', () => {
+        const items = [
+            { status: 'published', contentTypeName: 'article', publishedAt: '2024-01-01' },
+            { status: 'draft', contentTypeName: 'article', publishedAt: '2024-02-01' },
+            { status: 'published', contentTypeName: 'page', publishedAt: '2024-03-01' },
+        ];
+        const result = aggregateFeedResults(makeFeed(items));
+        expect(result.count).toBe(3);
+    });
+    it('groups items by status', () => {
+        const items = [
+            { status: 'published', contentTypeName: 'article' },
+            { status: 'published', contentTypeName: 'article' },
+            { status: 'draft', contentTypeName: 'article' },
+        ];
+        const result = aggregateFeedResults(makeFeed(items));
+        expect(result.byStatus).toEqual({ published: 2, draft: 1 });
+    });
+    it('groups items by content type', () => {
+        const items = [
+            { status: 'published', contentTypeName: 'article' },
+            { status: 'published', contentTypeName: 'page' },
+            { status: 'draft', contentTypeName: 'article' },
+        ];
+        const result = aggregateFeedResults(makeFeed(items));
+        expect(result.byContentType).toEqual({ article: 2, page: 1 });
+    });
+    it('uses "unknown" for missing status or contentTypeName', () => {
+        const items = [{ publishedAt: '2024-01-01' }];
+        const result = aggregateFeedResults(makeFeed(items));
+        expect(result.byStatus['unknown']).toBe(1);
+        expect(result.byContentType['unknown']).toBe(1);
+    });
+    it('finds the earliest and latest dates using publishedAt', () => {
+        const items = [
+            { status: 'published', contentTypeName: 'article', publishedAt: '2024-06-15' },
+            { status: 'published', contentTypeName: 'article', publishedAt: '2024-01-01' },
+            { status: 'published', contentTypeName: 'article', publishedAt: '2024-12-31' },
+        ];
+        const result = aggregateFeedResults(makeFeed(items));
+        expect(result.dateRange.earliest).toBe('2024-01-01');
+        expect(result.dateRange.latest).toBe('2024-12-31');
+    });
+    it('falls back to createdAt when publishedAt is absent', () => {
+        const items = [
+            { status: 'draft', contentTypeName: 'article', createdAt: '2024-03-10' },
+            { status: 'draft', contentTypeName: 'article', createdAt: '2024-01-05' },
+        ];
+        const result = aggregateFeedResults(makeFeed(items));
+        expect(result.dateRange.earliest).toBe('2024-01-05');
+        expect(result.dateRange.latest).toBe('2024-03-10');
+    });
+    it('handles a single item correctly', () => {
+        const items = [{ status: 'published', contentTypeName: 'video', publishedAt: '2024-07-04' }];
+        const result = aggregateFeedResults(makeFeed(items));
+        expect(result.count).toBe(1);
+        expect(result.dateRange.earliest).toBe('2024-07-04');
+        expect(result.dateRange.latest).toBe('2024-07-04');
+    });
+    it('excludes items with no date from dateRange', () => {
+        const items = [
+            { status: 'published', contentTypeName: 'article' },
+            { status: 'published', contentTypeName: 'article', publishedAt: '2024-05-01' },
+        ];
+        const result = aggregateFeedResults(makeFeed(items));
+        expect(result.dateRange.earliest).toBe('2024-05-01');
+        expect(result.dateRange.latest).toBe('2024-05-01');
+    });
+});
+//# sourceMappingURL=aggregate.test.js.map

package/dist/feeds/__tests__/aggregate.test.js.map

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

package/dist/feeds/__tests__/compound-filters.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=compound-filters.test.d.ts.map

package/dist/feeds/__tests__/compound-filters.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compound-filters.test.d.ts","sourceRoot":"","sources":["../../../src/feeds/__tests__/compound-filters.test.ts"],"names":[],"mappings":""}

package/dist/feeds/__tests__/compound-filters.test.js

@@ -0,0 +1,204 @@
+import { describe, it, expect } from 'vitest';
+import { buildFeedFilters } from '../engine.js';
+const _visited = new WeakSet();
+/**
+ * Extract all column names from a nested Drizzle condition tree.
+ * Handles both leaf eq/ne/like conditions and compound and/or wrappers.
+ */
+function extractTokens(condition, depth = 0) {
+    if (depth > 20)
+        return [];
+    if (!condition || typeof condition !== 'object')
+        return [];
+    if (_visited.has(condition))
+        return [];
+    _visited.add(condition);
+    const result = [];
+    const obj = condition;
+    const chunks = obj['queryChunks'];
+    if (Array.isArray(chunks)) {
+        for (const chunk of chunks) {
+            if (!chunk || typeof chunk !== 'object')
+                continue;
+            const c = chunk;
+            // Column reference — has a `name` string property
+            if (typeof c['name'] === 'string') {
+                result.push(c['name']);
+            }
+            // StringChunk — skip, we only care about column names
+            // Sub-condition (nested and/or) — has its own queryChunks
+            if ('queryChunks' in c) {
+                result.push(...extractTokens(c, depth + 1));
+            }
+        }
+    }
+    return result;
+}
+function extractAllTokens(conditions) {
+    return conditions.flatMap(c => extractTokens(c));
+}
+describe('filterGroups — compound OR', () => {
+    it('adds an OR group condition when operator is "or"', () => {
+        const orGroup = {
+            operator: 'or',
+            conditions: [
+                { field: 'status', operator: 'eq', value: 'published' },
+                { field: 'status', operator: 'eq', value: 'draft' },
+            ],
+        };
+        const query = { contentType: 'blogPost', filterGroups: [orGroup] };
+        const baseCount = buildFeedFilters({ contentType: 'blogPost' }).length;
+        const withGroup = buildFeedFilters(query);
+        // Should have one extra condition (the OR wrapper)
+        expect(withGroup.length).toBe(baseCount + 1);
+    });
+    it('tokens from OR group conditions appear in the result', () => {
+        const orGroup = {
+            operator: 'or',
+            conditions: [
+                { field: 'status', operator: 'eq', value: 'published' },
+                { field: 'status', operator: 'eq', value: 'draft' },
+            ],
+        };
+        const query = { contentType: 'blogPost', filterGroups: [orGroup] };
+        const conditions = buildFeedFilters(query);
+        const tokens = extractAllTokens(conditions);
+        expect(tokens).toContain('status');
+    });
+});
+describe('filterGroups — compound AND', () => {
+    it('adds an AND group condition when operator is "and"', () => {
+        const andGroup = {
+            operator: 'and',
+            conditions: [
+                { field: 'status', operator: 'eq', value: 'published' },
+                { field: 'locale', operator: 'eq', value: 'en' },
+            ],
+        };
+        const query = { contentType: 'blogPost', filterGroups: [andGroup] };
+        const baseCount = buildFeedFilters({ contentType: 'blogPost' }).length;
+        const withGroup = buildFeedFilters(query);
+        expect(withGroup.length).toBe(baseCount + 1);
+    });
+    it('tokens from AND group conditions appear in the result', () => {
+        const andGroup = {
+            operator: 'and',
+            conditions: [
+                { field: 'status', operator: 'eq', value: 'published' },
+                { field: 'locale', operator: 'eq', value: 'en' },
+            ],
+        };
+        const query = { contentType: 'blogPost', filterGroups: [andGroup] };
+        const conditions = buildFeedFilters(query);
+        const tokens = extractAllTokens(conditions);
+        expect(tokens).toContain('status');
+        expect(tokens).toContain('locale');
+    });
+});
+describe('filterGroups — mixed with flat filters', () => {
+    it('applies both flat filters and a filter group', () => {
+        const orGroup = {
+            operator: 'or',
+            conditions: [
+                { field: 'status', operator: 'eq', value: 'published' },
+                { field: 'status', operator: 'eq', value: 'approved' },
+            ],
+        };
+        const query = {
+            contentType: 'blogPost',
+            filters: [{ field: 'locale', operator: 'eq', value: 'en' }],
+            filterGroups: [orGroup],
+        };
+        const baseCount = buildFeedFilters({ contentType: 'blogPost' }).length;
+        // +1 for locale flat filter, +1 for OR group
+        const withBoth = buildFeedFilters(query);
+        expect(withBoth.length).toBe(baseCount + 2);
+    });
+    it('tokens from both flat filters and group conditions are present', () => {
+        const orGroup = {
+            operator: 'or',
+            conditions: [
+                { field: 'status', operator: 'eq', value: 'published' },
+                { field: 'status', operator: 'eq', value: 'approved' },
+            ],
+        };
+        const query = {
+            contentType: 'blogPost',
+            filters: [{ field: 'locale', operator: 'eq', value: 'en' }],
+            filterGroups: [orGroup],
+        };
+        const conditions = buildFeedFilters(query);
+        const tokens = extractAllTokens(conditions);
+        expect(tokens).toContain('locale');
+        expect(tokens).toContain('status');
+    });
+});
+describe('filterGroups — multiple groups', () => {
+    it('adds one condition per group', () => {
+        const groups = [
+            {
+                operator: 'or',
+                conditions: [
+                    { field: 'status', operator: 'eq', value: 'published' },
+                    { field: 'status', operator: 'eq', value: 'draft' },
+                ],
+            },
+            {
+                operator: 'and',
+                conditions: [
+                    { field: 'locale', operator: 'eq', value: 'en' },
+                ],
+            },
+        ];
+        const query = { contentType: 'blogPost', filterGroups: groups };
+        const baseCount = buildFeedFilters({ contentType: 'blogPost' }).length;
+        const withGroups = buildFeedFilters(query);
+        expect(withGroups.length).toBe(baseCount + 2);
+    });
+});
+describe('filterGroups — empty or invalid groups', () => {
+    it('skips groups with no valid conditions', () => {
+        const emptyGroup = {
+            operator: 'or',
+            conditions: [{ field: 'nonExistentField', operator: 'eq', value: 'x' }],
+        };
+        const baseCount = buildFeedFilters({ contentType: 'blogPost' }).length;
+        const withEmpty = buildFeedFilters({ contentType: 'blogPost', filterGroups: [emptyGroup] });
+        // No extra condition because group had no resolvable columns
+        expect(withEmpty.length).toBe(baseCount);
+    });
+    it('handles undefined filterGroups gracefully', () => {
+        const query = { contentType: 'blogPost' };
+        const base = buildFeedFilters({ contentType: 'blogPost' });
+        const result = buildFeedFilters(query);
+        expect(result.length).toBe(base.length);
+    });
+});
+describe('FeedDisplayConfig on FeedQuery', () => {
+    it('accepts a display config on FeedQuery without affecting filter count', () => {
+        const query = {
+            contentType: 'blogPost',
+            display: {
+                layout: 'grid',
+                showImage: true,
+                showSummary: true,
+                showDate: true,
+                showAuthor: false,
+                columnsDesktop: 3,
+                columnsMobile: 1,
+            },
+        };
+        const base = buildFeedFilters({ contentType: 'blogPost' });
+        const result = buildFeedFilters(query);
+        expect(result.length).toBe(base.length);
+    });
+    it('display config fields are typed correctly', () => {
+        const query = {
+            contentType: 'blogPost',
+            display: { layout: 'carousel', showImage: false, showSummary: false, showDate: false, showAuthor: true },
+        };
+        expect(query.display?.layout).toBe('carousel');
+        expect(query.display?.showImage).toBe(false);
+    });
+});
+//# sourceMappingURL=compound-filters.test.js.map

package/dist/feeds/__tests__/compound-filters.test.js.map

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

package/dist/feeds/__tests__/display-window-feed.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=display-window-feed.test.d.ts.map

package/dist/feeds/__tests__/display-window-feed.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-window-feed.test.d.ts","sourceRoot":"","sources":["../../../src/feeds/__tests__/display-window-feed.test.ts"],"names":[],"mappings":""}

package/dist/feeds/__tests__/display-window-feed.test.js

@@ -0,0 +1,27 @@
+import { describe, it, expect } from 'vitest';
+import { buildFeedFilters } from '../engine.js';
+describe('feed engine — display window filtering', () => {
+    it('includes display window conditions in the feed filter output', () => {
+        const baseQuery = { contentType: 'blogPost' };
+        const conditions = buildFeedFilters(baseQuery);
+        // Before display window: contentTypeName + deletedAt = 2 conditions
+        // After display window: contentTypeName + deletedAt + displayStart + displayStop = 4 conditions
+        expect(conditions.length).toBeGreaterThanOrEqual(4);
+    });
+    it('display window conditions are present regardless of other filters', () => {
+        const withStatus = { contentType: 'blogPost', status: 'published' };
+        const withoutStatus = { contentType: 'blogPost' };
+        const conditionsWithStatus = buildFeedFilters(withStatus);
+        const conditionsWithout = buildFeedFilters(withoutStatus);
+        // The status filter adds 1 extra condition
+        expect(conditionsWithStatus.length).toBe(conditionsWithout.length + 1);
+    });
+    it('display window conditions are present when locale filter is added', () => {
+        const query = { contentType: 'blogPost', locale: 'en' };
+        const base = { contentType: 'blogPost' };
+        const withLocale = buildFeedFilters(query);
+        const without = buildFeedFilters(base);
+        expect(withLocale.length).toBe(without.length + 1);
+    });
+});
+//# sourceMappingURL=display-window-feed.test.js.map

package/dist/feeds/__tests__/display-window-feed.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-window-feed.test.js","sourceRoot":"","sources":["../../../src/feeds/__tests__/display-window-feed.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAG/C,QAAQ,CAAC,wCAAwC,EAAE,GAAG,EAAE;IACtD,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,MAAM,SAAS,GAAc,EAAE,WAAW,EAAE,UAAU,EAAE,CAAA;QACxD,MAAM,UAAU,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAA;QAC9C,oEAAoE;QACpE,gGAAgG;QAChG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAA;IACrD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,MAAM,UAAU,GAAc,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,CAAA;QAC9E,MAAM,aAAa,GAAc,EAAE,WAAW,EAAE,UAAU,EAAE,CAAA;QAE5D,MAAM,oBAAoB,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAA;QACzD,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,aAAa,CAAC,CAAA;QAEzD,2CAA2C;QAC3C,MAAM,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IACxE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,MAAM,KAAK,GAAc,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;QAClE,MAAM,IAAI,GAAc,EAAE,WAAW,EAAE,UAAU,EAAE,CAAA;QACnD,MAAM,UAAU,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAA;QAC1C,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAA;QACtC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IACpD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/feeds/__tests__/engine.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=engine.test.d.ts.map

package/dist/feeds/__tests__/engine.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.test.d.ts","sourceRoot":"","sources":["../../../src/feeds/__tests__/engine.test.ts"],"names":[],"mappings":""}