@almadar/std 14.8.0 → 14.10.0

package/behaviors/registry/service/atoms/std-service-custom-bearer.orb

@@ -1,7 +1,7 @@
 {
   "name": "std-service-custom-bearer",
-  "version": "1.0.0",
-  "description": "std-service-custom-bearer as a Function",
+  "version": "2.0.0",
+  "description": "std-service-custom-bearer — Bearer-token HTTP service. Bind via `uses CustomBearer from \"std/behaviors/std-service-custom-bearer\"` and configure `endpoint` / `method` / `body` / `token` at the call site. Pass `uiTrait: \"@trait.YourBearerForm\"` to inject your own request form; leave unset to render the atom's default test form (standalone surface).",
   "orbitals": [
     {
       "name": "ServiceCustomBearerOrbital",
@@ -11,64 +11,193 @@
         "fields": [
           {
             "name": "id",
-            "type": "string"
+            "type": "string",
+            "required": true
           },
           {
-            "name": "name",
-            "type": "string"
+            "name": "endpoint",
+            "type": "string",
+            "default": ""
           },
           {
-            "name": "description",
-            "type": "string"
+            "name": "method",
+            "type": "string",
+            "default": "GET"
           },
           {
-            "name": "status",
+            "name": "body",
             "type": "string",
-            "default": "active",
-            "values": [
-              "active",
-              "inactive",
-              "pending"
-            ]
+            "default": ""
           },
           {
-            "name": "createdAt",
-            "type": "string"
+            "name": "token",
+            "type": "string",
+            "default": ""
           },
           {
-            "name": "endpoint",
-            "type": "string"
+            "name": "callId",
+            "type": "string",
+            "default": ""
           },
           {
-            "name": "method",
+            "name": "statusCode",
             "type": "string",
-            "default": "GET"
+            "default": ""
           },
           {
-            "name": "requestBody",
-            "type": "string"
+            "name": "error",
+            "type": "string",
+            "default": ""
           },
           {
-            "name": "responseData",
+            "name": "name",
             "type": "string"
           },
           {
-            "name": "statusCode",
-            "type": "string",
-            "default": ""
+            "name": "description",
+            "type": "string"
           },
           {
-            "name": "callStatus",
+            "name": "status",
             "type": "string",
-            "default": "idle"
+            "default": "active",
+            "values": [
+              "active",
+              "inactive",
+              "pending"
+            ]
           },
           {
-            "name": "error",
+            "name": "createdAt",
             "type": "string"
           }
         ]
       },
       "traits": [
+        {
+          "name": "ServiceCustomBearerDefaultForm",
+          "category": "interaction",
+          "emits": [
+            {
+              "event": "SEND",
+              "scope": "external",
+              "payloadSchema": [
+                {
+                  "name": "source",
+                  "type": "string"
+                }
+              ]
+            }
+          ],
+          "stateMachine": {
+            "states": [
+              {
+                "name": "ready",
+                "isInitial": true
+              }
+            ],
+            "events": [
+              {
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "key": "SEND",
+                "name": "Send"
+              }
+            ],
+            "transitions": [
+              {
+                "from": "ready",
+                "to": "ready",
+                "event": "INIT",
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "align": "center",
+                      "type": "stack",
+                      "gap": "lg",
+                      "direction": "vertical",
+                      "children": [
+                        {
+                          "children": [
+                            {
+                              "type": "icon",
+                              "name": "shield"
+                            },
+                            {
+                              "type": "typography",
+                              "content": "Bearer API Tester",
+                              "variant": "h2"
+                            }
+                          ],
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "gap": "md",
+                          "align": "center"
+                        },
+                        {
+                          "type": "divider"
+                        },
+                        {
+                          "gap": "md",
+                          "type": "stack",
+                          "direction": "vertical",
+                          "children": [
+                            {
+                              "options": [
+                                {
+                                  "label": "GET",
+                                  "value": "GET"
+                                },
+                                {
+                                  "label": "POST",
+                                  "value": "POST"
+                                },
+                                {
+                                  "label": "PUT",
+                                  "value": "PUT"
+                                },
+                                {
+                                  "value": "DELETE",
+                                  "label": "DELETE"
+                                }
+                              ],
+                              "type": "select"
+                            },
+                            {
+                              "type": "input",
+                              "placeholder": "/users"
+                            },
+                            {
+                              "placeholder": "JSON request body",
+                              "type": "textarea"
+                            },
+                            {
+                              "inputType": "password",
+                              "type": "input",
+                              "placeholder": "Bearer token"
+                            }
+                          ]
+                        },
+                        {
+                          "type": "button",
+                          "variant": "primary",
+                          "icon": "send",
+                          "action": "SEND",
+                          "label": "Send"
+                        }
+                      ]
+                    }
+                  ]
+                ]
+              }
+            ]
+          },
+          "scope": "instance"
+        },
         {
           "name": "ServiceCustomBearerCustomBearer",
           "category": "interaction",
@@ -95,9 +224,13 @@
               ]
             },
             {
-              "event": "ServiceCustomBearerCustomBearerApiCompleted",
+              "event": "ServiceCustomBearerCustomBearerCompleted",
               "scope": "external",
               "payloadSchema": [
+                {
+                  "name": "id",
+                  "type": "string"
+                },
                 {
                   "name": "result",
                   "type": "object"
@@ -105,7 +238,7 @@
               ]
             },
             {
-              "event": "ServiceCustomBearerCustomBearerApiFailed",
+              "event": "ServiceCustomBearerCustomBearerFailed",
               "scope": "external",
               "payloadSchema": [
                 {
@@ -117,6 +250,40 @@
                   "type": "string"
                 }
               ]
+            },
+            {
+              "event": "BearerDone",
+              "payloadSchema": [
+                {
+                  "name": "id",
+                  "type": "string",
+                  "required": true
+                },
+                {
+                  "name": "result",
+                  "type": "object"
+                }
+              ]
+            },
+            {
+              "event": "FAILED",
+              "payloadSchema": [
+                {
+                  "name": "error",
+                  "type": "string",
+                  "required": true
+                }
+              ]
+            }
+          ],
+          "listens": [
+            {
+              "event": "SEND",
+              "triggers": "SEND",
+              "source": {
+                "kind": "trait",
+                "trait": "ServiceCustomBearerDefaultForm"
+              }
             }
           ],
           "stateMachine": {
@@ -141,22 +308,41 @@
                 "name": "Initialize"
               },
               {
-                "key": "CALL_API",
-                "name": "Call Api"
+                "key": "SEND",
+                "name": "Send"
               },
               {
-                "key": "API_RESPONSE",
-                "name": "Api Response",
+                "key": "ServiceCustomBearerLoaded",
+                "name": "ServiceCustomBearer loaded",
                 "payloadSchema": [
                   {
-                    "name": "data",
+                    "name": "id",
+                    "type": "string"
+                  }
+                ]
+              },
+              {
+                "key": "ServiceCustomBearerLoadFailed",
+                "name": "ServiceCustomBearer load failed",
+                "payloadSchema": [
+                  {
+                    "name": "message",
+                    "type": "string"
+                  }
+                ]
+              },
+              {
+                "key": "BearerDone",
+                "name": "Bearer done",
+                "payloadSchema": [
+                  {
+                    "name": "id",
                     "type": "string",
                     "required": true
                   },
                   {
-                    "name": "statusCode",
-                    "type": "string",
-                    "required": true
+                    "name": "result",
+                    "type": "object"
                   }
                 ]
               },
@@ -176,77 +362,13 @@
                 "name": "Reset"
               },
               {
-                "key": "RETRY",
-                "name": "Retry"
-              },
-              {
-                "key": "ServiceCustomBearerLoaded",
-                "name": "ServiceCustomBearer loaded",
+                "key": "ServiceCustomBearerCustomBearerCompleted",
+                "name": "ServiceCustomBearer custom bearer completed",
                 "payloadSchema": [
                   {
                     "name": "id",
                     "type": "string"
                   },
-                  {
-                    "name": "name",
-                    "type": "string"
-                  },
-                  {
-                    "name": "description",
-                    "type": "string"
-                  },
-                  {
-                    "name": "status",
-                    "type": "string"
-                  },
-                  {
-                    "name": "createdAt",
-                    "type": "string"
-                  },
-                  {
-                    "name": "endpoint",
-                    "type": "string"
-                  },
-                  {
-                    "name": "method",
-                    "type": "string"
-                  },
-                  {
-                    "name": "requestBody",
-                    "type": "string"
-                  },
-                  {
-                    "name": "responseData",
-                    "type": "string"
-                  },
-                  {
-                    "name": "statusCode",
-                    "type": "string"
-                  },
-                  {
-                    "name": "callStatus",
-                    "type": "string"
-                  },
-                  {
-                    "name": "error",
-                    "type": "string"
-                  }
-                ]
-              },
-              {
-                "key": "ServiceCustomBearerLoadFailed",
-                "name": "ServiceCustomBearer load failed",
-                "payloadSchema": [
-                  {
-                    "name": "message",
-                    "type": "string"
-                  }
-                ]
-              },
-              {
-                "key": "ServiceCustomBearerCustomBearerApiCompleted",
-                "name": "ServiceCustomBearer custom bearer api completed",
-                "payloadSchema": [
                   {
                     "name": "result",
                     "type": "object"
@@ -254,8 +376,8 @@
                 ]
               },
               {
-                "key": "ServiceCustomBearerCustomBearerApiFailed",
-                "name": "ServiceCustomBearer custom bearer api failed",
+                "key": "ServiceCustomBearerCustomBearerFailed",
+                "name": "ServiceCustomBearer custom bearer failed",
                 "payloadSchema": [
                   {
                     "name": "error",
@@ -266,6 +388,10 @@
                     "type": "string"
                   }
                 ]
+              },
+              {
+                "key": "RETRY",
+                "name": "Retry"
               }
             ],
             "transitions": [
@@ -277,17 +403,22 @@
                   [
                     "set",
                     "@entity.endpoint",
-                    ""
+                    "@config.endpoint"
                   ],
                   [
                     "set",
                     "@entity.method",
-                    "GET"
+                    "@config.method"
+                  ],
+                  [
+                    "set",
+                    "@entity.body",
+                    "@config.body"
                   ],
                   [
                     "set",
-                    "@entity.requestBody",
-                    ""
+                    "@entity.token",
+                    "@config.token"
                   ],
                   [
                     "fetch",
@@ -303,57 +434,12 @@
                     "render-ui",
                     "main",
                     {
-                      "gap": "lg",
-                      "type": "stack",
-                      "align": "center",
-                      "direction": "vertical",
                       "children": [
-                        {
-                          "type": "icon",
-                          "name": "shield"
-                        },
-                        {
-                          "content": "Bearer API Tester",
-                          "variant": "h2",
-                          "type": "typography"
-                        },
-                        {
-                          "type": "input",
-                          "placeholder": "/users"
-                        },
-                        {
-                          "options": [
-                            {
-                              "label": "GET",
-                              "value": "GET"
-                            },
-                            {
-                              "value": "POST",
-                              "label": "POST"
-                            },
-                            {
-                              "label": "PUT",
-                              "value": "PUT"
-                            },
-                            {
-                              "label": "DELETE",
-                              "value": "DELETE"
-                            }
-                          ],
-                          "type": "select"
-                        },
-                        {
-                          "placeholder": "JSON request body",
-                          "type": "textarea"
-                        },
-                        {
-                          "label": "Send Request",
-                          "variant": "primary",
-                          "icon": "send",
-                          "type": "button",
-                          "action": "CALL_API"
-                        }
-                      ]
+                        "@config.uiTrait"
+                      ],
+                      "direction": "vertical",
+                      "gap": "md",
+                      "type": "stack"
                     }
                   ]
                 ]
@@ -361,86 +447,95 @@
               {
                 "from": "idle",
                 "to": "calling",
-                "event": "CALL_API",
+                "event": "SEND",
                 "effects": [
                   [
                     "render-ui",
                     "main",
                     {
                       "type": "loading-state",
-                      "message": "Sending request to servicecustombearer endpoint...",
-                      "title": "Calling API..."
+                      "title": "Calling API...",
+                      "message": "Sending bearer-authenticated request..."
                     }
                   ],
                   [
                     "call-service",
-                    "custom-bearer-api",
-                    "execute",
+                    "customBearer",
+                    "@config.method",
                     {
-                      "body": "@entity.requestBody",
-                      "method": "@entity.method",
-                      "endpoint": "@entity.endpoint"
+                      "endpoint": "@config.endpoint",
+                      "body": "@config.body",
+                      "token": "@config.token"
                     },
                     {
                       "emit": {
-                        "success": "ServiceCustomBearerCustomBearerApiCompleted",
-                        "failure": "ServiceCustomBearerCustomBearerApiFailed"
+                        "failure": "FAILED",
+                        "success": "BearerDone"
                       }
                     }
                   ]
                 ]
               },
+              {
+                "from": "idle",
+                "to": "idle",
+                "event": "ServiceCustomBearerLoaded"
+              },
+              {
+                "from": "idle",
+                "to": "idle",
+                "event": "ServiceCustomBearerLoadFailed"
+              },
               {
                 "from": "calling",
                 "to": "complete",
-                "event": "API_RESPONSE",
+                "event": "BearerDone",
                 "effects": [
                   [
                     "set",
-                    "@entity.responseData",
-                    "@payload.data"
+                    "@entity.callId",
+                    "@payload.id"
                   ],
                   [
-                    "set",
-                    "@entity.statusCode",
-                    "@payload.statusCode"
+                    "emit",
+                    "ServiceCustomBearerCustomBearerCompleted",
+                    {
+                      "id": "@payload.id",
+                      "result": "@payload.result"
+                    }
                   ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "align": "center",
+                      "type": "stack",
+                      "gap": "lg",
+                      "direction": "vertical",
                       "children": [
                         {
                           "type": "icon",
                           "name": "check-circle"
                         },
                         {
-                          "type": "typography",
-                          "variant": "h2",
-                          "content": "Response"
-                        },
-                        {
-                          "label": "@entity.statusCode",
-                          "type": "badge",
-                          "variant": "info"
+                          "type": "alert",
+                          "message": "Request successful!",
+                          "variant": "success"
                         },
                         {
-                          "type": "code-block",
-                          "code": "@entity.responseData",
-                          "language": "json"
+                          "type": "typography",
+                          "content": "@entity.callId",
+                          "color": "muted",
+                          "variant": "body"
                         },
                         {
-                          "action": "RESET",
-                          "label": "New Request",
                           "variant": "ghost",
                           "icon": "rotate-ccw",
-                          "type": "button"
+                          "type": "button",
+                          "label": "New Request",
+                          "action": "RESET"
                         }
                       ],
-                      "type": "stack",
-                      "direction": "vertical",
-                      "gap": "lg"
+                      "align": "center"
                     }
                   ]
                 ]
@@ -455,14 +550,22 @@
                     "@entity.error",
                     "@payload.error"
                   ],
+                  [
+                    "emit",
+                    "ServiceCustomBearerCustomBearerFailed",
+                    {
+                      "error": "@entity.error",
+                      "code": "bearer_call_failed"
+                    }
+                  ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "onRetry": "RETRY",
+                      "type": "error-state",
                       "message": "@entity.error",
                       "title": "Request Failed",
-                      "type": "error-state"
+                      "onRetry": "RETRY"
                     }
                   ]
                 ]
@@ -476,61 +579,26 @@
                     "render-ui",
                     "main",
                     {
-                      "align": "center",
                       "type": "stack",
-                      "direction": "vertical",
-                      "gap": "lg",
                       "children": [
-                        {
-                          "type": "icon",
-                          "name": "shield"
-                        },
-                        {
-                          "type": "typography",
-                          "content": "Bearer API Tester",
-                          "variant": "h2"
-                        },
-                        {
-                          "type": "input",
-                          "placeholder": "/users"
-                        },
-                        {
-                          "options": [
-                            {
-                              "value": "GET",
-                              "label": "GET"
-                            },
-                            {
-                              "value": "POST",
-                              "label": "POST"
-                            },
-                            {
-                              "value": "PUT",
-                              "label": "PUT"
-                            },
-                            {
-                              "label": "DELETE",
-                              "value": "DELETE"
-                            }
-                          ],
-                          "type": "select"
-                        },
-                        {
-                          "type": "textarea",
-                          "placeholder": "JSON request body"
-                        },
-                        {
-                          "type": "button",
-                          "action": "CALL_API",
-                          "icon": "send",
-                          "label": "Send Request",
-                          "variant": "primary"
-                        }
-                      ]
+                        "@config.uiTrait"
+                      ],
+                      "direction": "vertical",
+                      "gap": "md"
                     }
                   ]
                 ]
               },
+              {
+                "from": "complete",
+                "to": "complete",
+                "event": "ServiceCustomBearerCustomBearerCompleted"
+              },
+              {
+                "from": "error",
+                "to": "error",
+                "event": "ServiceCustomBearerCustomBearerFailed"
+              },
               {
                 "from": "error",
                 "to": "idle",
@@ -540,57 +608,12 @@
                     "render-ui",
                     "main",
                     {
-                      "direction": "vertical",
-                      "gap": "lg",
-                      "align": "center",
-                      "type": "stack",
                       "children": [
-                        {
-                          "type": "icon",
-                          "name": "shield"
-                        },
-                        {
-                          "type": "typography",
-                          "variant": "h2",
-                          "content": "Bearer API Tester"
-                        },
-                        {
-                          "type": "input",
-                          "placeholder": "/users"
-                        },
-                        {
-                          "options": [
-                            {
-                              "value": "GET",
-                              "label": "GET"
-                            },
-                            {
-                              "label": "POST",
-                              "value": "POST"
-                            },
-                            {
-                              "value": "PUT",
-                              "label": "PUT"
-                            },
-                            {
-                              "label": "DELETE",
-                              "value": "DELETE"
-                            }
-                          ],
-                          "type": "select"
-                        },
-                        {
-                          "placeholder": "JSON request body",
-                          "type": "textarea"
-                        },
-                        {
-                          "icon": "send",
-                          "label": "Send Request",
-                          "variant": "primary",
-                          "action": "CALL_API",
-                          "type": "button"
-                        }
-                      ]
+                        "@config.uiTrait"
+                      ],
+                      "gap": "md",
+                      "type": "stack",
+                      "direction": "vertical"
                     }
                   ]
                 ]
@@ -604,63 +627,46 @@
                     "render-ui",
                     "main",
                     {
-                      "children": [
-                        {
-                          "type": "icon",
-                          "name": "shield"
-                        },
-                        {
-                          "content": "Bearer API Tester",
-                          "type": "typography",
-                          "variant": "h2"
-                        },
-                        {
-                          "placeholder": "/users",
-                          "type": "input"
-                        },
-                        {
-                          "type": "select",
-                          "options": [
-                            {
-                              "label": "GET",
-                              "value": "GET"
-                            },
-                            {
-                              "label": "POST",
-                              "value": "POST"
-                            },
-                            {
-                              "label": "PUT",
-                              "value": "PUT"
-                            },
-                            {
-                              "value": "DELETE",
-                              "label": "DELETE"
-                            }
-                          ]
-                        },
-                        {
-                          "placeholder": "JSON request body",
-                          "type": "textarea"
-                        },
-                        {
-                          "label": "Send Request",
-                          "action": "CALL_API",
-                          "type": "button",
-                          "variant": "primary",
-                          "icon": "send"
-                        }
-                      ],
                       "type": "stack",
                       "direction": "vertical",
-                      "align": "center",
-                      "gap": "lg"
+                      "gap": "md",
+                      "children": [
+                        "@config.uiTrait"
+                      ]
                     }
                   ]
                 ]
               }
             ]
           },
+          "config": {
+            "uiTrait": {
+              "type": "trait",
+              "default": "@trait.ServiceCustomBearerDefaultForm"
+            },
+            "body": {
+              "type": "string",
+              "default": ""
+            },
+            "token": {
+              "type": "string",
+              "default": ""
+            },
+            "method": {
+              "type": "string",
+              "default": "GET",
+              "values": [
+                "GET",
+                "POST",
+                "PUT",
+                "DELETE"
+              ]
+            },
+            "endpoint": {
+              "type": "string",
+              "default": ""
+            }
+          },
           "scope": "instance"
         }
       ],