mirror of
https://github.com/kennethnym/aris.git
synced 2026-02-02 05:01:17 +00:00
kenneth
3c16dd4275
Adds orchestration for feed reconciliation with context-driven updates: - FeedController: holds context, debounces updates, reconciles sources - ContextBridge: bridges context providers to controller - ContextProvider: reactive + on-demand context value interface - Branded ContextKey<T> for type-safe context keys Moves source files to src/ directory and consolidates tests into integration test. Co-authored-by: Ona <no-reply@ona.com>
36 lines
1008 B
TypeScript
36 lines
1008 B
TypeScript
import type { Context } from "./context"
|
|
import type { FeedItem } from "./feed"
|
|
|
|
/**
|
|
* Produces feed items from an external source.
|
|
*
|
|
* @example
|
|
* ```ts
|
|
* type WeatherItem = FeedItem<"weather", { temp: number }>
|
|
*
|
|
* class WeatherDataSource implements DataSource<WeatherItem> {
|
|
* readonly type = "weather"
|
|
*
|
|
* async query(context: Context): Promise<WeatherItem[]> {
|
|
* const location = contextValue(context, LocationKey)
|
|
* if (!location) return []
|
|
* const data = await fetchWeather(location)
|
|
* return [{
|
|
* id: `weather-${Date.now()}`,
|
|
* type: this.type,
|
|
* priority: 0.5,
|
|
* timestamp: context.time,
|
|
* data: { temp: data.temperature },
|
|
* }]
|
|
* }
|
|
* }
|
|
* ```
|
|
*/
|
|
export interface DataSource<TItem extends FeedItem = FeedItem, TConfig = unknown> {
|
|
/** Unique identifier for this source type */
|
|
readonly type: TItem["type"]
|
|
|
|
/** Queries the source and returns feed items */
|
|
query(context: Context, config: TConfig): Promise<TItem[]>
|
|
}
|