@feralfile/cli 2.2.2 → 2.2.3

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@feralfile/cli",
-    "version": "2.2.2",
+    "version": "2.2.3",
     "description": "CLI for building, signing, and playing DP-1 playlists of digital art on Feral File devices",
     "repository": {
         "type": "git",

package/dist/src/commands/play.js

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.playCommand = void 0;
 exports.describeDiscoveryInput = describeDiscoveryInput;
+exports.probeDiscoveryUrlAsPlaylist = probeDiscoveryUrlAsPlaylist;
 const commander_1 = require("commander");
 const chalk_1 = __importDefault(require("chalk"));
 const source_resolver_1 = require("@feralfile/source-resolver");
@@ -62,6 +63,46 @@ function describeDiscoveryInput(source) {
             return 'an artwork reference';
     }
 }
+/**
+ * probeDiscoveryUrlAsPlaylist loads a discovery-classified http(s) URL as a
+ * DP-1 playlist document, or returns null when it is not one.
+ *
+ * The discovery parser claims whole hosts — any *.feralfile.com URL parses
+ * as a Feral File URL, and non-exhibition paths come back `unsupported` —
+ * which wrongly redirected DP-1 feed playlist URLs
+ * (https://feed.feralfile.com/api/v1/playlists/{slug}, exactly the URLs the
+ * feed hands out) to `find`, which has no feed route either; the documented
+ * "hosted playlist URL plays directly" contract was unreachable for them
+ * (found 2026-08-02 casting a published playlist to an FF1).
+ *
+ * Probing the document keeps both behaviors without a host allowlist: a URL
+ * that serves DP-1 JSON (`dpVersion` marker) plays directly; a marketplace
+ * *page* fails the probe (non-JSON, or JSON with no marker) and still
+ * redirects to `find` instead of being wrapped as a web item. The probe
+ * costs one fetch before a redirect, only for discovery inputs that are
+ * http(s) URLs; coordinates and wallet addresses never hit the network.
+ */
+async function probeDiscoveryUrlAsPlaylist(source) {
+    if (!(0, playlist_source_1.isPlaylistSourceUrl)(source)) {
+        return null;
+    }
+    try {
+        const loaded = await (0, playlist_source_1.loadPlaylistSource)(source);
+        const document = loaded.playlist;
+        if (typeof document?.dpVersion !== 'string') {
+            return null;
+        }
+        return {
+            kind: 'playlist',
+            playlist: loaded.playlist,
+            sourceType: loaded.sourceType,
+            source: loaded.source,
+        };
+    }
+    catch {
+        return null;
+    }
+}
 exports.playCommand = new commander_1.Command('play')
     .description('Play a playlist or media URL on an FF1 device')
     .argument('<source>', 'Playlist file, playlist URL, or media URL')
@@ -72,8 +113,15 @@ exports.playCommand = new commander_1.Command('play')
         // `play` casts an exact playable source. A marketplace URL / on-chain
         // coords / wallet must be resolved through the indexer first — redirect
         // to `find` rather than silently wrapping the *page* as a web item.
+        // Exception: a discovery-classified URL that actually serves a DP-1
+        // playlist document (the discovery parser claims whole hosts, catching
+        // feed playlist URLs) plays directly — see probeDiscoveryUrlAsPlaylist.
         const discovery = describeDiscoveryInput(source);
+        let probed = null;
         if (discovery) {
+            probed = await probeDiscoveryUrlAsPlaylist(source);
+        }
+        if (discovery && !probed) {
             console.error(chalk_1.default.red('\n`play` casts an exact playlist or media URL — it does not search marketplaces.'));
             console.error(chalk_1.default.dim(`  "${source}" looks like ${discovery}, which needs to be resolved first.`));
             const deviceFlag = options.device ? ` -d "${options.device}"` : '';
@@ -83,7 +131,7 @@ exports.playCommand = new commander_1.Command('play')
         const config = (0, config_1.getConfig)();
         // No explicit duration: a direct video/audio URL plays its natural
         // length (DP-1 §4.1); static media uses config.defaultDuration.
-        const resolved = await (0, playlist_source_1.resolvePlaySource)(source);
+        const resolved = probed ?? (await (0, playlist_source_1.resolvePlaySource)(source));
         const isPlaylistSource = resolved.kind === 'playlist';
         const sourceLabel = isPlaylistSource
             ? `${resolved.sourceType}: ${resolved.source}`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@feralfile/cli",
-  "version": "2.2.2",
+  "version": "2.2.3",
   "description": "CLI for building, signing, and playing DP-1 playlists of digital art on Feral File devices",
   "repository": {
     "type": "git",