@seedprotocol/feed 0.4.7 → 0.4.8

package/README.md

@@ -2,26 +2,27 @@
 
 ## Configuration
 
+### Caching (dev mode)
+
+In development (`NODE_ENV=development`), feed caching is **disabled by default** so you always see fresh content. Set `CACHE_ENABLED=true` to enable caching in dev. See `packages/feed/src/cache/README.md` for full cache 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}`.
+- `FEED_ITEM_URL_BASE` - Base URL for attestation links. Item URLs use `{base}/attestation/view/{uid}`. Default: `https://easscan.org`. Set to override.
   - **Testnet**: `https://optimism-sepolia.easscan.org`
-  - **Mainnet**: `https://easscan.org`
+  - **Mainnet**: `https://easscan.org` (default)
 - `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}`).
+- `FEED_SITE_URL` - Site URL for fallback when `FEED_ITEM_URL_BASE` is unset (default: `https://seedprotocol.io`).
 
 ### Example .env
 
 ```bash
-# EASScan attestation links (testnet)
+# Default: item links use https://easscan.org/attestation/view/{uid}
+# Override for 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
 ```
 
 ---

package/dist/cache/config.d.ts

@@ -3,7 +3,8 @@ import type { CacheConfig } from './types';
  * Load cache configuration from environment variables
  *
  * Environment variables:
- * - CACHE_ENABLED: Set to 'false' to disable caching (default: 'true')
+ * - CACHE_ENABLED: Set to 'false' to disable caching. Set to 'true' to enable (overrides NODE_ENV).
+ *   In development (NODE_ENV=development), cache is disabled by default unless CACHE_ENABLED='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')

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

@@ -1 +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"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/cache/config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAuB,MAAM,SAAS,CAAC;AAEhE;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,IAAI,WAAW,CAmE7C"}

package/dist/config.d.ts

@@ -3,12 +3,14 @@
  *
  * 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}.
+ *   When set, item links use {base}/attestation/view/{uid}. Default: 'https://easscan.org'. Set to override.
  * - FEED_ITEM_URL_PATH: Path segment for attestation links (default: 'attestation/view').
  *   Only used when FEED_ITEM_URL_BASE is set.
+ * - FEED_SITE_URL: Site URL for fallback when FEED_ITEM_URL_BASE is unset (default: 'https://seedprotocol.io').
  */
 export declare function loadFeedConfig(): {
-    itemUrlBase: string | undefined;
+    itemUrlBase: string;
     itemUrlPath: string;
+    siteUrl: string;
 };
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,cAAc,IAAI;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB,CAQA"}

package/dist/getFeedItems.d.ts

@@ -0,0 +1,2 @@
+export declare const getFeedItemsBySchemaName: (schemaName: string) => Promise<Record<string, unknown>[]>;
+//# sourceMappingURL=getFeedItems.d.ts.map

package/dist/getFeedItems.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getFeedItems.d.ts","sourceRoot":"","sources":["../src/getFeedItems.ts"],"names":[],"mappings":"AAsbA,eAAO,MAAM,wBAAwB,GAAU,YAAY,MAAM,KAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAmCpG,CAAC"}

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+import { getFeedItemsBySchemaName } from './getFeedItems';
+export { getFeedItemsBySchemaName };
 import type { FeedFormat, GraphQLItem } from './types';
 /**
  * Reset cache manager (useful for testing)
@@ -18,7 +20,6 @@ export declare const getClient: () => Promise<any>;
  * 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.

package/dist/index.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,OAAO,EAAE,wBAAwB,EAAE,CAAC;AAEpC,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;AAkLD,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"}