@seedprotocol/feed 0.4.7

package/README.md

@@ -0,0 +1,41 @@
+# @seedprotocol/feed
+
+## Configuration
+
+### Feed Item URLs (EASScan attestation links)
+
+Item links in the feed can point to EASScan attestation pages. Set these environment variables:
+
+- `FEED_ITEM_URL_BASE` - Base URL for attestation links. When set, item URLs use `{base}/attestation/view/{uid}`.
+  - **Testnet**: `https://optimism-sepolia.easscan.org`
+  - **Mainnet**: `https://easscan.org`
+- `FEED_ITEM_URL_PATH` - Path segment (default: `attestation/view`). Only used when `FEED_ITEM_URL_BASE` is set.
+
+When `FEED_ITEM_URL_BASE` is not set, item URLs fall back to `{siteUrl}/{collection}/{uid}` (e.g. `https://seedprotocol.io/posts/{uid}`).
+
+### Example .env
+
+```bash
+# EASScan attestation links (testnet)
+FEED_ITEM_URL_BASE=https://optimism-sepolia.easscan.org
+FEED_ITEM_URL_PATH=attestation/view
+
+# When going live, switch to:
+# FEED_ITEM_URL_BASE=https://easscan.org
+```
+
+---
+
+To install dependencies:
+
+```bash
+bun install
+```
+
+To run:
+
+```bash
+bun run index.ts
+```
+
+This project was created using `bun init` in bun v1.3.5. [Bun](https://bun.com) is a fast all-in-one JavaScript runtime.

package/dist/cache/CacheManager.d.ts

@@ -0,0 +1,81 @@
+import { MemoryCache } from './MemoryCache';
+import type { CachedFeedData, CachedFeedContent, CacheConfig, CacheStats } from './types';
+import type { GraphQLItem, ImageMetadata } from '../types';
+import type { FeedFormat } from '../types';
+/**
+ * Unified cache manager that combines in-memory and file-based caching
+ */
+export declare class CacheManager {
+    private memoryCache;
+    private fileCache;
+    private config;
+    private stats;
+    constructor(config: CacheConfig);
+    /**
+     * Get cached feed data for a schema
+     * Checks memory cache first, then file cache
+     */
+    getFeedData(schemaName: string): Promise<CachedFeedData | null>;
+    /**
+     * Set cached feed data for a schema
+     * Updates both memory and file cache
+     */
+    setFeedData(schemaName: string, items: GraphQLItem[]): Promise<void>;
+    /**
+     * Get cached feed content for a schema and format
+     * Checks memory cache first, then file cache
+     */
+    getFeedContent(schemaName: string, format: FeedFormat): Promise<CachedFeedContent | null>;
+    /**
+     * Set cached feed content for a schema and format
+     * Updates both memory and file cache
+     */
+    setFeedContent(schemaName: string, format: FeedFormat, content: string, contentType: string): Promise<void>;
+    /**
+     * Clear feed data cache for a schema
+     */
+    clearFeedData(schemaName: string): Promise<void>;
+    /**
+     * Clear all caches
+     */
+    clearAll(): Promise<void>;
+    /**
+     * Get or create a refresh lock for a schema
+     * Prevents concurrent fetches for the same schema
+     */
+    withRefreshLock<T>(schemaName: string, fn: () => Promise<T>): Promise<T>;
+    /**
+     * Merge new items with cached items
+     * Deduplicates by item ID and sorts by timeCreated (descending)
+     */
+    mergeItems(cachedItems: GraphQLItem[], newItems: GraphQLItem[]): GraphQLItem[];
+    /**
+     * Filter items to only include those newer than the given timestamp
+     */
+    filterNewItems(items: GraphQLItem[], lastProcessedTimestamp: number): GraphQLItem[];
+    /**
+     * Update configuration
+     */
+    updateConfig(config: Partial<CacheConfig>): void;
+    /**
+     * Get cache statistics
+     */
+    getStats(): CacheStats & {
+        memoryStats: ReturnType<MemoryCache['getStats']>;
+    };
+    /**
+     * Get cached image metadata for a transaction ID
+     * Checks memory cache first, then file cache
+     */
+    getImageMetadata(transactionId: string): Promise<ImageMetadata | null>;
+    /**
+     * Set cached image metadata for a transaction ID
+     * Updates both memory and file cache
+     */
+    setImageMetadata(transactionId: string, metadata: ImageMetadata): Promise<void>;
+    /**
+     * Reset statistics
+     */
+    resetStats(): void;
+}
+//# sourceMappingURL=CacheManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CacheManager.d.ts","sourceRoot":"","sources":["../../src/cache/CacheManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EACjB,WAAW,EACX,UAAU,EACX,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,KAAK,CAKX;gBAEU,MAAM,EAAE,WAAW;IAM/B;;;OAGG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IA+BrE;;;OAGG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB1E;;;OAGG;IACG,cAAc,CAClB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAuCpC;;;OAGG;IACG,cAAc,CAClB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;IAuBhB;;OAEG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOtD;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAK/B;;;OAGG;IACG,eAAe,CAAC,CAAC,EACrB,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC;IAIb;;;OAGG;IACH,UAAU,CAAC,WAAW,EAAE,WAAW,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE;IAkC9E;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,sBAAsB,EAAE,MAAM,GAAG,WAAW,EAAE;IAOnF;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI;IAMhD;;OAEG;IACH,QAAQ,IAAI,UAAU,GAAG;QAAE,WAAW,EAAE,UAAU,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAA;KAAE;IAO7E;;;OAGG;IACG,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IA+B5E;;;OAGG;IACG,gBAAgB,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBrF;;OAEG;IACH,UAAU,IAAI,IAAI;CAQnB"}

package/dist/cache/FileCache.d.ts

@@ -0,0 +1,75 @@
+import type { CachedFeedData, CachedFeedContent, CacheConfig } from './types';
+import type { ImageMetadata } from '../types';
+/**
+ * File-based persistent cache implementation
+ */
+export declare class FileCache {
+    private cacheDir;
+    private config;
+    constructor(config: CacheConfig);
+    /**
+     * Ensure cache directory exists
+     */
+    private ensureCacheDir;
+    /**
+     * Get file path for feed data
+     */
+    private getFeedDataPath;
+    /**
+     * Get file path for feed content
+     */
+    private getFeedContentPath;
+    /**
+     * Get file path for image metadata
+     */
+    private getImageMetadataPath;
+    /**
+     * Ensure image metadata directory exists
+     */
+    private ensureImageMetadataDir;
+    /**
+     * Get cached feed data for a schema
+     */
+    getFeedData(schemaName: string): Promise<CachedFeedData | null>;
+    /**
+     * Set cached feed data for a schema
+     */
+    setFeedData(schemaName: string, data: CachedFeedData): Promise<void>;
+    /**
+     * Get cached feed content for a schema and format
+     */
+    getFeedContent(schemaName: string, format: string): Promise<CachedFeedContent | null>;
+    /**
+     * Set cached feed content for a schema and format
+     */
+    setFeedContent(schemaName: string, format: string, content: CachedFeedContent): Promise<void>;
+    /**
+     * Clear feed data cache for a schema
+     */
+    clearFeedData(schemaName: string): Promise<void>;
+    /**
+     * Clear content cache for a schema and format
+     */
+    clearFeedContent(schemaName: string, format: string): Promise<void>;
+    /**
+     * Clear all content cache for a schema (all formats)
+     */
+    clearAllContentCache(schemaName: string): Promise<void>;
+    /**
+     * Get cached image metadata for a transaction ID
+     */
+    getImageMetadata(transactionId: string): Promise<ImageMetadata | null>;
+    /**
+     * Set cached image metadata for a transaction ID
+     */
+    setImageMetadata(transactionId: string, metadata: ImageMetadata): Promise<void>;
+    /**
+     * Clear image metadata cache for a transaction ID
+     */
+    clearImageMetadata(transactionId: string): Promise<void>;
+    /**
+     * Clear all caches
+     */
+    clearAll(): Promise<void>;
+}
+//# sourceMappingURL=FileCache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FileCache.d.ts","sourceRoot":"","sources":["../../src/cache/FileCache.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,WAAW,EAAuB,MAAM,SAAS,CAAC;AACnG,OAAO,KAAK,EAAe,aAAa,EAAE,MAAM,UAAU,CAAC;AAE3D;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAc;gBAEhB,MAAM,EAAE,WAAW;IAS/B;;OAEG;YACW,cAAc;IAW5B;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAI1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAK5B;;OAEG;YACW,sBAAsB;IAWpC;;OAEG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IA0BrE;;OAEG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAW1E;;OAEG;IACG,cAAc,CAClB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IA4BpC;;OAEG;IACG,cAAc,CAClB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC;IAchB;;OAEG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYtD;;OAEG;IACG,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAezE;;OAEG;IACG,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB7D;;OAEG;IACG,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAyB5E;;OAEG;IACG,gBAAgB,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBrF;;OAEG;IACG,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY9D;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAwBhC"}

package/dist/cache/MemoryCache.d.ts

@@ -0,0 +1,68 @@
+import type { CachedFeedData, CachedFeedContent, CacheConfig } from './types';
+import type { GraphQLItem, ImageMetadata } from '../types';
+/**
+ * In-memory cache implementation with TTL support
+ */
+export declare class MemoryCache {
+    private feedDataCache;
+    private feedContentCache;
+    private imageMetadataCache;
+    private config;
+    private refreshLocks;
+    constructor(config: CacheConfig);
+    /**
+     * Get cached feed data for a schema
+     */
+    getFeedData(schemaName: string): CachedFeedData | null;
+    /**
+     * Set cached feed data for a schema
+     */
+    setFeedData(schemaName: string, items: GraphQLItem[]): void;
+    /**
+     * Get cached feed content for a schema and format
+     */
+    getFeedContent(schemaName: string, format: string): CachedFeedContent | null;
+    /**
+     * Set cached feed content for a schema and format
+     */
+    setFeedContent(schemaName: string, format: string, content: string, contentType: string): void;
+    /**
+     * Clear feed data cache for a schema
+     */
+    clearFeedData(schemaName: string): void;
+    /**
+     * Clear content cache for a schema (all formats)
+     */
+    clearContentCache(schemaName: string): void;
+    /**
+     * Get cached image metadata for a transaction ID
+     */
+    getImageMetadata(transactionId: string): ImageMetadata | null;
+    /**
+     * Set cached image metadata for a transaction ID
+     */
+    setImageMetadata(transactionId: string, metadata: ImageMetadata): void;
+    /**
+     * Clear all caches
+     */
+    clearAll(): void;
+    /**
+     * Get or create a refresh lock for a schema
+     * Prevents concurrent fetches for the same schema
+     */
+    withRefreshLock<T>(schemaName: string, fn: () => Promise<T>): Promise<T>;
+    /**
+     * Update configuration
+     */
+    updateConfig(config: Partial<CacheConfig>): void;
+    /**
+     * Get cache statistics
+     */
+    getStats(): {
+        feedDataCount: number;
+        feedContentCount: number;
+        imageMetadataCount: number;
+        activeLocks: number;
+    };
+}
+//# sourceMappingURL=MemoryCache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryCache.d.ts","sourceRoot":"","sources":["../../src/cache/MemoryCache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,WAAW,EAAuB,MAAM,SAAS,CAAC;AACnG,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG3D;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,aAAa,CAA0C;IAC/D,OAAO,CAAC,gBAAgB,CAA6C;IACrE,OAAO,CAAC,kBAAkB,CAA+C;IACzE,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,YAAY,CAAyC;gBAEjD,MAAM,EAAE,WAAW;IAI/B;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAmBtD;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,IAAI;IAiC3D;;OAEG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAiB5E;;OAEG;IACH,cAAc,CACZ,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,IAAI;IAkBP;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIvC;;OAEG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAU3C;;OAEG;IACH,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAgB7D;;OAEG;IACH,gBAAgB,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI;IActE;;OAEG;IACH,QAAQ,IAAI,IAAI;IAMhB;;;OAGG;IACG,eAAe,CAAC,CAAC,EACrB,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC;IA0Bb;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI;IAIhD;;OAEG;IACH,QAAQ,IAAI;QACV,aAAa,EAAE,MAAM,CAAC;QACtB,gBAAgB,EAAE,MAAM,CAAC;QACzB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,WAAW,EAAE,MAAM,CAAC;KACrB;CAQF"}

package/dist/cache/config.d.ts

@@ -0,0 +1,13 @@
+import type { CacheConfig } from './types';
+/**
+ * Load cache configuration from environment variables
+ *
+ * Environment variables:
+ * - CACHE_ENABLED: Set to 'false' to disable caching (default: 'true')
+ * - CACHE_TTL: Cache time-to-live in seconds (default: 3600)
+ * - CACHE_DIR: Directory for cache files (default: './cache')
+ * - CACHE_BACKGROUND_REFRESH: Enable background refresh (default: 'false')
+ * - CACHE_REFRESH_INTERVAL: Background refresh interval in seconds (default: 300)
+ */
+export declare function loadCacheConfig(): CacheConfig;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/cache/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAuB,MAAM,SAAS,CAAC;AAEhE;;;;;;;;;GASG;AACH,wBAAgB,eAAe,IAAI,WAAW,CA4C7C"}

package/dist/cache/types.d.ts

@@ -0,0 +1,59 @@
+import type { GraphQLItem, ImageMetadata } from '../types';
+/**
+ * Cached feed data for a specific schema
+ */
+export interface CachedFeedData {
+    items: GraphQLItem[];
+    lastProcessedTimestamp: number;
+    lastProcessedItemId: string;
+    lastUpdated: number;
+    etag: string;
+}
+/**
+ * Cached image metadata for an Arweave transaction ID
+ */
+export interface CachedImageMetadata {
+    metadata: ImageMetadata;
+    cachedAt: number;
+    expiresAt: number;
+}
+/**
+ * Cached feed content for a specific schema and format
+ */
+export interface CachedFeedContent {
+    content: string;
+    contentType: string;
+    etag: string;
+    lastModified: number;
+    expiresAt: number;
+}
+/**
+ * Image metadata cache configuration
+ */
+export interface ImageMetadataConfig {
+    enabled: boolean;
+    ttl: number;
+    gateways: string[];
+    timeout: number;
+}
+/**
+ * Cache configuration options
+ */
+export interface CacheConfig {
+    ttl: number;
+    cacheDir: string;
+    enabled: boolean;
+    backgroundRefresh: boolean;
+    refreshInterval: number;
+    imageMetadata?: ImageMetadataConfig;
+}
+/**
+ * Cache statistics for monitoring
+ */
+export interface CacheStats {
+    hits: number;
+    misses: number;
+    refreshes: number;
+    errors: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cache/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,aAAa,CAAA;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,mBAAmB,CAAA;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/config.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Load feed configuration from environment variables
+ *
+ * Environment variables:
+ * - FEED_ITEM_URL_BASE: Base URL for attestation links (e.g. https://optimism-sepolia.easscan.org or https://easscan.org).
+ *   When set, item links use {base}/attestation/view/{uid}. When unset, falls back to siteUrl/{collection}/{uid}.
+ * - FEED_ITEM_URL_PATH: Path segment for attestation links (default: 'attestation/view').
+ *   Only used when FEED_ITEM_URL_BASE is set.
+ */
+export declare function loadFeedConfig(): {
+    itemUrlBase: string | undefined;
+    itemUrlPath: string;
+};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,cAAc,IAAI;IAChC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;CACrB,CAMA"}

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+import type { FeedFormat, GraphQLItem } from './types';
+/**
+ * Reset cache manager (useful for testing)
+ */
+export declare function resetCacheManager(): void;
+/**
+ * Initialize the Seed Protocol client
+ * This should be called as soon as the app is ready
+ */
+export declare const initializeSeedClient: () => Promise<void>;
+/**
+ * Get the Seed Protocol client, initializing it if necessary
+ * This function can be called from any context (Electron main process or Vite dev server)
+ */
+export declare const getClient: () => Promise<any>;
+/**
+ * Teardown the Seed Protocol client
+ * This should be called when the app is quitting
+ */
+export declare const teardownSeedClient: () => Promise<void>;
+export declare const GET_SEEDS: string;
+export declare const createFeed: (items: GraphQLItem[], schemaName: string, format: FeedFormat, cacheBust?: string) => Promise<string>;
+/**
+ * Main route handler for feed generation.
+ *
+ * URL Pattern: /:collection/:format
+ * Examples:
+ *   - /posts/rss    → RSS feed of posts
+ *   - /posts/atom   → Atom feed of posts
+ *   - /identities/json → JSON feed of identities
+ *   - /posts/rss?v=1234567890 → RSS feed with cache busting parameter
+ */
+export declare function handleFeedRequest(collectionSegment: string, formatSegment: string, ifNoneMatch?: string | null, cacheBust?: string): Promise<Response>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAA+C,MAAM,SAAS,CAAC;AAuBpG;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB,QAAa,OAAO,CAAC,IAAI,CAkCzD,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,QAAa,OAAO,CAAC,GAAG,CAe7C,CAAA;AAGD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,QAAa,OAAO,CAAC,IAAI,CAmBvD,CAAA;AA0BD,eAAO,MAAM,SAAS,QAkBrB,CAAA;AA4JD,eAAO,MAAM,UAAU,GACrB,OAAO,WAAW,EAAE,EACpB,YAAY,MAAM,EAClB,QAAQ,UAAU,EAClB,YAAY,MAAM,KACjB,OAAO,CAAC,MAAM,CAgUhB,CAAA;AA8BD;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CACrC,iBAAiB,EAAE,MAAM,EACzB,aAAa,EAAE,MAAM,EACrB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,EAC3B,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,QAAQ,CAAC,CAqNnB"}