@sprinterai/runtime 0.7.1 → 0.9.0

package/dist/source/source-poller.d.ts

@@ -0,0 +1,66 @@
+import type { SourceRecord, SourceStore } from '@sprinterai/core';
+/** A single content item fetched from a source. */
+export interface FetchedItem {
+    title: string;
+    url: string;
+    summary: string;
+    author?: string | null;
+    publishedAt?: string | null;
+    externalId?: string | null;
+}
+/** Result of fetching a single source. */
+export interface SourceFetchResult {
+    items: FetchedItem[];
+    /** If set, the fetch failed with this error message. */
+    error?: string;
+}
+/** Summary of a poll run across all due sources. */
+export interface SourcePollSummary {
+    polled: number;
+    succeeded: number;
+    failed: number;
+    errors: {
+        sourceId: string;
+        error: string;
+    }[];
+}
+export interface SourcePollerConfig {
+    store: SourceStore;
+    /**
+     * Framework-supplied function that fetches content items from a source.
+     * Called once per due source during `pollDueSources`.
+     */
+    fetchContent: (source: SourceRecord) => Promise<SourceFetchResult>;
+    /**
+     * Optional callback invoked after successful item fetches.
+     * Use this to enqueue items for downstream processing.
+     */
+    onItemsFetched?: (sourceId: string, items: FetchedItem[]) => Promise<void>;
+}
+export interface SourcePoller {
+    /** Returns true if the source's schedule indicates it is due for a sync. */
+    isDue(source: SourceRecord): boolean;
+    /** Lists all enabled, due sources for a tenant and polls each one. */
+    pollDueSources(tenantId: string): Promise<SourcePollSummary>;
+}
+/**
+ * Create a framework-agnostic source polling engine.
+ *
+ * The engine is responsible for schedule evaluation and status management.
+ * Content fetching is delegated to the caller-supplied `fetchContent` function,
+ * keeping this engine free of HTTP, RSS, or scraping dependencies.
+ *
+ * @example
+ * ```ts
+ * const poller = createSourcePoller({
+ *   store,
+ *   fetchContent: async (source) => fetchRss(source.url),
+ *   onItemsFetched: async (sourceId, items) => queue.push({ sourceId, items }),
+ * });
+ *
+ * // Call from a cron handler:
+ * const summary = await poller.pollDueSources(tenantId);
+ * ```
+ */
+export declare function createSourcePoller(config: SourcePollerConfig): SourcePoller;
+//# sourceMappingURL=source-poller.d.ts.map

package/dist/source/source-poller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-poller.d.ts","sourceRoot":"","sources":["../../src/source/source-poller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAMlE,mDAAmD;AACnD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,0CAA0C;AAC1C,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,oDAAoD;AACpD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC/C;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,WAAW,CAAC;IACnB;;;OAGG;IACH,YAAY,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACnE;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5E;AAED,MAAM,WAAW,YAAY;IAC3B,4EAA4E;IAC5E,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC;IACrC,sEAAsE;IACtE,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC9D;AAID;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,CAiD3E"}

package/dist/source/source-poller.js

@@ -0,0 +1,64 @@
+import { isSourceDue } from './source-status.js';
+// ─── Factory ──────────────────────────────────────────────────
+/**
+ * Create a framework-agnostic source polling engine.
+ *
+ * The engine is responsible for schedule evaluation and status management.
+ * Content fetching is delegated to the caller-supplied `fetchContent` function,
+ * keeping this engine free of HTTP, RSS, or scraping dependencies.
+ *
+ * @example
+ * ```ts
+ * const poller = createSourcePoller({
+ *   store,
+ *   fetchContent: async (source) => fetchRss(source.url),
+ *   onItemsFetched: async (sourceId, items) => queue.push({ sourceId, items }),
+ * });
+ *
+ * // Call from a cron handler:
+ * const summary = await poller.pollDueSources(tenantId);
+ * ```
+ */
+export function createSourcePoller(config) {
+    const { store, fetchContent, onItemsFetched } = config;
+    return {
+        isDue(source) {
+            return isSourceDue(source);
+        },
+        async pollDueSources(tenantId) {
+            const sources = await store.listSources(tenantId);
+            const due = sources.filter((s) => s.enabled && isSourceDue(s));
+            const summary = {
+                polled: due.length,
+                succeeded: 0,
+                failed: 0,
+                errors: [],
+            };
+            for (const source of due) {
+                try {
+                    const result = await fetchContent(source);
+                    if (result.error) {
+                        await store.updateSyncStatus(source.id, tenantId, 'error', result.error);
+                        summary.failed++;
+                        summary.errors.push({ sourceId: source.id, error: result.error });
+                        continue;
+                    }
+                    await store.triggerSync(source.id, tenantId);
+                    await store.updateSyncStatus(source.id, tenantId, 'active', null);
+                    if (onItemsFetched && result.items.length > 0) {
+                        await onItemsFetched(source.id, result.items);
+                    }
+                    summary.succeeded++;
+                }
+                catch (err) {
+                    const message = err instanceof Error ? err.message : String(err);
+                    await store.updateSyncStatus(source.id, tenantId, 'error', message);
+                    summary.failed++;
+                    summary.errors.push({ sourceId: source.id, error: message });
+                }
+            }
+            return summary;
+        },
+    };
+}
+//# sourceMappingURL=source-poller.js.map

package/dist/source/source-poller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-poller.js","sourceRoot":"","sources":["../../src/source/source-poller.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAkDjD,iEAAiE;AAEjE;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAA0B;IAC3D,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC;IAEvD,OAAO;QACL,KAAK,CAAC,MAAoB;YACxB,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;QAED,KAAK,CAAC,cAAc,CAAC,QAAgB;YACnC,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;YAClD,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;YAE/D,MAAM,OAAO,GAAsB;gBACjC,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,SAAS,EAAE,CAAC;gBACZ,MAAM,EAAE,CAAC;gBACT,MAAM,EAAE,EAAE;aACX,CAAC;YAEF,KAAK,MAAM,MAAM,IAAI,GAAG,EAAE,CAAC;gBACzB,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;oBAE1C,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;wBACjB,MAAM,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;wBACzE,OAAO,CAAC,MAAM,EAAE,CAAC;wBACjB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;wBAClE,SAAS;oBACX,CAAC;oBAED,MAAM,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;oBAC7C,MAAM,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;oBAElE,IAAI,cAAc,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBAC9C,MAAM,cAAc,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;oBAChD,CAAC;oBAED,OAAO,CAAC,SAAS,EAAE,CAAC;gBACtB,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;oBACjE,MAAM,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;oBACpE,OAAO,CAAC,MAAM,EAAE,CAAC;oBACjB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;gBAC/D,CAAC;YACH,CAAC;YAED,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/source/source-poller.test.d.ts

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

package/dist/source/source-poller.test.d.ts.map

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

package/dist/source/source-poller.test.js

@@ -0,0 +1,184 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { createSourcePoller } from './source-poller.js';
+const now = new Date('2026-04-03T12:00:00Z').getTime();
+function makeSource(overrides = {}) {
+    return {
+        id: 'src-1',
+        tenant_id: 'tenant-1',
+        name: 'Test RSS',
+        source_type: 'rss',
+        url: 'https://example.com/feed.xml',
+        schedule: 'hourly',
+        entity_type_slug: 'article',
+        field_mapping: {},
+        enabled: true,
+        sync_status: 'never_synced',
+        scrape_strategy: null,
+        sync_error: null,
+        last_synced_at: null,
+        last_validated_at: null,
+        metadata: null,
+        created_at: '2026-01-01T00:00:00Z',
+        updated_at: '2026-01-01T00:00:00Z',
+        ...overrides,
+    };
+}
+function makeStore(sources = []) {
+    return {
+        listSources: vi.fn(async () => sources),
+        getSource: vi.fn(async () => null),
+        createSource: vi.fn(async () => sources[0]),
+        updateSource: vi.fn(async () => null),
+        deleteSource: vi.fn(async () => undefined),
+        triggerSync: vi.fn(async () => undefined),
+        updateSyncStatus: vi.fn(async () => undefined),
+    };
+}
+describe('createSourcePoller - isDue', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+        vi.setSystemTime(now);
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    it('returns true for never-synced source', () => {
+        const poller = createSourcePoller({
+            store: makeStore(),
+            fetchContent: vi.fn(async () => ({ items: [] })),
+        });
+        expect(poller.isDue(makeSource({ last_synced_at: null }))).toBe(true);
+    });
+    it('returns false for manual schedule', () => {
+        const poller = createSourcePoller({
+            store: makeStore(),
+            fetchContent: vi.fn(async () => ({ items: [] })),
+        });
+        expect(poller.isDue(makeSource({ schedule: 'manual', last_synced_at: null }))).toBe(false);
+    });
+    it('returns true for hourly source synced 2 hours ago', () => {
+        const poller = createSourcePoller({
+            store: makeStore(),
+            fetchContent: vi.fn(async () => ({ items: [] })),
+        });
+        expect(poller.isDue(makeSource({ schedule: 'hourly', last_synced_at: '2026-04-03T10:00:00Z' }))).toBe(true);
+    });
+});
+describe('createSourcePoller - pollDueSources', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+        vi.setSystemTime(now);
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    it('skips disabled sources', async () => {
+        const source = makeSource({ enabled: false, last_synced_at: null });
+        const store = makeStore([source]);
+        const fetchContent = vi.fn(async () => ({ items: [] }));
+        const poller = createSourcePoller({ store, fetchContent });
+        const summary = await poller.pollDueSources('tenant-1');
+        expect(summary.polled).toBe(0);
+        expect(fetchContent).not.toHaveBeenCalled();
+    });
+    it('skips non-due sources', async () => {
+        // Synced 5 minutes ago, hourly schedule → not due
+        const source = makeSource({ schedule: 'hourly', last_synced_at: '2026-04-03T11:55:00Z' });
+        const store = makeStore([source]);
+        const fetchContent = vi.fn(async () => ({ items: [] }));
+        const poller = createSourcePoller({ store, fetchContent });
+        const summary = await poller.pollDueSources('tenant-1');
+        expect(summary.polled).toBe(0);
+        expect(fetchContent).not.toHaveBeenCalled();
+    });
+    it('polls due source and marks active on success', async () => {
+        const source = makeSource({ last_synced_at: null });
+        const store = makeStore([source]);
+        const items = [{ title: 'Item', url: 'https://example.com/1', summary: 'Summary' }];
+        const fetchContent = vi.fn(async () => ({ items }));
+        const poller = createSourcePoller({ store, fetchContent });
+        const summary = await poller.pollDueSources('tenant-1');
+        expect(summary.polled).toBe(1);
+        expect(summary.succeeded).toBe(1);
+        expect(summary.failed).toBe(0);
+        expect(store.triggerSync).toHaveBeenCalledWith('src-1', 'tenant-1');
+        expect(store.updateSyncStatus).toHaveBeenCalledWith('src-1', 'tenant-1', 'active', null);
+    });
+    it('marks source as error when fetchContent returns error', async () => {
+        const source = makeSource({ last_synced_at: null });
+        const store = makeStore([source]);
+        const fetchContent = vi.fn(async () => ({ items: [], error: 'Connection timeout' }));
+        const poller = createSourcePoller({ store, fetchContent });
+        const summary = await poller.pollDueSources('tenant-1');
+        expect(summary.polled).toBe(1);
+        expect(summary.succeeded).toBe(0);
+        expect(summary.failed).toBe(1);
+        expect(summary.errors[0]).toEqual({ sourceId: 'src-1', error: 'Connection timeout' });
+        expect(store.updateSyncStatus).toHaveBeenCalledWith('src-1', 'tenant-1', 'error', 'Connection timeout');
+        expect(store.triggerSync).not.toHaveBeenCalled();
+    });
+    it('marks source as error when fetchContent throws', async () => {
+        const source = makeSource({ last_synced_at: null });
+        const store = makeStore([source]);
+        const fetchContent = vi.fn(async () => {
+            throw new Error('Network unreachable');
+        });
+        const poller = createSourcePoller({ store, fetchContent });
+        const summary = await poller.pollDueSources('tenant-1');
+        expect(summary.failed).toBe(1);
+        expect(summary.errors[0].error).toBe('Network unreachable');
+        expect(store.updateSyncStatus).toHaveBeenCalledWith('src-1', 'tenant-1', 'error', 'Network unreachable');
+    });
+    it('calls onItemsFetched when items are present', async () => {
+        const source = makeSource({ last_synced_at: null });
+        const store = makeStore([source]);
+        const items = [{ title: 'T', url: 'https://x.com', summary: 'S' }];
+        const fetchContent = vi.fn(async () => ({ items }));
+        const onItemsFetched = vi.fn(async () => undefined);
+        const poller = createSourcePoller({ store, fetchContent, onItemsFetched });
+        await poller.pollDueSources('tenant-1');
+        expect(onItemsFetched).toHaveBeenCalledWith('src-1', items);
+    });
+    it('does not call onItemsFetched for empty result', async () => {
+        const source = makeSource({ last_synced_at: null });
+        const store = makeStore([source]);
+        const fetchContent = vi.fn(async () => ({ items: [] }));
+        const onItemsFetched = vi.fn(async () => undefined);
+        const poller = createSourcePoller({ store, fetchContent, onItemsFetched });
+        await poller.pollDueSources('tenant-1');
+        expect(onItemsFetched).not.toHaveBeenCalled();
+    });
+    it('polls multiple sources independently', async () => {
+        const src1 = makeSource({ id: 'src-1', last_synced_at: null });
+        const src2 = makeSource({
+            id: 'src-2',
+            last_synced_at: null,
+            name: 'Second',
+            url: 'https://other.com/feed.xml',
+        });
+        const store = makeStore([src1, src2]);
+        const fetchContent = vi.fn(async () => ({ items: [] }));
+        const poller = createSourcePoller({ store, fetchContent });
+        const summary = await poller.pollDueSources('tenant-1');
+        expect(summary.polled).toBe(2);
+        expect(summary.succeeded).toBe(2);
+        expect(fetchContent).toHaveBeenCalledTimes(2);
+    });
+    it('continues polling remaining sources after one fails', async () => {
+        const src1 = makeSource({ id: 'src-1', last_synced_at: null });
+        const src2 = makeSource({ id: 'src-2', last_synced_at: null, name: 'Second' });
+        const store = makeStore([src1, src2]);
+        const fetchContent = vi
+            .fn()
+            .mockImplementationOnce(async () => {
+            throw new Error('fail');
+        })
+            .mockResolvedValueOnce({ items: [] });
+        const poller = createSourcePoller({ store, fetchContent });
+        const summary = await poller.pollDueSources('tenant-1');
+        expect(summary.polled).toBe(2);
+        expect(summary.succeeded).toBe(1);
+        expect(summary.failed).toBe(1);
+    });
+});
+//# sourceMappingURL=source-poller.test.js.map

package/dist/source/source-poller.test.js.map

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

package/dist/source/source-status.d.ts

@@ -0,0 +1,41 @@
+import type { SourceSyncStatus, SourceRecord } from '@sprinterai/core';
+export type ValidationStatus = 'valid' | 'invalid' | null;
+/**
+ * Extract the validation status from a source record's metadata.
+ *
+ * Amble stores validation results under `metadata.sourceValidation.status`.
+ */
+export declare function getSourceValidationStatus(metadata: Record<string, unknown> | null | undefined): ValidationStatus;
+/**
+ * Determine the sync status for a source based on validation and history.
+ *
+ * Rules (in priority order):
+ * 1. Invalid validation → 'error'
+ * 2. Previously paused → preserve 'paused'
+ * 3. Has been synced before → 'active'
+ * 4. Everything else → 'never_synced'
+ */
+export declare function resolveSourceSyncStatus(params: {
+    validationStatus: ValidationStatus;
+    previousStatus?: string | null;
+    lastSyncedAt?: string | null;
+}): SourceSyncStatus;
+/**
+ * Returns true if a source sync is allowed to proceed.
+ *
+ * A sync is blocked when the source is paused or has a known invalid configuration.
+ */
+export declare function canRunSourceSync(params: {
+    syncStatus?: string | null;
+    validationStatus: ValidationStatus;
+}): boolean;
+/**
+ * Returns true if the source is due for a sync based on its schedule
+ * and the time of the last sync.
+ *
+ * Sources that have never been synced are always considered due.
+ * Sources with `schedule = 'manual'` are never automatically due.
+ * Unknown cron strings fall back to the 'daily' interval.
+ */
+export declare function isSourceDue(source: Pick<SourceRecord, 'schedule' | 'last_synced_at'>): boolean;
+//# sourceMappingURL=source-status.d.ts.map

package/dist/source/source-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-status.d.ts","sourceRoot":"","sources":["../../src/source/source-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEvE,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI,CAAC;AAE1D;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GACnD,gBAAgB,CAOlB;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,gBAAgB,CAOnB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACvC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,gBAAgB,EAAE,gBAAgB,CAAC;CACpC,GAAG,OAAO,CAIV;AASD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,UAAU,GAAG,gBAAgB,CAAC,GAAG,OAAO,CAY9F"}

package/dist/source/source-status.js

@@ -0,0 +1,73 @@
+/**
+ * Extract the validation status from a source record's metadata.
+ *
+ * Amble stores validation results under `metadata.sourceValidation.status`.
+ */
+export function getSourceValidationStatus(metadata) {
+    const v = metadata?.sourceValidation;
+    if (!v || typeof v !== 'object')
+        return null;
+    const s = v.status;
+    if (s === 'valid')
+        return 'valid';
+    if (s === 'invalid')
+        return 'invalid';
+    return null;
+}
+/**
+ * Determine the sync status for a source based on validation and history.
+ *
+ * Rules (in priority order):
+ * 1. Invalid validation → 'error'
+ * 2. Previously paused → preserve 'paused'
+ * 3. Has been synced before → 'active'
+ * 4. Everything else → 'never_synced'
+ */
+export function resolveSourceSyncStatus(params) {
+    const { validationStatus, previousStatus, lastSyncedAt } = params;
+    if (validationStatus === 'invalid')
+        return 'error';
+    if (previousStatus === 'paused')
+        return 'paused';
+    if (lastSyncedAt)
+        return 'active';
+    return 'never_synced';
+}
+/**
+ * Returns true if a source sync is allowed to proceed.
+ *
+ * A sync is blocked when the source is paused or has a known invalid configuration.
+ */
+export function canRunSourceSync(params) {
+    if (params.syncStatus === 'paused')
+        return false;
+    if (params.validationStatus === 'invalid')
+        return false;
+    return true;
+}
+/** Interval in milliseconds for each named schedule. */
+const SCHEDULE_INTERVALS_MS = {
+    hourly: 60 * 60 * 1000,
+    daily: 24 * 60 * 60 * 1000,
+    weekly: 7 * 24 * 60 * 60 * 1000,
+};
+/**
+ * Returns true if the source is due for a sync based on its schedule
+ * and the time of the last sync.
+ *
+ * Sources that have never been synced are always considered due.
+ * Sources with `schedule = 'manual'` are never automatically due.
+ * Unknown cron strings fall back to the 'daily' interval.
+ */
+export function isSourceDue(source) {
+    const { schedule, last_synced_at } = source;
+    if (schedule === 'manual')
+        return false;
+    if (!last_synced_at)
+        return true; // never synced → always due
+    const intervalMs = SCHEDULE_INTERVALS_MS[schedule ?? ''] ?? SCHEDULE_INTERVALS_MS['daily'];
+    const lastSyncMs = new Date(last_synced_at).getTime();
+    const nowMs = Date.now();
+    return nowMs - lastSyncMs >= intervalMs;
+}
+//# sourceMappingURL=source-status.js.map

package/dist/source/source-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-status.js","sourceRoot":"","sources":["../../src/source/source-status.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CACvC,QAAoD;IAEpD,MAAM,CAAC,GAAG,QAAQ,EAAE,gBAA8D,CAAC;IACnF,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC7C,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;IACnB,IAAI,CAAC,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC;IAClC,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACtC,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAIvC;IACC,MAAM,EAAE,gBAAgB,EAAE,cAAc,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC;IAElE,IAAI,gBAAgB,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC;IACnD,IAAI,cAAc,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IACjD,IAAI,YAAY;QAAE,OAAO,QAAQ,CAAC;IAClC,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAGhC;IACC,IAAI,MAAM,CAAC,UAAU,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACjD,IAAI,MAAM,CAAC,gBAAgB,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACxD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,wDAAwD;AACxD,MAAM,qBAAqB,GAA2B;IACpD,MAAM,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI;IACtB,KAAK,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;IAC1B,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;CAChC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,MAAyD;IACnF,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC;IAE5C,IAAI,QAAQ,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACxC,IAAI,CAAC,cAAc;QAAE,OAAO,IAAI,CAAC,CAAC,4BAA4B;IAE9D,MAAM,UAAU,GAAG,qBAAqB,CAAC,QAAQ,IAAI,EAAE,CAAC,IAAI,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAE3F,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,CAAC,OAAO,EAAE,CAAC;IACtD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEzB,OAAO,KAAK,GAAG,UAAU,IAAI,UAAU,CAAC;AAC1C,CAAC"}

package/dist/source/source-status.test.d.ts

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

package/dist/source/source-status.test.d.ts.map

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

package/dist/source/source-status.test.js

@@ -0,0 +1,116 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { getSourceValidationStatus, resolveSourceSyncStatus, canRunSourceSync, isSourceDue, } from './source-status.js';
+describe('getSourceValidationStatus', () => {
+    it('returns null for null metadata', () => {
+        expect(getSourceValidationStatus(null)).toBeNull();
+    });
+    it('returns null for undefined metadata', () => {
+        expect(getSourceValidationStatus(undefined)).toBeNull();
+    });
+    it('returns null when sourceValidation is missing', () => {
+        expect(getSourceValidationStatus({ other: 'field' })).toBeNull();
+    });
+    it('returns null when status is unknown', () => {
+        expect(getSourceValidationStatus({ sourceValidation: { status: 'pending' } })).toBeNull();
+    });
+    it('returns valid when status is valid', () => {
+        expect(getSourceValidationStatus({ sourceValidation: { status: 'valid' } })).toBe('valid');
+    });
+    it('returns invalid when status is invalid', () => {
+        expect(getSourceValidationStatus({ sourceValidation: { status: 'invalid' } })).toBe('invalid');
+    });
+});
+describe('resolveSourceSyncStatus', () => {
+    it('returns error for invalid validation', () => {
+        expect(resolveSourceSyncStatus({
+            validationStatus: 'invalid',
+            lastSyncedAt: '2026-01-01T00:00:00Z',
+        })).toBe('error');
+    });
+    it('preserves paused status', () => {
+        expect(resolveSourceSyncStatus({
+            validationStatus: 'valid',
+            previousStatus: 'paused',
+            lastSyncedAt: '2026-01-01T00:00:00Z',
+        })).toBe('paused');
+    });
+    it('returns active when synced before', () => {
+        expect(resolveSourceSyncStatus({
+            validationStatus: 'valid',
+            lastSyncedAt: '2026-01-01T00:00:00Z',
+        })).toBe('active');
+    });
+    it('returns never_synced for fresh source with no history', () => {
+        expect(resolveSourceSyncStatus({ validationStatus: null, lastSyncedAt: null })).toBe('never_synced');
+    });
+    it('returns never_synced for valid source never synced', () => {
+        expect(resolveSourceSyncStatus({ validationStatus: 'valid', lastSyncedAt: null })).toBe('never_synced');
+    });
+    it('invalid validation overrides paused status', () => {
+        expect(resolveSourceSyncStatus({
+            validationStatus: 'invalid',
+            previousStatus: 'paused',
+        })).toBe('error');
+    });
+});
+describe('canRunSourceSync', () => {
+    it('allows sync for valid source with no previous status', () => {
+        expect(canRunSourceSync({ syncStatus: null, validationStatus: 'valid' })).toBe(true);
+    });
+    it('allows sync for valid active source', () => {
+        expect(canRunSourceSync({ syncStatus: 'active', validationStatus: 'valid' })).toBe(true);
+    });
+    it('allows sync for valid never_synced source', () => {
+        expect(canRunSourceSync({ syncStatus: 'never_synced', validationStatus: null })).toBe(true);
+    });
+    it('blocks sync for paused source', () => {
+        expect(canRunSourceSync({ syncStatus: 'paused', validationStatus: 'valid' })).toBe(false);
+    });
+    it('blocks sync for invalid source', () => {
+        expect(canRunSourceSync({ syncStatus: 'active', validationStatus: 'invalid' })).toBe(false);
+    });
+});
+describe('isSourceDue', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+        vi.setSystemTime(new Date('2026-04-03T12:00:00Z'));
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    it('is always due when never synced', () => {
+        expect(isSourceDue({ schedule: 'daily', last_synced_at: null })).toBe(true);
+    });
+    it('is never due for manual schedule', () => {
+        expect(isSourceDue({ schedule: 'manual', last_synced_at: null })).toBe(false);
+    });
+    it('is never due for manual schedule even if last_synced_at is old', () => {
+        expect(isSourceDue({ schedule: 'manual', last_synced_at: '2020-01-01T00:00:00Z' })).toBe(false);
+    });
+    it('is due for hourly source synced 2 hours ago', () => {
+        expect(isSourceDue({ schedule: 'hourly', last_synced_at: '2026-04-03T10:00:00Z' })).toBe(true);
+    });
+    it('is not due for hourly source synced 30 min ago', () => {
+        expect(isSourceDue({ schedule: 'hourly', last_synced_at: '2026-04-03T11:30:00Z' })).toBe(false);
+    });
+    it('is due for daily source synced 25 hours ago', () => {
+        expect(isSourceDue({ schedule: 'daily', last_synced_at: '2026-04-02T11:00:00Z' })).toBe(true);
+    });
+    it('is not due for daily source synced 12 hours ago', () => {
+        expect(isSourceDue({ schedule: 'daily', last_synced_at: '2026-04-03T00:00:00Z' })).toBe(false);
+    });
+    it('is due for weekly source synced 8 days ago', () => {
+        expect(isSourceDue({ schedule: 'weekly', last_synced_at: '2026-03-26T12:00:00Z' })).toBe(true);
+    });
+    it('is not due for weekly source synced 3 days ago', () => {
+        expect(isSourceDue({ schedule: 'weekly', last_synced_at: '2026-03-31T12:00:00Z' })).toBe(false);
+    });
+    it('falls back to daily interval for unknown cron string', () => {
+        // Synced 25 hours ago → daily fallback → due
+        expect(isSourceDue({ schedule: '0 0 * * *', last_synced_at: '2026-04-02T11:00:00Z' })).toBe(true);
+    });
+    it('falls back to daily for null schedule when synced 25 hours ago', () => {
+        expect(isSourceDue({ schedule: null, last_synced_at: '2026-04-02T11:00:00Z' })).toBe(true);
+    });
+});
+//# sourceMappingURL=source-status.test.js.map

package/dist/source/source-status.test.js.map

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