@seedprotocol/feed 0.7.9-next.1177.ga3e08ed → 0.7.9-next.1306.g4ff6582

package/dist/services/arweaveImageService.d.ts

@@ -10,13 +10,16 @@ export declare class ArweaveImageService {
     private config;
     constructor(config: ArweaveImageServiceConfig);
     /**
-     * Detect if an Arweave transaction ID links to an image and extract metadata
-     */
-    detectImage(transactionId: string): Promise<ImageMetadata>;
-    /**
-     * Get image metadata from a URL
+     * Whether an Arweave transaction is an image, with its metadata. Gateways are tried in order
+     * until one answers (any successful HEAD, image or not); a gateway that errors or returns a
+     * non-ok status is skipped. Null when no gateway answered, so the caller can try again later
+     * instead of recording the transaction as "not an image".
      */
+    detectImage(transactionId: string): Promise<ImageMetadata | null>;
+    /** Image metadata for a URL; `isImage: false` when it isn't an image or couldn't be read. */
     getImageMetadata(url: string, hostHint?: string): Promise<ImageMetadata>;
+    /** The URL's metadata, or null when the host errored or answered with a non-ok status. */
+    private probe;
     /**
      * Fetch image metadata from full request (fallback when range requests fail)
      */

package/dist/services/arweaveImageService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"arweaveImageService.d.ts","sourceRoot":"","sources":["../../src/services/arweaveImageService.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAE7C,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAA2B;gBAE7B,MAAM,EAAE,yBAAyB;IAI7C;;OAEG;IACG,WAAW,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAgChE;;OAEG;IACG,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAmE9E;;OAEG;YACW,+BAA+B;IA8B7C;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAO1B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAqB9B;;OAEG;IACH,OAAO,CAAC,cAAc;IA6BtB;;OAEG;YACW,gBAAgB;CAsB/B"}
+{"version":3,"file":"arweaveImageService.d.ts","sourceRoot":"","sources":["../../src/services/arweaveImageService.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAE7C,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAA2B;gBAE7B,MAAM,EAAE,yBAAyB;IAI7C;;;;;OAKG;IACG,WAAW,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAcvE,6FAA6F;IACvF,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAI9E,0FAA0F;YAC5E,KAAK;IAmEnB;;OAEG;YACW,+BAA+B;IA8B7C;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAO1B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAqB9B;;OAEG;IACH,OAAO,CAAC,cAAc;IA6BtB;;OAEG;YACW,gBAAgB;CAsB/B"}

package/dist/types.d.ts

@@ -1,21 +1,10 @@
-import type { Request, Response } from 'express';
-/**
- * Express Request/Response types for API routes
- * Use these types in your route handlers
- */
-export type { Request, Response } from 'express';
-/**
- * Express route handler function type
- */
-export type ApiHandler = (req: Request, res: Response) => void | Promise<void>;
 export type FeedFormat = 'rss' | 'atom' | 'json';
 export interface TransformOptions {
     schemaName: string;
-    siteUrl: string;
-    /** When set, item URLs use {itemUrlBase}/{itemUrlPath}/{uid} (e.g. EASScan attestation links) */
-    itemUrlBase?: string;
-    /** Path for attestation links when itemUrlBase is set (default: attestation/view) */
-    itemUrlPath?: string;
+    /** Items without a link of their own link to {itemUrlBase}/{itemUrlPath}/{uid} (an EAS explorer). */
+    itemUrlBase: string;
+    /** e.g. `attestation/view` */
+    itemUrlPath: string;
     /**
      * `omit_items` (default): drop feed entries whose rich-text fields contain `data:image/` URIs (large RSS payloads).
      * `include_items`: keep those entries (opt-in).
@@ -35,7 +24,8 @@ export interface FeedConfig {
         link?: string;
     };
 }
-export interface GraphQLItem {
+/** A feed entry: an assembled seed record's `data` with feed defaults applied. */
+export interface FeedItem {
     id: string;
     title: string;
     summary?: string;
@@ -66,14 +56,6 @@ export interface GraphQLItem {
     };
     [key: string]: unknown;
 }
-export interface GraphQLResponse<T> {
-    data: {
-        [key: string]: T[];
-    };
-    errors?: Array<{
-        message: string;
-    }>;
-}
 /**
  * Image metadata extracted from Arweave transaction
  */

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAA;AAEhD,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAA;IAClB,qGAAqG;IACrG,WAAW,EAAE,MAAM,CAAA;IACnB,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAA;IACnB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,YAAY,GAAG,eAAe,CAAA;CACvD;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE;QACP,IAAI,EAAE,MAAM,CAAA;QACZ,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,CAAA;CACF;AAED,kFAAkF;AAClF,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,qFAAqF;IACrF,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAA;QACZ,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,OAAO,CAAC,EAAE,MAAM,CAAA;KACjB,CAAC,CAAA;IACF,YAAY,CAAC,EAAE;QACb,GAAG,EAAE,MAAM,CAAA;QACX,GAAG,CAAC,EAAE,MAAM,CAAA;KACb,CAAA;IACD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAGD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB"}

package/dist/utils/etag.d.ts

@@ -3,10 +3,6 @@
  * Uses MD5 hash for consistency and performance
  */
 export declare function generateETag(value: string): string;
-/**
- * Generate an ETag for cached feed content
- */
-export declare function generateContentETag(schemaName: string, format: string, lastModified: number, contentLength: number): string;
 /**
  * Check if an ETag matches the provided value
  * Handles both quoted and unquoted ETags

package/dist/utils/etag.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"etag.d.ts","sourceRoot":"","sources":["../../src/utils/etag.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,GACpB,MAAM,CAGR;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAIjE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,EAAE,CAQjF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,iBAAiB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC5C,WAAW,EAAE,MAAM,GAClB,OAAO,CAaT"}
+{"version":3,"file":"etag.d.ts","sourceRoot":"","sources":["../../src/utils/etag.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAIjE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,EAAE,CAQjF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,iBAAiB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC5C,WAAW,EAAE,MAAM,GAClB,OAAO,CAaT"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seedprotocol/feed",
-  "version": "0.7.9-next.1177.ga3e08ed",
+  "version": "0.7.9-next.1306.g4ff6582",
   "description": "RSS 2.0, Atom and JSON Feed generation for Seed Protocol items, with HTTP handlers, ETag caching and RFC 5005 archives",
   "keywords": [
     "seed-protocol",
@@ -36,12 +36,11 @@
     "prepublishOnly": "bun run build && node ../../scripts/sync-versions.js"
   },
   "dependencies": {
-    "@seedprotocol/arweave": "0.7.9-next.1177.ga3e08ed",
-    "@seedprotocol/eas": "0.7.9-next.1177.ga3e08ed",
-    "@seedprotocol/query": "0.7.9-next.1177.ga3e08ed",
-    "express": "^5.2.1",
+    "@seedprotocol/arweave": "0.7.9-next.1306.g4ff6582",
+    "@seedprotocol/eas": "0.7.9-next.1306.g4ff6582",
+    "@seedprotocol/query": "0.7.9-next.1306.g4ff6582",
+    "debug": "^4.4.1",
     "feedsmith": "^2.9.0",
-    "graphql-request": "^7.3.5",
     "image-size": "^1.1.1",
     "pluralize": "^8.0.0",
     "rss-parser": "^3.13.0",
@@ -49,7 +48,6 @@
   },
   "devDependencies": {
     "@types/bun": "latest",
-    "@types/express": "^5.0.6",
     "typescript": "~5.9.3",
     "vite": "^8.0.0"
   },

package/dist/feedFieldStorageModel.d.ts

@@ -1,3 +0,0 @@
-export { FEED_RICH_BODY_STORAGE_SCHEMAS, RICH_BODY_STORAGE_SCHEMAS, isFeedRichBodyStorageSchema, isRichBodyStorageSchema, feedRichBodyModelPriority, richBodyModelPriority, getFeedFieldStorageModels, getFieldStorageModels, getFeedListElementStorageModels, getListElementStorageModels, setFeedFieldStorageModel, setFieldStorageModel, setFeedListElementStorageModels, setListElementStorageModels, } from '@seedprotocol/query';
-export type { FeedFieldStorageModels, FieldStorageModels, FeedListElementStorageModels, ListElementStorageModels, } from '@seedprotocol/query';
-//# sourceMappingURL=feedFieldStorageModel.d.ts.map

package/dist/feedFieldStorageModel.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"feedFieldStorageModel.d.ts","sourceRoot":"","sources":["../src/feedFieldStorageModel.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,yBAAyB,EACzB,2BAA2B,EAC3B,uBAAuB,EACvB,yBAAyB,EACzB,qBAAqB,EACrB,yBAAyB,EACzB,qBAAqB,EACrB,+BAA+B,EAC/B,2BAA2B,EAC3B,wBAAwB,EACxB,oBAAoB,EACpB,+BAA+B,EAC/B,2BAA2B,GAC5B,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EACV,sBAAsB,EACtB,kBAAkB,EAClB,4BAA4B,EAC5B,wBAAwB,GACzB,MAAM,qBAAqB,CAAA"}

package/dist/hydrateArweaveRichText.d.ts

@@ -1,2 +0,0 @@
-export { hydrateArweaveRichTextInFeedItems, hydrateArweaveRichTextInItems, isArweaveTransactionGatewayUrl, } from '@seedprotocol/query';
-//# sourceMappingURL=hydrateArweaveRichText.d.ts.map

package/dist/hydrateArweaveRichText.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"hydrateArweaveRichText.d.ts","sourceRoot":"","sources":["../src/hydrateArweaveRichText.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iCAAiC,EACjC,6BAA6B,EAC7B,8BAA8B,GAC/B,MAAM,qBAAqB,CAAA"}

package/dist/imageRelationEnrichment.d.ts

@@ -1,2 +0,0 @@
-export { enrichImageSeedCloneForFeed, enrichImageSeedClone, } from '@seedprotocol/query';
-//# sourceMappingURL=imageRelationEnrichment.d.ts.map

package/dist/imageRelationEnrichment.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"imageRelationEnrichment.d.ts","sourceRoot":"","sources":["../src/imageRelationEnrichment.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,qBAAqB,CAAA"}

package/dist/listRelationKey.d.ts

@@ -1,2 +0,0 @@
-export { publicListRelationPropertyKey, stripListRelationStorageAliasesForPublicKey, tryCoerceJsonStringArray, } from '@seedprotocol/query';
-//# sourceMappingURL=listRelationKey.d.ts.map

package/dist/listRelationKey.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"listRelationKey.d.ts","sourceRoot":"","sources":["../src/listRelationKey.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,EAC7B,2CAA2C,EAC3C,wBAAwB,GACzB,MAAM,qBAAqB,CAAA"}

package/dist/parseEasPropertyMetadataForFeed.d.ts

@@ -1,3 +0,0 @@
-export { parseEasPropertyMetadataForFeed, parseEasPropertyMetadata, } from '@seedprotocol/query';
-export type { EasPropertyMetadataForFeed, ParseEasPropertyMetadataForFeedResult, EasPropertyMetadata, ParseEasPropertyMetadataResult, } from '@seedprotocol/query';
-//# sourceMappingURL=parseEasPropertyMetadataForFeed.d.ts.map

package/dist/parseEasPropertyMetadataForFeed.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"parseEasPropertyMetadataForFeed.d.ts","sourceRoot":"","sources":["../src/parseEasPropertyMetadataForFeed.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,+BAA+B,EAC/B,wBAAwB,GACzB,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EACV,0BAA0B,EAC1B,qCAAqC,EACrC,mBAAmB,EACnB,8BAA8B,GAC/B,MAAM,qBAAqB,CAAA"}

package/dist/utils/arweaveUrl.d.ts

@@ -1,2 +0,0 @@
-export { getArweaveUrlForTransaction } from '@seedprotocol/query';
-//# sourceMappingURL=arweaveUrl.d.ts.map

package/dist/utils/arweaveUrl.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"arweaveUrl.d.ts","sourceRoot":"","sources":["../../src/utils/arweaveUrl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAA"}