@portpowered/reference-data 0.4.7 → 0.4.8

package/generated/public/docs/references/capability-interfaces/media-player/1.0/attributes/now-playing.yaml

@@ -0,0 +1,30 @@
+description: >-
+  Media identity observed on this route. Active false means the provider session
+  is on another target; it does not prove the speaker is silent through other
+  providers.
+type: object
+properties:
+  active:
+    type: boolean
+  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.
+  contextMediaId:
+    $ref: '#/properties/mediaId'
+  name:
+    type: string
+required:
+  - active
+additionalProperties: false

package/generated/public/docs/references/capability-interfaces/media-player/1.0/configuration.yaml

@@ -3,6 +3,36 @@ description: >-
   playback. Read playback state and use only the commands supported by the connected player.
 type: object
 properties:
+  supportedMediaResources:
+    type: array
+    description: >-
+      Exact play-media URI combinations accepted by this route. Member or endpoint unions do not
+      imply support by every route.
+    items:
+      title: SupportedMediaResource
+      description: A provider, media type and resource-kind combination accepted by a control route.
+      type: object
+      properties:
+        provider:
+          $ref: '#/properties/supportedAudioProviders/items'
+        mediaType:
+          type: string
+          enum:
+            - AUDIO
+            - VIDEO
+            - IMAGE
+        resourceKinds:
+          type: array
+          minItems: 1
+          uniqueItems: true
+          items:
+            type: string
+            description: Lowercase resource-kind segment from the provider URI.
+      required:
+        - provider
+        - mediaType
+        - resourceKinds
+      additionalProperties: false
   supportedAudioProviders:
     type: array
     uniqueItems: true

package/generated/public/docs/references/capability-interfaces/media-player/1.0/messages/play-media.yaml

@@ -4,11 +4,17 @@ properties:
     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.
 required:
   - mediaId
 additionalProperties: false

package/generated/public/docs/references/capability-interfaces/media-player/1.0.yaml

@@ -144,10 +144,16 @@ messages:
           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.
       required:
         - mediaId
       additionalProperties: false
@@ -288,6 +294,39 @@ messages:
       type: object
       additionalProperties: false
 attributes:
+  - name: now-playing
+    description: >-
+      Media identity observed on this route. Active false means the provider session is on another
+      target; it does not prove the speaker is silent through other providers.
+    schema:
+      description: >-
+        Media identity observed on this route. Active false means the provider session is on another
+        target; it does not prove the speaker is silent through other providers.
+      type: object
+      properties:
+        active:
+          type: boolean
+        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.
+        contextMediaId:
+          $ref: '#/properties/mediaId'
+        name:
+          type: string
+      required:
+        - active
+      additionalProperties: false
   - name: playback-speed
     description: null
     schema:
@@ -324,6 +363,36 @@ configuration:
     playback. Read playback state and use only the commands supported by the connected player.
   type: object
   properties:
+    supportedMediaResources:
+      type: array
+      description: >-
+        Exact play-media URI combinations accepted by this route. Member or endpoint unions do not
+        imply support by every route.
+      items:
+        title: SupportedMediaResource
+        description: A provider, media type and resource-kind combination accepted by a control route.
+        type: object
+        properties:
+          provider:
+            $ref: '#/properties/supportedAudioProviders/items'
+          mediaType:
+            type: string
+            enum:
+              - AUDIO
+              - VIDEO
+              - IMAGE
+          resourceKinds:
+            type: array
+            minItems: 1
+            uniqueItems: true
+            items:
+              type: string
+              description: Lowercase resource-kind segment from the provider URI.
+        required:
+          - provider
+          - mediaType
+          - resourceKinds
+        additionalProperties: false
     supportedAudioProviders:
       type: array
       uniqueItems: true

package/generated/public/docs/references/capability-interfaces/media-player.yaml

@@ -144,10 +144,16 @@ messages:
           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.
       required:
         - mediaId
       additionalProperties: false
@@ -288,6 +294,39 @@ messages:
       type: object
       additionalProperties: false
 attributes:
+  - name: now-playing
+    description: >-
+      Media identity observed on this route. Active false means the provider session is on another
+      target; it does not prove the speaker is silent through other providers.
+    schema:
+      description: >-
+        Media identity observed on this route. Active false means the provider session is on another
+        target; it does not prove the speaker is silent through other providers.
+      type: object
+      properties:
+        active:
+          type: boolean
+        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.
+        contextMediaId:
+          $ref: '#/properties/mediaId'
+        name:
+          type: string
+      required:
+        - active
+      additionalProperties: false
   - name: playback-speed
     description: null
     schema:
@@ -324,6 +363,36 @@ configuration:
     playback. Read playback state and use only the commands supported by the connected player.
   type: object
   properties:
+    supportedMediaResources:
+      type: array
+      description: >-
+        Exact play-media URI combinations accepted by this route. Member or endpoint unions do not
+        imply support by every route.
+      items:
+        title: SupportedMediaResource
+        description: A provider, media type and resource-kind combination accepted by a control route.
+        type: object
+        properties:
+          provider:
+            $ref: '#/properties/supportedAudioProviders/items'
+          mediaType:
+            type: string
+            enum:
+              - AUDIO
+              - VIDEO
+              - IMAGE
+          resourceKinds:
+            type: array
+            minItems: 1
+            uniqueItems: true
+            items:
+              type: string
+              description: Lowercase resource-kind segment from the provider URI.
+        required:
+          - provider
+          - mediaType
+          - resourceKinds
+        additionalProperties: false
     supportedAudioProviders:
       type: array
       uniqueItems: true

package/generated/public/docs/references/capability-interfaces/media-playlist/1.0/messages/get-playlist.yaml

@@ -4,6 +4,15 @@ properties:
     type: string
     description: ID of the playlist to retrieve
     minLength: 1
+  maxResults:
+    type: integer
+    minimum: 1
+    maximum: 50
+    default: 20
+  nextToken:
+    type: string
+    minLength: 1
+    description: Opaque continuation for the same playlist.
 required:
   - playlistId
 additionalProperties: false

package/generated/public/docs/references/capability-interfaces/media-playlist/1.0/messages/list-playlists.yaml

@@ -0,0 +1,15 @@
+description: >-
+  List the connected customer's owned or followed playlists; use search-media
+  for catalog search.
+type: object
+properties:
+  maxResults:
+    type: integer
+    minimum: 1
+    maximum: 50
+    default: 20
+  nextToken:
+    type: string
+    minLength: 1
+required: []
+additionalProperties: false

package/generated/public/docs/references/capability-interfaces/media-playlist/1.0/messages/playlist-contents.yaml

@@ -0,0 +1,114 @@
+description: A bounded playlist page containing playable tracks or episodes.
+type: object
+properties:
+  playlistId:
+    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.
+  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/playlistId'
+        name:
+          type: string
+          minLength: 1
+        showId:
+          $ref: '#/properties/playlistId'
+        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:
+  - playlistId
+  - tracks
+  - episodes
+additionalProperties: false

package/generated/public/docs/references/capability-interfaces/media-playlist/1.0/messages/playlists.yaml

@@ -0,0 +1,35 @@
+description: A page of the connected customer's playlists with exact resource IDs.
+type: object
+properties:
+  playlists:
+    type: array
+    items:
+      type: object
+      properties:
+        id:
+          type: string
+          description: Unique identifier for the playlist
+          minLength: 1
+        name:
+          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:
+        - id
+        - name
+      additionalProperties: false
+      title: Playlist
+  nextToken:
+    type: string
+    minLength: 1
+required:
+  - playlists
+additionalProperties: false

package/generated/public/docs/references/capability-interfaces/media-playlist/1.0.yaml

@@ -53,9 +53,39 @@ messages:
           type: string
           description: ID of the playlist to retrieve
           minLength: 1
+        maxResults:
+          type: integer
+          minimum: 1
+          maximum: 50
+          default: 20
+        nextToken:
+          type: string
+          minLength: 1
+          description: Opaque continuation for the same playlist.
       required:
         - playlistId
       additionalProperties: false
+  - name: list-playlists
+    description: >-
+      List the connected customer's owned or followed playlists; use search-media for catalog
+      search.
+    directionality: in
+    schema:
+      description: >-
+        List the connected customer's owned or followed playlists; use search-media for catalog
+        search.
+      type: object
+      properties:
+        maxResults:
+          type: integer
+          minimum: 1
+          maximum: 50
+          default: 20
+        nextToken:
+          type: string
+          minLength: 1
+      required: []
+      additionalProperties: false
   - name: play-playlist
     description: null
     directionality: in
@@ -72,6 +102,160 @@ messages:
       required:
         - playlistId
       additionalProperties: false
+  - name: playlist-contents
+    description: A bounded playlist page containing playable tracks or episodes.
+    directionality: out
+    schema:
+      description: A bounded playlist page containing playable tracks or episodes.
+      type: object
+      properties:
+        playlistId:
+          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.
+        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/playlistId'
+              name:
+                type: string
+                minLength: 1
+              showId:
+                $ref: '#/properties/playlistId'
+              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:
+        - playlistId
+        - tracks
+        - episodes
+      additionalProperties: false
+  - name: playlists
+    description: A page of the connected customer's playlists with exact resource IDs.
+    directionality: out
+    schema:
+      description: A page of the connected customer's playlists with exact resource IDs.
+      type: object
+      properties:
+        playlists:
+          type: array
+          items:
+            type: object
+            properties:
+              id:
+                type: string
+                description: Unique identifier for the playlist
+                minLength: 1
+              name:
+                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:
+              - id
+              - name
+            additionalProperties: false
+            title: Playlist
+        nextToken:
+          type: string
+          minLength: 1
+      required:
+        - playlists
+      additionalProperties: false
   - name: remove-from-playlist
     description: null
     directionality: in