@almadar/std 6.5.2 → 7.2.0

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

@@ -1,7 +1,7 @@
 {
   "name": "std-service-oauth",
   "version": "1.0.0",
-  "description": "OAuth service integration behavior: authorize, token exchange, refresh. Wraps the `oauth` integration with a multi-step authorization flow. Pure function: params in, OrbitalDefinition out.",
+  "description": "std-service-oauth as a Function",
   "orbitals": [
     {
       "name": "ServiceOauthOrbital",
@@ -71,8 +71,73 @@
       "traits": [
         {
           "name": "ServiceOauthOauth",
-          "linkedEntity": "ServiceOauth",
           "category": "interaction",
+          "linkedEntity": "ServiceOauth",
+          "emits": [
+            {
+              "event": "ServiceOauthLoaded",
+              "description": "Fired when ServiceOauth finishes loading",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "id",
+                  "type": "string",
+                  "required": true
+                },
+                {
+                  "name": "provider",
+                  "type": "string"
+                },
+                {
+                  "name": "authUrl",
+                  "type": "string"
+                },
+                {
+                  "name": "accessToken",
+                  "type": "string"
+                },
+                {
+                  "name": "refreshToken",
+                  "type": "string"
+                },
+                {
+                  "name": "authStatus",
+                  "type": "string"
+                },
+                {
+                  "name": "error",
+                  "type": "string"
+                },
+                {
+                  "name": "name",
+                  "type": "string"
+                },
+                {
+                  "name": "description",
+                  "type": "string"
+                },
+                {
+                  "name": "status",
+                  "type": "string"
+                },
+                {
+                  "name": "createdAt",
+                  "type": "string"
+                }
+              ]
+            },
+            {
+              "event": "ServiceOauthLoadFailed",
+              "description": "Fired when ServiceOauth fails to load",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "message",
+                  "type": "string"
+                }
+              ]
+            }
+          ],
           "stateMachine": {
             "states": [
               {
@@ -103,7 +168,7 @@
               },
               {
                 "key": "AUTH_URL_RECEIVED",
-                "name": "Auth URL Received",
+                "name": "Auth Url Received",
                 "payload": [
                   {
                     "name": "authUrl",
@@ -114,7 +179,7 @@
               },
               {
                 "key": "CALLBACK",
-                "name": "Authorization Callback",
+                "name": "Callback",
                 "payload": [
                   {
                     "name": "code",
@@ -123,6 +188,17 @@
                   }
                 ]
               },
+              {
+                "key": "FAILED",
+                "name": "Failed",
+                "payload": [
+                  {
+                    "name": "error",
+                    "type": "string",
+                    "required": true
+                  }
+                ]
+              },
               {
                 "key": "TOKEN_RECEIVED",
                 "name": "Token Received",
@@ -141,7 +217,11 @@
               },
               {
                 "key": "REFRESH",
-                "name": "Refresh Token"
+                "name": "Refresh"
+              },
+              {
+                "key": "LOGOUT",
+                "name": "Logout"
               },
               {
                 "key": "TOKEN_REFRESHED",
@@ -155,23 +235,22 @@
                 ]
               },
               {
-                "key": "LOGOUT",
-                "name": "Logout"
+                "key": "RETRY",
+                "name": "Retry"
               },
               {
-                "key": "FAILED",
-                "name": "Failed",
+                "key": "ServiceOauthLoaded",
+                "name": "ServiceOauth loaded"
+              },
+              {
+                "key": "ServiceOauthLoadFailed",
+                "name": "ServiceOauth load failed",
                 "payload": [
                   {
-                    "name": "error",
-                    "type": "string",
-                    "required": true
+                    "name": "message",
+                    "type": "string"
                   }
                 ]
-              },
-              {
-                "key": "RETRY",
-                "name": "Retry"
               }
             ],
             "transitions": [
@@ -182,43 +261,42 @@
                 "effects": [
                   [
                     "fetch",
-                    "ServiceOauth"
+                    "ServiceOauth",
+                    {
+                      "emit": {
+                        "success": "ServiceOauthLoaded",
+                        "failure": "ServiceOauthLoadFailed"
+                      }
+                    }
                   ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
-                      "direction": "vertical",
-                      "gap": "lg",
-                      "align": "center",
                       "children": [
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "md",
-                          "align": "center",
                           "children": [
                             {
                               "type": "icon",
-                              "name": "lock",
-                              "size": "lg"
+                              "size": "lg",
+                              "name": "lock"
                             },
                             {
-                              "type": "typography",
                               "content": "Sign In",
+                              "type": "typography",
                               "variant": "h2"
                             }
-                          ]
+                          ],
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "align": "center",
+                          "gap": "md"
                         },
                         {
                           "type": "divider"
                         },
                         {
-                          "type": "select",
                           "label": "Provider",
-                          "field": "provider",
-                          "bind": "@entity.provider",
                           "options": [
                             {
                               "label": "Google",
@@ -229,19 +307,26 @@
                               "value": "github"
                             },
                             {
-                              "label": "Microsoft",
-                              "value": "microsoft"
+                              "value": "microsoft",
+                              "label": "Microsoft"
                             }
-                          ]
+                          ],
+                          "type": "select",
+                          "field": "provider",
+                          "bind": "@entity.provider"
                         },
                         {
-                          "type": "button",
+                          "variant": "primary",
+                          "icon": "log-in",
                           "label": "Login",
                           "event": "LOGIN",
-                          "variant": "primary",
-                          "icon": "log-in"
+                          "type": "button"
                         }
-                      ]
+                      ],
+                      "align": "center",
+                      "gap": "lg",
+                      "direction": "vertical",
+                      "type": "stack"
                     }
                   ]
                 ]
@@ -255,9 +340,9 @@
                     "render-ui",
                     "main",
                     {
+                      "message": "Redirecting to provider for authorization.",
                       "type": "loading-state",
-                      "title": "Authorizing...",
-                      "message": "Redirecting to provider for authorization."
+                      "title": "Authorizing..."
                     }
                   ],
                   [
@@ -265,11 +350,11 @@
                     "oauth",
                     "authorize",
                     {
-                      "provider": "@entity.provider",
                       "scopes": [
                         "openid",
                         "email"
-                      ]
+                      ],
+                      "provider": "@entity.provider"
                     }
                   ]
                 ]
@@ -288,10 +373,10 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
                       "direction": "vertical",
-                      "gap": "lg",
+                      "type": "stack",
                       "align": "center",
+                      "gap": "lg",
                       "children": [
                         {
                           "type": "icon",
@@ -299,28 +384,28 @@
                           "size": "lg"
                         },
                         {
-                          "type": "typography",
                           "content": "Authorization Required",
+                          "type": "typography",
                           "variant": "h2"
                         },
                         {
-                          "type": "typography",
                           "content": "@entity.authUrl",
                           "variant": "body",
+                          "type": "typography",
                           "color": "muted"
                         },
                         {
                           "type": "input",
-                          "label": "Authorization Code",
                           "field": "code",
-                          "placeholder": "Paste authorization code here"
+                          "placeholder": "Paste authorization code here",
+                          "label": "Authorization Code"
                         },
                         {
-                          "type": "button",
                           "label": "Submit",
                           "event": "CALLBACK",
                           "variant": "primary",
-                          "icon": "check"
+                          "icon": "check",
+                          "type": "button"
                         }
                       ]
                     }
@@ -344,10 +429,10 @@
                     "render-ui",
                     "main",
                     {
+                      "align": "center",
                       "type": "stack",
                       "direction": "vertical",
                       "gap": "lg",
-                      "align": "center",
                       "children": [
                         {
                           "type": "icon",
@@ -355,37 +440,74 @@
                           "size": "lg"
                         },
                         {
-                          "type": "alert",
                           "variant": "success",
-                          "message": "Authenticated successfully"
+                          "message": "Authenticated successfully",
+                          "type": "alert"
                         },
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
                           "gap": "sm",
                           "justify": "center",
                           "children": [
                             {
-                              "type": "button",
                               "label": "Refresh Token",
-                              "event": "REFRESH",
+                              "icon": "refresh-cw",
                               "variant": "outline",
-                              "icon": "refresh-cw"
+                              "type": "button",
+                              "event": "REFRESH"
                             },
                             {
-                              "type": "button",
                               "label": "Logout",
-                              "event": "LOGOUT",
+                              "icon": "log-out",
+                              "type": "button",
                               "variant": "ghost",
-                              "icon": "log-out"
+                              "event": "LOGOUT"
                             }
-                          ]
+                          ],
+                          "direction": "horizontal",
+                          "type": "stack"
                         }
                       ]
                     }
                   ]
                 ]
               },
+              {
+                "from": "authorizing",
+                "to": "error",
+                "event": "FAILED",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.error",
+                    "@payload.error"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "stack",
+                      "gap": "lg",
+                      "direction": "vertical",
+                      "children": [
+                        {
+                          "type": "error-state",
+                          "onRetry": "RETRY",
+                          "message": "@entity.error",
+                          "title": "Authentication Failed"
+                        },
+                        {
+                          "type": "button",
+                          "variant": "primary",
+                          "icon": "rotate-ccw",
+                          "label": "Try Again",
+                          "event": "RETRY"
+                        }
+                      ],
+                      "align": "center"
+                    }
+                  ]
+                ]
+              },
               {
                 "from": "authenticated",
                 "to": "authenticated",
@@ -410,10 +532,10 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
-                      "direction": "vertical",
                       "gap": "lg",
+                      "direction": "vertical",
                       "align": "center",
+                      "type": "stack",
                       "children": [
                         {
                           "type": "icon",
@@ -421,31 +543,31 @@
                           "size": "lg"
                         },
                         {
+                          "message": "Authenticated successfully",
                           "type": "alert",
-                          "variant": "success",
-                          "message": "Authenticated successfully"
+                          "variant": "success"
                         },
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "sm",
                           "justify": "center",
                           "children": [
                             {
+                              "event": "REFRESH",
                               "type": "button",
                               "label": "Refresh Token",
-                              "event": "REFRESH",
-                              "variant": "outline",
-                              "icon": "refresh-cw"
+                              "icon": "refresh-cw",
+                              "variant": "outline"
                             },
                             {
-                              "type": "button",
-                              "label": "Logout",
                               "event": "LOGOUT",
+                              "label": "Logout",
+                              "type": "button",
                               "variant": "ghost",
                               "icon": "log-out"
                             }
-                          ]
+                          ],
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "gap": "sm"
                         }
                       ]
                     }
@@ -461,9 +583,9 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "loading-state",
                       "title": "Refreshing token...",
-                      "message": "Obtaining a new access token."
+                      "message": "Obtaining a new access token.",
+                      "type": "loading-state"
                     }
                   ],
                   [
@@ -476,62 +598,6 @@
                   ]
                 ]
               },
-              {
-                "from": "refreshing",
-                "to": "authenticated",
-                "event": "TOKEN_REFRESHED",
-                "effects": [
-                  [
-                    "set",
-                    "@entity.accessToken",
-                    "@payload.accessToken"
-                  ],
-                  [
-                    "render-ui",
-                    "main",
-                    {
-                      "type": "stack",
-                      "direction": "vertical",
-                      "gap": "lg",
-                      "align": "center",
-                      "children": [
-                        {
-                          "type": "icon",
-                          "name": "check-circle",
-                          "size": "lg"
-                        },
-                        {
-                          "type": "alert",
-                          "variant": "success",
-                          "message": "Authenticated successfully"
-                        },
-                        {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "sm",
-                          "justify": "center",
-                          "children": [
-                            {
-                              "type": "button",
-                              "label": "Refresh Token",
-                              "event": "REFRESH",
-                              "variant": "outline",
-                              "icon": "refresh-cw"
-                            },
-                            {
-                              "type": "button",
-                              "label": "Logout",
-                              "event": "LOGOUT",
-                              "variant": "ghost",
-                              "icon": "log-out"
-                            }
-                          ]
-                        }
-                      ]
-                    }
-                  ]
-                ]
-              },
               {
                 "from": "authenticated",
                 "to": "unauthenticated",
@@ -546,15 +612,10 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
-                      "direction": "vertical",
-                      "gap": "lg",
-                      "align": "center",
                       "children": [
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
                           "gap": "md",
+                          "direction": "horizontal",
                           "align": "center",
                           "children": [
                             {
@@ -563,78 +624,102 @@
                               "size": "lg"
                             },
                             {
-                              "type": "typography",
+                              "variant": "h2",
                               "content": "Sign In",
-                              "variant": "h2"
+                              "type": "typography"
                             }
-                          ]
+                          ],
+                          "type": "stack"
                         },
                         {
                           "type": "divider"
                         },
                         {
+                          "bind": "@entity.provider",
                           "type": "select",
-                          "label": "Provider",
                           "field": "provider",
-                          "bind": "@entity.provider",
                           "options": [
                             {
-                              "label": "Google",
-                              "value": "google"
+                              "value": "google",
+                              "label": "Google"
                             },
                             {
                               "label": "GitHub",
                               "value": "github"
                             },
                             {
-                              "label": "Microsoft",
-                              "value": "microsoft"
+                              "value": "microsoft",
+                              "label": "Microsoft"
                             }
-                          ]
+                          ],
+                          "label": "Provider"
                         },
                         {
-                          "type": "button",
+                          "icon": "log-in",
                           "label": "Login",
                           "event": "LOGIN",
                           "variant": "primary",
-                          "icon": "log-in"
+                          "type": "button"
                         }
-                      ]
+                      ],
+                      "align": "center",
+                      "type": "stack",
+                      "gap": "lg",
+                      "direction": "vertical"
                     }
                   ]
                 ]
               },
               {
-                "from": "authorizing",
-                "to": "error",
-                "event": "FAILED",
+                "from": "refreshing",
+                "to": "authenticated",
+                "event": "TOKEN_REFRESHED",
                 "effects": [
                   [
                     "set",
-                    "@entity.error",
-                    "@payload.error"
+                    "@entity.accessToken",
+                    "@payload.accessToken"
                   ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
                       "direction": "vertical",
-                      "gap": "lg",
+                      "type": "stack",
                       "align": "center",
+                      "gap": "lg",
                       "children": [
                         {
-                          "type": "error-state",
-                          "title": "Authentication Failed",
-                          "message": "@entity.error",
-                          "onRetry": "RETRY"
+                          "type": "icon",
+                          "name": "check-circle",
+                          "size": "lg"
                         },
                         {
-                          "type": "button",
-                          "label": "Try Again",
-                          "event": "RETRY",
-                          "variant": "primary",
-                          "icon": "rotate-ccw"
+                          "variant": "success",
+                          "message": "Authenticated successfully",
+                          "type": "alert"
+                        },
+                        {
+                          "children": [
+                            {
+                              "event": "REFRESH",
+                              "icon": "refresh-cw",
+                              "label": "Refresh Token",
+                              "variant": "outline",
+                              "type": "button"
+                            },
+                            {
+                              "variant": "ghost",
+                              "label": "Logout",
+                              "icon": "log-out",
+                              "event": "LOGOUT",
+                              "type": "button"
+                            }
+                          ],
+                          "direction": "horizontal",
+                          "gap": "sm",
+                          "type": "stack",
+                          "justify": "center"
                         }
                       ]
                     }
@@ -655,25 +740,25 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
-                      "direction": "vertical",
                       "gap": "lg",
-                      "align": "center",
+                      "type": "stack",
                       "children": [
                         {
-                          "type": "error-state",
                           "title": "Authentication Failed",
-                          "message": "@entity.error",
-                          "onRetry": "RETRY"
+                          "type": "error-state",
+                          "onRetry": "RETRY",
+                          "message": "@entity.error"
                         },
                         {
                           "type": "button",
-                          "label": "Try Again",
                           "event": "RETRY",
                           "variant": "primary",
-                          "icon": "rotate-ccw"
+                          "icon": "rotate-ccw",
+                          "label": "Try Again"
                         }
-                      ]
+                      ],
+                      "direction": "vertical",
+                      "align": "center"
                     }
                   ]
                 ]
@@ -688,65 +773,66 @@
                     "main",
                     {
                       "type": "stack",
-                      "direction": "vertical",
                       "gap": "lg",
-                      "align": "center",
                       "children": [
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "md",
-                          "align": "center",
                           "children": [
                             {
                               "type": "icon",
-                              "name": "lock",
-                              "size": "lg"
+                              "size": "lg",
+                              "name": "lock"
                             },
                             {
                               "type": "typography",
-                              "content": "Sign In",
-                              "variant": "h2"
+                              "variant": "h2",
+                              "content": "Sign In"
                             }
-                          ]
+                          ],
+                          "gap": "md",
+                          "direction": "horizontal",
+                          "type": "stack",
+                          "align": "center"
                         },
                         {
                           "type": "divider"
                         },
                         {
-                          "type": "select",
-                          "label": "Provider",
-                          "field": "provider",
-                          "bind": "@entity.provider",
                           "options": [
                             {
-                              "label": "Google",
-                              "value": "google"
+                              "value": "google",
+                              "label": "Google"
                             },
                             {
                               "label": "GitHub",
                               "value": "github"
                             },
                             {
-                              "label": "Microsoft",
-                              "value": "microsoft"
+                              "value": "microsoft",
+                              "label": "Microsoft"
                             }
-                          ]
+                          ],
+                          "type": "select",
+                          "bind": "@entity.provider",
+                          "label": "Provider",
+                          "field": "provider"
                         },
                         {
-                          "type": "button",
-                          "label": "Login",
                           "event": "LOGIN",
+                          "label": "Login",
                           "variant": "primary",
-                          "icon": "log-in"
+                          "icon": "log-in",
+                          "type": "button"
                         }
-                      ]
+                      ],
+                      "direction": "vertical",
+                      "align": "center"
                     }
                   ]
                 ]
               }
             ]
-          }
+          },
+          "scope": "instance"
         }
       ],
       "pages": [
@@ -762,4 +848,4 @@
       ]
     }
   ]
-}
+}