@almadar/std 14.8.0 → 14.9.0

package/behaviors/registry/service/atoms/std-service-youtube.orb

@@ -1,7 +1,7 @@
 {
   "name": "std-service-youtube",
-  "version": "1.0.0",
-  "description": "std-service-youtube as a Function",
+  "version": "2.0.0",
+  "description": "std-service-youtube. YouTube embed service. Bind via `uses Youtube from \"std/behaviors/std-service-youtube\"` and configure `videoId` / `autoplay` / `controls` / `start` at the call site. SPECIAL: the default render IS the embed itself, so passing `uiTrait: \"@trait.YourPlayerSkin\"` OVERRIDES the embed (e.g., a custom player skin) rather than supplements it. Leave `uiTrait` unset to render the atom's default embed.",
   "orbitals": [
     {
       "name": "ServiceYoutubeOrbital",
@@ -15,29 +15,24 @@
             "required": true
           },
           {
-            "name": "query",
+            "name": "videoId",
             "type": "string",
             "default": ""
           },
           {
-            "name": "selectedVideoId",
-            "type": "string",
-            "default": ""
+            "name": "autoplay",
+            "type": "boolean",
+            "default": false
           },
           {
-            "name": "videoTitle",
-            "type": "string",
-            "default": ""
+            "name": "controls",
+            "type": "boolean",
+            "default": true
           },
           {
-            "name": "videoDescription",
-            "type": "string",
-            "default": ""
-          },
-          {
-            "name": "searchStatus",
-            "type": "string",
-            "default": "idle"
+            "name": "start",
+            "type": "number",
+            "default": 0.0
           },
           {
             "name": "error",
@@ -69,6 +64,125 @@
         ]
       },
       "traits": [
+        {
+          "name": "ServiceYoutubeDefaultPlayer",
+          "category": "interaction",
+          "emits": [
+            {
+              "event": "PLAY",
+              "scope": "external",
+              "payloadSchema": [
+                {
+                  "name": "source",
+                  "type": "string"
+                }
+              ]
+            },
+            {
+              "event": "READY",
+              "scope": "external",
+              "payloadSchema": [
+                {
+                  "name": "source",
+                  "type": "string"
+                }
+              ]
+            }
+          ],
+          "stateMachine": {
+            "states": [
+              {
+                "name": "ready",
+                "isInitial": true
+              }
+            ],
+            "events": [
+              {
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "key": "PLAY",
+                "name": "Play"
+              },
+              {
+                "key": "READY",
+                "name": "Ready"
+              }
+            ],
+            "transitions": [
+              {
+                "from": "ready",
+                "to": "ready",
+                "event": "INIT",
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "children": [
+                        {
+                          "gap": "md",
+                          "type": "stack",
+                          "direction": "vertical",
+                          "children": [
+                            {
+                              "type": "icon",
+                              "name": "video"
+                            },
+                            {
+                              "content": "YouTube Video",
+                              "type": "typography",
+                              "variant": "h2"
+                            },
+                            {
+                              "content": "@config.videoId",
+                              "color": "muted",
+                              "type": "typography",
+                              "variant": "body"
+                            },
+                            {
+                              "gap": "sm",
+                              "justify": "center",
+                              "children": [
+                                {
+                                  "variant": "primary",
+                                  "action": "PLAY",
+                                  "icon": "play",
+                                  "label": "Play",
+                                  "type": "button"
+                                }
+                              ],
+                              "type": "stack",
+                              "direction": "horizontal"
+                            }
+                          ],
+                          "align": "center"
+                        }
+                      ],
+                      "type": "card"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "ready",
+                "to": "ready",
+                "event": "PLAY",
+                "effects": [
+                  [
+                    "emit",
+                    "PLAY",
+                    {
+                      "source": "default-player"
+                    }
+                  ]
+                ]
+              }
+            ]
+          },
+          "scope": "instance"
+        },
         {
           "name": "ServiceYoutubeYoutube",
           "category": "interaction",
@@ -95,12 +209,12 @@
               ]
             },
             {
-              "event": "ServiceYoutubeYoutubeCompleted",
+              "event": "ServiceYoutubeYoutubeReady",
               "scope": "external",
               "payloadSchema": [
                 {
-                  "name": "result",
-                  "type": "object"
+                  "name": "videoId",
+                  "type": "string"
                 }
               ]
             },
@@ -117,6 +231,26 @@
                   "type": "string"
                 }
               ]
+            },
+            {
+              "event": "FAILED",
+              "payloadSchema": [
+                {
+                  "name": "error",
+                  "type": "string",
+                  "required": true
+                }
+              ]
+            }
+          ],
+          "listens": [
+            {
+              "event": "READY",
+              "triggers": "READY",
+              "source": {
+                "kind": "trait",
+                "trait": "ServiceYoutubeDefaultPlayer"
+              }
             }
           ],
           "stateMachine": {
@@ -126,13 +260,7 @@
                 "isInitial": true
               },
               {
-                "name": "searching"
-              },
-              {
-                "name": "results"
-              },
-              {
-                "name": "viewingDetail"
+                "name": "ready"
               },
               {
                 "name": "error"
@@ -144,19 +272,8 @@
                 "name": "Initialize"
               },
               {
-                "key": "SEARCH",
-                "name": "Search"
-              },
-              {
-                "key": "SEARCH_COMPLETE",
-                "name": "Search Complete",
-                "payloadSchema": [
-                  {
-                    "name": "results",
-                    "type": "string",
-                    "required": true
-                  }
-                ]
+                "key": "READY",
+                "name": "Ready"
               },
               {
                 "key": "FAILED",
@@ -169,88 +286,12 @@
                   }
                 ]
               },
-              {
-                "key": "SELECT_VIDEO",
-                "name": "Select Video",
-                "payloadSchema": [
-                  {
-                    "name": "videoId",
-                    "type": "string",
-                    "required": true
-                  }
-                ]
-              },
-              {
-                "key": "RESET",
-                "name": "Reset"
-              },
-              {
-                "key": "VIDEO_LOADED",
-                "name": "Video Loaded",
-                "payloadSchema": [
-                  {
-                    "name": "title",
-                    "type": "string",
-                    "required": true
-                  },
-                  {
-                    "name": "description",
-                    "type": "string",
-                    "required": true
-                  }
-                ]
-              },
-              {
-                "key": "BACK",
-                "name": "Back"
-              },
               {
                 "key": "ServiceYoutubeLoaded",
                 "name": "ServiceYoutube loaded",
                 "payloadSchema": [
                   {
                     "name": "id",
-                    "type": "string",
-                    "required": true
-                  },
-                  {
-                    "name": "query",
-                    "type": "string"
-                  },
-                  {
-                    "name": "selectedVideoId",
-                    "type": "string"
-                  },
-                  {
-                    "name": "videoTitle",
-                    "type": "string"
-                  },
-                  {
-                    "name": "videoDescription",
-                    "type": "string"
-                  },
-                  {
-                    "name": "searchStatus",
-                    "type": "string"
-                  },
-                  {
-                    "name": "error",
-                    "type": "string"
-                  },
-                  {
-                    "name": "name",
-                    "type": "string"
-                  },
-                  {
-                    "name": "description",
-                    "type": "string"
-                  },
-                  {
-                    "name": "status",
-                    "type": "string"
-                  },
-                  {
-                    "name": "createdAt",
                     "type": "string"
                   }
                 ]
@@ -266,12 +307,12 @@
                 ]
               },
               {
-                "key": "ServiceYoutubeYoutubeCompleted",
-                "name": "ServiceYoutube youtube completed",
+                "key": "ServiceYoutubeYoutubeReady",
+                "name": "ServiceYoutube youtube ready",
                 "payloadSchema": [
                   {
-                    "name": "result",
-                    "type": "object"
+                    "name": "videoId",
+                    "type": "string"
                   }
                 ]
               },
@@ -288,6 +329,10 @@
                     "type": "string"
                   }
                 ]
+              },
+              {
+                "key": "RETRY",
+                "name": "Retry"
               }
             ],
             "transitions": [
@@ -298,8 +343,23 @@
                 "effects": [
                   [
                     "set",
-                    "@entity.query",
-                    ""
+                    "@entity.videoId",
+                    "@config.videoId"
+                  ],
+                  [
+                    "set",
+                    "@entity.autoplay",
+                    "@config.autoplay"
+                  ],
+                  [
+                    "set",
+                    "@entity.controls",
+                    "@config.controls"
+                  ],
+                  [
+                    "set",
+                    "@entity.start",
+                    "@config.start"
                   ],
                   [
                     "fetch",
@@ -315,42 +375,11 @@
                     "render-ui",
                     "main",
                     {
-                      "gap": "lg",
-                      "type": "stack",
+                      "gap": "md",
                       "direction": "vertical",
-                      "align": "stretch",
+                      "type": "stack",
                       "children": [
-                        {
-                          "gap": "md",
-                          "align": "center",
-                          "type": "stack",
-                          "children": [
-                            {
-                              "name": "video",
-                              "type": "icon"
-                            },
-                            {
-                              "type": "typography",
-                              "variant": "h2",
-                              "content": "YouTube Search"
-                            }
-                          ],
-                          "direction": "horizontal"
-                        },
-                        {
-                          "type": "divider"
-                        },
-                        {
-                          "type": "input",
-                          "placeholder": "Search YouTube videos..."
-                        },
-                        {
-                          "label": "Search",
-                          "type": "button",
-                          "action": "SEARCH",
-                          "variant": "primary",
-                          "icon": "search"
-                        }
+                        "@config.uiTrait"
                       ]
                     }
                   ]
@@ -358,109 +387,32 @@
               },
               {
                 "from": "idle",
-                "to": "searching",
-                "event": "SEARCH",
+                "to": "ready",
+                "event": "READY",
                 "effects": [
                   [
-                    "render-ui",
-                    "main",
-                    {
-                      "type": "loading-state",
-                      "message": "Searching YouTube for videos...",
-                      "title": "Searching..."
-                    }
-                  ],
-                  [
-                    "call-service",
-                    "youtube",
-                    "search",
-                    {
-                      "maxResults": 10.0,
-                      "type": "video",
-                      "query": "@entity.query"
-                    },
+                    "emit",
+                    "ServiceYoutubeYoutubeReady",
                     {
-                      "emit": {
-                        "failure": "ServiceYoutubeYoutubeFailed",
-                        "success": "ServiceYoutubeYoutubeCompleted"
-                      }
+                      "videoId": "@entity.videoId"
                     }
-                  ]
-                ]
-              },
-              {
-                "from": "searching",
-                "to": "results",
-                "event": "SEARCH_COMPLETE",
-                "effects": [
-                  [
-                    "set",
-                    "@entity.searchStatus",
-                    "complete"
                   ],
                   [
                     "render-ui",
                     "main",
                     {
                       "type": "stack",
-                      "gap": "lg",
+                      "direction": "vertical",
+                      "gap": "md",
                       "children": [
-                        {
-                          "direction": "horizontal",
-                          "align": "center",
-                          "gap": "md",
-                          "children": [
-                            {
-                              "name": "video",
-                              "type": "icon"
-                            },
-                            {
-                              "content": "Search Results",
-                              "variant": "h2",
-                              "type": "typography"
-                            }
-                          ],
-                          "type": "stack"
-                        },
-                        {
-                          "type": "divider"
-                        },
-                        {
-                          "content": "Select a video to view details.",
-                          "variant": "body",
-                          "type": "typography"
-                        },
-                        {
-                          "children": [
-                            {
-                              "type": "button",
-                              "variant": "ghost",
-                              "label": "New Search",
-                              "icon": "rotate-ccw",
-                              "action": "RESET"
-                            },
-                            {
-                              "icon": "search",
-                              "action": "SEARCH",
-                              "type": "button",
-                              "label": "Search Again",
-                              "variant": "ghost"
-                            }
-                          ],
-                          "type": "stack",
-                          "justify": "center",
-                          "direction": "horizontal",
-                          "gap": "sm"
-                        }
-                      ],
-                      "align": "stretch",
-                      "direction": "vertical"
+                        "@config.uiTrait"
+                      ]
                     }
                   ]
                 ]
               },
               {
-                "from": "searching",
+                "from": "idle",
                 "to": "error",
                 "event": "FAILED",
                 "effects": [
@@ -470,363 +422,130 @@
                     "@payload.error"
                   ],
                   [
-                    "set",
-                    "@entity.searchStatus",
-                    "error"
-                  ],
-                  [
-                    "render-ui",
-                    "main",
+                    "emit",
+                    "ServiceYoutubeYoutubeFailed",
                     {
-                      "gap": "lg",
-                      "align": "center",
-                      "type": "stack",
-                      "children": [
-                        {
-                          "type": "error-state",
-                          "message": "@entity.error",
-                          "onRetry": "SEARCH",
-                          "title": "Search Failed"
-                        },
-                        {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "sm",
-                          "children": [
-                            {
-                              "label": "Retry",
-                              "action": "SEARCH",
-                              "variant": "primary",
-                              "type": "button",
-                              "icon": "refresh-cw"
-                            },
-                            {
-                              "icon": "rotate-ccw",
-                              "label": "Reset",
-                              "type": "button",
-                              "action": "RESET",
-                              "variant": "ghost"
-                            }
-                          ],
-                          "justify": "center"
-                        }
-                      ],
-                      "direction": "vertical"
+                      "error": "@entity.error",
+                      "code": "youtube_embed_failed"
                     }
-                  ]
-                ]
-              },
-              {
-                "from": "results",
-                "to": "searching",
-                "event": "SEARCH",
-                "effects": [
+                  ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "type": "loading-state",
-                      "message": "Searching YouTube for videos...",
-                      "title": "Searching..."
-                    }
-                  ],
-                  [
-                    "call-service",
-                    "youtube",
-                    "search",
-                    {
-                      "query": "@entity.query",
-                      "maxResults": 10.0,
-                      "type": "video"
-                    },
-                    {
-                      "emit": {
-                        "success": "ServiceYoutubeYoutubeCompleted",
-                        "failure": "ServiceYoutubeYoutubeFailed"
-                      }
+                      "message": "@entity.error",
+                      "type": "error-state",
+                      "onRetry": "RETRY",
+                      "title": "Video Failed"
                     }
                   ]
                 ]
               },
               {
-                "from": "results",
-                "to": "viewingDetail",
-                "event": "SELECT_VIDEO",
-                "effects": [
-                  [
-                    "set",
-                    "@entity.selectedVideoId",
-                    "@payload.videoId"
-                  ],
-                  [
-                    "render-ui",
-                    "main",
-                    {
-                      "title": "Loading video...",
-                      "type": "loading-state",
-                      "message": "Fetching video details..."
-                    }
-                  ],
-                  [
-                    "call-service",
-                    "youtube",
-                    "getVideo",
-                    {
-                      "videoId": "@payload.videoId"
-                    },
-                    {
-                      "emit": {
-                        "failure": "ServiceYoutubeYoutubeFailed",
-                        "success": "ServiceYoutubeYoutubeCompleted"
-                      }
-                    }
-                  ]
-                ]
+                "from": "idle",
+                "to": "idle",
+                "event": "ServiceYoutubeLoaded"
               },
               {
-                "from": "results",
+                "from": "idle",
                 "to": "idle",
-                "event": "RESET",
-                "effects": [
-                  [
-                    "set",
-                    "@entity.searchStatus",
-                    "idle"
-                  ],
-                  [
-                    "render-ui",
-                    "main",
-                    {
-                      "align": "stretch",
-                      "gap": "lg",
-                      "direction": "vertical",
-                      "type": "stack",
-                      "children": [
-                        {
-                          "direction": "horizontal",
-                          "align": "center",
-                          "gap": "md",
-                          "children": [
-                            {
-                              "name": "video",
-                              "type": "icon"
-                            },
-                            {
-                              "variant": "h2",
-                              "content": "YouTube Search",
-                              "type": "typography"
-                            }
-                          ],
-                          "type": "stack"
-                        },
-                        {
-                          "type": "divider"
-                        },
-                        {
-                          "type": "input",
-                          "placeholder": "Search YouTube videos..."
-                        },
-                        {
-                          "variant": "primary",
-                          "icon": "search",
-                          "action": "SEARCH",
-                          "type": "button",
-                          "label": "Search"
-                        }
-                      ]
-                    }
-                  ]
-                ]
+                "event": "ServiceYoutubeLoadFailed"
               },
               {
-                "from": "viewingDetail",
-                "to": "viewingDetail",
-                "event": "VIDEO_LOADED",
+                "from": "ready",
+                "to": "ready",
+                "event": "ServiceYoutubeYoutubeReady"
+              },
+              {
+                "from": "ready",
+                "to": "error",
+                "event": "FAILED",
                 "effects": [
                   [
                     "set",
-                    "@entity.videoTitle",
-                    "@payload.title"
+                    "@entity.error",
+                    "@payload.error"
                   ],
                   [
-                    "set",
-                    "@entity.videoDescription",
-                    "@payload.description"
+                    "emit",
+                    "ServiceYoutubeYoutubeFailed",
+                    {
+                      "code": "youtube_playback_failed",
+                      "error": "@entity.error"
+                    }
                   ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "direction": "vertical",
-                      "gap": "lg",
-                      "type": "stack",
-                      "children": [
-                        {
-                          "type": "stack",
-                          "gap": "md",
-                          "align": "center",
-                          "children": [
-                            {
-                              "type": "icon",
-                              "name": "video"
-                            },
-                            {
-                              "content": "@entity.videoTitle",
-                              "type": "typography",
-                              "variant": "h2"
-                            }
-                          ],
-                          "direction": "horizontal"
-                        },
-                        {
-                          "type": "divider"
-                        },
-                        {
-                          "variant": "body",
-                          "content": "@entity.videoDescription",
-                          "type": "typography"
-                        },
-                        {
-                          "type": "button",
-                          "variant": "ghost",
-                          "icon": "arrow-left",
-                          "label": "Back to Results",
-                          "action": "BACK"
-                        }
-                      ],
-                      "align": "stretch"
+                      "message": "@entity.error",
+                      "type": "error-state",
+                      "title": "Video Failed",
+                      "onRetry": "RETRY"
                     }
                   ]
                 ]
               },
               {
-                "from": "viewingDetail",
-                "to": "results",
-                "event": "BACK",
-                "effects": [
-                  [
-                    "render-ui",
-                    "main",
-                    {
-                      "type": "stack",
-                      "direction": "vertical",
-                      "children": [
-                        {
-                          "children": [
-                            {
-                              "type": "icon",
-                              "name": "video"
-                            },
-                            {
-                              "variant": "h2",
-                              "type": "typography",
-                              "content": "Search Results"
-                            }
-                          ],
-                          "type": "stack",
-                          "gap": "md",
-                          "align": "center",
-                          "direction": "horizontal"
-                        },
-                        {
-                          "type": "divider"
-                        },
-                        {
-                          "variant": "body",
-                          "type": "typography",
-                          "content": "Select a video to view details."
-                        },
-                        {
-                          "children": [
-                            {
-                              "label": "New Search",
-                              "variant": "ghost",
-                              "type": "button",
-                              "action": "RESET",
-                              "icon": "rotate-ccw"
-                            },
-                            {
-                              "action": "SEARCH",
-                              "variant": "ghost",
-                              "icon": "search",
-                              "type": "button",
-                              "label": "Search Again"
-                            }
-                          ],
-                          "direction": "horizontal",
-                          "gap": "sm",
-                          "justify": "center",
-                          "type": "stack"
-                        }
-                      ],
-                      "gap": "lg",
-                      "align": "stretch"
-                    }
-                  ]
-                ]
+                "from": "error",
+                "to": "error",
+                "event": "ServiceYoutubeYoutubeFailed"
               },
               {
                 "from": "error",
                 "to": "idle",
-                "event": "RESET",
+                "event": "RETRY",
                 "effects": [
-                  [
-                    "set",
-                    "@entity.searchStatus",
-                    "idle"
-                  ],
                   [
                     "set",
                     "@entity.error",
                     ""
                   ],
+                  [
+                    "emit",
+                    "FAILED",
+                    {
+                      "error": "@entity.error"
+                    }
+                  ],
                   [
                     "render-ui",
                     "main",
                     {
+                      "type": "stack",
+                      "direction": "vertical",
                       "children": [
-                        {
-                          "type": "stack",
-                          "gap": "md",
-                          "children": [
-                            {
-                              "name": "video",
-                              "type": "icon"
-                            },
-                            {
-                              "type": "typography",
-                              "variant": "h2",
-                              "content": "YouTube Search"
-                            }
-                          ],
-                          "align": "center",
-                          "direction": "horizontal"
-                        },
-                        {
-                          "type": "divider"
-                        },
-                        {
-                          "type": "input",
-                          "placeholder": "Search YouTube videos..."
-                        },
-                        {
-                          "label": "Search",
-                          "type": "button",
-                          "icon": "search",
-                          "variant": "primary",
-                          "action": "SEARCH"
-                        }
+                        "@config.uiTrait"
                       ],
-                      "gap": "lg",
-                      "direction": "vertical",
-                      "align": "stretch",
-                      "type": "stack"
+                      "gap": "md"
                     }
                   ]
                 ]
               }
             ]
           },
+          "config": {
+            "videoId": {
+              "type": "string",
+              "default": ""
+            },
+            "uiTrait": {
+              "type": "trait",
+              "default": "@trait.ServiceYoutubeDefaultPlayer"
+            },
+            "controls": {
+              "type": "boolean",
+              "default": true
+            },
+            "start": {
+              "type": "number",
+              "default": 0.0
+            },
+            "autoplay": {
+              "type": "boolean",
+              "default": false
+            }
+          },
           "scope": "instance"
         }
       ],