@feralfile/cli 1.5.0 → 1.6.0

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@feralfile/cli",
-    "version": "1.5.0",
+    "version": "1.6.0",
     "description": "CLI for building DP-1 playlists of digital art using AI (Claude, Grok, ChatGPT, Gemini)",
     "repository": {
         "type": "git",

package/dist/src/commands/find.js

@@ -37,6 +37,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.findCommand = void 0;
+exports.buildRasterMediaItems = buildRasterMediaItems;
 exports.parseLimitOption = parseLimitOption;
 exports.decideActions = decideActions;
 const commander_1 = require("commander");
@@ -68,7 +69,7 @@ const DP1_MAX_ITEMS = 1024;
 const RASTER_PAGE_SIZE = 100;
 exports.findCommand = new commander_1.Command('find')
     .description('Find an artwork on the web and build a DP-1 playlist')
-    .argument('<input>', 'URL (Objkt / fxhash / Art Blocks / OpenSea / SuperRare / Feral File / Neort / Verse), `ethereum:{contract}:{tokenId}`, `tezos:{contract}:{tokenId}`, or a wallet address')
+    .argument('<input>', 'URL (Objkt / fxhash / Art Blocks / OpenSea / SuperRare / Feral File / Neort / Verse / Raster), `ethereum:{contract}:{tokenId}`, `tezos:{contract}:{tokenId}`, or a wallet address')
     .option('-o, --output <path>', 'Save the playlist to this file (default: ./<slug>.json)')
     .option('-l, --limit <n>', 'Max tokens to include from the series (default: all)')
     .option('-p, --play', 'Play the playlist on an FF1 device after building')
@@ -83,7 +84,7 @@ exports.findCommand = new commander_1.Command('find')
         const parsed = (0, marketplace_url_1.parseFindInput)(input);
         if (!parsed) {
             console.error(chalk_1.default.red('Could not understand input.'));
-            console.error(chalk_1.default.dim('Supported URLs: Objkt, fxhash, Art Blocks, OpenSea, SuperRare, Feral File, Neort, Verse. ' +
+            console.error(chalk_1.default.dim('Supported URLs: Objkt, fxhash, Art Blocks, OpenSea, SuperRare, Feral File, Neort, Verse, Raster. ' +
                 'Or: `ethereum:{contract}:{tokenId}`, `tezos:{contract}:{tokenId}`, ' +
                 'or a wallet address (`0x...` / `tz1.../tz2.../tz3...`).'));
             process.exit(1);
@@ -125,7 +126,7 @@ exports.findCommand = new commander_1.Command('find')
             seriesHasMore = fetched.hasMore;
         }
         else {
-            tokens = [target.coords];
+            tokens = [{ ...target.coords, mediaUrl: null, mediaType: null }];
         }
         if (tokens.length === 0) {
             console.error(chalk_1.default.red('Series has no tokens on supported chains (Ethereum + Tezos mainnet).'));
@@ -148,11 +149,25 @@ exports.findCommand = new commander_1.Command('find')
         // display seconds), not concurrency — concurrency is hardcoded inside.
         // Omit it for auto timing: video/audio items carry no duration and play
         // their natural length (DP-1 §4.1); static items get the config default.
-        const items = await getNFTTokenInfoBatch(tokens.map((t) => ({
+        let items = await getNFTTokenInfoBatch(tokens.map((t) => ({
             chain: t.chain,
             contractAddress: t.contract,
             tokenId: t.tokenId,
         })));
+        // FF-indexer bypass for Raster-minted tokens. The indexer doesn't carry
+        // Raster's tokens, so it returns nothing — but Raster handed us each
+        // token's playable `media.contentUrl`. Build DP-1 items straight from
+        // that (off-chain provenance, same shape as the Neort path), so the
+        // series still builds into a signable, verifiable playlist instead of
+        // failing the way it did before. The indexer is tried first so tokens
+        // it *can* resolve keep their richer on-chain provenance.
+        if (!Array.isArray(items) || items.length === 0) {
+            const rasterItems = buildRasterMediaItems(tokens, target);
+            if (rasterItems.length > 0) {
+                console.log(chalk_1.default.dim(`  FF indexer returned nothing; building ${rasterItems.length} item${rasterItems.length === 1 ? '' : 's'} directly from Raster media.`));
+                items = rasterItems;
+            }
+        }
         if (!Array.isArray(items) || items.length === 0) {
             console.error(chalk_1.default.red('No tokens could be indexed; cannot build playlist.'));
             console.error(chalk_1.default.dim('  The FF indexer may be under load when warming a series of previously-unseen tokens.'));
@@ -217,6 +232,14 @@ async function resolveTarget(parsed, skipPrompt) {
         const coords = await (0, verse_marketplace_1.resolveVerseSeries)(parsed.slug);
         return resolveCoords(coords);
     }
+    if (parsed.kind === 'raster-artwork') {
+        const summary = await (0, raster_client_1.resolveSlugToArtwork)(parsed.slug);
+        if (summary === null) {
+            throw new Error(`No artwork found on Raster for slug "${parsed.slug}". ` +
+                'Check the URL — Raster artwork URLs are raster.art/artwork/{slug}.');
+        }
+        return { kind: 'series', summary };
+    }
     if (parsed.kind === 'address') {
         const artist = await (0, raster_client_1.resolveAddressToArtist)(parsed.address);
         if (artist === null) {
@@ -259,6 +282,32 @@ function playlistTitleFor(target, items) {
     }
     return items[0]?.title ?? `Token ${target.coords.tokenId}`;
 }
+/**
+ * Build DP-1 items directly from Raster's per-token media, bypassing the FF
+ * indexer. Used as a fallback when the indexer resolves nothing — tokens
+ * without a Raster `mediaUrl` are dropped (nothing playable to point at).
+ *
+ * Item shape matches the Neort off-chain path (`buildUrlItem` →
+ * `provenance.offChainURI`), so the resulting playlist signs and verifies
+ * normally. Titles are "<Series> #<tokenId>" for series, falling back to the
+ * series/coords title for a single token.
+ */
+function buildRasterMediaItems(tokens, target) {
+    const seriesTitle = target.kind === 'series' ? target.summary.title : undefined;
+    const items = [];
+    for (const t of tokens) {
+        if (!t.mediaUrl) {
+            continue;
+        }
+        const title = seriesTitle ? `${seriesTitle} #${t.tokenId}` : `Token ${t.tokenId}`;
+        // No explicit duration: auto timing (video/audio play their natural
+        // length). `mediaType` carries Raster's type so an extensionless IPFS
+        // contentUrl is still classified correctly — otherwise a video would be
+        // stamped a fixed duration and play as a still.
+        items.push(buildUrlItem(t.mediaUrl, undefined, { title, mimeType: t.mediaType ?? undefined }));
+    }
+    return items;
+}
 function parseLimitOption(limitStr) {
     if (limitStr === undefined) {
         return Number.POSITIVE_INFINITY;
@@ -300,6 +349,8 @@ async function fetchTokens(summary, limit) {
                 chain: t.chain,
                 contract: t.contractAddress,
                 tokenId: t.tokenId,
+                mediaUrl: t.mediaUrl,
+                mediaType: t.mediaType,
             });
         }
         if (hasMore || page.nextCursor === null) {

package/dist/src/utilities/marketplace-url.js

@@ -26,6 +26,7 @@ exports.parseOpenSea = parseOpenSea;
 exports.parseSuperRare = parseSuperRare;
 exports.parseNeort = parseNeort;
 exports.parseVerse = parseVerse;
+exports.parseRaster = parseRaster;
 exports.parseFeralFile = parseFeralFile;
 const ETH_ADDR = /^0x[a-fA-F0-9]{40}$/;
 const TEZOS_ADDR = /^(tz1|tz2|tz3)[1-9A-HJ-NP-Za-km-z]{33}$/;
@@ -101,6 +102,9 @@ function parseMarketplaceUrl(url) {
     if (host === 'verse.works' || host.endsWith('.verse.works')) {
         return parseVerse(url);
     }
+    if (host === 'raster.art' || host.endsWith('.raster.art')) {
+        return parseRaster(url);
+    }
     return null;
 }
 /**
@@ -382,6 +386,27 @@ function parseVerse(url) {
             '/items/ethereum/{contract}/{tokenId} or /series/{slug}.',
     };
 }
+/**
+ * Raster URL forms (raster.art):
+ *   raster.art/artwork/{slug}   — artwork (series) detail page
+ *
+ * Unlike the other marketplaces, Raster is already the find flow's backend
+ * resolver — so a Raster URL resolves to an artwork by slug via
+ * `artworkBySlug` and (crucially) builds DP-1 items straight from Raster's
+ * own `media.contentUrl`, bypassing the FF indexer the way Neort does. This
+ * is what lets Raster-minted tokens (which the FF indexer doesn't carry)
+ * build a verifiable playlist without `--skip-verify`.
+ */
+function parseRaster(url) {
+    const m = /^\/artwork\/([A-Za-z0-9][A-Za-z0-9_-]*)\/?$/.exec(url.pathname);
+    if (m) {
+        return { kind: 'raster-artwork', slug: m[1] };
+    }
+    return {
+        kind: 'unsupported',
+        reason: `Raster URL not recognized: ${url.pathname}. Expected /artwork/{slug}.`,
+    };
+}
 /**
  * Feral File URL forms (source of truth: feralfile-client app-routing
  * + collection-routing modules):

package/dist/src/utilities/playlist-builder.js

@@ -536,6 +536,10 @@ function detectMimeType(url) {
  *   (video/audio URLs play their natural length per DP-1 §4.1)
  * @param {Object} [options] - Optional configuration
  * @param {string} [options.title] - Optional item title override
+ * @param {string} [options.mimeType] - Source media type hint for timing
+ *   (DP-1 §4.1). Needed when the URL has no file extension to detect from —
+ *   e.g. extensionless IPFS gateway URLs, where without this hint a video
+ *   would be misclassified as a static image and stamped a fixed duration.
  * @returns {Object} DP1 playlist item
  */
 function buildUrlItem(url, duration, options = {}) {
@@ -580,7 +584,7 @@ function buildUrlItem(url, duration, options = {}) {
             margin: 0,
         },
     };
-    return applyItemTiming(item, { sourceUrl }, duration);
+    return applyItemTiming(item, { sourceUrl, mimeType: options.mimeType }, duration);
 }
 module.exports = {
     convertTokenToDP1Item,

package/dist/src/utilities/raster-client.js

@@ -58,6 +58,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveTokenToArtwork = resolveTokenToArtwork;
+exports.resolveSlugToArtwork = resolveSlugToArtwork;
 exports.resolveAddressToArtist = resolveAddressToArtist;
 exports.listArtworkTokens = listArtworkTokens;
 exports.listArtistArtworks = listArtistArtworks;
@@ -150,6 +151,30 @@ async function resolveTokenToArtwork(chain, contract, tokenId) {
         artists: (artwork.artists ?? []).map(toRasterArtist),
     };
 }
+/**
+ * Resolve a `raster.art/artwork/{slug}` URL to its artwork (series) summary.
+ *
+ * One round trip via `artworkBySlug`. Returns `null` when the slug is
+ * unknown (Raster models not-found as a null query field, not an HTTP 404).
+ */
+async function resolveSlugToArtwork(slug) {
+    const data = await rasterQuery(`query ResolveSlug($slug: String!) {
+      artworkBySlug(slug: $slug) {
+        id
+        title
+        artists { id name slug }
+      }
+    }`, { slug });
+    const artwork = data.artworkBySlug;
+    if (!artwork) {
+        return null;
+    }
+    return {
+        artworkId: artwork.id,
+        title: artwork.title,
+        artists: (artwork.artists ?? []).map(toRasterArtist),
+    };
+}
 /**
  * Resolve a wallet address to the Raster artist who claims it.
  *
@@ -180,7 +205,7 @@ async function listArtworkTokens(artworkId, options = {}) {
     const data = await rasterQuery(`query ArtworkTokens($id: ID!, $first: Int, $after: String) {
       artwork(id: $id) {
         tokens(first: $first, after: $after) {
-          nodes { chainId contractAddress tokenId }
+          nodes { chainId contractAddress tokenId media { contentUrl contentType previewType } }
           pageInfo { hasNextPage endCursor }
         }
       }
@@ -200,6 +225,10 @@ async function listArtworkTokens(artworkId, options = {}) {
             chain,
             contractAddress: raw.contractAddress,
             tokenId: raw.tokenId,
+            mediaUrl: raw.media?.contentUrl ?? null,
+            // Prefer a real MIME (`contentType`) when Raster populates it; today it
+            // is usually empty, so fall back to the category-prefixed `previewType`.
+            mediaType: raw.media?.contentType || raw.media?.previewType || null,
         });
     }
     const { hasNextPage, endCursor } = data.artwork.tokens.pageInfo;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@feralfile/cli",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "CLI for building DP-1 playlists of digital art using AI (Claude, Grok, ChatGPT, Gemini)",
   "repository": {
     "type": "git",