@almadar/std 6.5.2 → 7.2.0

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

@@ -1,7 +1,7 @@
 {
   "name": "std-service-youtube",
   "version": "1.0.0",
-  "description": "YouTube service integration behavior: search videos, view video details. Wraps the `youtube` service integration with search and getVideo operations. Pure function: params in, OrbitalDefinition out.",
+  "description": "std-service-youtube as a Function",
   "orbitals": [
     {
       "name": "ServiceYoutubeOrbital",
@@ -71,8 +71,73 @@
       "traits": [
         {
           "name": "ServiceYoutubeYoutube",
-          "linkedEntity": "ServiceYoutube",
           "category": "interaction",
+          "linkedEntity": "ServiceYoutube",
+          "emits": [
+            {
+              "event": "ServiceYoutubeLoaded",
+              "description": "Fired when ServiceYoutube finishes loading",
+              "scope": "internal",
+              "payload": [
+                {
+                  "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"
+                }
+              ]
+            },
+            {
+              "event": "ServiceYoutubeLoadFailed",
+              "description": "Fired when ServiceYoutube fails to load",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "message",
+                  "type": "string"
+                }
+              ]
+            }
+          ],
           "stateMachine": {
             "states": [
               {
@@ -99,7 +164,7 @@
               },
               {
                 "key": "SEARCH",
-                "name": "Search Videos"
+                "name": "Search"
               },
               {
                 "key": "SEARCH_COMPLETE",
@@ -112,6 +177,17 @@
                   }
                 ]
               },
+              {
+                "key": "FAILED",
+                "name": "Failed",
+                "payload": [
+                  {
+                    "name": "error",
+                    "type": "string",
+                    "required": true
+                  }
+                ]
+              },
               {
                 "key": "SELECT_VIDEO",
                 "name": "Select Video",
@@ -123,6 +199,10 @@
                   }
                 ]
               },
+              {
+                "key": "RESET",
+                "name": "Reset"
+              },
               {
                 "key": "VIDEO_LOADED",
                 "name": "Video Loaded",
@@ -141,22 +221,21 @@
               },
               {
                 "key": "BACK",
-                "name": "Back to Results"
+                "name": "Back"
               },
               {
-                "key": "FAILED",
-                "name": "Failed",
+                "key": "ServiceYoutubeLoaded",
+                "name": "ServiceYoutube loaded"
+              },
+              {
+                "key": "ServiceYoutubeLoadFailed",
+                "name": "ServiceYoutube load failed",
                 "payload": [
                   {
-                    "name": "error",
-                    "type": "string",
-                    "required": true
+                    "name": "message",
+                    "type": "string"
                   }
                 ]
-              },
-              {
-                "key": "RESET",
-                "name": "Reset"
               }
             ],
             "transitions": [
@@ -167,22 +246,21 @@
                 "effects": [
                   [
                     "fetch",
-                    "ServiceYoutube"
+                    "ServiceYoutube",
+                    {
+                      "emit": {
+                        "success": "ServiceYoutubeLoaded",
+                        "failure": "ServiceYoutubeLoadFailed"
+                      }
+                    }
                   ],
                   [
                     "render-ui",
                     "main",
                     {
                       "type": "stack",
-                      "direction": "vertical",
-                      "gap": "lg",
-                      "align": "stretch",
                       "children": [
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "md",
-                          "align": "center",
                           "children": [
                             {
                               "type": "icon",
@@ -190,29 +268,36 @@
                               "size": "lg"
                             },
                             {
-                              "type": "typography",
                               "content": "YouTube Search",
+                              "type": "typography",
                               "variant": "h2"
                             }
-                          ]
+                          ],
+                          "direction": "horizontal",
+                          "type": "stack",
+                          "gap": "md",
+                          "align": "center"
                         },
                         {
                           "type": "divider"
                         },
                         {
+                          "placeholder": "Search YouTube videos...",
                           "type": "input",
                           "label": "Search",
-                          "bind": "@entity.query",
-                          "placeholder": "Search YouTube videos..."
+                          "bind": "@entity.query"
                         },
                         {
                           "type": "button",
+                          "icon": "search",
                           "label": "Search",
-                          "event": "SEARCH",
                           "variant": "primary",
-                          "icon": "search"
+                          "event": "SEARCH"
                         }
-                      ]
+                      ],
+                      "direction": "vertical",
+                      "gap": "lg",
+                      "align": "stretch"
                     }
                   ]
                 ]
@@ -227,34 +312,8 @@
                     "main",
                     {
                       "type": "loading-state",
-                      "title": "Searching...",
-                      "message": "Searching YouTube for videos..."
-                    }
-                  ],
-                  [
-                    "call-service",
-                    "youtube",
-                    "search",
-                    {
-                      "query": "@entity.query",
-                      "maxResults": 10,
-                      "type": "video"
-                    }
-                  ]
-                ]
-              },
-              {
-                "from": "results",
-                "to": "searching",
-                "event": "SEARCH",
-                "effects": [
-                  [
-                    "render-ui",
-                    "main",
-                    {
-                      "type": "loading-state",
-                      "title": "Searching...",
-                      "message": "Searching YouTube for videos..."
+                      "message": "Searching YouTube for videos...",
+                      "title": "Searching..."
                     }
                   ],
                   [
@@ -262,9 +321,9 @@
                     "youtube",
                     "search",
                     {
-                      "query": "@entity.query",
-                      "maxResults": 10,
-                      "type": "video"
+                      "maxResults": 10.0,
+                      "type": "video",
+                      "query": "@entity.query"
                     }
                   ]
                 ]
@@ -283,26 +342,25 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
-                      "direction": "vertical",
                       "gap": "lg",
+                      "type": "stack",
                       "align": "stretch",
                       "children": [
                         {
-                          "type": "stack",
                           "direction": "horizontal",
-                          "gap": "md",
+                          "type": "stack",
                           "align": "center",
+                          "gap": "md",
                           "children": [
                             {
+                              "size": "lg",
                               "type": "icon",
-                              "name": "video",
-                              "size": "lg"
+                              "name": "video"
                             },
                             {
+                              "variant": "h2",
                               "type": "typography",
-                              "content": "Search Results",
-                              "variant": "h2"
+                              "content": "Search Results"
                             }
                           ]
                         },
@@ -310,33 +368,117 @@
                           "type": "divider"
                         },
                         {
-                          "type": "typography",
                           "content": "Select a video to view details.",
+                          "type": "typography",
                           "variant": "body"
                         },
                         {
-                          "type": "stack",
                           "direction": "horizontal",
-                          "gap": "sm",
-                          "justify": "center",
                           "children": [
                             {
-                              "type": "button",
-                              "label": "New Search",
                               "event": "RESET",
+                              "label": "New Search",
                               "variant": "ghost",
-                              "icon": "rotate-ccw"
+                              "icon": "rotate-ccw",
+                              "type": "button"
                             },
                             {
-                              "type": "button",
-                              "label": "Search Again",
-                              "event": "SEARCH",
+                              "icon": "search",
                               "variant": "outline",
-                              "icon": "search"
+                              "event": "SEARCH",
+                              "type": "button",
+                              "label": "Search Again"
                             }
-                          ]
+                          ],
+                          "gap": "sm",
+                          "justify": "center",
+                          "type": "stack"
                         }
-                      ]
+                      ],
+                      "direction": "vertical"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "searching",
+                "to": "error",
+                "event": "FAILED",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.error",
+                    "@payload.error"
+                  ],
+                  [
+                    "set",
+                    "@entity.searchStatus",
+                    "error"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "direction": "vertical",
+                      "gap": "lg",
+                      "children": [
+                        {
+                          "onRetry": "SEARCH",
+                          "message": "@entity.error",
+                          "type": "error-state",
+                          "title": "Search Failed"
+                        },
+                        {
+                          "children": [
+                            {
+                              "icon": "refresh-cw",
+                              "type": "button",
+                              "label": "Retry",
+                              "variant": "primary",
+                              "event": "SEARCH"
+                            },
+                            {
+                              "label": "Reset",
+                              "variant": "ghost",
+                              "icon": "rotate-ccw",
+                              "event": "RESET",
+                              "type": "button"
+                            }
+                          ],
+                          "justify": "center",
+                          "type": "stack",
+                          "gap": "sm",
+                          "direction": "horizontal"
+                        }
+                      ],
+                      "type": "stack",
+                      "align": "center"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "results",
+                "to": "searching",
+                "event": "SEARCH",
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "message": "Searching YouTube for videos...",
+                      "type": "loading-state",
+                      "title": "Searching..."
+                    }
+                  ],
+                  [
+                    "call-service",
+                    "youtube",
+                    "search",
+                    {
+                      "type": "video",
+                      "maxResults": 10.0,
+                      "query": "@entity.query"
                     }
                   ]
                 ]
@@ -371,86 +513,88 @@
                 ]
               },
               {
-                "from": "viewingDetail",
-                "to": "viewingDetail",
-                "event": "VIDEO_LOADED",
+                "from": "results",
+                "to": "idle",
+                "event": "RESET",
                 "effects": [
                   [
                     "set",
-                    "@entity.videoTitle",
-                    "@payload.title"
-                  ],
-                  [
-                    "set",
-                    "@entity.videoDescription",
-                    "@payload.description"
+                    "@entity.searchStatus",
+                    "idle"
                   ],
                   [
                     "render-ui",
                     "main",
                     {
                       "type": "stack",
-                      "direction": "vertical",
-                      "gap": "lg",
                       "align": "stretch",
                       "children": [
                         {
-                          "type": "stack",
                           "direction": "horizontal",
-                          "gap": "md",
-                          "align": "center",
                           "children": [
                             {
-                              "type": "icon",
                               "name": "video",
-                              "size": "lg"
+                              "size": "lg",
+                              "type": "icon"
                             },
                             {
-                              "type": "typography",
-                              "content": "@entity.videoTitle",
-                              "variant": "h2"
+                              "content": "YouTube Search",
+                              "variant": "h2",
+                              "type": "typography"
                             }
-                          ]
+                          ],
+                          "align": "center",
+                          "gap": "md",
+                          "type": "stack"
                         },
                         {
                           "type": "divider"
                         },
                         {
-                          "type": "typography",
-                          "content": "@entity.videoDescription",
-                          "variant": "body"
+                          "label": "Search",
+                          "bind": "@entity.query",
+                          "type": "input",
+                          "placeholder": "Search YouTube videos..."
                         },
                         {
+                          "variant": "primary",
+                          "label": "Search",
+                          "event": "SEARCH",
                           "type": "button",
-                          "label": "Back to Results",
-                          "event": "BACK",
-                          "variant": "ghost",
-                          "icon": "arrow-left"
+                          "icon": "search"
                         }
-                      ]
+                      ],
+                      "direction": "vertical",
+                      "gap": "lg"
                     }
                   ]
                 ]
               },
               {
                 "from": "viewingDetail",
-                "to": "results",
-                "event": "BACK",
+                "to": "viewingDetail",
+                "event": "VIDEO_LOADED",
                 "effects": [
+                  [
+                    "set",
+                    "@entity.videoTitle",
+                    "@payload.title"
+                  ],
+                  [
+                    "set",
+                    "@entity.videoDescription",
+                    "@payload.description"
+                  ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
-                      "direction": "vertical",
                       "gap": "lg",
                       "align": "stretch",
                       "children": [
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "md",
                           "align": "center",
+                          "direction": "horizontal",
                           "children": [
                             {
                               "type": "icon",
@@ -459,157 +603,98 @@
                             },
                             {
                               "type": "typography",
-                              "content": "Search Results",
+                              "content": "@entity.videoTitle",
                               "variant": "h2"
                             }
-                          ]
+                          ],
+                          "gap": "md",
+                          "type": "stack"
                         },
                         {
                           "type": "divider"
                         },
                         {
                           "type": "typography",
-                          "content": "Select a video to view details.",
+                          "content": "@entity.videoDescription",
                           "variant": "body"
                         },
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "sm",
-                          "justify": "center",
-                          "children": [
-                            {
-                              "type": "button",
-                              "label": "New Search",
-                              "event": "RESET",
-                              "variant": "ghost",
-                              "icon": "rotate-ccw"
-                            },
-                            {
-                              "type": "button",
-                              "label": "Search Again",
-                              "event": "SEARCH",
-                              "variant": "outline",
-                              "icon": "search"
-                            }
-                          ]
+                          "event": "BACK",
+                          "icon": "arrow-left",
+                          "type": "button",
+                          "variant": "ghost",
+                          "label": "Back to Results"
                         }
-                      ]
-                    }
-                  ]
-                ]
-              },
-              {
-                "from": "searching",
-                "to": "error",
-                "event": "FAILED",
-                "effects": [
-                  [
-                    "set",
-                    "@entity.error",
-                    "@payload.error"
-                  ],
-                  [
-                    "set",
-                    "@entity.searchStatus",
-                    "error"
-                  ],
-                  [
-                    "render-ui",
-                    "main",
-                    {
-                      "type": "stack",
+                      ],
                       "direction": "vertical",
-                      "gap": "lg",
-                      "align": "center",
-                      "children": [
-                        {
-                          "type": "error-state",
-                          "title": "Search Failed",
-                          "message": "@entity.error",
-                          "onRetry": "SEARCH"
-                        },
-                        {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "sm",
-                          "justify": "center",
-                          "children": [
-                            {
-                              "type": "button",
-                              "label": "Retry",
-                              "event": "SEARCH",
-                              "variant": "primary",
-                              "icon": "refresh-cw"
-                            },
-                            {
-                              "type": "button",
-                              "label": "Reset",
-                              "event": "RESET",
-                              "variant": "ghost",
-                              "icon": "rotate-ccw"
-                            }
-                          ]
-                        }
-                      ]
+                      "type": "stack"
                     }
                   ]
                 ]
               },
               {
-                "from": "results",
-                "to": "idle",
-                "event": "RESET",
+                "from": "viewingDetail",
+                "to": "results",
+                "event": "BACK",
                 "effects": [
-                  [
-                    "set",
-                    "@entity.searchStatus",
-                    "idle"
-                  ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
-                      "direction": "vertical",
-                      "gap": "lg",
-                      "align": "stretch",
                       "children": [
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "md",
-                          "align": "center",
                           "children": [
                             {
                               "type": "icon",
-                              "name": "video",
-                              "size": "lg"
+                              "size": "lg",
+                              "name": "video"
                             },
                             {
                               "type": "typography",
-                              "content": "YouTube Search",
+                              "content": "Search Results",
                               "variant": "h2"
                             }
-                          ]
+                          ],
+                          "gap": "md",
+                          "direction": "horizontal",
+                          "type": "stack",
+                          "align": "center"
                         },
                         {
                           "type": "divider"
                         },
                         {
-                          "type": "input",
-                          "label": "Search",
-                          "bind": "@entity.query",
-                          "placeholder": "Search YouTube videos..."
+                          "variant": "body",
+                          "type": "typography",
+                          "content": "Select a video to view details."
                         },
                         {
-                          "type": "button",
-                          "label": "Search",
-                          "event": "SEARCH",
-                          "variant": "primary",
-                          "icon": "search"
+                          "children": [
+                            {
+                              "type": "button",
+                              "icon": "rotate-ccw",
+                              "event": "RESET",
+                              "label": "New Search",
+                              "variant": "ghost"
+                            },
+                            {
+                              "icon": "search",
+                              "variant": "outline",
+                              "label": "Search Again",
+                              "event": "SEARCH",
+                              "type": "button"
+                            }
+                          ],
+                          "justify": "center",
+                          "direction": "horizontal",
+                          "gap": "sm",
+                          "type": "stack"
                         }
-                      ]
+                      ],
+                      "type": "stack",
+                      "align": "stretch",
+                      "gap": "lg",
+                      "direction": "vertical"
                     }
                   ]
                 ]
@@ -634,51 +719,52 @@
                     "main",
                     {
                       "type": "stack",
-                      "direction": "vertical",
-                      "gap": "lg",
                       "align": "stretch",
                       "children": [
                         {
-                          "type": "stack",
                           "direction": "horizontal",
-                          "gap": "md",
-                          "align": "center",
                           "children": [
                             {
+                              "size": "lg",
                               "type": "icon",
-                              "name": "video",
-                              "size": "lg"
+                              "name": "video"
                             },
                             {
-                              "type": "typography",
                               "content": "YouTube Search",
-                              "variant": "h2"
+                              "variant": "h2",
+                              "type": "typography"
                             }
-                          ]
+                          ],
+                          "type": "stack",
+                          "gap": "md",
+                          "align": "center"
                         },
                         {
                           "type": "divider"
                         },
                         {
-                          "type": "input",
                           "label": "Search",
+                          "type": "input",
                           "bind": "@entity.query",
                           "placeholder": "Search YouTube videos..."
                         },
                         {
+                          "variant": "primary",
                           "type": "button",
                           "label": "Search",
                           "event": "SEARCH",
-                          "variant": "primary",
                           "icon": "search"
                         }
-                      ]
+                      ],
+                      "direction": "vertical",
+                      "gap": "lg"
                     }
                   ]
                 ]
               }
             ]
-          }
+          },
+          "scope": "instance"
         }
       ],
       "pages": [
@@ -694,4 +780,4 @@
       ]
     }
   ]
-}
+}