@portpowered/reference-data 0.4.7 → 0.4.9

package/generated/resources/media-search/message-audio-media-results.json

@@ -114,6 +114,14 @@
             "type": "string",
             "description": "Playlist name",
             "minLength": 1
+          },
+          "ownerId": {
+            "type": "string",
+            "description": "Provider-scoped owner identity, when supplied by the provider."
+          },
+          "ownerName": {
+            "type": "string",
+            "description": "Owner display name, useful for distinguishing owned and followed playlists."
           }
         },
         "required": [
@@ -124,6 +132,74 @@
         "title": "Playlist"
       },
       "description": "Playlist results"
+    },
+    "shows": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "description": "Provider-qualified podcast series; read episodes before playback.",
+        "properties": {
+          "id": {
+            "title": "MediaId",
+            "type": "string",
+            "minLength": 1,
+            "example": "portos-media://portpowered.com/spotify/audio/track/Ab123",
+            "pattern": "^(portos-media://portpowered[.]com/[a-z][a-z0-9_-]*/(audio|video|image)/[a-z][a-z0-9_-]*/([^/?#\\s]|%[0-9A-Fa-f]{2})+|https?://[^\\s]+|portos://[^\\s]+|youtube:video:[A-Za-z0-9_-]+)$",
+            "description": "Exact provider resource identity. The canonical form is portos-media://portpowered.com/provider/media-type/resource-kind/resource-id, with no URI version. Spotify emits audio track, playlist, album, artist, show and episode identities. Copy an ID returned by search or library discovery; do not send a search phrase as an ID. Legacy providers retain their own input contracts until explicitly migrated. See https://portpowered.com/docs/media.\n"
+          },
+          "name": {
+            "type": "string",
+            "minLength": 1
+          },
+          "publisher": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "id",
+          "name"
+        ],
+        "additionalProperties": false,
+        "title": "PodcastShow"
+      }
+    },
+    "episodes": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "description": "Provider-qualified podcast episode with selection metadata.",
+        "properties": {
+          "id": {
+            "$ref": "#/properties/shows/items/properties/id"
+          },
+          "name": {
+            "type": "string",
+            "minLength": 1
+          },
+          "showId": {
+            "$ref": "#/properties/shows/items/properties/id"
+          },
+          "releaseDate": {
+            "type": "string",
+            "description": "Provider release date; precision can be year, month or day."
+          },
+          "releaseDatePrecision": {
+            "type": "string",
+            "description": "Provider date precision."
+          }
+        },
+        "required": [
+          "id",
+          "name"
+        ],
+        "additionalProperties": false,
+        "title": "PodcastEpisode"
+      }
+    },
+    "nextToken": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Opaque continuation for the same search; omit when exhausted."
     }
   },
   "required": [

package/generated/resources/media-search/message-get-media.json

@@ -0,0 +1,29 @@
+{
+  "description": "Inspect an exact media resource or traverse an album/show. Use get-playlist for playlist contents.",
+  "type": "object",
+  "properties": {
+    "mediaId": {
+      "title": "MediaId",
+      "type": "string",
+      "minLength": 1,
+      "example": "portos-media://portpowered.com/spotify/audio/track/Ab123",
+      "pattern": "^(portos-media://portpowered[.]com/[a-z][a-z0-9_-]*/(audio|video|image)/[a-z][a-z0-9_-]*/([^/?#\\s]|%[0-9A-Fa-f]{2})+|https?://[^\\s]+|portos://[^\\s]+|youtube:video:[A-Za-z0-9_-]+)$",
+      "description": "Exact provider resource identity. The canonical form is portos-media://portpowered.com/provider/media-type/resource-kind/resource-id, with no URI version. Spotify emits audio track, playlist, album, artist, show and episode identities. Copy an ID returned by search or library discovery; do not send a search phrase as an ID. Legacy providers retain their own input contracts until explicitly migrated. See https://portpowered.com/docs/media.\n"
+    },
+    "maxResults": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 50,
+      "default": 20
+    },
+    "nextToken": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Opaque continuation for the same resource."
+    }
+  },
+  "required": [
+    "mediaId"
+  ],
+  "additionalProperties": false
+}

package/generated/resources/media-search/message-media-details.json

@@ -0,0 +1,146 @@
+{
+  "description": "Exact media resource details and a bounded page of its children.",
+  "type": "object",
+  "properties": {
+    "mediaId": {
+      "title": "MediaId",
+      "type": "string",
+      "minLength": 1,
+      "example": "portos-media://portpowered.com/spotify/audio/track/Ab123",
+      "pattern": "^(portos-media://portpowered[.]com/[a-z][a-z0-9_-]*/(audio|video|image)/[a-z][a-z0-9_-]*/([^/?#\\s]|%[0-9A-Fa-f]{2})+|https?://[^\\s]+|portos://[^\\s]+|youtube:video:[A-Za-z0-9_-]+)$",
+      "description": "Exact provider resource identity. The canonical form is portos-media://portpowered.com/provider/media-type/resource-kind/resource-id, with no URI version. Spotify emits audio track, playlist, album, artist, show and episode identities. Copy an ID returned by search or library discovery; do not send a search phrase as an ID. Legacy providers retain their own input contracts until explicitly migrated. See https://portpowered.com/docs/media.\n"
+    },
+    "name": {
+      "type": "string"
+    },
+    "resourceKind": {
+      "type": "string",
+      "description": "Provider resource kind from the media URI."
+    },
+    "tracks": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "description": "Track information",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Unique identifier for the track",
+            "minLength": 1
+          },
+          "name": {
+            "type": "string",
+            "description": "Track name",
+            "minLength": 1
+          },
+          "artists": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "description": "Artist information",
+              "properties": {
+                "id": {
+                  "type": "string",
+                  "description": "Unique identifier for the artist",
+                  "minLength": 1
+                },
+                "name": {
+                  "type": "string",
+                  "description": "Artist name",
+                  "minLength": 1
+                }
+              },
+              "required": [
+                "id",
+                "name"
+              ],
+              "additionalProperties": false,
+              "title": "Artist"
+            },
+            "description": "Track artists"
+          },
+          "album": {
+            "description": "Track album",
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "description": "Unique identifier for the album",
+                "minLength": 1
+              },
+              "name": {
+                "type": "string",
+                "description": "Album name",
+                "minLength": 1
+              },
+              "artists": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/properties/tracks/items/properties/artists/items"
+                },
+                "description": "Album artists"
+              }
+            },
+            "required": [
+              "id",
+              "name",
+              "artists"
+            ],
+            "additionalProperties": false,
+            "title": "Album"
+          }
+        },
+        "required": [
+          "id",
+          "name",
+          "artists",
+          "album"
+        ],
+        "additionalProperties": false,
+        "title": "Track"
+      }
+    },
+    "episodes": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "description": "Provider-qualified podcast episode with selection metadata.",
+        "properties": {
+          "id": {
+            "$ref": "#/properties/mediaId"
+          },
+          "name": {
+            "type": "string",
+            "minLength": 1
+          },
+          "showId": {
+            "$ref": "#/properties/mediaId"
+          },
+          "releaseDate": {
+            "type": "string",
+            "description": "Provider release date; precision can be year, month or day."
+          },
+          "releaseDatePrecision": {
+            "type": "string",
+            "description": "Provider date precision."
+          }
+        },
+        "required": [
+          "id",
+          "name"
+        ],
+        "additionalProperties": false,
+        "title": "PodcastEpisode"
+      }
+    },
+    "nextToken": {
+      "type": "string",
+      "minLength": 1
+    }
+  },
+  "required": [
+    "mediaId",
+    "resourceKind"
+  ],
+  "additionalProperties": false
+}

package/generated/resources/media-search/message-search-media.json

@@ -7,7 +7,7 @@
     },
     "type": {
       "type": "string",
-      "description": "Supported types, track, album, artist, playlist. Defaults to track",
+      "description": "Resource kind: track, album, artist, playlist, show or episode when advertised. Defaults to track",
       "default": "track"
     },
     "album": {
@@ -21,6 +21,18 @@
     "year": {
       "type": "string",
       "description": "Search by year, can only be used when searching albums, years, and tracks. You can pass a range like 1990-2000"
+    },
+    "maxResults": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 50,
+      "default": 20,
+      "description": "Maximum results on one page."
+    },
+    "nextToken": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Copy the opaque continuation from the previous result with the same query and filters."
     }
   },
   "required": [

package/generated/resources/recordings/message-list-recordings-response.json

@@ -17,7 +17,9 @@
             "title": "MediaId",
             "type": "string",
             "minLength": 1,
-            "description": "Media IDs are a standardized identifier that Port OS uses to represent media across YouTube, Spotify, and other media providers. See https://portpowered.com/docs/media for the current media identifiers documentation."
+            "example": "portos-media://portpowered.com/spotify/audio/track/Ab123",
+            "pattern": "^(portos-media://portpowered[.]com/[a-z][a-z0-9_-]*/(audio|video|image)/[a-z][a-z0-9_-]*/([^/?#\\s]|%[0-9A-Fa-f]{2})+|https?://[^\\s]+|portos://[^\\s]+|youtube:video:[A-Za-z0-9_-]+)$",
+            "description": "Exact provider resource identity. The canonical form is portos-media://portpowered.com/provider/media-type/resource-kind/resource-id, with no URI version. Spotify emits audio track, playlist, album, artist, show and episode identities. Copy an ID returned by search or library discovery; do not send a search phrase as an ID. Legacy providers retain their own input contracts until explicitly migrated. See https://portpowered.com/docs/media.\n"
           },
           "startedAt": {
             "type": "string",

package/package.json

@@ -1,9 +1,14 @@
 {
   "name": "@portpowered/reference-data",
-  "version": "0.4.7",
+  "version": "0.4.9",
   "private": false,
-  "publishConfig": { "access": "public" },
-  "repository": { "type": "git", "url": "https://github.com/portpowered/portos-reference-data.git" },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/portpowered/portos-reference-data.git"
+  },
   "type": "module",
   "files": [
     "generated",